---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/analyst/datasets.md?version=v26.1
  - https://ydb.tech/docs/ru/analyst/datasets.md?version=v26.1
  - href: ru/analyst/datasets/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/analyst/datasets/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Обзор

На этих страницах описаны популярные датасеты, которые вы можете загрузить в YDB для ознакомления с функциональностью базы данных и тестирования различных сценариев использования.

## Предварительные требования

Для загрузки датасетов вам потребуется:

1. Установленный [YDB CLI](https://ydb.tech/docs/ru/reference/ydb-cli/index.md?version=v26.1)
2. [Опционально] Настроенный [профиль подключения](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v26.1) к YDB, чтобы не указывать параметры подключения при каждом вызове

## Общая информация о загрузке данных {#general-info}

YDB поддерживает импорт данных из CSV-файлов с помощью [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v26.1) `ydb import file csv`. Пример запуска команды:

```bash
ydb import file csv --header --null-value "" --path <путь_к_таблице> <файл>.csv
```

Где:

* `--header` означает, что в первой строке файла содержится список имён колонок, а сами данные начинаются со второй строки;
* `--null-value ""` означает, что пустая строка вместо значения в CSV будет интерпретироваться как null-значение при импорте данных из csv-файла в таблицу.

Для импорта данных нужна заранее созданная таблица в YDB. Основной способ создания таблицы - выполнить [YQL-запрос `CREATE TABLE`](https://ydb.tech/docs/ru/yql/reference/syntax/create_table/index.md?version=v26.1). Чтобы не составлять его полностью вручную, можно попробовать выполнить команду импорта из файла, как в любом примере ниже, не создавая перед этим таблицу. В таком случае CLI предложит текст `CREATE TABLE`, который можно будет взять за основу, при необходимости отредактировать и выполнить.

Для импорта данных в YDB таблица должна быть заранее создана. Обычно таблицу создают с помощью [YQL-запроса `CREATE TABLE`](https://ydb.tech/docs/ru/yql/reference/syntax/create_table/index.md?version=v26.1). Однако, вместо того чтобы писать такой запрос вручную, можно запустить команду импорта `ydb import file csv` так же, как показано в примерах импорта в этом разделе. Если таблица отсутствует, CLI автоматически предложит готовый текст запроса `CREATE TABLE`, который можно будет использовать для создания таблицы.

{% note info "Выбор первичного ключа" %}

YDB требует, чтобы у таблицы был первичный ключ. Он значительно ускоряет загрузку и обработку данных, а также позволяет выполнять дедупликацию: строки с одинаковыми значениями в столбцах первичного ключа заменяются друг другом.

Если в импортируемом наборе данных нет подходящих столбцов для первичного ключа, мы добавляем новый столбец с номерами строк и используем его в качестве первичного ключа, так как номер каждой строки уникален в пределах файла.

{% endnote %}

## Особенности и ограничения

При работе с загрузкой CSV-файлов в YDB следует учитывать следующие моменты:

1. **Имена колонок**: Названия колонок не должны содержать пробелы или специальные символы.

2. **Типы данных**:
   - Строки в формате даты/времени с указанием временной зоны (например, "2019-11-01 00:00:00 UTC") будут импортированы как тип Text
   - Тип Bool не поддерживается в качестве типа колонки, используйте Text или Int64

## Доступные датасеты

* [Chess Position Evaluations](https://ydb.tech/docs/ru/analyst/datasets/chess.md?version=v26.1) - оценки шахматных позиций от движка Stockfish
* [Video Game Sales](https://ydb.tech/docs/ru/analyst/datasets/video-games.md?version=v26.1) - данные о продажах видеоигр
* [E-Commerce Behavior Data](https://ydb.tech/docs/ru/analyst/datasets/ecommerce.md?version=v26.1) - данные о поведении пользователей в интернет-магазине
* [COVID-19 Open Research Dataset](https://ydb.tech/docs/ru/analyst/datasets/covid.md?version=v26.1) - открытый набор данных исследований COVID-19
* [Netflix Movies and TV Shows](https://ydb.tech/docs/ru/analyst/datasets/netflix.md?version=v26.1) - данные о фильмах и сериалах на Netflix
* [Animal Crossing New Horizons Catalog](https://ydb.tech/docs/ru/analyst/datasets/animal-crossing.md?version=v26.1) - каталог предметов из игры