Motor de tabela ArrowFlight

​

Criando uma tabela

CREATE TABLE [IF NOT EXISTS] [db.]table_name (name1 [type1], name2 [type2], ...)
    ENGINE = ArrowFlight('host:port', 'dataset_name' [, 'username', 'password']);

• host:port — Endereço do servidor Arrow Flight remoto. Se a porta for omitida, a porta padrão 8815 será usada. String.
• dataset_name — Identificador do conjunto de dados no servidor Flight (usado como um descritor PATH ou em uma consulta SELECT *, dependendo da configuração arrow_flight_request_descriptor_type). String.
• username — Nome de usuário para autenticação HTTP básica. String.
• password — Senha para autenticação HTTP básica. String.

​

Coleções nomeadas

CREATE TABLE remote_flight_data
    ENGINE = ArrowFlight(named_collection_name);

​

Configurações

• arrow_flight_request_descriptor_type — Controla como o nome do conjunto de dados é enviado ao servidor Flight. Valores possíveis: path (padrão; envia como um descritor PATH) ou command (envia como um descritor CMD com SELECT * FROM <dataset>). Use command em servidores Flight que esperam comandos SQL (por exemplo, Dremio).
• arrow_flight_request_timeout_sec — Tempo limite, em segundos, para uma única requisição Arrow Flight; o padrão é 300. Esse limite se aplica à requisição inteira: no caso de um SELECT, abrange todo o stream de resultados, e não apenas a espera pelo primeiro lote de registros. 0 significa sem tempo limite; nesse caso, um servidor Flight que aceite uma requisição e nunca responda bloqueará a consulta até que a conexão seja encerrada.

​

Exemplo de uso

CREATE TABLE remote_flight_data
(
    id UInt32,
    name String,
    value Float64
) ENGINE = ArrowFlight('127.0.0.1:9005', 'sample_dataset');

SELECT * FROM remote_flight_data ORDER BY id;

┌─id─┬─name────┬─value─┐
│  1 │ foo     │ 42.1  │
│  2 │ bar     │ 13.3  │
│  3 │ baz     │ 77.0  │
└────┴─────────┴───────┘

INSERT INTO remote_flight_data VALUES (4, 'qux', 99.9);

​

Notas

• Se colunas forem especificadas na instrução CREATE TABLE, elas deverão corresponder ao esquema retornado pelo servidor Flight.
• Se as colunas forem omitidas, o esquema será inferido automaticamente do servidor remoto.
• Há suporte tanto para leitura (SELECT) quanto para gravação (INSERT).
• A configuração arrow_flight_request_descriptor_type controla se o nome do conjunto de dados é enviado como um descritor PATH ou como um descritor CMD que encapsula uma consulta SELECT *.

​

Veja também

• função de tabela arrowFlight
• interface do Arrow Flight
• Apache Arrow Flight SQL
• integração do formato Arrow no ClickHouse