Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

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 -> (строка)

Оператор PartiQL, использующий параметры.

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": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"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": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

ReturnValuesOnConditionCheckFailure -> (строка)

Необязательный параметр, возвращающий атрибуты элемента для операции 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.

Возможные значения:

  • INDEXES
  • TOTAL
  • NONE

--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": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"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": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

ConsumedCapacity -> (список)

Единицы емкости, потребленные во всей операции. Значения в списке упорядочены в соответствии с порядком операторов.

(структура)

Единицы емкости, потребленные операцией. Возвращаемые данные включают общую потребленную пропускную способность, а также статистику по таблице и любым индексам, участвующим в операции. ConsumedCapacity возвращается только в том случае, если это было запрошено. Для получения дополнительной информации см. раздел Режим пропускной способности в Руководстве разработчика Amazon DynamoDB.

TableName -> (строка)

Имя таблицы, которая была затронута операцией. Если вы указали Amazon Resource Name (ARN) таблицы ввода, то вы увидите ARN таблицы в ответе.

CapacityUnits -> (двойное)

Общее количество единиц емкости, потребленных операцией.

ReadCapacityUnits -> (двойное)

Общее количество единиц пропускной способности чтения, потребленных операцией.

WriteCapacityUnits -> (двойное)

Общее количество единиц пропускной способности записи, потребленных операцией.

Table -> (структура)

Объем пропускной способности, потребленной в таблице, затронутой операцией.

ReadCapacityUnits -> (двойное)

Общее количество единиц пропускной способности чтения, потребленных в таблице или индексе.

WriteCapacityUnits -> (двойное)

Общее количество единиц пропускной способности записи, потребленных в таблице или индексе.

CapacityUnits -> (двойное)

Общее количество единиц емкости, потребленных в таблице или индексе.

LocalSecondaryIndexes -> (словарь)

Объем пропускной способности, потребленный на каждом локальном индексе, затронутом операцией.

ключ -> (строка)

значение -> (структура)

Представляет объем пропускной способности предоставленной пропускной способности, потребленный в таблице или индексе.

ReadCapacityUnits -> (двойное)

Общее количество единиц пропускной способности чтения, потребленных в таблице или индексе.

WriteCapacityUnits -> (двойное)

Общее количество единиц пропускной способности записи, потребленных в таблице или индексе.

CapacityUnits -> (двойное)

Общее количество единиц емкости, потребленных в таблице или индексе.

GlobalSecondaryIndexes -> (словарь)

Объем пропускной способности, потребленный на каждом глобальном индексе, затронутом операцией.

ключ -> (строка)

значение -> (структура)

Представляет объем пропускной способности предоставленной пропускной способности, потребленный в таблице или индексе.

ReadCapacityUnits -> (двойное)

Общее количество единиц пропускной способности чтения, потребленных в таблице или индексе.

WriteCapacityUnits -> (двойное)

Общее количество единиц пропускной способности записи, потребленных в таблице или индексе.

CapacityUnits -> (двойное)

Общее количество единиц емкости, потребленных в таблице или индексе.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API