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

<!-- source: en/reference/ydb-cli/commands/_includes/readtable.md -->
# Streaming table reads

To read an entire table snapshot, use the `read` subcommand. Data is transferred as a stream, which enables you to read any size table.

Read data:

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

Where:

* `--ordered`: Order read entries by key.
* `--limit`: Limit the number of entries to read.
* `--columns`: Columns whose values should be read (all by default) in CSV format.

Result:

```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" |
└───────────┴───────────┴────────────┴───────────────────────────────┘
```

To only get the number of read entries, use the `--count-only` parameter:

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

Result:

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