S3 - ClickHouse Documentation

S3 データベースエンジンは、Amazon S3 および S3 互換のオブジェクトストレージ上のオブジェクトを読み取り専用のテーブルとして公開します。テーブル名は、s3 テーブル関数によってオブジェクトの URL として解決されます。

データベースの作成

CREATE DATABASE s3_data
ENGINE = S3([url[, NOSIGN | access_key_id, secret_access_key]]);

このエンジンは named collection を受け取ることもできます。サポートされている設定キーは url、access_key_id、secret_access_key、no_sign_request、use_environment_credentials です。

base URL を指定した場合、テーブル名はその URL からの相対的なオブジェクトパスとなります。

CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;

base URL を指定しない場合は、オブジェクトの完全な URL をテーブル名として使用します。スキーマとフォーマットは、s3 テーブル関数と同じ方法で推論されます。このデータベースはテーブル定義を保持せず、テーブルの DDL や書き込みもサポートしません。

S3 URL は、サーバーの remote-host フィルターによってチェックされます。このデータベースを作成するには、table_engines_require_grant の設定にかかわらず、S3 に対する READ および WRITE のソース権限が必要です。例:

GRANT READ, WRITE ON S3 TO user_name;

バージョンおよび互換性の詳細については、SOURCES 権限を参照してください。