paimon

Fornece uma interface semelhante a uma tabela, somente leitura, para tabelas Apache Paimon no Amazon S3, Azure, HDFS ou armazenadas localmente.

Sintaxe

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

A descrição dos argumentos é a mesma das funções de tabela s3, azureBlobStorage, HDFS e file, respectivamente. format indica o formato dos arquivos de dados na tabela Paimon. Para paimonS3, é possível usar um parâmetro opcional extra_credentials para fornecer um role_arn para controle de acesso baseado em função no ClickHouse Cloud. Consulte Secure S3 para ver as etapas de configuração.

Valor retornado

Uma tabela com a estrutura especificada para ler dados da tabela Paimon informada.

Limitações

A mesclagem durante a leitura não foi implementada. Por isso, não é possível ler tabelas com chave primária: o leitor retorna a união dos arquivos de dados do snapshot sem processamento adicional, incluindo versões de linhas substituídas por upserts posteriores. Assim, a tentativa de ler uma tabela cujo schema declara primary-key lança uma exceção.

Definindo uma coleção nomeada

Aqui está um exemplo de configuração de uma coleção nomeada para armazenar a URL e as credenciais:

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

Aliases

A função de tabela paimon agora é um alias para paimonS3.

Colunas virtuais

_path — Caminho do arquivo. Tipo: LowCardinality(String).
_file — Nome do arquivo. Tipo: LowCardinality(String).
_size — Tamanho do arquivo em bytes. Tipo: Nullable(UInt64). Se o tamanho do arquivo for desconhecido, o valor será NULL.
_time — Data e hora da última modificação do arquivo. Tipo: Nullable(DateTime). Se a data e hora forem desconhecidas, o valor será NULL.
_etag — O etag do arquivo. Tipo: LowCardinality(String). Se o etag for desconhecido, o valor será NULL.

Tipos de dados compatíveis

Tipo de dado do Paimon	Tipo de dado do 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

Partições compatíveis

Tipos de dados compatíveis com chaves de partição no Paimon:

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

Veja também

função de tabela de cluster do Paimon

Referência de SQL

Tipos de dados

Motores

Funções

Formatos

Configurações

Tabelas de sistema

Lagos de dados

Sintaxe

Argumentos

Valor retornado

Limitações

Definindo uma coleção nomeada

Aliases

Colunas virtuais

Tipos de dados compatíveis

Partições compatíveis

Veja também

​Sintaxe

​Argumentos

​Valor retornado

​Limitações

​Definindo uma coleção nomeada

​Aliases

​Colunas virtuais

​Tipos de dados compatíveis

​Partições compatíveis

​Veja também

Sintaxe

Argumentos

Valor retornado

Limitações

Definindo uma coleção nomeada

Aliases

Colunas virtuais

Tipos de dados compatíveis

Partições compatíveis

Veja também