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

paimon テーブル関数

Experimental feature. Learn more.

Amazon S3、Azure、HDFS、またはローカルに保存された Apache Paimon テーブルに読み取り専用のテーブル形式インターフェイスを提供します。

構文​

paimon(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

paimonS3(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

paimonAzure(connection_string|storage_account_url, container_name, blobpath, [,account_name], [,account_key] [,format] [,compression_method])

paimonHDFS(path_to_table, [,format] [,compression_method])

paimonLocal(path_to_table, [,format] [,compression_method])

引数​

引数の説明は、それぞれのテーブル関数 s3、azureBlobStorage、HDFS、file における引数の説明と同一です。 format は、Paimon テーブル内のデータファイルのフォーマットを表します。

paimonS3 では、ClickHouse Cloud でロールベースアクセスを行うために、オプションの extra_credentials パラメータを使用して role_arn を渡すことができます。設定手順については、Secure S3 を参照してください。

戻り値​

指定された Paimon テーブルからデータを読み取るための、指定された構造を持つテーブルが返されます。

名前付きコレクションの定義​

次の例は、URL と認証情報を保存するための名前付きコレクションの設定方法を示しています。

<clickhouse>
    <named_collections>
        <paimon_conf>
            <url>http://test.s3.amazonaws.com/clickhouse-bucket/</url>
            <access_key_id>test<access_key_id>
            <secret_access_key>test</secret_access_key>
            <format>auto</format>
            <structure>auto</structure>
        </paimon_conf>
    </named_collections>
</clickhouse>

SELECT * FROM paimonS3(paimon_conf, filename = 'test_table')
DESCRIBE paimonS3(paimon_conf, filename = 'test_table')

エイリアス​

テーブル関数 paimon は、現在 paimonS3 のエイリアスになっています。

仮想列​

  • _path — ファイルへのパス。型: LowCardinality(String)。
  • _file — ファイル名。型: LowCardinality(String)。
  • _size — ファイルサイズ (バイト単位) 。型: Nullable(UInt64)。ファイルサイズが不明な場合、値は NULL となります。
  • _time — ファイルの最終更新時刻。型: Nullable(DateTime)。時刻が不明な場合、値は NULL となります。
  • _etag — ファイルの etag。型: LowCardinality(String)。etag が不明な場合、値は NULL となります。

サポートされるデータ型​

Paimon データ型ClickHouse データ型
BOOLEANInt8
TINYINTInt8
SMALLINTInt16
INTEGERInt32
BIGINTInt64
FLOATFloat32
DOUBLEFloat64
STRING,VARCHAR,BYTES,VARBINARYString
DATEDate
TIME(p),TIMETime('UTC')
TIMESTAMP(p) WITH LOCAL TIME ZONEDateTime64
TIMESTAMP(p)DateTime64('UTC')
CHARFixedString(1)
BINARY(n)FixedString(n)
DECIMAL(P,S)Decimal(P,S)
ARRAYArray
MAPMap

サポートされるパーティション​

Paimon のパーティションキーでサポートされるデータ型：

  • CHAR
  • VARCHAR
  • BOOLEAN
  • DECIMAL
  • TINYINT
  • SMALLINT
  • INTEGER
  • DATE
  • TIME
  • TIMESTAMP
  • TIMESTAMP WITH LOCAL TIME ZONE
  • BIGINT
  • FLOAT
  • DOUBLE

関連項目​