DynamoDB предлагает широкий набор мощных API-инструментов для манипулирования таблицами, чтения и модификации данных.
Amazon рекомендует использовать AWS SDK (например, Java SDK) вместо вызова низкоуровневых API. Библиотеки делают ненужным взаимодействие с низкоуровневыми API. Библиотеки упрощают общие задачи, такие как аутентификация, сериализация и соединения.
Управлять таблицами
DynamoDB предлагает пять низкоуровневых действий для Table Management —
-
CreateTable — это порождает таблицу и включает пропускную способность, установленную пользователем. Требуется установить первичный ключ, будь то составной или простой. Это также позволяет один или несколько вторичных индексов.
-
ListTables — предоставляет список всех таблиц в учетной записи текущего пользователя AWS и привязан к их конечной точке.
-
UpdateTable — изменяет пропускную способность и пропускную способность глобального вторичного индекса.
-
DescribeTable — предоставляет метаданные таблицы; например, состояние, размер и индексы.
-
DeleteTable — это просто стирает таблицу и ее индексы.
CreateTable — это порождает таблицу и включает пропускную способность, установленную пользователем. Требуется установить первичный ключ, будь то составной или простой. Это также позволяет один или несколько вторичных индексов.
ListTables — предоставляет список всех таблиц в учетной записи текущего пользователя AWS и привязан к их конечной точке.
UpdateTable — изменяет пропускную способность и пропускную способность глобального вторичного индекса.
DescribeTable — предоставляет метаданные таблицы; например, состояние, размер и индексы.
DeleteTable — это просто стирает таблицу и ее индексы.
Читать данные
DynamoDB предлагает четыре низкоуровневых действия для чтения данных —
-
GetItem — принимает первичный ключ и возвращает атрибуты связанного элемента. Он допускает изменения в настройках по умолчанию, которые в конечном итоге соответствуют настройкам чтения.
-
BatchGetItem — выполняет несколько запросов GetItem для нескольких элементов через первичные ключи с возможностью выбора одной или нескольких таблиц. Возвращает не более 100 предметов и должно оставаться менее 16 МБ. Это позволяет в конечном итоге согласованные и строго согласованные чтения.
-
Сканирование — считывает все элементы таблицы и выдает в итоге согласованный набор результатов. Вы можете фильтровать результаты по условиям. Он избегает использования индекса и сканирует всю таблицу, поэтому не используйте его для запросов, требующих предсказуемости.
-
Запрос — возвращает один или несколько элементов таблицы или элементов вторичного индекса. Он использует указанное значение для ключа раздела и позволяет использовать операторы сравнения для сужения области действия. Он включает поддержку обоих типов согласованности, и каждый ответ соответствует предельному размеру в 1 МБ.
GetItem — принимает первичный ключ и возвращает атрибуты связанного элемента. Он допускает изменения в настройках по умолчанию, которые в конечном итоге соответствуют настройкам чтения.
BatchGetItem — выполняет несколько запросов GetItem для нескольких элементов через первичные ключи с возможностью выбора одной или нескольких таблиц. Возвращает не более 100 предметов и должно оставаться менее 16 МБ. Это позволяет в конечном итоге согласованные и строго согласованные чтения.
Сканирование — считывает все элементы таблицы и выдает в итоге согласованный набор результатов. Вы можете фильтровать результаты по условиям. Он избегает использования индекса и сканирует всю таблицу, поэтому не используйте его для запросов, требующих предсказуемости.
Запрос — возвращает один или несколько элементов таблицы или элементов вторичного индекса. Он использует указанное значение для ключа раздела и позволяет использовать операторы сравнения для сужения области действия. Он включает поддержку обоих типов согласованности, и каждый ответ соответствует предельному размеру в 1 МБ.
Изменить данные
DynamoDB предлагает четыре низкоуровневых действия для модификации данных —
PutItem — создает новый элемент или заменяет существующие. При обнаружении идентичных первичных ключей по умолчанию он заменяет элемент. Условные операторы позволяют работать по умолчанию и заменять элементы только при определенных условиях.
BatchWriteItem — выполняет несколько запросов PutItem и DeleteItem, а также несколько таблиц. Если один запрос не выполняется, он не влияет на всю операцию. Его кепка вмещает 25 предметов размером 16 МБ.
UpdateItem — изменяет существующие атрибуты элемента и разрешает использование условных операторов для выполнения обновлений только при определенных условиях.
DeleteItem — использует первичный ключ для удаления элемента, а также позволяет использовать условные операторы для указания условий для удаления.