paimon

Proporciona una interfaz similar a una tabla de solo lectura para tablas de Apache Paimon en Amazon S3, Azure, HDFS o almacenadas localmente.

Sintaxis

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

Argumentos

La descripción de estos argumentos coincide con la de las funciones de tabla s3, azureBlobStorage, HDFS y file, respectivamente. format indica el formato de los archivos de datos de la tabla Paimon. Para paimonS3, puede usarse un parámetro opcional, extra_credentials, para pasar un role_arn y habilitar el acceso basado en roles en ClickHouse Cloud. Consulta Secure S3 para ver los pasos de configuración.

Valor de retorno

Una tabla con la estructura especificada para leer datos de la tabla de Paimon indicada.

Limitaciones

La fusión durante la lectura no está implementada, por lo que no se pueden leer tablas con clave primaria: el componente de lectura devuelve la unión sin procesar de los archivos de datos de la instantánea, que aún contiene versiones de filas sustituidas por operaciones posteriores de inserción o actualización. Por tanto, leer una tabla cuyo esquema declara primary-key genera una excepción.

Definir una colección con nombre

A continuación se muestra un ejemplo de cómo configurar una colección con nombre para almacenar la URL y las credenciales:

<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 función de tabla paimon ahora es un alias de paimonS3.

Columnas virtuales

_path — Ruta del archivo. Tipo: LowCardinality(String).
_file — Nombre del archivo. Tipo: LowCardinality(String).
_size — Tamaño del archivo en bytes. Tipo: Nullable(UInt64). Si se desconoce el tamaño del archivo, el valor es NULL.
_time — Hora de la última modificación del archivo. Tipo: Nullable(DateTime). Si se desconoce la hora, el valor es NULL.
_etag — El etag del archivo. Tipo: LowCardinality(String). Si se desconoce el etag, el valor es NULL.

Tipos de datos admitidos

Tipo de dato de Paimon	Tipo de dato de 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

Particiones admitidas

Tipos de datos admitidos en las claves de partición de Paimon:

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

Véase también

Función de tabla de clúster de Paimon

Referencia de SQL

Tipos de datos

Motores

Funciones

Formatos

Configuración

Tablas del sistema

Lagos de datos

Sintaxis

Argumentos

Valor de retorno

Limitaciones

Definir una colección con nombre

Alias

Columnas virtuales

Tipos de datos admitidos

Particiones admitidas

Véase también

​Sintaxis

​Argumentos

​Valor de retorno

​Limitaciones

​Definir una colección con nombre

​Alias

​Columnas virtuales

​Tipos de datos admitidos

​Particiones admitidas

​Véase también

Sintaxis

Argumentos

Valor de retorno

Limitaciones

Definir una colección con nombre

Alias

Columnas virtuales

Tipos de datos admitidos

Particiones admitidas

Véase también