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

> Cria uma tabela a partir de uma `URL`, com `format` e `structure` especificados

# Função de tabela url

export const CloudNotSupportedBadge = () => {
  return <div className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            Not supported in ClickHouse Cloud
        </div>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            Experimental feature. <u><a href="/docs/beta-and-experimental-features#experimental-features">Learn more.</a></u>
        </div>;
};

A função `url` cria uma tabela a partir de uma `URL`, com `format` e `structure` especificados.

A função `url` pode ser usada em consultas `SELECT` e `INSERT` sobre dados em tabelas [URL](/pt-BR/reference/engines/table-engines/special/url).

<div id="syntax">
  ## Sintaxe
</div>

```sql theme={null}
url(URL [,format] [,structure] [,headers])
```

<div id="parameters">
  ## Parâmetros
</div>

| Parâmetro   | Descrição                                                                                                                                                                                                        |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `URL`       | Endereço de servidor HTTP ou HTTPS entre aspas simples, que pode aceitar requisições `GET` ou `POST` (para consultas `SELECT` ou `INSERT`, respectivamente). Tipo: [String](/pt-BR/reference/data-types/string). |
| `format`    | [Format](/pt-BR/reference/formats) dos dados. Tipo: [String](/pt-BR/reference/data-types/string).                                                                                                                |
| `structure` | Estrutura da tabela no format `'UserID UInt64, Name String'`. Determina os nomes e os tipos das colunas. Tipo: [String](/pt-BR/reference/data-types/string).                                                     |
| `headers`   | Cabeçalhos no formato `'headers('key1'='value1', 'key2'='value2')'`. Você pode definir cabeçalhos para a chamada HTTP.                                                                                           |

<div id="returned_value">
  ## Valor retornado
</div>

Uma tabela com o formato e a estrutura especificados, contendo dados da `URL` definida.

<div id="examples">
  ## Exemplos
</div>

Obtendo as 3 primeiras linhas de uma tabela com colunas dos tipos `String` e [UInt32](/pt-BR/reference/data-types/int-uint) a partir de um servidor HTTP que responde no formato [CSV](/pt-BR/reference/formats/CSV/CSV).

```sql theme={null}
SELECT * FROM url('http://127.0.0.1:12345/', CSV, 'column1 String, column2 UInt32', headers('Accept'='text/csv; charset=utf-8')) LIMIT 3;
```

Inserindo dados de uma `URL` em uma tabela:

```sql theme={null}
CREATE TABLE test_table (column1 String, column2 UInt32) ENGINE=Memory;
INSERT INTO FUNCTION url('http://127.0.0.1:8123/?query=INSERT+INTO+test_table+FORMAT+CSV', 'CSV', 'column1 String, column2 UInt32') VALUES ('http interface', 42);
SELECT * FROM test_table;
```

<div id="globs-in-url">
  ## Globs na URL
</div>

Padrões em `{ }` são usados para gerar um conjunto de shards ou para especificar endereços de failover. Para ver os tipos de padrões compatíveis e exemplos, consulte a descrição da função [remote](/pt-BR/reference/functions/table-functions/remote#globs-in-addresses).
O caractere `|` dentro dos padrões é usado para especificar endereços de failover. Eles são percorridos na mesma ordem em que aparecem no padrão. O número de endereços gerados é limitado pela configuração [glob\_expansion\_max\_elements](/pt-BR/reference/settings/session-settings#glob_expansion_max_elements).

<div id="virtual-columns">
  ## Colunas Virtuais
</div>

* `_path` — Caminho até a `URL`. Tipo: `LowCardinality(String)`.
* `_file` — Nome do recurso da `URL`. Tipo: `LowCardinality(String)`.
* `_size` — Tamanho do recurso em bytes. Tipo: `Nullable(UInt64)`. Se o tamanho for desconhecido, o valor é `NULL`.
* `_time` — Data e hora da última modificação do arquivo. Tipo: `Nullable(DateTime)`. Se esse horário for desconhecido, o valor é `NULL`.
* `_headers` - Cabeçalhos da resposta HTTP. Tipo: `Map(LowCardinality(String), LowCardinality(String))`.

<div id="hive-style-partitioning">
  ## configuração use\_hive\_partitioning
</div>

Quando a configuração `use_hive_partitioning` é definida como 1, o ClickHouse detecta o particionamento no estilo Hive no caminho (`/name=value/`) e permite usar colunas de partição como colunas virtuais na consulta. Essas colunas virtuais terão os mesmos nomes do caminho particionado.

**Exemplo**

Use a coluna virtual criada com o particionamento no estilo Hive

```sql theme={null}
SELECT * FROM url('http://data/path/date=*/country=*/code=*/*.parquet') WHERE date > '2020-01-01' AND country = 'Netherlands' AND code = 42;
```

<div id="resolving-relative-urls">
  ## Resolução de URLs relativas
</div>

A configuração [url\_base](/pt-BR/reference/settings/session-settings#url_base) permite passar uma URL relativa para a função `url`. Quando `url_base` está definida e o argumento da função é uma referência relativa, ela é resolvida com base na URL base, de acordo com a [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).

As regras de resolução são:

* **Relativa ao caminho** (por exemplo, `data.csv`): combinada com o caminho da URL base — tudo após a última `/` no caminho base é substituído. A barra no final faz diferença: `https://example.com/dir/` + `data.csv` resulta em `https://example.com/dir/data.csv`, mas `https://example.com/dir` + `data.csv` resulta em `https://example.com/data.csv`. Os segmentos de ponto (`./` e `../`) são normalizados.
* **Relativa ao host** (por exemplo, `/test/data.csv`): resolvida usando o esquema e o host da URL base.
* **Relativa ao esquema** (por exemplo, `//other.com/test/data.csv`): resolvida usando o esquema da URL base.
* **Apenas consulta** (por exemplo, `?x=1`): anexada ao caminho base completo, substituindo qualquer consulta ou fragmento existente.
* **Apenas fragmento** (por exemplo, `#frag`): anexado à URL base, preservando a consulta e substituindo qualquer fragmento existente.
* **Vazia**: retorna a URL base sem fragmento.
* **URL absoluta**: é passada sem alterações; `url_base` é ignorada.

**Exemplo**

```sql theme={null}
SET url_base = 'https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/';
SELECT * FROM url('tests/queries/0_stateless/data_csv/data.csv', CSV) LIMIT 3;
```

<div id="storage-settings">
  ## Configurações de armazenamento
</div>

* [engine\_url\_skip\_empty\_files](/pt-BR/reference/settings/session-settings#engine_url_skip_empty_files) - permite ignorar arquivos vazios durante a leitura. Desativado por padrão.
* [enable\_url\_encoding](/pt-BR/reference/settings/session-settings#enable_url_encoding) - permite ativar/desativar a decodificação/codificação do caminho no URI. Ativado por padrão.
* [url\_base](/pt-BR/reference/settings/session-settings#url_base) - URL base para resolver URLs relativas passadas para a função `url`.

<div id="permissions">
  ## Permissões
</div>

A função `url` requer a permissão `CREATE TEMPORARY TABLE`. Portanto, ela não funciona para usuários com a configuração [readonly](/pt-BR/concepts/features/configuration/settings/permissions-for-queries#readonly) = 1. No mínimo, é necessário readonly = 2.

<div id="related">
  ## Relacionados
</div>

* [Colunas virtuais](/pt-BR/reference/engines/table-engines#table_engines-virtual_columns)