> ## 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.

> Движок баз данных URL представляет данные, адресуемые по URL, в виде таблиц.

# URL

Движок базы данных `URL` трактует имена таблиц как URL и предоставляет данные по этим URL в виде таблиц. Он использует табличную функцию [`url`](/ru/reference/functions/table-functions/url), которая направляет каждый URL соответствующему backend-соединению, например `file`, `s3`, HDFS, Azure Blob Storage или HTTP.

## Создание базы данных

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

Если указан `base_url`, относительные имена таблиц разрешаются относительно него. Без базового URL каждое имя таблицы должно быть полным URL.

## Использование

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

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

База данных не хранит определений таблиц. Каждая таблица разрешается по своему URL в момент использования, поэтому её схема выводится из текущих данных. В именах таблиц также можно указывать полный URL, например `web_data.`s3://bucket/data/events.parquet\`\`.

## Управление доступом

Для создания такой базы данных требуются source-привилегии `READ` и `WRITE` на `URL`, независимо от значения [`table_engines_require_grant`](/ru/reference/settings/server-settings/settings/other#table_engines_require_grant). Для чтения таблицы также необходима source-привилегия `READ` на разрешённое backend-соединение, а для записи — соответствующая привилегия `WRITE`. Например:

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

Для базы данных с базовым URL `file://` пользователю требуется привилегия `READ ON FILE`. На ClickHouse server доступ к локальным файлам дополнительно ограничен каталогом [`user_files_path`](/ru/reference/settings/server-settings/settings#user_files_path).

Подробности о версиях и совместимости см. в разделе [привилегии `SOURCES`](/ru/reference/statements/grant#sources).

## См. также

* [Табличная функция `url`](/ru/reference/functions/table-functions/url)
* [Движок базы данных Filesystem](/ru/reference/engines/database-engines/filesystem)
* [Движок базы данных S3](/ru/reference/engines/database-engines/s3)