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.

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.

Limitations

La fusion à la lecture (merge-on-read) n’étant pas implémentée, les tables à clé primaire ne peuvent pas être lues : le lecteur renvoie l’union brute des fichiers de données du snapshot, qui contient encore les versions de lignes remplacées par des upserts ultérieurs. La lecture d’une table dont le schéma déclare primary-key lève donc une exception.

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	Bool
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

Référence SQL

Types de données

Moteurs

Fonctions

Formats

Paramètres

Tables système

Lacs de données

Syntaxe

Arguments

Valeur renvoyée

Limitations

Définir une collection nommée

Alias

Colonnes virtuelles

Types de données prises en charge

Prise en charge des partitions

Voir aussi

​Syntaxe

​Arguments

​Valeur renvoyée

​Limitations

​Définir une collection nommée

​Alias

​Colonnes virtuelles

​Types de données prises en charge

​Prise en charge des partitions

​Voir aussi

Syntaxe

Arguments

Valeur renvoyée

Limitations

Définir une collection nommée

Alias

Colonnes virtuelles

Types de données prises en charge

Prise en charge des partitions

Voir aussi