scan

Описание

Операция Scan возвращает одну или несколько записей и атрибуты записей, обращаясь к каждой записи в таблице или вторичном индексе. Чтобы DynamoDB возвращал меньше записей, вы можете использовать операцию FilterExpression.

Если общий размер отсканированных записей превышает максимальный лимит размера набора данных в 1 МБ, сканирование завершается, и результаты возвращаются пользователю. Также возвращается значение LastEvaluatedKey, и запрашивающий может использовать LastEvaluatedKey для продолжения сканирования в последующей операции. Каждый ответ сканирования также включает количество отсканированных записей (ScannedCount) в рамках запроса. При использовании FilterExpression результат сканирования может не содержать записей, соответствующих критериям, и Count будет равно нулю. Если вы не использовали FilterExpression в запросе на сканирование, то Count равно ScannedCount.

Примечание

Count и ScannedCount возвращают только количество записей, относящихся к одному запросу сканирования, и, если таблица меньше 1 МБ, не представляют общее количество записей в таблице.

Операция Scan сначала считывает до максимального количества записей (если используется параметр Limit) или до максимального размера данных в 1 МБ, а затем применяет любые фильтры к результатам, если предоставлен FilterExpression. Если LastEvaluatedKey присутствует в ответе, требуется постраничная навигация для завершения полного сканирования таблицы. Дополнительную информацию см. в разделе Постраничная навигация по результатам в Руководстве разработчика Amazon DynamoDB.

Scan операции выполняются последовательно; однако, для повышения производительности на больших таблицах или вторичных индексах, приложения могут запросить параллельную операцию Scan, предоставив параметры Segment и TotalSegments. Дополнительную информацию см. в разделе Параллельное сканирование в Руководстве разработчика Amazon DynamoDB.

По умолчанию, Scan использует чтение с нестрогой консистенцией при доступе к записям в таблице. Поэтому результаты операции Scan с нестрогой консистенцией могут не содержать последних изменений записей к моменту, когда сканирование проходит по каждой записи в таблице. Если вам требуется строго согласованное чтение каждой записи по мере того, как сканирование проходит по записям в таблице, вы можете установить параметр ConsistentRead в значение true. Строгая консистенция относится только к согласованности чтения на уровне записи.

Примечание

DynamoDB не предоставляет изоляцию моментального снимка для операции сканирования, когда параметр ConsistentRead установлен в значение true. Таким образом, операция сканирования DynamoDB не гарантирует, что все чтения в рамках сканирования увидят согласованный моментальный снимок таблицы в момент запроса операции сканирования.

См. также: Документация API AWS

scan — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную навигацию, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной навигацией, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Items, Count, ScannedCount

Синопсис

  scan
--table-name <value>
[--index-name <value>]
[--attributes-to-get <value>]
[--select <value>]
[--scan-filter <value>]
[--conditional-operator <value>]
[--return-consumed-capacity <value>]
[--total-segments <value>]
[--segment <value>]
[--projection-expression <value>]
[--filter-expression <value>]
[--expression-attribute-names <value>]
[--expression-attribute-values <value>]
[--consistent-read | --no-consistent-read]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--table-name (строка)

Имя таблицы, содержащей запрашиваемые элементы, или, если вы предоставили IndexName, имя таблицы, к которой относится этот индекс.

Вы также можете указать Amazon Resource Name (ARN) таблицы в этом параметре.

--index-name (строка)

Имя вторичного индекса для сканирования. Этот индекс может быть любым локальным или глобальным вторичным индексом. Обратите внимание, что если вы используете параметр IndexName, вы также должны предоставить TableName.

--attributes-to-get (список)

Это устаревший параметр. Используйте ProjectionExpression вместо него. Дополнительную информацию см. в разделе AttributesToGet в руководстве разработчика Amazon DynamoDB.

(строка)

Синтаксис:

"string" "string" ...

--select (строка)

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

ALL_ATTRIBUTES — Возвращает все атрибуты элемента из указанной таблицы или индекса. Если вы запрашиваете локальный вторичный индекс, то для каждого совпадающего элемента в индексе DynamoDB извлекает весь элемент из родительской таблицы. Если индекс настроен на проектирование всех атрибутов элемента, то все данные могут быть получены из локального вторичного индекса, и извлечение не требуется.
ALL_PROJECTED_ATTRIBUTES — Разрешено только при запросе индекса. Возвращает все атрибуты, которые были спроецированы в индекс. Если индекс настроен на проектирование всех атрибутов, то это значение эквивалентно указанию ALL_ATTRIBUTES.
COUNT — Возвращает количество совпадающих элементов, а не сами совпадающие элементы. Обратите внимание, что это использует такое же количество единиц пропускной способности чтения, как и получение элементов, и подчиняется тем же расчетам размера элементов.
SPECIFIC_ATTRIBUTES — Возвращает только атрибуты, перечисленные в ProjectionExpression. Это значение эквивалентно указанию ProjectionExpression без указания какого-либо значения для Select. Если вы запрашиваете или сканируете локальный вторичный индекс и запрашиваете только атрибуты, которые спроецированы в этот индекс, операция считывает только индекс, а не таблицу. Если какие-либо из запрашиваемых атрибутов не спроецированы в локальный вторичный индекс, DynamoDB извлекает каждый из этих атрибутов из родительской таблицы. Это дополнительное извлечение влечёт дополнительные затраты на пропускную способность и задержку. Если вы запрашиваете или сканируете глобальный вторичный индекс, вы можете запросить только атрибуты, которые спроецированы в индекс. Запросы глобального вторичного индекса не могут извлекать атрибуты из родительской таблицы.

Если ни Select, ни ProjectionExpression не указаны, DynamoDB по умолчанию использует ALL_ATTRIBUTES при обращении к таблице и ALL_PROJECTED_ATTRIBUTES при обращении к индексу. Вы не можете использовать как Select, так и ProjectionExpression вместе в одном запросе, если значение для Select равно SPECIFIC_ATTRIBUTES. (Это использование эквивалентно указанию ProjectionExpression без значения для Select).

Примечание

Если вы используете параметр ProjectionExpression, то значение для Select может быть только SPECIFIC_ATTRIBUTES. Любое другое значение для Select вернёт ошибку.

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

ALL_ATTRIBUTES
ALL_PROJECTED_ATTRIBUTES
SPECIFIC_ATTRIBUTES
COUNT

--scan-filter (массив)

Это устаревший параметр. Используйте FilterExpression вместо него. Дополнительную информацию см. в разделе ScanFilter в руководстве разработчика Amazon DynamoDB.

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

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

Представляет критерии выбора для операции Query или Scan:

Для операции Query, Condition используется для указания KeyConditions, используемых при запросе таблицы или индекса. Для KeyConditions поддерживаются только следующие операторы сравнения: EQ | LE | LT | GE | GT | BEGINS_WITH | BETWEEN. Condition также используется в QueryFilter, который оценивает результаты запроса и возвращает только нужные значения.
Для операции Scan, Condition используется в ScanFilter, который оценивает результаты сканирования и возвращает только нужные значения.

AttributeValueList -> (список)

Одно или несколько значений для оценки по отношению к предоставленному атрибуту. Количество значений в списке зависит от используемого ComparisonOperator.

Для типа Число, сравнение значений выполняется численно.

Сравнения строчных значений для больше чем, равно или меньше чем основаны на значениях кода ASCII символов. Например, a больше, чем A, и a больше, чем B. Список значений кода см. на http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

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

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это сами данные.

Дополнительную информацию см. в разделе Типы данных в руководстве разработчика 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"]

(строка)

BS -> (список)

Атрибут типа Множество двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (массив)

Атрибут типа Массив. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

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

Представляет данные для атрибута.

Дополнительную информацию см. в разделе Типы данных в руководстве разработчика Amazon DynamoDB.

S -> (строка)

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

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

B -> (байтовый массив)

Атрибут типа Двоичный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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"

B -> (байтовый массив)

Атрибут типа Двоичный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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

ComparisonOperator -> (строка)

Сравнительный оператор для оценки атрибутов. Например, равно, больше, меньше и т.д.

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

EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN

Ниже приведены описания каждого оператора сравнения.

EQ : Равно. EQ поддерживается для всех типов данных, включая списки и карты. AttributeValueList может содержать только один AttributeValue элемент типа String, Number, Binary, String Set, Number Set или Binary Set. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не равно {"NS":["6", "2", "1"]}.
NE : Не равно. NE поддерживается для всех типов данных, включая списки и карты. AttributeValueList может содержать только один AttributeValue элемент типа String, Number, Binary, String Set, Number Set или Binary Set. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не равно {"NS":["6", "2", "1"]}.
LE : Меньше или равно. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не типа множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
LT : Меньше. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не типа множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
GE : Больше или равно. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не типа множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
GT : Больше. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не типа множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
NOT_NULL : Атрибут существует. NOT_NULL поддерживается для всех типов данных, включая списки и карты.

Примечание

Этот оператор проверяет существование атрибута, а не его тип данных. Если тип данных атрибута “a” равен null, и вы оцениваете его с помощью NOT_NULL, результат — логическое значение true. Это потому, что атрибут “a” существует; его тип данных не имеет отношения к оператору сравнения NOT_NULL.

NULL : Атрибут не существует. NULL поддерживается для всех типов данных, включая списки и карты.

Примечание

Этот оператор проверяет отсутствие атрибута, а не его тип данных. Если тип данных атрибута “a” равен null, и вы оцениваете его с помощью NULL, результат — логическое значение false. Это потому, что атрибут “a” существует; его тип данных не имеет отношения к оператору сравнения NULL.

CONTAINS : Проверка подпоследовательности или значения в множестве. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если целевой атрибут сравнения имеет тип String, оператор проверяет соответствие подстроке. Если целевой атрибут имеет тип Binary, оператор ищет подпоследовательность в целевом, которая соответствует вводу. Если целевой атрибут — множество (”SS”, “NS” или “BS”), оператор оценивается как true, если найдено точное соответствие любому элементу множества. CONTAINS поддерживается для списков: при оценке “a CONTAINS b”, “a” может быть списком; однако “b” не может быть множеством, картой или списком.
NOT_CONTAINS : Проверка отсутствия подпоследовательности или значения в множестве. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если целевой атрибут сравнения — строка, оператор проверяет отсутствие соответствия подстроке. Если целевой атрибут — двоичные данные, оператор проверяет отсутствие подпоследовательности в целевом, которая соответствует вводу. Если целевой атрибут — множество (”SS”, “NS” или “BS”), оператор оценивается как true, если не найдено точное соответствие ни одному элементу множества. NOT_CONTAINS поддерживается для списков: при оценке “a NOT CONTAINS b”, “a” может быть списком; однако “b” не может быть множеством, картой или списком.
BEGINS_WITH : Проверка префикса. AttributeValueList может содержать только один AttributeValue элемент типа String или Binary (не Number или тип множества). Целевой атрибут сравнения должен быть типа String или Binary (не Number или тип множества).
IN : Проверка соответствия элементов в списке. AttributeValueList может содержать один или несколько AttributeValue элементов типа String, Number или Binary. Эти атрибуты сравниваются с существующим атрибутом элемента. Если какие-либо элементы входных данных равны атрибуту элемента, выражение оценивается как true.
BETWEEN : Больше или равно первому значению и меньше или равно второму значению. AttributeValueList должен содержать два AttributeValue элемента одного типа: String, Number или Binary (не тип множества). Целевой атрибут соответствует, если целевое значение больше или равно первому элементу и меньше или равно второму элементу. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не соответствует. Например, {"S":"6"} не сравнивается с {"N":"6"}. Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}

Примеры использования AttributeValueList и ComparisonOperator см. в разделе Legacy Conditional Parameters в Руководстве разработчика Amazon DynamoDB.

Синтаксис JSON:

{"string": {
      "AttributeValueList": [
        {
          "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
        }
        ...
      ],
      "ComparisonOperator": "EQ"|"NE"|"IN"|"LE"|"LT"|"GE"|"GT"|"BETWEEN"|"NOT_NULL"|"NULL"|"CONTAINS"|"NOT_CONTAINS"|"BEGINS_WITH"
    }
  ...}

--conditional-operator (строка)

Это параметр устаревшей версии. Используйте FilterExpression вместо него. Дополнительную информацию см. в ConditionalOperator в Руководстве разработчика Amazon DynamoDB.

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

AND
OR

--return-consumed-capacity (строка)

Определяет уровень детализации потребления пропускной способности по выделенному или по запросу, который возвращается в ответе:

INDEXES - Ответ включает агрегированное значение ConsumedCapacity для операции, вместе с ConsumedCapacity для каждой таблицы и вторичного индекса, к которым был произведен доступ. Обратите внимание, что некоторые операции, такие как GetItem и BatchGetItem, вообще не обращаются к индексам. В этих случаях указание INDEXES вернёт только информацию о таблице(ах) ConsumedCapacity.
TOTAL - Ответ включает только агрегированное ConsumedCapacity для операции.
NONE - Подробности о ConsumedCapacity не включены в ответ.

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

INDEXES
TOTAL
NONE

--total-segments (целое число)

Для параллельного запроса Scan, TotalSegments представляет общее количество сегментов, на которые операция Scan будет разделена. Значение TotalSegments соответствует количеству рабочих процессов приложения, которые будут выполнять параллельный поиск. Например, если вы хотите использовать четыре потока приложения для сканирования таблицы или индекса, укажите значение TotalSegments равное 4.

Значение TotalSegments должно быть больше или равно 1 и меньше или равно 1000000. Если вы укажете значение TotalSegments равное 1, операция Scan будет последовательной, а не параллельной.

Если вы указываете TotalSegments, вы также должны указать Segment.

--segment (целое число)

Для параллельного запроса Scan, Segment идентифицирует отдельный сегмент, который будет сканироваться рабочим процессом приложения.

Идентификаторы сегментов нумеруются с нуля, поэтому первый сегмент всегда равен 0. Например, если вы хотите использовать четыре потока приложения для сканирования таблицы или индекса, первый поток указывает значение Segment равное 0, второй поток указывает 1 и так далее.

Значение LastEvaluatedKey, возвращённое в ответ на параллельный запрос Scan, должно использоваться в качестве ExclusiveStartKey с тем же идентификатором сегмента в последующей операции Scan.

Значение Segment должно быть больше или равно 0 и меньше значения, указанного для TotalSegments.

Если вы предоставляете Segment, вы также должны предоставить TotalSegments.

--projection-expression (строка)

Строка, идентифицирующая один или несколько атрибутов для извлечения из указанной таблицы или индекса. Эти атрибуты могут включать скаляры, множества или элементы JSON-документа. Атрибуты в выражении должны быть разделены запятыми.

Если имена атрибутов не указаны, будут возвращены все атрибуты. Если какой-либо из запрошенных атрибутов не найден, он не будет отображаться в результате.

Для получения дополнительной информации см. раздел Указание атрибутов элементов в руководстве разработчика Amazon DynamoDB.

--filter-expression (строка)

Строка, содержащая условия, которые DynamoDB применяет после операции Scan, но перед возвратом данных. Элементы, которые не удовлетворяют критериям FilterExpression, не возвращаются.

Примечание

Фильтр применяется после того, как элементы уже были прочитаны; процесс фильтрации не потребляет дополнительные единицы пропускной способности чтения.

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

--expression-attribute-names (карта)

Один или несколько маркеров подстановки для имен атрибутов в выражении. Ниже приведены некоторые варианты использования ExpressionAttributeNames:

Для доступа к атрибуту, имя которого конфликтует с зарезервированным словом DynamoDB.
Для создания замены для повторяющихся вхождений имени атрибута в выражении.
Для предотвращения неправильной интерпретации специальных символов в имени атрибута в выражении.

В выражении используйте символ # для обращения к имени атрибута. Например, рассмотрим следующее имя атрибута:

Percentile

Имя этого атрибута конфликтует с зарезервированным словом, поэтому его нельзя использовать непосредственно в выражении. (Полный список зарезервированных слов см. в руководстве разработчика Amazon DynamoDB в разделе Зарезервированные слова). Чтобы обойти это, можно указать следующее для ExpressionAttributeNames:

{"#P":"Percentile"}

Затем вы можете использовать эту подстановку в выражении, как в этом примере:

#P = :val

Примечание

Маркеры, начинающиеся с символа :, являются значениями атрибутов выражения, которые являются заменителями фактического значения во время выполнения.

Дополнительную информацию об именах атрибутов выражения см. в разделе Указание атрибутов элементов в руководстве разработчика Amazon DynamoDB.

key -> (строка)

value -> (строка)

Сокращенная синтаксическая форма:

KeyName1=string,KeyName2=string

JSON-синтаксис:

{"string": "string"
  ...}

--expression-attribute-values (карта)

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

В выражении используйте символ : (двоеточие) для обращения к значению атрибута. Например, предположим, что вы хотели проверить, является ли значение атрибута ProductStatus одним из следующих:

Available | Backordered | Discontinued

Сначала вам необходимо указать ExpressionAttributeValues следующим образом:

{ ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }

Затем вы можете использовать эти значения в выражении, например:

ProductStatus IN (:avail, :back, :disc)

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

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"]

(строка)

BS -> (список)

Атрибут типа Множество двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (карта)

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

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

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

Представляет данные для атрибута.

Дополнительную информацию см. в разделе Типы данных в руководстве разработчика Amazon DynamoDB.

S -> (строка)

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

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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"

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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

JSON-синтаксис:

{"string": {
      "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
    }
  ...}

--consistent-read | --no-consistent-read (булево)

Булево значение, определяющее модель согласованности чтения во время сканирования:

Если ConsistentRead равно false, возвращенные данные от Scan могут не содержать результаты других недавно завершенных операций записи (PutItem, UpdateItem или DeleteItem).
Если ConsistentRead равно true, все операции записи, завершившиеся до начала Scan, гарантированно будут содержаться в ответе Scan.

Значение по умолчанию для ConsistentRead — false.

Параметр ConsistentRead не поддерживается для глобальных вторичных индексов. Если вы сканируете глобальный вторичный индекс с ConsistentRead, установленным в true, вы получите ошибку ValidationException.

--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью JSON-предоставленных значений, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания точки начала пагинации. Это NextToken из ранее обрезанного ответа.

Примеры использования см. в разделе Пагинация в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для вызова AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе «Пагинация» в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления пагинации укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе «Пагинация» в руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение без значения или значение input, выводит JSON-пример ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример ввода YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команды и вернёт JSON-пример вывода для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку регистрации.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию проверки SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическую пагинацию. Если автоматическая пагинация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для использования при фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла аутентификации.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (булево)

Не подписывать запросы. Кредиты не будут загружаться, если этот аргумент предоставлен.

--ca-bundle (строка)

Набор сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, который будет использоваться для двоичных блоков. Формат по умолчанию — 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 (булево)

Отключить страницу кли для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. См. руководство «Начало работы» в руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Для сканирования таблицы

Следующий scan пример сканирует всю таблицу MusicCollection, а затем сужает результаты до песен художника «No One You Know». Для каждого элемента возвращаются только заголовок альбома и заголовок песни.

aws dynamodb scan \
    --table-name MusicCollection \
    --filter-expression "Artist = :a" \
    --projection-expression "#ST, #AT" \
    --expression-attribute-names file://expression-attribute-names.json \
    --expression-attribute-values file://expression-attribute-values.json

Содержимое expression-attribute-names.json:

{
    "#ST": "SongTitle",
    "#AT":"AlbumTitle"
}

Содержимое expression-attribute-values.json:

{
    ":a": {"S": "No One You Know"}
}

Вывод:

{
    "Count": 2,
    "Items": [
        {
            "SongTitle": {
                "S": "Call Me Today"
            },
            "AlbumTitle": {
                "S": "Somewhat Famous"
            }
        },
        {
            "SongTitle": {
                "S": "Scared of My Shadow"
            },
            "AlbumTitle": {
                "S": "Blue Sky Blues"
            }
        }
    ],
    "ScannedCount": 3,
    "ConsumedCapacity": null
}

Для получения дополнительной информации см. раздел «Работа со сканированием в DynamoDB» в руководстве разработчика Amazon DynamoDB.

Вывод

Элементы -> (список)

Массив атрибутов элементов, соответствующих критериям сканирования. Каждый элемент этого массива состоит из имени атрибута и значения этого атрибута.

(отображение)

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

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — тип данных, а значение — само данные.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика 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"]

(строка)

BS -> (список)

Атрибут типа Набор бинарных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный)

M -> (отображение)

Атрибут типа Отображение. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — тип данных, а значение — само данные.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

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

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

B -> (бинарный)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

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

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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"

B -> (бинарный)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

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

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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

Количество -> (целое число)

Количество элементов в ответе.

Если вы установили ScanFilter в запросе, то Count — это количество элементов, возвращенных после применения фильтра, а ScannedCount — количество соответствующих элементов до применения фильтра.

Если вы не использовали фильтр в запросе, то Count равно ScannedCount.

Количество отсканированных элементов -> (целое число)

Количество элементов, обработанных перед применением любого ScanFilter. Высокое значение ScannedCount с небольшим или отсутствующим результатом Count указывает на неэффективную операцию Scan. Дополнительную информацию см. в разделе «Количество и количество сканированных элементов» в руководстве разработчика Amazon DynamoDB.

Если вы не использовали фильтр в запросе, то ScannedCount равно Count.

Последний обработанный ключ -> (отображение)

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

Если LastEvaluatedKey пусто, значит, была обработана последняя страница результатов, и больше данных для извлечения нет.

Если LastEvaluatedKey не пусто, это не обязательно означает, что в наборе результатов есть дополнительные данные. Единственный способ узнать, достигли ли вы конца набора результатов, это когда LastEvaluatedKey пусто.

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"]

(строка)

BS -> (список)

Атрибут типа Множество бинарных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный массив)

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

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

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

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

Представляет данные для атрибута.

Для получения дополнительной информации см. Типы данных в руководстве разработчика Amazon DynamoDB.

S -> (строка)

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

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

B -> (бинарный массив)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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"

B -> (бинарный массив)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

(строка)

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

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

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

TableName -> (строка)

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

CapacityUnits -> (двойное число)

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

ReadCapacityUnits -> (двойное число)

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

WriteCapacityUnits -> (двойное число)

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

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

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

ReadCapacityUnits -> (двойное число)

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

WriteCapacityUnits -> (двойное число)

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

CapacityUnits -> (двойное число)

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

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

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

key -> (строка)

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

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

ReadCapacityUnits -> (двойное число)

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

WriteCapacityUnits -> (двойное число)

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

CapacityUnits -> (двойное число)

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

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

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

key -> (строка)

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

ReadCapacityUnits -> (двойное число)

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

WriteCapacityUnits -> (двойное число)

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

CapacityUnits -> (двойное число)

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