paimon

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

​

Fonction de table paimon

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

​

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

• Fonction de table cluster de Paimon