> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Permite ler e gravar dados expostos por meio de um servidor Apache Arrow Flight.

# arrowFlight

Permite ler e gravar dados expostos por meio de um servidor [Apache Arrow Flight](/pt-BR/concepts/features/interfaces/arrowflight).

**Sintaxe**

```sql theme={null}
arrowFlight('host:port', 'dataset_name' [, 'username', 'password'])
```

**Argumentos**

* `host:port` — Endereço do servidor Arrow Flight. Se a porta for omitida, será usada a porta padrão `8815`. [String](/pt-BR/reference/data-types/string).
* `dataset_name` — Nome do conjunto de dados ou descritor disponível no servidor Arrow Flight. [String](/pt-BR/reference/data-types/string).
* `username` — Nome de usuário para autenticação HTTP básica. [String](/pt-BR/reference/data-types/string).
* `password` — Senha para autenticação HTTP básica. [String](/pt-BR/reference/data-types/string).

Se `username` e `password` não forem especificados, a autenticação não será usada (isso funciona apenas se o servidor Arrow Flight permitir acesso sem autenticação).

A função também oferece suporte a [coleções nomeadas](/pt-BR/concepts/features/configuration/server-config/named-collections) — consulte o [motor de tabela ArrowFlight](/pt-BR/reference/engines/table-engines/integrations/arrowflight#named-collections) para obter a lista de parâmetros compatíveis.

**Valor retornado**

Um objeto de tabela que representa o conjunto de dados remoto. O esquema é inferido do servidor Arrow Flight.

**Configurações**

* `arrow_flight_request_descriptor_type` — Controla como o nome do conjunto de dados é enviado ao servidor Flight. Valores: `path` (padrão) ou `command`. Consulte o [motor de tabela ArrowFlight](/pt-BR/reference/engines/table-engines/integrations/arrowflight#settings) para mais detalhes.

**Exemplos**

Leitura de um servidor Arrow Flight remoto:

```sql title="Query" theme={null}
SELECT * FROM arrowFlight('127.0.0.1:9005', 'sample_dataset') ORDER BY id;
```

```text title="Response" theme={null}
┌─id─┬─name────┬─value─┐
│  1 │ foo     │ 42.1  │
│  2 │ bar     │ 13.3  │
│  3 │ baz     │ 77.0  │
└────┴─────────┴───────┘
```

Inserindo dados em um servidor remoto do Arrow Flight:

```sql theme={null}
INSERT INTO FUNCTION arrowFlight('127.0.0.1:9005', 'sample_dataset') VALUES (4, 'qux', 99.9);
```

Usando uma coleção nomeada:

```sql theme={null}
SELECT * FROM arrowFlight(named_collection_name);
```

**Veja também**

* [Motor de tabela ArrowFlight](/pt-BR/reference/engines/table-engines/integrations/arrowflight)
* [Interface Arrow Flight](/pt-BR/concepts/features/interfaces/arrowflight)
* [Especificação SQL do Apache Arrow Flight](https://arrow.apache.org/docs/format/FlightSql.html)