batch-get-item

Описание

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

В рамках одной операции можно получить до 16 МБ данных, которые могут содержать до 100 элементов. BatchGetItem возвращает частичный результат, если превышен лимит размера ответа, превышен пропускная способность таблицы, запрошено более 1 МБ на раздел или произошла внутренняя ошибка обработки. Если возвращается частичный результат, операция возвращает значение для UnprocessedKeys . Вы можете использовать это значение для повторного выполнения операции, начиная с следующего элемента для получения.

Например, если вы запрашиваете 100 элементов, но каждый отдельный элемент имеет размер 300 КБ, система возвращает 52 элемента (чтобы не превысить лимит 16 МБ). Она также возвращает соответствующее значение UnprocessedKeys, чтобы вы могли получить следующую страницу результатов. При необходимости ваше приложение может включить собственную логику для объединения страниц результатов в один набор данных.

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

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

Для минимизации задержки ответа, BatchGetItem может извлекать элементы параллельно.

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

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

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

Синопсис

  batch-get-item
--request-items <value>
[--return-consumed-capacity <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--request-items (map)

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

--debug (boolean)

Включить отладку протоколирования.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

• json
• text
• table
• yaml
• yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного формата cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Получение нескольких элементов из таблицы

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

aws dynamodb batch-get-item \
    --request-items file://request-items.json \
    --return-consumed-capacity TOTAL

Содержимое request-items.json:

{
    "MusicCollection": {
        "Keys": [
            {
                "Artist": {"S": "No One You Know"},
                "SongTitle": {"S": "Call Me Today"}
            },
            {
                "Artist": {"S": "Acme Band"},
                "SongTitle": {"S": "Happy Day"}
            },
            {
                "Artist": {"S": "No One You Know"},
                "SongTitle": {"S": "Scared of My Shadow"}
            }
        ],
        "ProjectionExpression":"AlbumTitle"
    }
}

Вывод:

{
    "Responses": {
        "MusicCollection": [
            {
                "AlbumTitle": {
                    "S": "Somewhat Famous"
                }
            },
            {
                "AlbumTitle": {
                    "S": "Blue Sky Blues"
                }
            },
            {
                "AlbumTitle": {
                    "S": "Louder Than Ever"
                }
            }
        ]
    },
    "UnprocessedKeys": {},
    "ConsumedCapacity": [
        {
            "TableName": "MusicCollection",
            "CapacityUnits": 1.5
        }
    ]
}

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

Вывод

Responses -> (map)