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

<!-- source: ru/reference/ydb-cli/commands/_includes/readtable.md -->
# Потоковое чтение строковой таблицы

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

<!-- source: ru/_includes/not_allow_for_olap_text.md -->
Поддерживается только для [строковых](https://ydb.tech/docs/ru/concepts/datamodel/table.md#row-oriented-tables) таблиц. Поддержка функциональности для [колоночных](https://ydb.tech/docs/ru/concepts/datamodel/table.md#column-oriented-tables) таблиц находится в разработке.
<!-- endsource: ru/_includes/not_allow_for_olap_text.md -->

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

Чтобы прочитать снапшот таблицы целиком, используйте подкоманду `read`. Данные передаются в виде стрима, что позволяет прочитать таблицу произвольного размера.

Прочитайте данные:

```bash
ydb table read episodes \
  --ordered \
  --limit 5 \
  --columns series_id,season_id,episode_id,title
```

Где :

* `--ordered` — упорядочить читаемые записи по ключу.
* `--limit` — ограничить количество читаемых записей.
* `--columns` — колонки, значения которых следует читать (по умолчанию читаются все колонки) в формате CSV.

Результат:

```text
┌───────────┬───────────┬────────────┬───────────────────────────────┐
| series_id | season_id | episode_id | title                         |
├───────────┼───────────┼────────────┼───────────────────────────────┤
| 1         | 1         | 1          | "Yesterday's Jam"             |
├───────────┼───────────┼────────────┼───────────────────────────────┤
| 1         | 1         | 2          | "Calamity Jen"                |
├───────────┼───────────┼────────────┼───────────────────────────────┤
| 1         | 1         | 3          | "Fifty-Fifty"                 |
├───────────┼───────────┼────────────┼───────────────────────────────┤
| 1         | 1         | 4          | "The Red Door"                |
├───────────┼───────────┼────────────┼───────────────────────────────┤
| 1         | 1         | 5          | "The Haunting of Bill Crouse" |
└───────────┴───────────┴────────────┴───────────────────────────────┘
```

Если вам нужно получить только количество прочитанных записей, используйте параметр `--count-only`:

```bash
ydb table read episodes \
  --columns series_id \
  --count-only
```

Результат:

```text
70
```
<!-- endsource: ru/reference/ydb-cli/commands/_includes/readtable.md -->