メインコンテンツへスキップ
メインコンテンツへスキップ

DeltaLake テーブルエンジン

このエンジンは、Amazon S3 上に存在する既存の Delta Lake テーブルとの連携を提供し、読み取りと書き込みの両方をサポートします（v25.10 から）。

テーブルを作成する​

Delta Lake テーブルはあらかじめ S3 上に存在している必要があり、このコマンドでは新しいテーブルを作成するための DDL パラメータは指定できません。

CREATE TABLE deltalake
ENGINE = DeltaLake(url, [aws_access_key_id, aws_secret_access_key,])

エンジンパラメータ

  • url — 既存の Delta Lake テーブルへのパスを含むバケットの URL。
  • aws_access_key_id, aws_secret_access_key - AWS アカウントユーザーの長期的に有効な認証情報。リクエストの認証に使用できます。パラメータは省略可能です。認証情報が指定されていない場合は、設定ファイルで指定されたものが使用されます。

エンジンパラメータは Named Collections を使用して指定できます。

例

CREATE TABLE deltalake
ENGINE = DeltaLake('http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/test_table/', 'ABC123', 'Abc+123')

名前付きコレクションの使用:

<clickhouse>
    <named_collections>
        <deltalake_conf>
            <url>http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/</url>
            <access_key_id>ABC123<access_key_id>
            <secret_access_key>Abc+123</secret_access_key>
        </deltalake_conf>
    </named_collections>
</clickhouse>

CREATE TABLE deltalake
ENGINE = DeltaLake(deltalake_conf, filename = 'test_table')

データキャッシュ​

DeltaLake テーブルエンジンおよびテーブル関数は、S3、AzureBlobStorage、HDFS ストレージと同様に、データキャッシュをサポートします。詳細はこちらを参照してください。

データの挿入​

DeltaLake テーブルエンジンを使用してテーブルを作成したら、次の方法でデータを挿入できます。

SET allow_experimental_delta_lake_writes = 1;

INSERT INTO deltalake(id, firstname, lastname, gender, age)
VALUES (1, 'John', 'Smith', 'M', 32);

関連項目​