> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-1d264819.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Replica-aware 라우팅

> 캐시 재사용률을 높이기 위해 Replica-aware 라우팅을 사용하는 방법

export const PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Private preview in ClickHouse Cloud'}
        </div>;
};

Replica-aware 라우팅(스티키 세션, 스티키 라우팅 또는 세션 어피니티라고도 함)은 [Envoy 프록시의 ring hash 로드 밸런싱](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/upstream/load_balancing/load_balancers#ring-hash)을 사용합니다. Replica-aware 라우팅의 주된 목적은 캐시 재사용 가능성을 높이는 것입니다. 다만, 격리를 보장하지는 않습니다.

서비스에서 Replica-aware 라우팅을 활성화하면 서비스 호스트명 앞에 와일드카드 서브도메인을 사용할 수 있습니다. 예를 들어 호스트명이 `abcxyz123.us-west-2.aws.clickhouse.cloud`인 서비스의 경우, `*.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud`와 일치하는 임의의 호스트명을 사용해 서비스에 접속할 수 있습니다.

| 예시 호스트명                                                                  |
| ------------------------------------------------------------------------ |
| `aaa.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud`                    |
| `000.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud`                    |
| `clickhouse-is-the-best.sticky.abcxyz123.us-west-2.aws.clickhouse.cloud` |

Envoy가 이러한 패턴과 일치하는 호스트명을 받으면, 해당 호스트명을 기준으로 라우팅 해시를 계산하고 그 해시를 바탕으로 해시 링에서 해당하는 ClickHouse 서버를 찾습니다. 서비스에 진행 중인 변경이 없다고 가정하면(예: 서버 재시작, 스케일 아웃/인), Envoy는 항상 동일한 ClickHouse 서버를 선택해 연결합니다.

원래 호스트명은 여전히 기본 라우팅 알고리즘인 `LEAST_CONNECTION` 로드 밸런싱을 사용한다는 점에 유의하십시오.

<div id="limitations-of-replica-aware-routing">
  ## Replica-aware 라우팅의 한계
</div>

<div id="replica-aware-routing-does-not-guarantee-isolation">
  ### Replica-aware 라우팅은 격리를 보장하지 않습니다
</div>

서비스에 어떤 형태로든 변경이나 중단이 발생하면(예: 버전 업그레이드, 크래시, 수직 스케일링 업 등의 이유로 서버 파드가 재시작되거나 서버가 스케일 아웃/인되는 경우) 라우팅 해시 링이 영향을 받습니다. 그러면 동일한 호스트명을 가진 연결이 다른 서버 파드로 라우팅될 수 있습니다.

<div id="replica-aware-routing-does-not-work-out-of-the-box-with-private-link">
  ### Replica-aware 라우팅은 Private Link에서 별도 설정 없이 바로 작동하지 않습니다
</div>

고객은 새로운 호스트명 패턴에 대해 이름 해석이 동작하도록 DNS 레코드를 수동으로 추가해야 합니다. 이를 잘못 구성하면 서버 부하가 불균형해질 수 있습니다.

<div id="configuring-replica-aware-routing">
  ## Replica-aware 라우팅 설정
</div>

Replica-aware 라우팅을 활성화하려면 [지원팀](https://clickhouse.com/support/program)에 문의하십시오.