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

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

  • Создать таблицу
  • Строковая таблица
  • Документная таблица
  • Изменить структуру таблицы
  • Строковая таблица
  • Документная таблица
  • Удалить таблицу
  • Строковая таблица
  • Документная таблица
  • Создать и удалить директории
  1. Пошаговые инструкции
  2. Управление таблицами и директориями

Управление таблицами и директориями

Статья создана
Yandex Cloud
Улучшена
Max Z.
Обновлена 21 октября 2024 г.
  • Создать таблицу
    • Строковая таблица
    • Документная таблица
  • Изменить структуру таблицы
    • Строковая таблица
    • Документная таблица
  • Удалить таблицу
    • Строковая таблица
    • Документная таблица
  • Создать и удалить директории

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

Доступны следующие операции:

  • Создать таблицу.
  • Изменить структуру таблицы.
  • Удалить таблицу.
  • Создать и удалить директории.

Для работы с таблицами и директориями понадобится заранее созданная база данных.

Создать таблицуСоздать таблицу

Вы можете создать строковую или документную таблицы.

Строковая таблицаСтроковая таблица

Консоль управления
Terraform
  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно создать таблицу.
  3. Перейдите на вкладку Навигация.
  4. Выберите Создать → Таблицу в правой части страницы.
  5. Настройте параметры таблицы:
    • Имя таблицы. Должно быть уникальным в рамках базы данных.
    • Тип таблицы — Строковая таблица.
  6. Добавьте колонки:
    • Имя колонки. Должно быть уникальным в рамках таблицы.
    • Тип данных колонки. Независимо от типа данных, каждая колонка может содержать значение NULL.
    • Первичный ключ. Укажите, входит ли колонка в состав первичного ключа. По первичному ключу автоматически строятся первичные индексы.
  7. При необходимости настройте вторичные индексы:
    • Имя вторичного индекса. Должно быть уникальным в рамках таблицы.
    • Ключ — одна или несколько колонок, которые образуют ключ для построения вторичного индекса.
  8. Настройте политику партиционирования:
    • Нет — таблица не партиционируется.
    • Равномерно — весь диапазон значений ключевой колонки типа Uint32 или Uint64 (от 0 до максимального значения) разбивается на интервалы одинаковой длины. При использовании такой политики задайте число интервалов в поле Количество.
    • Явно — позволяет явно указать значения ключей, которые будут выступать границами для первоначального разбиения таблицы на партиции. Чтобы добавить очередное граничное значение, нажмите кнопку Добавить ключ-границу шарда.
  9. Настройте автопартицирование:
    • По размеру — если включено, то партиция разделяется на две при достижении определенного размера данных.
    • По нагрузке — если включено, то партиция разделяется на две если в течение некоторого промежутка времени испытывает высокую нагрузку (потребляет много процессорного времени).
  10. Задайте расширенные настройки таблицы:
    • Автопартицирование по размеру MB — пороговое значение размера данных, при котором срабатывает автопартицирование по размеру.
    • Минимальное количество партиций — количество партиций в таблице, ниже которого не происходит слияние партиций по размеру или нагрузке.
    • Максимальное количество партиций — количество партиций в таблице, выше которого не происходит разбиение по размеру или нагрузке.
    • Фильтр Блума для первичного ключа — если включено, использует Блум-фильтр для поиска по ключу. В некоторых случаях позволяет ускорить чтение по ключу.
  11. Нажмите кнопку Создать таблицу.

Для создания строковых таблиц также можно воспользоваться командой CREATE TABLE.

О том, как создать строковую таблицу с помощью Terraform, можно узнать из статьи Создание строковых таблиц в базе данных.

Документная таблицаДокументная таблица

Консоль управления
Terraform

Примечание

Документные таблицы доступны только в бессерверном режиме работы Managed Service for YDB.

  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно создать таблицу.
  3. Выберите Создать → Таблицу в правой части страницы.
  4. Настройте параметры таблицы:
    • Имя таблицы. Должно быть уникальным в рамках базы данных.
    • Тип таблицы — Документная таблица.
  5. Добавьте колонки:
    • Имя колонки. Должно быть уникальным в рамках таблицы.
    • Тип данных колонки. Независимо от типа данных, каждая колонка может содержать значение NULL.
    • Ключ партицирования — простой первичный ключ, который состоит из одного атрибута. YDB использует значение ключа партицирования в качестве входных данных для внутренней функции хеширования. Результат вычисления хеш-функции определяет партицию, на которой элемент будет храниться.
    • Ключ сортировки. Первичный ключ может быть составным и состоять из ключа партицирования и ключа сортировки. Все элементы с одинаковым ключом партицирования будут храниться вместе, отсортированные по значению ключа сортировки. Если в документной таблице задан ключ партицирования и ключ сортировки, два элемента могут содержать одинаковое значение ключа партицирования, но должны содержать различные значения ключа сортировки.
  6. Нажмите кнопку Создать таблицу.

О том, как создать документную таблицу с помощью Terraform, можно узнать из статьи Создание документных таблиц в базе данных.

Изменить структуру таблицыИзменить структуру таблицы

Строковая таблицаСтроковая таблица

Консоль управления
Terraform

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

  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно изменить таблицу.
  3. Найдите таблицу в списке и выберите → Изменить.
  4. Добавьте новые колонки в таблицу и укажите их параметры:
    • Имя колонки. Должно быть уникальным в рамках таблицы.
    • Тип данных колонки. Независимо от типа данных, каждая колонка может содержать значение NULL.
  5. Чтобы удалить неключевые колонки из таблицы, нажмите на значок в нужной строке. Удалить колонки, которые образуют первичный ключ, невозможно.
  6. Настройте автопартицирование:
    • По размеру — если включено, то партиция разделяется на две при достижении определенного размера данных.
    • По нагрузке — если включено, то партиция разделяется на две если в течение некоторого промежутка времени испытывает высокую нагрузку (потребляет много процессорного времени).
  7. Задайте расширенные настройки таблицы:
    • Автопартицирование по размеру MB — пороговое значение размера данных, при котором срабатывает автопартицирование по размеру.
    • Минимальное количество партиций — количество партиций в таблице, ниже которого не происходит слияние партиций по размеру или нагрузке.
    • Максимальное количество партиций — количество партиций в таблице, выше которого не происходит разбиение по размеру или нагрузке.
    • Фильтр Блума для первичного ключа — если включено, использует Блум-фильтр для поиска по ключу. В некоторых случаях позволяет ускорить чтение по ключу.
  8. Нажмите кнопку Изменить таблицу.

Сущности таблицы, которые можно изменять с помощью Terraform описаны в статье Создание строковых таблиц в базе данных.

Документная таблицаДокументная таблица

Консоль управления
Terraform

Примечание

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

  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно изменить таблицу.
  3. Найдите таблицу в списке и кликнете по ней.
  4. Нажмите кнопку Добавить строку.
  5. Введите желаемые значения для перечисленных в форме колонок и нажмите кнопку Добавить.

Сущности таблицы, которые можно изменять с помощью Terraform описаны в статье Создание документных таблиц в базе данных.

Для изменения строковых таблиц также предназначена команда ALTER TABLE.

Удалить таблицуУдалить таблицу

Строковая таблицаСтроковая таблица

Консоль управления
Terraform
  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно удалить таблицу.
  3. Найдите таблицу в списке и выберите → Удалить.
  4. Подтвердите удаление.

Для удаления строковой таблицы удалите ресурс yandex_ydb_table.

Документная таблицаДокументная таблица

Консоль управления
Terraform
  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Перейдите базу данных, в которой нужно удалить документную таблицу.
  3. Выберите документную таблицу из списка таблиц, нажмите → Удалить.
  4. Подтвердите удаление.

Для удаления документной таблицы удалите ресурс aws_dynamodb_table.

Для удаления строковых таблиц также предназначена команда DROP TABLE.

Создать и удалить директорииСоздать и удалить директории

Консоль управления
  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for YDB.
  2. Выберите базу данных, в которой нужно создать директорию.
  3. Выберите Создать → Директорию в правой части страницы.
  4. Введите имя директории и нажмите кнопку Создать директорию.

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

Предыдущая
Миграция базы данных в другую зону доступности
Следующая
Чтение и запись данных
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»