execute-transaction
Описание
Эта операция позволяет выполнять транзакционные чтение или запись данных, хранящихся в DynamoDB, с использованием PartiQL.
Примечание
Вся транзакция должна состоять либо из операторов чтения, либо из операторов записи; смешивать их в одной транзакции нельзя. Функция EXISTS является исключением и может использоваться для проверки состояния конкретных атрибутов элемента аналогичноConditionCheck в API TransactWriteItems.См. также: Документация AWS API
Синтаксис
execute-transaction
--transact-statements <value>
[--client-request-token <value>]
[--return-consumed-capacity <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--transact-statements (список)
Список операторов PartiQL, представляющих транзакцию для выполнения.
(структура)
Представляет оператор PartiQL, использующий параметры.
Statement -> (строка)
Parameters -> (список)
Значения параметров.
(структура)
Представляет данные для атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.
Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (байтовый массив)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Множество строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Множество чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Множество двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](байтовый массив)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}key -> (строка)
value -> (структура)
Представляет данные для атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.
Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (байтовый массив)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Множество строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Множество чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Множество двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](байтовый массив)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}key -> (строка)
(… рекурсивно…)
L -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](… рекурсивно…)
NULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueL -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](структура)
Представляет данные для атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.
Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (байтовый массив)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Множество строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Множество чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа отправляются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Множество двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](байтовый массив)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}key -> (строка)
(… рекурсивно…)
L -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](… рекурсивно…)
NULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueNULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueReturnValuesOnConditionCheckFailure -> (строка)
Необязательный параметр, возвращающий атрибуты элемента для операции PartiQL ParameterizedStatement, которая не прошла проверку условия.
Запрос значения не влечет дополнительных затрат, кроме небольшой сетевой и процессорной нагрузки при получении более длинного ответа. Единицы пропускной способности чтения не расходуются.
Синтаксис JSON:
[
{
"Statement": "string",
"Parameters": [
{
"S": "string",
"N": "string",
"B": blob,
"SS": ["string", ...],
"NS": ["string", ...],
"BS": [blob, ...],
"M": {"string": {
"S": "string",
"N": "string",
"B": blob,
"SS": ["string", ...],
"NS": ["string", ...],
"BS": [blob, ...],
"M": {"string": { ... recursive ... }
...},
"L": [
{ ... recursive ... }
...
],
"NULL": true|false,
"BOOL": true|false
}
...},
"L": [
{
"S": "string",
"N": "string",
"B": blob,
"SS": ["string", ...],
"NS": ["string", ...],
"BS": [blob, ...],
"M": {"string": { ... recursive ... }
...},
"L": [
{ ... recursive ... }
...
],
"NULL": true|false,
"BOOL": true|false
}
...
],
"NULL": true|false,
"BOOL": true|false
}
...
],
"ReturnValuesOnConditionCheckFailure": "ALL_OLD"|"NONE"
}
...
]
--client-request-token (строка)
NextToken было возвращено в ответе на операцию.--return-consumed-capacity (строка)
Определяет уровень детализации потребления пропускной способности, предоставленной или по запросу, возвращаемой в ответе. Дополнительную информацию см. в разделах TransactGetItems и TransactWriteItems.
Возможные значения:
INDEXESTOTALNONE
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, указанному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет взята дословно. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если не указано значение или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выводится пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, проверяются входные данные команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (boolean)
Включить отладку логирования.
--endpoint-url (string)
Переопределить стандартный URL команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/окружения.
--version (string)
Отобразить версию данного инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (string)
Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка в кодировке base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается как двоичный блок fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Вывод
Ответы -> (список)
Ответ на транзакцию PartiQL.
(структура)
Подробности запрошенного элемента.
Элемент -> (словарь)
Словарь атрибутов, содержащий тип данных и значение атрибута.
ключ -> (строка)
значение -> (структура)
Представляет данные атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — само данные.
Для получения дополнительной информации см. раздел Типы данных в Руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (двоичный файл)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Набор строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Набор чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Набор двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](двоичный файл)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}ключ -> (строка)
значение -> (структура)
Представляет данные атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — само данные.
Для получения дополнительной информации см. раздел Типы данных в Руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (двоичный файл)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Набор строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Набор чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Набор двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](двоичный файл)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}ключ -> (строка)
(… рекурсивно …)
L -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](… рекурсивно …)
NULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueL -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](структура)
Представляет данные атрибута.
Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — само данные.
Для получения дополнительной информации см. раздел Типы данных в Руководстве разработчика Amazon DynamoDB.
S -> (строка)
Атрибут типа Строка. Например:
"S": "Hello"N -> (строка)
Атрибут типа Число. Например:
"N": "123.45"Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
B -> (двоичный файл)
Атрибут типа Двоичные данные. Например:
"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"SS -> (список)
Атрибут типа Набор строк. Например:
"SS": ["Giraffe", "Hippo" ,"Zebra"](строка)
NS -> (список)
Атрибут типа Набор чисел. Например:
"NS": ["42.2", "-19", "7.5", "3.14"]Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.
(строка)
BS -> (список)
Атрибут типа Набор двоичных данных. Например:
"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="](двоичный файл)
M -> (словарь)
Атрибут типа Словарь. Например:
"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}ключ -> (строка)
(… рекурсивно …)
L -> (список)
Атрибут типа Список. Например:
"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}](… рекурсивно …)
NULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueNULL -> (булево)
Атрибут типа Null. Например:
"NULL": trueBOOL -> (булево)
Атрибут типа Булево. Например:
"BOOL": trueConsumedCapacity -> (список)
Единицы емкости, потребленные во всей операции. Значения в списке упорядочены в соответствии с порядком операторов.
(структура)
Единицы емкости, потребленные операцией. Возвращаемые данные включают общую потребленную пропускную способность, а также статистику по таблице и любым индексам, участвующим в операции. ConsumedCapacity возвращается только в том случае, если это было запрошено. Для получения дополнительной информации см. раздел Режим пропускной способности в Руководстве разработчика Amazon DynamoDB.
TableName -> (строка)
CapacityUnits -> (двойное)
ReadCapacityUnits -> (двойное)
WriteCapacityUnits -> (двойное)
Table -> (структура)
Объем пропускной способности, потребленной в таблице, затронутой операцией.
ReadCapacityUnits -> (двойное)
WriteCapacityUnits -> (двойное)
CapacityUnits -> (двойное)
LocalSecondaryIndexes -> (словарь)
Объем пропускной способности, потребленный на каждом локальном индексе, затронутом операцией.
ключ -> (строка)
значение -> (структура)
Представляет объем пропускной способности предоставленной пропускной способности, потребленный в таблице или индексе.
ReadCapacityUnits -> (двойное)
WriteCapacityUnits -> (двойное)
CapacityUnits -> (двойное)
GlobalSecondaryIndexes -> (словарь)
Объем пропускной способности, потребленный на каждом глобальном индексе, затронутом операцией.
ключ -> (строка)
значение -> (структура)
Представляет объем пропускной способности предоставленной пропускной способности, потребленный в таблице или индексе.
ReadCapacityUnits -> (двойное)
WriteCapacityUnits -> (двойное)
CapacityUnits -> (двойное)
© Copyright 2025, Amazon Web Services. Created using Sphinx.