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

> Создаёт таблицу по `URL` с указанными `format` и `structure`

# Табличная функция 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>;
};

Функция `url` создаёт таблицу по `URL` с указанными `format` и `structure`.

Функция `url` может использоваться в запросах `SELECT` и `INSERT` для данных в таблицах [URL](/ru/reference/engines/table-engines/special/url).

<div id="syntax">
  ## Синтаксис
</div>

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

<div id="parameters">
  ## Параметры
</div>

| Параметр    | Описание                                                                                                                                                                                     |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `URL`       | Адрес HTTP- или HTTPS-сервера в одинарных кавычках, принимающего запросы `GET` или `POST` (для запросов `SELECT` и `INSERT` соответственно). Тип: [String](/ru/reference/data-types/string). |
| `format`    | [Формат](/ru/reference/formats) данных. Тип: [String](/ru/reference/data-types/string).                                                                                                      |
| `structure` | Структура таблицы в формате `'UserID UInt64, Name String'`. Определяет имена и типы столбцов. Тип: [String](/ru/reference/data-types/string).                                                |
| `headers`   | Заголовки в формате `'headers('key1'='value1', 'key2'='value2')'`. Позволяет задать заголовки для HTTP-запроса.                                                                              |

<div id="returned_value">
  ## Возвращаемое значение
</div>

Таблица в указанном формате и с указанной структурой, содержащая данные из заданного `URL`.

<div id="examples">
  ## Примеры
</div>

Получение первых 3 строк таблицы, содержащей столбцы типа `String` и [UInt32](/ru/reference/data-types/int-uint), с HTTP-сервера, который возвращает данные в формате [CSV](/ru/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;
```

Вставка данных из `URL` в таблицу:

```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">
  ## Глоб-шаблоны в URL
</div>

Шаблоны в `{ }` используются для генерации набора сегментов или для указания адресов аварийного переключения. Поддерживаемые типы шаблонов и примеры см. в описании функции [remote](/ru/reference/functions/table-functions/remote#globs-in-addresses).
Символ `|` внутри шаблонов используется для указания адресов аварийного переключения. Они перебираются в том же порядке, в котором перечислены в шаблоне. Количество сгенерированных адресов ограничено настройкой [glob\_expansion\_max\_elements](/ru/reference/settings/session-settings#glob_expansion_max_elements).

<div id="virtual-columns">
  ## Виртуальные столбцы
</div>

* `_path` — Путь к `URL`. Тип: `LowCardinality(String)`.
* `_file` — Имя ресурса `URL`. Тип: `LowCardinality(String)`.
* `_size` — Размер ресурса в байтах. Тип: `Nullable(UInt64)`. Если размер неизвестен, значение — `NULL`.
* `_time` — Время последнего изменения файла. Тип: `Nullable(DateTime)`. Если время неизвестно, значение — `NULL`.
* `_headers` - Заголовки HTTP-ответа. Тип: `Map(LowCardinality(String), LowCardinality(String))`.

<div id="hive-style-partitioning">
  ## настройка use\_hive\_partitioning
</div>

Если настройка `use_hive_partitioning` имеет значение 1, ClickHouse распознаёт партиционирование в стиле Hive в пути (`/name=value/`) и позволяет использовать столбцы партиций в качестве виртуальных столбцов в запросе. Эти виртуальные столбцы будут иметь те же имена, что и в пути с партициями.

**Пример**

Используйте виртуальный столбец, созданный при партиционировании в стиле 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">
  ## Разрешение относительных URL
</div>

Настройка [url\_base](/ru/reference/settings/session-settings#url_base) позволяет передавать в функцию `url` относительный URL. Когда задан `url_base` и аргумент функции представляет собой относительную ссылку, она разрешается относительно базового URL в соответствии с [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).

Правила разрешения:

* **Относительный путь** (например, `data.csv`): объединяется с путем базового URL — всё после последнего `/` в базовом пути заменяется. Наличие завершающего слеша имеет значение: `https://example.com/dir/` + `data.csv` дает `https://example.com/dir/data.csv`, а `https://example.com/dir` + `data.csv` дает `https://example.com/data.csv`. Сегменты с точками (`./` и `../`) нормализуются.
* **Относительный к хосту** (например, `/test/data.csv`): разрешается с использованием схемы и хоста базового URL.
* **Относительный к схеме** (например, `//other.com/test/data.csv`): разрешается с использованием схемы базового URL.
* **Только запрос** (например, `?x=1`): добавляется к полному базовому пути, заменяя существующие запрос или фрагмент.
* **Только фрагмент** (например, `#frag`): добавляется к базовому URL с сохранением запроса и заменой существующего фрагмента.
* **Пустой**: возвращает базовый URL без фрагмента.
* **Абсолютный URL**: передается без изменений; `url_base` игнорируется.

**Пример**

```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">
  ## Настройки хранилища
</div>

* [engine\_url\_skip\_empty\_files](/ru/reference/settings/session-settings#engine_url_skip_empty_files) - позволяет пропускать пустые файлы при чтении. По умолчанию отключено.
* [enable\_url\_encoding](/ru/reference/settings/session-settings#enable_url_encoding) - позволяет включать и отключать декодирование/кодирование пути в URI. По умолчанию включено.
* [url\_base](/ru/reference/settings/session-settings#url_base) - базовый URL для разрешения относительных URL, передаваемых в функцию `url`.

<div id="permissions">
  ## Разрешения
</div>

Для функции `url` требуется разрешение `CREATE TEMPORARY TABLE`. Поэтому она не будет работать для пользователей с настройкой [readonly](/ru/concepts/features/configuration/settings/permissions-for-queries#readonly) = 1. Требуется значение readonly не ниже 2.

<div id="related">
  ## Связанные материалы
</div>

* [Виртуальные столбцы](/ru/reference/engines/table-engines#table_engines-virtual_columns)