Como usar o Tigris

Use o armazenamento de objetos compatível com S3 do Tigris com o ClickHouse

Esta página não se aplica ao ClickHouse Cloud. O recurso documentado aqui não está disponível nos serviços do ClickHouse Cloud. Consulte o guia Compatibilidade com Cloud do ClickHouse para mais informações.

A função de tabela s3 e o tipo de disco S3 do ClickHouse são compatíveis com o Tigris, um serviço de armazenamento de objetos compatível com S3. O Tigris disponibiliza um único endpoint global em https://t3.storage.dev, com leituras atendidas pela região mais próxima de quem faz a chamada. Assim, uma frota multirregional do ClickHouse pode usar uma única URL de bucket, sem réplicas por região nem tráfego de saída entre regiões.

A configuração da árvore de mesclagem de suporte é compatível com pequenas alterações:

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

Defina <region>auto</region>. O Tigris usa um único endpoint global, em vez de buckets por região, mas o fluxo de assinatura AWS SigV4 usado pelo ClickHouse ainda exige um valor de região, e auto é a convenção.

A função de tabela s3 funciona com o mesmo endpoint:

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

As chaves de acesso podem ser criadas no Console do Tigris. Os IDs das chaves de acesso começam com tid_, e os segredos, com tsec_.