Amazon DynamoDB
Чтение и запись таблиц Amazon DynamoDB в процессах Pailot
Amazon DynamoDB — управляемая NoSQL-база (схема без жёстких таблиц как в SQL) в AWS (Amazon Web Services — облако Amazon). Блок ходит по ключам доступа: Get, Put, Query, Scan, Update, Delete и схема таблицы.
С DynamoDB в Pailot вы можете:
- Читать элемент по первичному ключу (опционально consistent read)
- Записывать и обновлять элементы выражениями
SET
- Делать Query по условию ключа и Scan по таблице
- Удалять элемент с условием
- Смотреть список таблиц региона или схему одной таблицы
Нужны region, accessKeyId и secretAccessKey. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Прочитать элемент по первичному ключу.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
key | object | Да | Первичный ключ элемента |
consistentRead | boolean | Нет | Строго согласованное чтение |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
item | object | Прочитанный элемент |
Записать элемент в таблицу.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
item | object | Да | Элемент для записи |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
item | object | Записанный элемент |
Запрос элементов по условию ключа.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
keyConditionExpression | string | Да | Условие ключа (например, pk = :pk) |
filterExpression | string | Нет | Фильтр результатов |
expressionAttributeNames | object | Нет | Подстановки имён для зарезервированных слов |
expressionAttributeValues | object | Нет | Значения выражений |
indexName | string | Нет | Имя вторичного индекса |
limit | number | Нет | Максимум элементов |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
items | array | Массив элементов |
count | number | Число элементов |
Сканировать все элементы таблицы.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
filterExpression | string | Нет | Фильтр результатов |
projectionExpression | string | Нет | Какие атрибуты вернуть |
expressionAttributeNames | object | Нет | Подстановки имён для зарезервированных слов |
expressionAttributeValues | object | Нет | Значения выражений |
limit | number | Нет | Максимум элементов |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
items | array | Массив элементов |
count | number | Число элементов |
Обновить элемент таблицы.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
key | object | Да | Первичный ключ элемента |
updateExpression | string | Да | Выражение обновления (например, SET #name = :name) |
expressionAttributeNames | object | Нет | Подстановки имён для зарезервированных слов |
expressionAttributeValues | object | Нет | Значения выражений |
conditionExpression | string | Нет | Условие, без которого обновление не пройдёт |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
item | object | Обновлённый элемент |
Удалить элемент по первичному ключу.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Да | Имя таблицы DynamoDB |
key | object | Да | Первичный ключ элемента |
conditionExpression | string | Нет | Условие, без которого удаление не пройдёт |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
Список таблиц региона или схема одной таблицы.
| Параметр | Тип | Обязательный | Описание |
|---|
region | string | Да | Регион AWS (например, us-east-1) |
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ AWS |
tableName | string | Нет | Имя таблицы для схемы. Если пусто — список всех таблиц |
| Параметр | Тип | Описание |
|---|
message | string | Статус операции |
tables | array | Имена таблиц в регионе |
tableDetails | object | Схема указанной таблицы |
