Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

import-table

Описание

Импортирует данные таблицы из ведра S3.

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

Синтаксис

  import-table
[--client-token <value>]
--s3-bucket-source <value>
--input-format <value>
[--input-format-options <value>]
[--input-compression-type <value>]
--table-creation-parameters <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]

Параметры

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

Предоставление ClientToken делает вызов ImportTableInput идемпотентным, что означает, что несколько одинаковых вызовов имеют тот же эффект, что и один единственный вызов.

Токен клиента действителен в течение 8 часов после завершения первого запроса, который его использует. По истечении 8 часов любой запрос с тем же токеном клиента обрабатывается как новый запрос. Не отправляйте один и тот же запрос с тем же токеном клиента более 8 часов, в противном случае результат может быть неидемпотентным.

Если вы отправите запрос с тем же токеном клиента, но с изменением других параметров в течение 8-часового окна идемпотентности, DynamoDB возвратит исключение IdempotentParameterMismatch.

--s3-bucket-source (структура)

Ведро S3, являющееся источником для импорта.

S3BucketOwner -> (строка)

Номер учетной записи ведра S3, из которого происходит импорт. Если ведро принадлежит отправителю запроса, это необязательно.

S3Bucket -> (строка)

Ведро S3, из которого происходит импорт.

S3KeyPrefix -> (строка)

Префикс ключа, общий для всех объектов S3, которые импортируются.

Сокращенный синтаксис:

S3BucketOwner=string,S3Bucket=string,S3KeyPrefix=string

Синтаксис JSON:

{
  "S3BucketOwner": "string",
  "S3Bucket": "string",
  "S3KeyPrefix": "string"
}

--input-format (строка)

Формат исходных данных. Допустимые значения для ImportFormat это CSV , DYNAMODB_JSON или ION .

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

  • DYNAMODB_JSON
  • ION
  • CSV

--input-format-options (структура)

Дополнительные свойства, которые указывают, как отформатирован ввод,

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

Параметры импортируемых файлов в формате CSV. Значения — Delimiter и HeaderList.

Delimiter -> (строка)

Разделитель, используемый для разделения элементов в импортируемом файле CSV.

HeaderList -> (список)

Список заголовков, используемых для указания общего заголовка для всех импортируемых файлов CSV. Если этот параметр указан, то первая строка каждого файла CSV обрабатывается как данные, а не как заголовок. Если этот параметр не указан, то первая строка каждого файла CSV обрабатывается как заголовок.

(строка)

Сокращенный синтаксис:

Csv={Delimiter=string,HeaderList=[string,string]}

Синтаксис JSON:

{
  "Csv": {
    "Delimiter": "string",
    "HeaderList": ["string", ...]
  }
}

--input-compression-type (строка)

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

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

  • GZIP
  • ZSTD
  • NONE

--table-creation-parameters (структура)

Параметры таблицы для импорта данных.

TableName -> (строка)

Имя таблицы, созданной в рамках операции импорта.

AttributeDefinitions -> (список)

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

(структура)

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

AttributeName -> (строка)

Имя атрибута.

AttributeType -> (строка)

Тип данных атрибута, где:

  • S — атрибут типа Строка
  • N — атрибут типа Число
  • B — атрибут типа Двоичные данные

KeySchema -> (список)

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

(структура)

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

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

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть строкой, числом или двоичными данными. Атрибут не может быть вложен в список или словарь.

AttributeName -> (строка)

Имя атрибута ключа.

KeyType -> (строка)

Роль, которую этот атрибут ключа будет выполнять:

  • HASH — разделяющий ключ
  • RANGE — сортировочный ключ

Примечание

Разделяющий ключ элемента также известен как атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений разделяющего ключа.

Сортировочный ключ элемента также известен как атрибут диапазона. Термин «атрибут диапазона» происходит от того, как DynamoDB хранит элементы с одинаковым разделяющим ключом физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

BillingMode -> (строка)

Режим выставления счетов для выделения ресурсов для созданной таблицы.

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

Представляет параметры пропускной способности для указанного глобального вторичного индекса. Вы должны использовать ProvisionedThroughput или OnDemandThroughput в зависимости от режима емкости вашей таблицы.

См. минимальные и максимальные значения пропускной способности в разделе «Квоты службы, учетной записи и таблицы» в руководстве разработчика Amazon DynamoDB.

ReadCapacityUnits -> (длинное целое)

Максимальное количество чтений с сильной согласованностью, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException . Дополнительные сведения см. в разделе «Указание требований к чтению и записи» в руководстве разработчика Amazon DynamoDB.

Если режим пропускной способности для чтения/записи — PAY_PER_REQUEST , значение равно 0.

WriteCapacityUnits -> (длинное целое)

Максимальное количество записей, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException . Дополнительные сведения см. в разделе «Указание требований к чтению и записи» в руководстве разработчика Amazon DynamoDB.

Если режим пропускной способности для чтения/записи — PAY_PER_REQUEST , значение равно 0.

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

Устанавливает максимальное количество единиц чтения и записи для указанной таблицы по требованию. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits , MaxWriteRequestUnits или оба.

MaxReadRequestUnits -> (длинное целое)

Максимальное количество единиц запросов на чтение для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput на вашей таблице, установите значение MaxReadRequestUnits как больше или равно 1. Чтобы удалить установленное максимальное OnDemandThroughput на вашей таблице, установите значение MaxReadRequestUnits в -1.

MaxWriteRequestUnits -> (длинное целое)

Максимальное количество единиц запросов на запись для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput на вашей таблице, установите значение MaxWriteRequestUnits как больше или равно 1. Чтобы удалить установленное максимальное OnDemandThroughput на вашей таблице, установите значение MaxWriteRequestUnits в -1.

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

Представляет параметры, используемые для включения шифрования на стороне сервера.

Enabled -> (булево)

Указывает, выполняется ли шифрование на стороне сервера с использованием управляемого Amazon Web Services ключа или ключа, принадлежащего Amazon Web Services. Если включено (true), тип шифрования на стороне сервера устанавливается в KMS и используется управляемый Amazon Web Services ключ (применяются сборы KMS). Если отключено (false) или не указано, шифрование на стороне сервера устанавливается в ключ, принадлежащий Amazon Web Services.

SSEType -> (строка)

Тип шифрования на стороне сервера. Единственное поддерживаемое значение:

  • KMS — шифрование на стороне сервера, которое использует Key Management Service. Ключ хранится в вашей учетной записи и управляется KMS (применяются сборы KMS).

KMSMasterKeyId -> (строка)

Ключ KMS, который необходимо использовать для шифрования KMS. Для указания ключа используйте его идентификатор, Amazon Resource Name (ARN), имя псевдонима или ARN псевдонима. Обратите внимание, что вы должны указать этот параметр только в том случае, если ключ отличается от стандартного ключа DynamoDB alias/aws/dynamodb .

GlobalSecondaryIndexes -> (список)

Глобальные вторичные индексы (GSI) таблицы, которые должны быть созданы в рамках операции импорта.

(структура)

Представляет свойства глобального вторичного индекса.

IndexName -> (строка)

Имя глобального вторичного индекса. Имя должно быть уникальным среди всех других индексов этой таблицы.

KeySchema -> (список)

Полная схема ключей глобального вторичного индекса, которая состоит из одного или нескольких пар имён атрибутов и типов ключей:

  • HASH - ключ разбиения
  • RANGE - сортировочный ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортировочный ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

(структура)

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

KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для ключа разбиения). Составной первичный ключ потребует одного KeySchemaElement для ключа разбиения и другого KeySchemaElement для сортировочного ключа.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть String, Number или Binary. Атрибут не может быть вложен в List или Map.

AttributeName -> (строка)

Имя ключевого атрибута.

KeyType -> (строка)

Роль, которую этот ключевой атрибут будет выполнять:

  • HASH - ключ разбиения
  • RANGE - сортировочный ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортировочный ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от способа хранения DynamoDB элементов с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортировочного ключа.

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

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

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY - В индекс проектируются только индексные и первичные ключи.
  • INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY, вторичный индекс будет включать другие неключевые атрибуты, которые вы укажете.
  • ALL - Все атрибуты таблицы проектируются в индекс.

При использовании консоли DynamoDB, ALL выбрано по умолчанию.

NonKeyAttributes -> (список)

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

Для глобальных и локальных вторичных индексов общее количество NonKeyAttributes, суммированное по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это считается двумя различными атрибутами при определении общего количества. Это ограничение применяется только тогда, когда вы указываете ProjectionType INCLUDE. Вы всё ещё можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица имеет более 100 атрибутов.

(строка)

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

Представляет настройки пропускной способности для указанного глобального вторичного индекса. Вы должны использовать либо OnDemandThroughput, либо ProvisionedThroughput, в зависимости от режима пропускной способности вашей таблицы.

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

ReadCapacityUnits -> (длинное целое)

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

Если режим пропускной способности чтение/запись - PAY_PER_REQUEST, значение установлено в 0.

WriteCapacityUnits -> (длинное целое)

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

Если режим пропускной способности чтение/запись - PAY_PER_REQUEST, значение установлено в 0.

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

Максимальное количество единиц чтения и записи для указанного глобального вторичного индекса. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба. Вы должны использовать либо OnDemandThroughput, либо ProvisionedThroughput в зависимости от режима пропускной способности вашей таблицы.

MaxReadRequestUnits -> (длинное целое)

Максимальное количество единиц запроса чтения для указанной таблицы.

Для указания максимального количества OnDemandThroughput в вашей таблице установите значение MaxReadRequestUnits как больше или равно 1. Для удаления установленного максимального количества OnDemandThroughput в вашей таблице установите значение MaxReadRequestUnits в -1.

MaxWriteRequestUnits -> (длинное целое)

Максимальное количество единиц запроса записи для указанной таблицы.

Для указания максимального количества OnDemandThroughput в вашей таблице установите значение MaxWriteRequestUnits как больше или равно 1. Для удаления установленного максимального количества OnDemandThroughput в вашей таблице установите значение MaxWriteRequestUnits в -1.

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

Представляет значение тепловой пропускной способности (в единицах чтения в секунду и записи в секунду) для указанного вторичного индекса. Если вы используете этот параметр, вы должны указать ReadUnitsPerSecond, WriteUnitsPerSecond или оба.

ReadUnitsPerSecond -> (длинное целое)

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

WriteUnitsPerSecond -> (длинное целое)

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

Синтаксис JSON:

{
  "TableName": "string",
  "AttributeDefinitions": [
    {
      "AttributeName": "string",
      "AttributeType": "S"|"N"|"B"
    }
    ...
  ],
  "KeySchema": [
    {
      "AttributeName": "string",
      "KeyType": "HASH"|"RANGE"
    }
    ...
  ],
  "BillingMode": "PROVISIONED"|"PAY_PER_REQUEST",
  "ProvisionedThroughput": {
    "ReadCapacityUnits": long,
    "WriteCapacityUnits": long
  },
  "OnDemandThroughput": {
    "MaxReadRequestUnits": long,
    "MaxWriteRequestUnits": long
  },
  "SSESpecification": {
    "Enabled": true|false,
    "SSEType": "AES256"|"KMS",
    "KMSMasterKeyId": "string"
  },
  "GlobalSecondaryIndexes": [
    {
      "IndexName": "string",
      "KeySchema": [
        {
          "AttributeName": "string",
          "KeyType": "HASH"|"RANGE"
        }
        ...
      ],
      "Projection": {
        "ProjectionType": "ALL"|"KEYS_ONLY"|"INCLUDE",
        "NonKeyAttributes": ["string", ...]
      },
      "ProvisionedThroughput": {
        "ReadCapacityUnits": long,
        "WriteCapacityUnits": long
      },
      "OnDemandThroughput": {
        "MaxReadRequestUnits": long,
        "MaxWriteRequestUnits": long
      },
      "WarmThroughput": {
        "ReadUnitsPerSecond": long,
        "WriteUnitsPerSecond": long
      }
    }
    ...
  ]
}

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

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

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

--debug (логическое)

Включить отладочный вывод.

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

Вывод

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

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

ImportArn -> (строка)

Amazon Resource Number (ARN), соответствующий запросу на импорт.

ImportStatus -> (строка)

Статус импорта.

TableArn -> (строка)

Amazon Resource Number (ARN) таблицы, в которую выполняется импорт.

TableId -> (строка)

Идентификатор таблицы, соответствующий таблице, созданной в процессе импорта таблицы.

ClientToken -> (строка)

Маркер клиента, предоставленный для задачи импорта. Повторное использование маркера клиента при повторной попытке делает вызов ImportTable идемпотентным.

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

Значения для S3-ведра, из которого импортируется исходный файл. Включает имя ведра (обязательно), префикс ключа (необязательно) и идентификатор владельца учетной записи ведра (необязательно).

S3BucketOwner -> (строка)

Номер учетной записи S3-ведра, из которого выполняется импорт. Если ведро принадлежит запросившему, это необязательно.

S3Bucket -> (строка)

S3-ведро, из которого выполняется импорт.

S3KeyPrefix -> (строка)

Префикс ключа, общий для всех объектов S3, которые импортируются.

ErrorCount -> (целое число)

Количество ошибок, возникших при импорте исходного файла в целевую таблицу.

CloudWatchLogGroupArn -> (строка)

Amazon Resource Number (ARN) группы журналов CloudWatch, связанной с целевой таблицей.

InputFormat -> (строка)

Формат исходных данных, попадающих в целевую таблицу.

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

Параметры формата данных, импортированных в целевую таблицу. Есть одно значение: CsvOption.

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

Параметры импортированных исходных файлов в формате CSV. Значения: Delimiter и HeaderList.

Delimiter -> (строка)

Разделитель, используемый для разделения элементов в импортируемом CSV-файле.

HeaderList -> (список)

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

(строка)

InputCompressionType -> (строка)

Параметры сжатия данных, импортированных в целевую таблицу. Допустимые значения: NONE, GZIP или ZSTD.

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

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

TableName -> (строка)

Имя таблицы, созданной в рамках операции импорта.

AttributeDefinitions -> (список)

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

(структура)

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

AttributeName -> (строка)

Имя атрибута.

AttributeType -> (строка)

Тип данных атрибута:

  • S - атрибут типа Строка
  • N - атрибут типа Число
  • B - атрибут типа Двоичный

KeySchema -> (список)

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

(структура)

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

Один KeySchemaElement представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для партиционного ключа). Составной первичный ключ потребует одного KeySchemaElement для партиционного ключа и другого KeySchemaElement для сортировочного ключа.

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть одним из String, Number или Binary. Атрибут не может быть вложенным в список или карту.

AttributeName -> (строка)

Имя атрибута ключа.

KeyType -> (строка)

Роль, которую этот атрибут ключа будет выполнять:

  • HASH - партиционный ключ
  • RANGE - сортировочный ключ

Примечание

Партиционный ключ элемента также известен как его хэш-атрибут. Термин «хэш-атрибут» происходит от использования DynamoDB внутренней хэш-функции для равномерного распределения элементов данных по разделам на основе значений их партиционного ключа.

Сортировочный ключ элемента также известен как его диапазонный атрибут. Термин «диапазонный атрибут» происходит от способа, которым DynamoDB хранит элементы с одинаковым партиционным ключом физически близко друг к другу в отсортированном порядке по значениям сортировочного ключа.

BillingMode -> (строка)

Режим выставления счетов для выделения ресурсов таблицы, созданной в рамках операции импорта.

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

Представляет параметры пропускной способности выделенных ресурсов для указанного глобального вторичного индекса. Вы должны использовать ProvisionedThroughput или OnDemandThroughput в зависимости от режима емкости вашей таблицы.

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

ReadCapacityUnits -> (целое число)

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

Если режим емкости чтения/записи равен PAY_PER_REQUEST, значение устанавливается в 0.

WriteCapacityUnits -> (целое число)

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

Если режим емкости чтения/записи равен PAY_PER_REQUEST, значение устанавливается в 0.

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

Устанавливает максимальное количество единиц чтения и записи для указанной таблицы по требованию. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба.

MaxReadRequestUnits -> (целое число)

Максимальное количество единиц запросов на чтение для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput для вашей таблицы, установите значение MaxReadRequestUnits как не меньше 1. Чтобы удалить установленное максимальное OnDemandThroughput для вашей таблицы, установите значение MaxReadRequestUnits в -1.

MaxWriteRequestUnits -> (целое число)

Максимальное количество единиц запросов на запись для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits как не меньше 1. Чтобы удалить установленное максимальное OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits в -1.

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

Представляет параметры, используемые для включения шифрования на стороне сервера.

Enabled -> (булево)

Указывает, выполняется ли шифрование на стороне сервера с использованием управляемого Amazon Web Services ключа или ключа Amazon Web Services. Если включено (true), тип шифрования на стороне сервера установлен на KMS и используется управляемый Amazon Web Services ключ (применяются платы KMS). Если отключено (false) или не указано, шифрование на стороне сервера установлено на ключ Amazon Web Services.

SSEType -> (строка)

Тип шифрования на стороне сервера. Поддерживается только одно значение:

  • KMS - Шифрование на стороне сервера, использующее Key Management Service. Ключ хранится в вашей учетной записи и управляется KMS (применяются платы KMS).

KMSMasterKeyId -> (строка)

Ключ KMS, который должен использоваться для шифрования KMS. Для указания ключа используйте его идентификатор ключа, Amazon Resource Name (ARN), имя псевдонима или ARN псевдонима. Обратите внимание, что вы должны указать этот параметр только в том случае, если ключ отличается от стандартного ключа DynamoDB alias/aws/dynamodb.

GlobalSecondaryIndexes -> (список)

Глобальные вторичные индексы (GSI) таблицы, которая создаётся в ходе операции импорта.

(структура)

Представляет свойства глобального вторичного индекса.

IndexName -> (строка)

Имя глобального вторичного индекса. Имя должно быть уникальным среди всех других индексов в этой таблице.

KeySchema -> (список)

Полная схема ключей глобального вторичного индекса, которая состоит из одной или нескольких пар имён атрибутов и типов ключей:

  • HASH — ключ разбиения
  • RANGE — сортирующий ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней функции хеширования для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортирующий ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от того, как DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортирующего ключа.

(структура)

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

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

KeySchemaElement должен быть скалярным атрибутом верхнего уровня (не вложенным атрибутом). Тип данных должен быть одним из String, Number или Binary. Атрибут не может быть вложенным в List или Map.

AttributeName -> (строка)

Имя ключевого атрибута.

KeyType -> (строка)

Роль, которую будет выполнять этот ключевой атрибут:

  • HASH — ключ разбиения
  • RANGE — сортирующий ключ

Примечание

Ключ разбиения элемента также известен как его атрибут хеширования. Термин «атрибут хеширования» происходит от использования DynamoDB внутренней функции хеширования для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

Сортирующий ключ элемента также известен как его атрибут диапазона. Термин «атрибут диапазона» происходит от того, как DynamoDB хранит элементы с одинаковым ключом разбиения физически близко друг к другу в отсортированном порядке по значению сортирующего ключа.

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

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

ProjectionType -> (строка)

Набор атрибутов, которые проектируются в индекс:

  • KEYS_ONLY — Проектируются только ключ индекса и первичный ключ.
  • INCLUDE — В дополнение к атрибутам, описанным в KEYS_ONLY, вторичный индекс будет включать другие неключевые атрибуты, которые вы укажете.
  • ALL — Все атрибуты таблицы проектируются в индекс.

При использовании консоли DynamoDB по умолчанию выбирается ALL.

NonKeyAttributes -> (список)

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

Для глобальных и локальных вторичных индексов суммарное количество NonKeyAttributes по всем вторичным индексам не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это считается двумя разными атрибутами при определении общего количества. Это ограничение действует только когда вы указываете ProjectionType INCLUDE. Вы по-прежнему можете указать ProjectionType ALL, чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.

(строка)

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

Представляет параметры пропускной способности для указанного глобального вторичного индекса. Вы должны использовать либо OnDemandThroughput, либо ProvisionedThroughput в зависимости от режима пропускной способности вашей таблицы.

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

ReadCapacityUnits -> (целое число)

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

Если режим пропускной способности чтения/записи — PAY_PER_REQUEST, значение устанавливается в 0.

WriteCapacityUnits -> (целое число)

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

Если режим пропускной способности чтения/записи — PAY_PER_REQUEST, значение устанавливается в 0.

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

Максимальное количество единиц чтения и записи для указанного глобального вторичного индекса. Если вы используете этот параметр, вы должны указать MaxReadRequestUnits, MaxWriteRequestUnits или оба. Вы должны использовать либо OnDemandThroughput, либо ProvisionedThroughput в зависимости от режима пропускной способности вашей таблицы.

MaxReadRequestUnits -> (целое число)

Максимальное количество единиц запросов на чтение для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput для вашей таблицы, установите значение MaxReadRequestUnits как большее или равное 1. Чтобы удалить установленное максимальное OnDemandThroughput вашей таблицы, установите значение MaxReadRequestUnits в -1.

MaxWriteRequestUnits -> (целое число)

Максимальное количество единиц запросов на запись для указанной таблицы.

Чтобы указать максимальное OnDemandThroughput для вашей таблицы, установите значение MaxWriteRequestUnits как большее или равное 1. Чтобы удалить установленное максимальное OnDemandThroughput вашей таблицы, установите значение MaxWriteRequestUnits в -1.

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

Представляет значение тёплой пропускной способности (в единицах чтения в секунду и записи в секунду) для указанного вторичного индекса. Если вы используете этот параметр, вы должны указать ReadUnitsPerSecond, WriteUnitsPerSecond или оба.

ReadUnitsPerSecond -> (целое число)

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

WriteUnitsPerSecond -> (целое число)

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

StartTime -> (метка времени)

Время начала этой задачи импорта.

EndTime -> (метка времени)

Время завершения создания таблицы, связанной с этой задачей импорта.

ProcessedSizeBytes -> (целое число)

Общий размер данных, обработанных из исходного файла, в байтах.

ProcessedItemCount -> (целое число)

Общее количество элементов, обработанных из исходного файла.

ImportedItemCount -> (целое число)

Количество элементов, успешно импортированных в новую таблицу.

FailureCode -> (строка)

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

FailureMessage -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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