Pular para o conteúdo principal
O motor de tabela ArrowFlight permite que o ClickHouse consulte conjuntos de dados remotos por meio do protocolo Apache Arrow Flight. Essa integração permite que o ClickHouse obtenha dados de servidores externos com suporte a Flight no formato colunar Arrow, com alto desempenho.

Criando uma tabela

CREATE TABLE [IF NOT EXISTS] [db.]table_name (name1 [type1], name2 [type2], ...)
    ENGINE = ArrowFlight('host:port', 'dataset_name' [, 'username', 'password']);
Parâmetros do motor
  • host:port — Endereço do servidor Arrow Flight remoto.
  • dataset_name — Identificador do conjunto de dados no servidor Flight.
  • username - Nome de usuário a ser usado com autenticação básica no estilo HTTP.
  • password - Senha a ser usada com autenticação básica no estilo HTTP. Se username e password não forem especificados, isso significa que a autenticação não será usada (isso só funcionará se o servidor Arrow Flight permitir).

Exemplo de uso

Este exemplo mostra como criar uma tabela que lê dados de um servidor remoto do Arrow Flight:
CREATE TABLE remote_flight_data
(
    id UInt32,
    name String,
    value Float64
) ENGINE = ArrowFlight('127.0.0.1:9005', 'sample_dataset');
Consulte os dados remotos como se estivessem em uma tabela local:
SELECT * FROM remote_flight_data ORDER BY id;
┌─id─┬─name────┬─value─┐
│  1 │ foo     │ 42.1  │
│  2 │ bar     │ 13.3  │
│  3 │ baz     │ 77.0  │
└────┴─────────┴───────┘

Notas

  • O esquema definido no ClickHouse deve corresponder ao esquema retornado pelo servidor Flight.
  • Este motor é adequado para consultas federadas, virtualização de dados e desacoplamento entre armazenamento e computação.

Veja também

Última modificação em 10 de junho de 2026