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

> O motor de banco de dados URL expõe dados endereçados por URL como tabelas.

# URL

O motor de banco de dados `URL` trata nomes de tabelas como URLs e expõe os dados dessas URLs como tabelas. Ele utiliza a função de tabela [`url`](/pt-BR/reference/functions/table-functions/url), que encaminha cada URL ao backend apropriado, como `file`, `s3`, HDFS, Azure Blob Storage ou HTTP.

## Criando um banco de dados

```sql theme={null}
CREATE DATABASE web_data
ENGINE = URL([base_url]);
```

Quando `base_url` é especificado, os nomes de tabela relativos são resolvidos em relação a ele. Sem uma base URL, todo nome de tabela deve ser uma URL completa.

## Usage

```sql theme={null}
CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;
```

O banco de dados não contém definições de tabelas. Cada tabela é resolvida a partir de sua URL no momento do uso, de modo que seu schema é inferido dos dados atuais. Os nomes de tabelas também podem usar uma URL completa, por exemplo `web_data.`s3://bucket/data/events.parquet\`\`.

## Access control

Criar esse banco de dados exige grants de source `READ` e `WRITE` em `URL`, independentemente de [`table_engines_require_grant`](/pt-BR/reference/settings/server-settings/settings/other#table_engines_require_grant). Ler uma tabela também exige um grant de source `READ` para o backend resolvido; a gravação exige o grant `WRITE` correspondente. Por exemplo:

```sql theme={null}
GRANT READ, WRITE ON URL TO user_name;
GRANT READ, WRITE ON S3 TO user_name;
```

Para um banco de dados com base URL `file://`, o usuário precisa do privilégio `READ ON FILE`. No servidor ClickHouse, os arquivos locais também ficam restritos ao [`user_files_path`](/pt-BR/reference/settings/server-settings/settings#user_files_path).

Consulte os [privilégios `SOURCES`](/pt-BR/reference/statements/grant#sources) para obter detalhes sobre versão e compatibilidade.

## Veja também

* [Função de tabela `url`](/pt-BR/reference/functions/table-functions/url)
* [Motor de banco de dados Filesystem](/pt-BR/reference/engines/database-engines/filesystem)
* [Motor de banco de dados S3](/pt-BR/reference/engines/database-engines/s3)