Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ML Services
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Managed Service for YDB
  • Начало работы
  • Управление доступом
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Вопросы и ответы
  • Публичные материалы
  • Обучающие курсы

В этой статье:

  • Перед началом работы
  • Создайте базу данных
  • Создайте бессерверную БД
  • Создайте БД на выделенных серверах
  • Выполните запрос к базе данных
  • Что дальше

Как начать работать с Managed Service for YDB

Статья создана
Yandex Cloud
Улучшена
Обновлена 21 апреля 2025 г.
  • Перед началом работы
  • Создайте базу данных
    • Создайте бессерверную БД
    • Создайте БД на выделенных серверах
  • Выполните запрос к базе данных
  • Что дальше

В этой инструкции вы создадите базу данных YDB в Yandex Cloud и выполните простой запрос к ней с помощью консоли управления Yandex Cloud или инструментов командной строки.

Для работы с БД в Yandex Managed Service for YDB также доступны:

  • YDB SDK.
  • YDB CLI.
  • AWS SDK.
  • AWS CLI.

Перед началом работыПеред началом работы

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь, если вы еще не зарегистрированы.

  2. Если у вас еще нет каталога, создайте его:

    1. В консоли управления в списке слева выберите нужное облако.

    2. Справа сверху нажмите кнопку Создать каталог.

    3. Введите имя каталога. Требования к имени:

      • длина — от 2 до 63 символов;
      • может содержать строчные буквы латинского алфавита, цифры и дефисы;
      • первый символ — буква, последний — не дефис.
    4. (Опционально) Введите описание каталога.

    5. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

    6. Нажмите кнопку Создать.

Создайте базу данныхСоздайте базу данных

Вы можете создать БД в бессерверной (Serverless) конфигурации или с выделенными серверами (Dedicated). Подробнее о различиях в конфигурациях читайте в разделе Serverless и Dedicated режимы работы. Тип БД нельзя изменить после создания.

Примечание

Для работы в режиме совместимости с Amazon DynamoDB используйте бессерверную (Serverless) конфигурацию БД.

Создайте бессерверную БДСоздайте бессерверную БД

Консоль управления
Yandex Cloud CLI
  1. В консоли управления выберите каталог, в котором будет создана БД.

  2. В списке сервисов выберите Managed Service for YDB.

  3. Нажмите кнопку Создать базу данных.

  4. Введите Имя БД. Требования к имени:

    • длина — от 2 до 63 символов;
    • может содержать строчные буквы латинского алфавита, цифры и дефисы;
    • первый символ — буква, последний — не дефис.
  5. В блоке Тип базы данных выберите опцию Serverless.

    Вы можете оставить параметры по умолчанию для создаваемой БД и изменить их позже. Подробнее о параметрах БД читайте в разделе Создать Serverless базу данных.

  6. Нажмите кнопку Создать базу данных.

Дождитесь запуска БД. В процессе создания БД будет иметь статус Provisioning, а когда станет готова к использованию — статус сменится на Running.

  1. Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  2. Создайте базу данных:

    yc ydb database create <имя_БД> --serverless
    

    Где <имя_БД> — имя вашей базы данных.

    Результат:

    done (6s)
    id: etn95g8jk8g0********
    folder_id: b1g7gvsi89m3********
    created_at: "2022-05-30T07:26:44Z"
    name: test
    status: PROVISIONING
    endpoint: grpcs://ydb.serverless.yandexcloud.net:2135/?database=/ru-central1/b1gia87mbaom********/etn95g8jk8g0********
    serverless_database:
      storage_size_limit: "53687091200"
    location_id: ru-central1
    backup_config:
      backup_settings:
      - name: daily
        backup_schedule:
          daily_backup_schedule:
            execute_time:
              hours: 17
        backup_time_to_live: 172800s
        type: SYSTEM
    document_api_endpoint: https://docapi.serverless.yandexcloud.net/ru-central1/b1gia87mbaom********/etn95g8jk8g0********
    monitoring_config: {}
    

    Будет создана база с параметрами по умолчанию. Вы сможете изменить параметры позже. Подробнее о параметрах БД читайте в разделе Создать Serverless базу данных.

  3. Проверьте статус созданной БД:

    yc ydb database get <имя_БД>
    

    Где <имя_БД> — имя созданной БД.

    В процессе создания БД будет иметь статус PROVISIONING, а когда станет готова к использованию — статус сменится на RUNNING.

Создайте БД на выделенных серверахСоздайте БД на выделенных серверах

Консоль управления
Yandex Cloud CLI
  1. В консоли управления выберите каталог, в котором будет создана БД.

  2. В списке сервисов выберите Managed Service for YDB.

  3. Нажмите кнопку Создать базу данных.

  4. Введите Имя БД. Требования к имени:

    • длина — от 2 до 63 символов;
    • может содержать строчные буквы латинского алфавита, цифры и дефисы;
    • первый символ — буква, последний — не дефис.
  5. В блоке Тип базы данных выберите опцию Dedicated.

  6. В блоке Вычислительные ресурсы выберите тип и количество вычислительных ресурсов.

  7. В блоке Группы хранения выберите тип диска и количество групп хранения, определяющее суммарный объем хранилища.

  8. В блоке Сеть настройте параметры сети:

    1. (Опционально) В поле Публичные IP-адреса выберите опцию Присвоить, если вы планируете отправлять запросы к БД не только из сети Yandex Cloud, но и через интернет.

      Важно

      Потребление исходящего интернет-трафика для баз Managed Service for YDB с внешними IP-адресами учитывается по действующим тарифам.

      Начисления за исходящий интернет-трафик, возникшие в результате использования Managed Service for YDB, будут компенсированы грантами.

    2. Выберите существующую сеть из списка Облачная сеть или создайте новую:

      1. Нажмите кнопку Создать.
      2. В открывшемся окне укажите Имя новой сети.
      3. (Опционально) Выберите опцию Создать подсети. Подсети в каждой зоне доступности будут созданы автоматически.
      4. Нажмите кнопку Создать сеть.
    3. В блоке Подсети для каждой зоны доступности выберите подсеть или создайте новую:

      1. Нажмите кнопку Создать.
      2. В открывшемся окне укажите Имя новой подсети.
      3. (Опционально) Введите Описание подсети.
      4. Выберите из списка Зона доступности нужную зону.
      5. Задайте адрес подсети в формате CIDR.
      6. Нажмите кнопку Создать подсеть.

    Настойки блока Сеть нельзя изменить после создания БД.

  9. Нажмите кнопку Создать базу данных.

    Дождитесь запуска БД. В процессе создания БД будет иметь статус Provisioning, а когда станет готова к использованию — статус сменится на Running.

  1. Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  2. При необходимости создайте облачную сеть и подсети для каждой зоны доступности.

  3. Создайте базу данных:

    yc ydb database create <имя_БД> \
      --dedicated \
      --resource-preset <конфигурация> \
      --storage type=<тип_носителя>,groups=<количество_групп_хранения> \
      --public-ip \
      --network-name default\
      --async
    

    Где:

    • --resource-preset STR — конфигурация вычислительных ресурсов узла. Возможные значения перечислены в колонке Имя конфигурации в таблице раздела База данных на выделенных ресурсах (Dedicated).
    • --storage STR — тип носителя и количество групп хранения в формате type=<тип_носителя>,groups=<количество_групп_хранения>. Для типа ssd одна группа хранения вмещает 100 ГБ данных.
    • --public-ip — флаг назначения публичных IP-адресов. Без этого флага вы не сможете подключиться к создаваемой базе данных из интернета.
    • --network-name STR — имя облачной сети, в которой будет создана база данных. Может быть указана сеть default.
    • --async — флаг асинхронного создания БД.

    Подробнее о параметрах БД читайте в разделе Создать Serverless базу данных.

    Результат:

    done (7m18s)
    id: etnk1u65e4sh********
    folder_id: b1g7gvsi89m3********
    created_at: "2022-05-31T10:10:12Z"
    name: test-ded
    status: PROVISIONING
    endpoint: grpcs://lb.etnk1u65e4sh********.ydb.mdb.yandexcloud.net:2135/?database=/ru-central1/b1gia87mbaom********/etnk1u65e4sh********
    resource_preset_id: medium
    storage_config:
      storage_options:
      - storage_type_id: ssd
        group_count: "1"
      storage_size_limit: "107374182400"
    scale_policy:
      fixed_scale:
        size: "1"
    network_id: enpqkm0od2bu********
    subnet_ids:
    - b0cmespgm8o3********
    - e2lif378n1pg********
    - e9b72lv142k4********
    dedicated_database:
      resource_preset_id: medium
      storage_config:
        storage_options:
        - storage_type_id: ssd
          group_count: "1"
        storage_size_limit: "107374182400"
      scale_policy:
        fixed_scale:
          size: "1"
      network_id: enpqkm0od2bu********
      subnet_ids:
      - b0cmespgm8o3********
      - e2lif378n1pg********
      - e9b72lv142k4********
      assign_public_ips: true
    assign_public_ips: true
    location_id: ru-central1
    backup_config:
      backup_settings:
      - name: daily
        backup_schedule:
          daily_backup_schedule:
            execute_time:
              hours: 17
        backup_time_to_live: 172800s
        type: SYSTEM
    monitoring_config: {}
    
  4. Проверьте статус созданной БД:

    yc ydb database get <имя_БД>
    

    Где <имя_БД> — имя созданной БД.

    В процессе создания БД будет иметь статус PROVISIONING, а когда станет готова к использованию — статус сменится на RUNNING.

Выполните запрос к базе данныхВыполните запрос к базе данных

Консоль управления
YDB CLI
  1. В консоли управления выберите каталог, в котором находится нужная БД.

  2. В списке сервисов выберите Managed Service for YDB.

  3. Выберите созданную ранее БД.

  4. Перейдите на вкладку Навигация.

  5. Нажмите кнопку Новый SQL-запрос и введите текст запроса:

    SELECT 1;
    
  6. Нажмите кнопку Выполнить.

    Ниже будет отображен результат выполнения запроса:

    # column0
    0 1
    
  1. Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  2. Чтобы управлять вашими БД из командной строки, установите YDB CLI.

  3. Для аутентификации YDB CLI в Yandex Cloud получите IAM-токен и экспортируйте его в переменную окружения:

    export IAM_TOKEN=`yc iam create-token`
    
  4. Получите эндпоинт и путь БД:

    yc ydb database get ydb-prod
    

    Результат:

    ...
    endpoint: grpcs://ydb.serverless.yandexcloud.net:2135/?database=/ru-central1/b1gia87mbaom********/etnudu2n9ri3********
    ...
    

    Здесь часть строки grpcs://ydb.serverless.yandexcloud.net:2135 содержит эндпоинт, а /ru-central1/b1gia87mbaom********/etnudu2n9ri3******** — путь БД.

  5. Выполните запрос к созданной ранее БД, используя полученные значения эндпоинта и пути БД:

    ydb \
      --endpoint grpcs://ydb.serverless.yandexcloud.net:2135 \
      --database /ru-central1/b1gia87mbaom********/etnudu2n9ri3******** \
      yql -s "SELECT 1;"
    

    Результат:

    ┌─────────┐
    | column0 |
    ├─────────┤
    | 1       |
    └─────────┘
    

Что дальшеЧто дальше

  • Узнайте подробнее о работе с БД.
  • Изучите концепции сервиса.
  • Ознакомьтесь с языком запросов YQL.

Была ли статья полезна?

Следующая
Обзор
Проект Яндекса
© 2025 ООО «Яндекс.Облако»