> ## 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 互換オブジェクトストレージを使用する

# 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/ja/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_`のプレフィックスが付与されます。