Utiliser Tigris

Cette page ne s’applique pas à ClickHouse Cloud. La fonctionnalité décrite ici n’est pas disponible dans les services ClickHouse Cloud. Consultez le guide ClickHouse Compatibilité Cloud pour plus d’informations.

La table function s3 et le disk type S3 de ClickHouse sont compatibles avec Tigris, un service d’object storage compatible avec S3. Tigris propose un endpoint global unique à l’adresse https://t3.storage.dev, les reads étant effectuées depuis la Region la plus proche de l’appelant. Ainsi, un parc ClickHouse multirégion peut utiliser une seule Bucket URL, sans répliques par Region ni egress interrégional. La configuration de backed merge tree est compatible moyennant des modifications mineures :

<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>

Définissez <region>auto</region>. Tigris utilise un endpoint global unique plutôt que des buckets par région, mais le processus de signature AWS SigV4 utilisé par ClickHouse requiert tout de même une valeur de région, et auto est la convention.

La fonction de table s3 fonctionne avec le même endpoint :

SELECT *
FROM s3(
    'https://your-bucket.t3.storage.dev/path/to/file.parquet',
    'your_access_key_id',
    'your_secret_access_key',
    'Parquet'
);

Vous pouvez créer des clés d’accès depuis la Console Tigris. Les identifiants des clés d’accès commencent par tid_ et les secrets par tsec_.

Dernière modification le 14 août 2026

Data sources

Data visualization

Data ingestion

Data integrations

SQL-clients

Tools