Pular para o conteúdo principal
Fornece uma interface semelhante a tabela, somente leitura, para tabelas do Apache Hudi no Amazon S3.

Sintaxe

hudi(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

Argumentos

ArgumentoDescrição
urlURL do bucket com o caminho para uma tabela Hudi existente no S3.
aws_access_key_id, aws_secret_access_keyCredenciais de longo prazo para o usuário da conta AWS. Você pode usá-las para autenticar suas requisições. Esses parâmetros são opcionais. Se as credenciais não forem especificadas, elas serão obtidas da configuração do ClickHouse. Para obter mais informações, consulte Usando o S3 para armazenamento de dados.
formatO formato do arquivo.
structureEstrutura da tabela. Formato: 'column1_name column1_type, column2_name column2_type, ...'.
compressionO parâmetro é opcional. Valores aceitos: none, gzip/gz, brotli/br, xz/LZMA, zstd/zst. Por padrão, a compressão será detectada automaticamente pela extensão do arquivo.
extra_credentialsO parâmetro é opcional. Usado para passar um role_arn para controle de acesso baseado em função no ClickHouse Cloud. Consulte S3 seguro para ver as etapas de configuração.

Valor retornado

Uma tabela com a estrutura especificada para ler dados da tabela Hudi especificada no S3.

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 é NULL.
  • _time — Horário da última modificação do arquivo. Tipo: Nullable(DateTime). Se o horário for desconhecido, o valor é NULL.
  • _etag — O etag do arquivo. Tipo: LowCardinality(String). Se o etag for desconhecido, o valor é NULL.
Última modificação em 10 de junho de 2026