Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

paimon

View as MarkdownEdit this pageReport an issueSet up docs MCP
Fonctionnalité expérimentale

Fournit une interface de type table en lecture seule pour les tables Apache Paimon stockées dans Amazon S3, Azure, HDFS ou en local.

Syntaxe

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

Arguments

La description de ces arguments correspond à celle des arguments des fonctions de table s3, azureBlobStorage, HDFS et file, respectivement. format désigne le format des data files de la table Paimon.

Pour paimonS3, vous pouvez utiliser le paramètre facultatif extra_credentials pour transmettre un role_arn afin d'activer un accès basé sur les rôles dans ClickHouse Cloud. Voir Secure S3 pour les étapes de configuration.

Valeur renvoyée

Une table ayant la structure spécifiée, permettant de lire les données de la table Paimon indiquée.

Définir une collection nommée

Voici un exemple de configuration d'une collection nommée pour stocker l'URL et les informations d'authentification :

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

Alias

La fonction de table paimon est désormais un alias de paimonS3.

Colonnes virtuelles

  • _path — Chemin du fichier. Type : LowCardinality(String).
  • _file — Nom du fichier. Type : LowCardinality(String).
  • _size — Taille du fichier en octets. Type : Nullable(UInt64). Si la taille du fichier est inconnue, la valeur est NULL.
  • _time — Date et heure de dernière modification du fichier. Type : Nullable(DateTime). Si la date et l’heure sont inconnues, la valeur est NULL.
  • _etag — ETag du fichier. Type : LowCardinality(String). Si l’ETag est inconnu, la valeur est NULL.

Types de données prises en charge

Type de données Paimon Type de données ClickHouse
BOOLEAN Int8
TINYINT Int8
SMALLINT Int16
INTEGER Int32
BIGINT Int64
FLOAT Float32
DOUBLE Float64
STRING,VARCHAR,BYTES,VARBINARY String
DATE Date
TIME(p),TIME Time('UTC')
TIMESTAMP(p) WITH LOCAL TIME ZONE DateTime64
TIMESTAMP(p) DateTime64('UTC')
CHAR FixedString(1)
BINARY(n) FixedString(n)
DECIMAL(P,S) Decimal(P,S)
ARRAY Array
MAP Map

Prise en charge des partitions

Types de données pris en charge pour les clés de partition Paimon :

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

Voir aussi

Navigation