---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.4
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/scan-query.md
  - https://ydb.tech/docs/ru/reference/ydb-cli/scan-query.md
sourcePath: ru/core/reference/ydb-cli/scan-query.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

<!-- source: ru/reference/ydb-cli/commands/_includes/scan-query.md -->
# Выполнение скан запросов

<!-- source: ru/_includes/scan_query_deprecated_warning.md -->
{% note warning %}

Использование `ScanQuery` не рекомендуется для новых сценариев. Для выполнения запросов используйте стандартные механизмы.

Подробнее см. в разделе [Выполнение запросов](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md).

Исключение — выполнение длительных (более 5 минут) запросов к строчным таблицам. В этом случае мы по-прежнему рекомендуем использовать `ScanQuery`, так как стандартные механизмы выполнения запросов пока не полностью поддерживают этот сценарий.

{% endnote %}
<!-- endsource: ru/_includes/scan_query_deprecated_warning.md -->

Запуск запроса через [Scan Queries](https://ydb.tech/docs/ru/concepts/query_execution/scan_query.md) посредством YDB CLI осуществляется добавлением флага `-t scan` в команду `ydb table query execute`.

Выполните запрос к данным:

```bash
ydb table query execute -t scan \
 --query "SELECT season_id, episode_id, title \
 FROM episodes \
 WHERE series_id = 1 AND season_id > 1 \
 ORDER BY season_id, episode_id \
 LIMIT 3"
```

Где:

* `--query` — текст запроса.

Результат:

```text
┌───────────┬────────────┬──────────────────────────────┐
| season_id | episode_id | title |
├───────────┼────────────┼──────────────────────────────┤
| 2 | 1 | "The Work Outing" |
├───────────┼────────────┼──────────────────────────────┤
| 2 | 2 | "Return of the Golden Child" |
├───────────┼────────────┼──────────────────────────────┤
| 2 | 3 | "Moss and the German" |
└───────────┴────────────┴──────────────────────────────┘
```
<!-- endsource: ru/reference/ydb-cli/commands/_includes/scan-query.md -->