> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ClickHouse에서 Tigris S3-compatible 객체 스토리지 사용

# Tigris 사용

export const CloudNotSupportedBadge = () => {
  return <a href="https://clickhouse.com/docs/products/cloud/guides/cloud-compatibility#list-of-unsupported-features" className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            ClickHouse Cloud에서 지원되지 않음
        </a>;
};

<CloudNotSupportedBadge />

<Note>
  이 페이지는 [ClickHouse Cloud](https://clickhouse.com/cloud)에는 적용되지 않습니다. 여기에서 설명하는 기능은 ClickHouse Cloud 서비스에서 지원되지 않습니다.
  자세한 내용은 ClickHouse의 [Cloud Compatibility](/docs/ko/products/cloud/guides/cloud-compatibility) 가이드를 참조하십시오.
</Note>

ClickHouse의 `s3` 테이블 함수와 `S3` 디스크 유형은 S3 호환 객체 스토리지 서비스인 [Tigris](https://www.tigrisdata.com)와 호환됩니다. Tigris는 `https://t3.storage.dev`에 단일 글로벌 엔드포인트를 제공하며, 읽기 요청은 호출자와 가장 가까운 리전에서 처리됩니다. 따라서 여러 리전에 걸친 ClickHouse 환경에서도 리전별 레플리카나 리전 간 egress 없이 하나의 버킷 URL을 사용할 수 있습니다.

기존 MergeTree 구성은 약간만 변경하면 호환됩니다:

```xml theme={null}
<clickhouse>
    <storage_configuration>
        ...
        <disks>
            <s3>
                <type>s3</type>
                <endpoint>https://your-bucket.t3.storage.dev/tables/</endpoint>
                <access_key_id>your_access_key_id</access_key_id>
                <secret_access_key>your_secret_access_key</secret_access_key>
                <region>auto</region>
                <metadata_path>/var/lib/clickhouse/disks/s3/</metadata_path>
            </s3>
            <s3_cache>
                <type>cache</type>
                <disk>s3</disk>
                <path>/var/lib/clickhouse/disks/s3_cache/</path>
                <max_size>10Gi</max_size>
            </s3_cache>
        </disks>
        ...
    </storage_configuration>
</clickhouse>
```

<Tip>
  `<region>auto</region>`로 설정하십시오. Tigris는 리전별 버킷이 아닌 단일 글로벌 엔드포인트를 사용하지만, ClickHouse에서 사용하는 AWS SigV4 서명 절차에는 여전히 리전 값이 필요하며 `auto`를 사용하는 것이 관례입니다.
</Tip>

`s3` 테이블 함수도 동일한 엔드포인트를 사용합니다:

```sql theme={null}
SELECT *
FROM s3(
    'https://your-bucket.t3.storage.dev/path/to/file.parquet',
    'your_access_key_id',
    'your_secret_access_key',
    'Parquet'
);
```

[Tigris Console](https://console.storage.dev/)에서 액세스 키를 생성할 수 있습니다. 액세스 키 ID는 `tid_`로, 시크릿은 `tsec_`로 시작합니다.