Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

запрос

Описание

Вы должны указать имя атрибута ключа раздела и единственное значение для этого атрибута. Query возвращает все элементы со значением ключа раздела. Дополнительно, вы можете указать атрибут ключа сортировки и использовать оператор сравнения для уточнения результатов поиска.

Используйте параметр KeyConditionExpression, чтобы указать конкретное значение для ключа раздела. Операция Query вернет все элементы из таблицы или индекса со значением ключа раздела. Вы можете дополнительно сузить область действия операции Query, указав значение ключа сортировки и оператор сравнения в KeyConditionExpression. Для дальнейшего уточнения результатов Query, вы можете дополнительно указать FilterExpression. FilterExpression определяет, какие элементы из результатов должны быть возвращены. Все остальные результаты отбрасываются.

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

Примечание

DynamoDB вычисляет количество потребленных единиц емкости чтения на основе размера элемента, а не на количестве данных, возвращаемых приложению. Количество потребленных единиц емкости будет одинаковым, независимо от того, запрашиваете ли вы все атрибуты (по умолчанию) или только некоторые из них (с помощью выражения проекции). Количество будет также одинаковым, используете ли вы FilterExpression.

Результаты Query всегда сортируются по значению ключа сортировки. Если тип данных ключа сортировки — число, результаты возвращаются в числовом порядке; в противном случае результаты возвращаются в порядке байтов UTF-8. По умолчанию порядок сортировки — возрастающий. Для изменения порядка установите параметр ScanIndexForward в значение false.

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

FilterExpression применяется после завершения Query, но перед возвращением результатов. FilterExpression не может содержать атрибуты ключа раздела или ключа сортировки. Вам необходимо указать эти атрибуты в KeyConditionExpression.

Примечание

Операция Query может вернуть пустой набор результатов и LastEvaluatedKey, если все прочитанные элементы для страницы результатов отфильтрованы.

Вы можете выполнить запрос к таблице, локальному вторичному индексу или глобальному вторичному индексу. Для запроса к таблице или локальному вторичному индексу вы можете установить параметр ConsistentRead в значение true и получить сильно согласованный результат. Глобальные вторичные индексы поддерживают только согласованные во времени чтения, поэтому не указывайте ConsistentRead при запросе к глобальному вторичному индексу.

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

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

Резюме

  query
--table-name <value>
[--index-name <value>]
[--select <value>]
[--attributes-to-get <value>]
[--consistent-read | --no-consistent-read]
[--key-conditions <value>]
[--query-filter <value>]
[--conditional-operator <value>]
[--scan-index-forward | --no-scan-index-forward]
[--return-consumed-capacity <value>]
[--projection-expression <value>]
[--filter-expression <value>]
[--key-condition-expression <value>]
[--expression-attribute-names <value>]
[--expression-attribute-values <value>]
[--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 (строка)

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

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

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

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

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

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

(строка)

Синтаксис:

"string" "string" ...

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

Определяет модель согласованности чтения: Если установлено в значение true, то операция использует сильно согласованные чтения; в противном случае операция использует согласованные во времени чтения.

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

--key-conditions (словарь)

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

key -> (строка)

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

Представляет критерии выбора для операции 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"]

Числа отправляются в 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

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 (не тип множества). Если целевой атрибут сравнения имеет тип String, оператор проверяет отсутствие совпадения подстроки. Если целевой атрибут имеет тип 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 см. в разделе «Параметры условных выражений устаревшего типа» в руководстве разработчика 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"
    }
  ...}

--query-filter (карта)

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

key -> (строка)

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

Представляет критерии выбора для операции 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"]

Числа передаются в 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

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 (не тип множества). Если целевой атрибут сравнения является строкой, то оператор проверяет отсутствие соответствия подстроки. Если целевой атрибут сравнения имеет тип 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. Эти атрибуты сравниваются с существующим атрибутом элемента. Если какие-либо элементы входных данных равны атрибуту элемента, выражение оценивается как истинное.
  • BETWEEN : Больше или равно первому значению и меньше или равно второму значению. AttributeValueList должен содержать два AttributeValue элемента одного типа, String, Number или Binary (не тип множества). Целевой атрибут соответствует, если целевое значение больше или равно первому элементу и меньше или равно второму элементу. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не соответствует. Например, {"S":"6"} не сравнивается с {"N":"6"} . Также, {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}

Примеры использования AttributeValueList и ComparisonOperator см. в разделе "Параметры условных выражений устаревшего формата" в Руководстве разработчика 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

--scan-index-forward | --no-scan-index-forward (логическое значение)

Указывает порядок обхода индекса: если true (по умолчанию), обход выполняется в возрастающем порядке; если false , обход выполняется в убывающем порядке.

Элементы с одинаковым значением первичного ключа хранятся в отсортированном порядке по значению сортировочного ключа. Если тип данных сортировочного ключа — число, результаты хранятся в числовом порядке. Для типа String результаты хранятся в порядке UTF-8 байтов. Для типа Binary DynamoDB обрабатывает каждый байт двоичных данных как беззнаковый.

Если ScanIndexForward имеет значение true , DynamoDB возвращает результаты в том порядке, в котором они хранятся (по значению сортировочного ключа). Это поведение по умолчанию. Если ScanIndexForward имеет значение false , DynamoDB считывает результаты в обратном порядке по значению сортировочного ключа, а затем возвращает результаты клиенту.

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

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

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

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

  • INDEXES
  • TOTAL
  • NONE

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

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

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

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

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

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

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

Примечание

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

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

--key-condition-expression (строка)

Условие, определяющее значения ключей для элементов, которые должны быть извлечены действием Query.

Условие должно выполнять проверку равенства на единственное значение ключа раздела.

Условие может необязательно выполнить несколько сравнений на единственное значение ключа сортировки. Это позволяет Query извлечь один элемент с заданным значением ключа раздела и ключа сортировки или несколько элементов с одинаковым значением ключа раздела, но разными значениями ключа сортировки.

Проверка равенства ключа раздела обязательна и должна быть указана в следующем формате:

partitionKeyName = :partitionkeyval

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

partitionKeyName = :partitionkeyval AND sortKeyName = :sortkeyval

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

  • sortKeyName = :sortkeyval — истинно, если значение ключа сортировки равно :sortkeyval.
  • sortKeyName < :sortkeyval — истинно, если значение ключа сортировки меньше :sortkeyval.
  • sortKeyName <= :sortkeyval — истинно, если значение ключа сортировки меньше или равно :sortkeyval.
  • sortKeyName > :sortkeyval — истинно, если значение ключа сортировки больше :sortkeyval.
  • sortKeyName >= :sortkeyval — истинно, если значение ключа сортировки больше или равно :sortkeyval.
  • sortKeyName BETWEEN :sortkeyval1 AND :sortkeyval2 — истинно, если значение ключа сортировки больше или равно :sortkeyval1 и меньше или равно :sortkeyval2.
  • begins_with ( sortKeyName, :sortkeyval ) — истинно, если значение ключа сортировки начинается с определенного операнда. (Вы не можете использовать эту функцию с ключом сортировки типа Число.) Обратите внимание, что имя функции begins_with чувствительно к регистру.

Используйте параметр ExpressionAttributeValues для замены таких токенов, как :partitionval и :sortval, фактическими значениями во время выполнения.

Необязательно используйте параметр ExpressionAttributeNames, чтобы заменить имена ключа раздела и ключа сортировки маркерами-заполнителями. Этот параметр может потребоваться, если имя атрибута конфликтует с зарезервированным словом DynamoDB. Например, следующий параметр KeyConditionExpression вызывает ошибку, так как Size — зарезервированное слово:

  • Size = :myval

Чтобы обойти это, определите заполнитель (например, #S) для представления имени атрибута Size. KeyConditionExpression тогда выглядит следующим образом:

  • #S = :myval

Список зарезервированных слов см. в Руководстве разработчика Amazon DynamoDB в разделе «Зарезервированные слова».

Дополнительную информацию о ExpressionAttributeNames и ExpressionAttributeValues см. в разделе «Использование заполнителей для имён и значений атрибутов» в Руководстве разработчика 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"]

Числа передаются в 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

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
    }
  ...}

--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 (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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку 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.

Примеры

Примечание

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

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

Пример 1: Запрос таблицы

Следующий query пример запрашивает элементы в таблице MusicCollection. Таблица имеет первичный ключ хеш-и-диапазон (Artist и SongTitle), но этот запрос указывает только значение ключа хеш. Он возвращает названия песен исполнителя «No One You Know».

aws dynamodb query \
    --table-name MusicCollection \
    --projection-expression "SongTitle" \
    --key-condition-expression "Artist = :v1" \
    --expression-attribute-values file://expression-attributes.json \
    --return-consumed-capacity TOTAL

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

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

Вывод:

{
    "Items": [
        {
            "SongTitle": {
                "S": "Call Me Today"
            },
            "SongTitle": {
                "S": "Scared of My Shadow"
            }
        }
    ],
    "Count": 2,
    "ScannedCount": 2,
    "ConsumedCapacity": {
        "TableName": "MusicCollection",
        "CapacityUnits": 0.5
    }
}

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

Пример 2: Запрос таблицы с чтением сильной согласованности и обходом индекса в порядке убывания

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

aws dynamodb query \
    --table-name MusicCollection \
    --projection-expression "SongTitle" \
    --key-condition-expression "Artist = :v1" \
    --expression-attribute-values file://expression-attributes.json \
    --consistent-read \
    --no-scan-index-forward \
    --return-consumed-capacity TOTAL

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

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

Вывод:

{
    "Items": [
        {
            "SongTitle": {
                "S": "Scared of My Shadow"
            }
        },
        {
            "SongTitle": {
                "S": "Call Me Today"
            }
        }
    ],
    "Count": 2,
    "ScannedCount": 2,
    "ConsumedCapacity": {
        "TableName": "MusicCollection",
        "CapacityUnits": 1.0
    }
}

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

Пример 3: Фильтрация определенных результатов

Следующий пример запрашивает таблицу MusicCollection, но исключает результаты со специфическими значениями в атрибуте AlbumTitle. Обратите внимание, что это не влияет на ScannedCount или ConsumedCapacity, поскольку фильтр применяется после чтения элементов.

aws dynamodb query \
    --table-name MusicCollection \
    --key-condition-expression "#n1 = :v1" \
    --filter-expression "NOT (#n2 IN (:v2, :v3))" \
    --expression-attribute-names file://names.json \
    --expression-attribute-values file://values.json \
    --return-consumed-capacity TOTAL

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

{
    ":v1": {"S": "No One You Know"},
    ":v2": {"S": "Blue Sky Blues"},
    ":v3": {"S": "Greatest Hits"}
}

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

{
    "#n1": "Artist",
    "#n2": "AlbumTitle"
}

Вывод:

{
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Call Me Today"
            }
        }
    ],
    "Count": 1,
    "ScannedCount": 2,
    "ConsumedCapacity": {
        "TableName": "MusicCollection",
        "CapacityUnits": 0.5
    }
}

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

Пример 4: Получение только количества элементов

Следующий пример получает количество элементов, соответствующих запросу, но не получает сами элементы.

aws dynamodb query \
    --table-name MusicCollection \
    --select COUNT \
    --key-condition-expression "Artist = :v1" \
    --expression-attribute-values file://expression-attributes.json

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

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

Вывод:

{
    "Count": 2,
    "ScannedCount": 2,
    "ConsumedCapacity": null
}

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

Пример 5: Запрос индекса

Следующий пример запрашивает локальный вторичный индекс AlbumTitleIndex. Запрос возвращает все атрибуты из основной таблицы, которые были спроецированы в локальный вторичный индекс. Обратите внимание, что при запросе локального вторичного индекса или глобального вторичного индекса необходимо также указать имя основной таблицы с помощью параметра table-name.

aws dynamodb query \
    --table-name MusicCollection \
    --index-name AlbumTitleIndex \
    --key-condition-expression "Artist = :v1" \
    --expression-attribute-values file://expression-attributes.json \
    --select ALL_PROJECTED_ATTRIBUTES \
    --return-consumed-capacity INDEXES

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

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

Вывод:

{
    "Items": [
        {
            "AlbumTitle": {
                "S": "Blue Sky Blues"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Scared of My Shadow"
            }
        },
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "Artist": {
                "S": "No One You Know"
            },
            "SongTitle": {
                "S": "Call Me Today"
            }
        }
    ],
    "Count": 2,
    "ScannedCount": 2,
    "ConsumedCapacity": {
        "TableName": "MusicCollection",
        "CapacityUnits": 0.5,
        "Table": {
            "CapacityUnits": 0.0
        },
        "LocalSecondaryIndexes": {
            "AlbumTitleIndex": {
                "CapacityUnits": 0.5
            }
        }
    }
}

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

Числа передаются по сети в 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

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

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

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

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

ОбработанноеКоличество -> (целое число)

Количество элементов, обработанных до применения любого QueryFilter. Высокое значение ScannedCount с небольшим или отсутствием результатов Count указывает на неэффективную операцию Query. Дополнительную информацию см. в разделе «Количество и ОбработанноеКоличество» в руководстве разработчика 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"]

Числа передаются по сети в 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

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

Единицы емкости, потребленные операцией Query. Возвращаемые данные включают общее потребленное пропускную способность, а также статистику для таблицы и любых индексов, участвующих в операции. 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 -> (число с плавающей запятой)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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