---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ytsaurus.tech/docs/en/yql/syntax/use.md
  - https://ytsaurus.tech/docs/ru/yql/syntax/use.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ytsaurus.tech/docs/ru/llms.txt

# USE

Указать «базу данных». Как правило, в её роли выступает один из кластеров YTsaurus. Это указание будет использоваться по умолчанию для поиска таблиц в тех случаях, где база данных не указана явно.

Если в запросе не используется `USE`, то кластер следует указывать в начале пути к таблице в формате ``` cluster.`path/to/table` ```, например ``` cluster.`home/yql/test` ```. Backticks используются для автоматического экранирования спецсимволов, в данном случае слешей.

Обычно имя кластера указывается непосредственно, но есть возможность указать его в виде выражения. В этом случае для `USE` должна использоваться запись ```USE yt:$cluster_name```, где `$cluster_name` — [именованное выражение](https://ytsaurus.tech/docs/ru/yql/syntax/expressions.md#named-nodes) типа `String`.

Либо можно указывать кластер прямо в начале пути к таблице в формате ``` yt:$cluster_name.`path/to/table` ```.

Сам `USE` при этом можно использовать внутри [действий](https://ytsaurus.tech/docs/ru/yql/syntax/action.md) или [шаблонов подзапросов](https://ytsaurus.tech/docs/ru/yql/syntax/subquery.md). Значение текущего кластера наследуется на объявления вложенных действий или подзапросов. Область влияния `USE` прекращается по окончании действия или шаблона подзапроса, в котором оно объявлено.

#### Пример

```yql
USE <cluster-name>;
```

{% note info "Примечание" %}

`USE` **не** гарантирует, что запрос обязательно будет выполнен именно на указанном кластере. Запрос может быть выполнен на другом кластере, если в нём не используются входные данные (например, `USE foo; SELECT 2 + 2;` ) или если указан полный путь к таблице на другом кластере (например, ```USE foo; SELECT * FROM bar.`path/to/table`;```).

{% endnote %}