create-table

Описание

Операция CreateTable добавляет новую таблицу в вашу учётную запись. В учетной записи Amazon Web Services имена таблиц должны быть уникальными в каждом регионе. То есть, у вас могут быть две таблицы с одинаковым именем, если вы создадите их в разных регионах.

CreateTable — это асинхронная операция. При получении запроса CreateTable DynamoDB немедленно возвращает ответ с TableStatus значения CREATING. После создания таблицы DynamoDB устанавливает TableStatus в ACTIVE. Вы можете выполнять операции чтения и записи только для ACTIVE таблицы.

Вы можете необязательно определить вторичные индексы в новой таблице в рамках операции CreateTable. Если вы хотите создать несколько таблиц со вторичными индексами, вы должны создавать таблицы последовательно. Только одна таблица со вторичными индексами может находиться в состоянии CREATING в любой момент времени.

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

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

Синтаксис

  create-table
--attribute-definitions <value>
--table-name <value>
--key-schema <value>
[--local-secondary-indexes <value>]
[--global-secondary-indexes <value>]
[--billing-mode <value>]
[--provisioned-throughput <value>]
[--stream-specification <value>]
[--sse-specification <value>]
[--tags <value>]
[--table-class <value>]
[--deletion-protection-enabled | --no-deletion-protection-enabled]
[--warm-throughput <value>]
[--resource-policy <value>]
[--on-demand-throughput <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]

Параметры

--attribute-definitions (список)

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

(структура)

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

AttributeName -> (строка)

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

AttributeType -> (строка)

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

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

Сокращенная синтаксическая запись:

AttributeName=string,AttributeType=string ...

Синтаксис JSON:

[
  {
    "AttributeName": "string",
    "AttributeType": "S"|"N"|"B"
  }
  ...
]

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

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

--key-schema (список)

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

Каждый элемент KeySchemaElement в массиве состоит из:

AttributeName - Имя этого атрибута ключа.
KeyType - Роль, которую атрибут ключа будет выполнять:
- HASH - партиционный ключ
- RANGE - сортировочный ключ

Примечание

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

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

Для простого первичного ключа (партиционного ключа) вы должны указать ровно один элемент с KeyType равным HASH.

Для составного первичного ключа (партиционный и сортировочный ключ) вы должны указать ровно два элемента в этом порядке: первый элемент должен иметь KeyType равным HASH, а второй элемент должен иметь KeyType равным RANGE.

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

(структура)

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

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

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

Сокращенная синтаксическая запись:

AttributeName=string,KeyType=string ...

Синтаксис JSON:

[
  {
    "AttributeName": "string",
    "KeyType": "HASH"|"RANGE"
  }
  ...
]

--local-secondary-indexes (список)

Один или несколько локальных вторичных индексов (максимум 5) для создания в таблице. Каждый индекс ограничен определённым значением партиционного ключа. Есть лимит 10 ГБ на значение партиционного ключа; в противном случае размер локального вторичного индекса не ограничен.

Каждый локальный вторичный индекс в массиве включает следующее:

IndexName - Имя локального вторичного индекса. Должно быть уникальным только для этой таблицы.
KeySchema - Определяет схему ключей для локального вторичного индекса. Схема ключей должна начинаться с того же партиционного ключа, что и таблица.
Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Это помимо атрибутов первичного ключа и ключа индекса, которые автоматически проектируются. Каждое указание атрибута состоит из:
- ProjectionType - Один из следующих:
  - KEYS_ONLY - В индекс будут проецироваться только индекс и первичные ключи.
  - INCLUDE - В индекс будут проецироваться только указанные атрибуты таблицы. Список проецируемых атрибутов находится в NonKeyAttributes.
  - ALL - В индекс будут проецироваться все атрибуты таблицы.
- NonKeyAttributes - Список одного или более имён атрибутов, не являющихся ключами, которые будут проецированы во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes, суммарно по всем вторичным индексам, не должно превышать 100. Если вы проецируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего числа. Это ограничение применяется только когда вы указываете ProjectionType в INCLUDE. Вы по-прежнему можете указать ProjectionType в ALL для проецирования всех атрибутов из исходной таблицы, даже если таблица содержит более 100 атрибутов.

(структура)

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

IndexName -> (строка)

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

KeySchema -> (список)

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

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

Примечание

(структура)

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

ProjectionType -> (строка)

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

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

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

NonKeyAttributes -> (список)

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

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

(строка)

Сокращенная синтаксическая запись:

IndexName=string,KeySchema=[{AttributeName=string,KeyType=string},{AttributeName=string,KeyType=string}],Projection={ProjectionType=string,NonKeyAttributes=[string,string]} ...

Синтаксис JSON:

[
  {
    "IndexName": "string",
    "KeySchema": [
      {
        "AttributeName": "string",
        "KeyType": "HASH"|"RANGE"
      }
      ...
    ],
    "Projection": {
      "ProjectionType": "ALL"|"KEYS_ONLY"|"INCLUDE",
      "NonKeyAttributes": ["string", ...]
    }
  }
  ...
]

--global-secondary-indexes (список)

Один или несколько глобальных вторичных индексов (максимум 20) для создания на таблице. Каждый глобальный вторичный индекс в массиве включает следующее:

IndexName - Название глобального вторичного индекса. Должно быть уникальным только для этой таблицы.
KeySchema - Указывает схему ключа для глобального вторичного индекса.
Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Это дополнительно к атрибутам первичного ключа и ключам индекса, которые автоматически проектируются. Каждая спецификация атрибута состоит из:
- ProjectionType - Один из следующих:
  - KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
  - INCLUDE - В индекс проектируются только указанные атрибуты таблицы. Список спроектированных атрибутов находится в NonKeyAttributes .
  - ALL - В индекс проектируются все атрибуты таблицы.
- NonKeyAttributes - Список одного или нескольких имён атрибутов, не являющихся ключами, которые проектируются во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение применяется только при указании типа проекции INCLUDE . Вы по-прежнему можете указать тип проекции ALL, чтобы спроектировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
ProvisionedThroughput - Параметры выделенного пропускной способности для глобального вторичного индекса, состоящие из единиц пропускной способности для чтения и записи.

(структура)

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

IndexName -> (строка)

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

KeySchema -> (список)

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

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

Примечание

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

(структура)

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

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

ProjectionType -> (строка)

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

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

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

NonKeyAttributes -> (список)

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

Для глобальных и локальных вторичных индексов общее количество NonKeyAttributes, суммарно по всем вторичным индексам, не должно превышать 100. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение применяется только при указании типа проекции INCLUDE. Вы по-прежнему можете указать тип проекции 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 -> (целое число)

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

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

IndexName=string,KeySchema=[{AttributeName=string,KeyType=string},{AttributeName=string,KeyType=string}],Projection={ProjectionType=string,NonKeyAttributes=[string,string]},ProvisionedThroughput={ReadCapacityUnits=long,WriteCapacityUnits=long},OnDemandThroughput={MaxReadRequestUnits=long,MaxWriteRequestUnits=long},WarmThroughput={ReadUnitsPerSecond=long,WriteUnitsPerSecond=long} ...

Синтаксис JSON:

[
  {
    "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
    }
  }
  ...
]

--billing-mode (строка)

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

PAY_PER_REQUEST - Мы рекомендуем использовать PAY_PER_REQUEST для большинства рабочих нагрузок DynamoDB. PAY_PER_REQUEST устанавливает режим выставления счетов на режим спроса.
PROVISIONED - Мы рекомендуем использовать PROVISIONED для стабильных рабочих нагрузок с предсказуемым ростом, где потребности в пропускной способности можно надёжно спрогнозировать. PROVISIONED устанавливает режим выставления счетов на режим с выделенной пропускной способностью.

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

PROVISIONED
PAY_PER_REQUEST

--provisioned-throughput (структура)

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

Если вы установите BillingMode как PROVISIONED, вы должны указать этот параметр. Если вы установите BillingMode как PAY_PER_REQUEST, вы не можете указать этот параметр.

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

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

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

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

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

ReadCapacityUnits=long,WriteCapacityUnits=long

Синтаксис JSON:

{
  "ReadCapacityUnits": long,
  "WriteCapacityUnits": long
}

--stream-specification (структура)

Настройки DynamoDB Streams для таблицы. Эти настройки включают:

StreamEnabled - Указывает, включено (true) или выключено (false) DynamoDB Streams.
StreamViewType - При изменении элемента в таблице, StreamViewType определяет, какая информация записывается в поток таблицы. Допустимые значения для StreamViewType:
- KEYS_ONLY - В поток записываются только ключевые атрибуты изменённого элемента.
- NEW_IMAGE - В поток записывается весь элемент в виде, в котором он был после изменения.
- OLD_IMAGE - В поток записывается весь элемент в виде, в котором он был до изменения.
- NEW_AND_OLD_IMAGES - В поток записываются оба состояния элемента: новый и старый.

StreamEnabled -> (boolean)

Указывает, включено (true) или выключено (false) DynamoDB Streams для таблицы.

StreamViewType -> (string)

При изменении элемента в таблице, StreamViewType определяет, какая информация записывается в поток для этой таблицы. Допустимые значения для StreamViewType:

KEYS_ONLY - В поток записываются только ключевые атрибуты изменённого элемента.
NEW_IMAGE - В поток записывается весь элемент в виде, в котором он был после изменения.
OLD_IMAGE - В поток записывается весь элемент в виде, в котором он был до изменения.
NEW_AND_OLD_IMAGES - В поток записываются оба состояния элемента: новый и старый.

Сокращенная форма записи:

StreamEnabled=boolean,StreamViewType=string

Формат JSON:

{
  "StreamEnabled": true|false,
  "StreamViewType": "NEW_IMAGE"|"OLD_IMAGE"|"NEW_AND_OLD_IMAGES"|"KEYS_ONLY"
}

--sse-specification (структура)

Представляет настройки для включения шифрования на стороне сервера.

Enabled -> (boolean)

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

SSEType -> (string)

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

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

KMSMasterKeyId -> (string)

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

Сокращенная форма записи:

Enabled=boolean,SSEType=string,KMSMasterKeyId=string

Формат JSON:

{
  "Enabled": true|false,
  "SSEType": "AES256"|"KMS",
  "KMSMasterKeyId": "string"
}

--tags (список)

Список пар ключ-значение для маркировки таблицы. Дополнительную информацию см. в разделе Маркировка для DynamoDB .

(структура)

Описывает метку. Метка — это пара ключ-значение. Вы можете добавить до 50 меток к одной таблице DynamoDB.

Назначенные Amazon Web Services имена и значения меток автоматически получают префикс aws:, который пользователь не может назначить. Назначенные Amazon Web Services имена меток не учитываются при подсчете лимита в 50. Имена меток, назначенные пользователем, имеют префикс user: в отчете об распределении затрат. Применить метку нельзя после её создания.

Обзор маркировки ресурсов DynamoDB см. в разделе Маркировка для DynamoDB в руководстве разработчика Amazon DynamoDB.

Key -> (string)

Ключ метки. Ключи меток чувствительны к регистру. В каждой таблице DynamoDB может быть не более одной метки с тем же ключом. Если вы пытаетесь добавить существующую метку (с тем же ключом), значение существующей метки будет обновлено на новое значение.

Value -> (string)

Значение метки. Значения меток чувствительны к регистру и могут быть нулевыми.

Сокращенная форма записи:

Key=string,Value=string ...

Формат JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

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

Класс таблицы новой таблицы. Допустимые значения — STANDARD и STANDARD_INFREQUENT_ACCESS.

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

STANDARD
STANDARD_INFREQUENT_ACCESS

--deletion-protection-enabled | --no-deletion-protection-enabled (boolean)

Указывает, включена (true) или выключена (false) защита от удаления таблицы.

--warm-throughput (структура)

Представляет тепловой пропускной способности (в единицах чтения в секунду и записи в секунду) для создания таблицы.

ReadUnitsPerSecond -> (long)

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

WriteUnitsPerSecond -> (long)

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

Сокращенная форма записи:

ReadUnitsPerSecond=long,WriteUnitsPerSecond=long

Формат JSON:

{
  "ReadUnitsPerSecond": long,
  "WriteUnitsPerSecond": long
}

--resource-policy (строка)

Политика Amazon Web Services на основе ресурсов в формате JSON, которая будет прикреплена к таблице.

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

Максимальный размер документа политики на основе ресурсов — 20 КБ. DynamoDB учитывает пробелы при расчете размера политики по отношению к этому ограничению. Полный список всех требований, которые применяются к политикам на основе ресурсов, см. в разделе Рассмотрение политик на основе ресурсов.

Примечание

Вам необходимо указать CreateTable и PutResourcePolicy действия IAM для разрешения пользователю создавать таблицу с политикой на основе ресурсов.

--on-demand-throughput (структура)

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

MaxReadRequestUnits -> (long)

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

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

MaxWriteRequestUnits -> (long)

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

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

Сокращенная форма записи:

MaxReadRequestUnits=long,MaxWriteRequestUnits=long

Формат JSON:

{
  "MaxReadRequestUnits": long,
  "MaxWriteRequestUnits": 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 (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.

Примеры

Примечание

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

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

Пример 1. Создание таблицы с тегами

Следующий create-table пример использует указанные атрибуты и схему ключей для создания таблицы с именем MusicCollection. Эта таблица использует предоставленную пропускную способность и зашифрована в состоянии покоя с использованием CMK, принадлежащего AWS, по умолчанию. Команда также применяет тег к таблице с ключом Owner и значением blueTeam.

aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
    --tags Key=Owner,Value=blueTeam

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "WriteCapacityUnits": 5,
            "ReadCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "TableName": "MusicCollection",
        "TableStatus": "CREATING",
        "KeySchema": [
            {
                "KeyType": "HASH",
                "AttributeName": "Artist"
            },
            {
                "KeyType": "RANGE",
                "AttributeName": "SongTitle"
            }
        ],
        "ItemCount": 0,
        "CreationDateTime": "2020-05-26T16:04:41.627000-07:00",
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 2. Создание таблицы в режиме по требованию

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

aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --billing-mode PAY_PER_REQUEST

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "TableName": "MusicCollection",
        "KeySchema": [
            {
                "AttributeName": "Artist",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "SongTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-05-27T11:44:10.807000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 0,
            "WriteCapacityUnits": 0
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "BillingModeSummary": {
            "BillingMode": "PAY_PER_REQUEST"
        }
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 3. Создание таблицы и ее шифрование с помощью CMK, управляемого клиентом

В следующем примере создается таблица с именем MusicCollection и шифруется с помощью CMK, управляемого клиентом.

aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
    --sse-specification Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "TableName": "MusicCollection",
        "KeySchema": [
            {
                "AttributeName": "Artist",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "SongTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-05-27T11:12:16.431000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 5,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "SSEDescription": {
            "Status": "ENABLED",
            "SSEType": "KMS",
            "KMSMasterKeyArn": "arn:aws:kms:us-west-2:123456789012:key/abcd1234-abcd-1234-a123-ab1234a1b234"
        }
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 4. Создание таблицы с локальным вторичным индексом

В следующем примере используются указанные атрибуты и схема ключей для создания таблицы с именем MusicCollection с локальным вторичным индексом с именем AlbumTitleIndex.

aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S AttributeName=AlbumTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --local-secondary-indexes \
        "[
            {
                \"IndexName\": \"AlbumTitleIndex\",
                \"KeySchema\": [
                    {\"AttributeName\": \"Artist\",\"KeyType\":\"HASH\"},
                    {\"AttributeName\": \"AlbumTitle\",\"KeyType\":\"RANGE\"}
                ],
                \"Projection\": {
                    \"ProjectionType\": \"INCLUDE\",
                    \"NonKeyAttributes\": [\"Genre\", \"Year\"]
                }
            }
        ]"

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "AlbumTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "TableName": "MusicCollection",
        "KeySchema": [
            {
                "AttributeName": "Artist",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "SongTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-05-26T15:59:49.473000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "LocalSecondaryIndexes": [
            {
                "IndexName": "AlbumTitleIndex",
                "KeySchema": [
                    {
                        "AttributeName": "Artist",
                        "KeyType": "HASH"
                    },
                    {
                        "AttributeName": "AlbumTitle",
                        "KeyType": "RANGE"
                    }
                ],
                "Projection": {
                    "ProjectionType": "INCLUDE",
                    "NonKeyAttributes": [
                        "Genre",
                        "Year"
                    ]
                },
                "IndexSizeBytes": 0,
                "ItemCount": 0,
                "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection/index/AlbumTitleIndex"
            }
        ]
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 5. Создание таблицы с глобальным вторичным индексом

В следующем примере создается таблица с именем GameScores с глобальным вторичным индексом с именем GameTitleIndex. Базовая таблица имеет ключ раздела UserId и ключ сортировки GameTitle, что позволяет эффективно находить лучший результат отдельного пользователя для определенной игры, в то время как GSI имеет ключ раздела GameTitle и ключ сортировки TopScore, что позволяет быстро находить общий самый высокий результат для конкретной игры.

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S AttributeName=TopScore,AttributeType=N \
    --key-schema AttributeName=UserId,KeyType=HASH \
                AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --global-secondary-indexes \
        "[
            {
                \"IndexName\": \"GameTitleIndex\",
                \"KeySchema\": [
                    {\"AttributeName\":\"GameTitle\",\"KeyType\":\"HASH\"},
                    {\"AttributeName\":\"TopScore\",\"KeyType\":\"RANGE\"}
                ],
                \"Projection\": {
                    \"ProjectionType\":\"INCLUDE\",
                    \"NonKeyAttributes\":[\"UserId\"]
                },
                \"ProvisionedThroughput\": {
                    \"ReadCapacityUnits\": 10,
                    \"WriteCapacityUnits\": 5
                }
            }
        ]"

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "TopScore",
                "AttributeType": "N"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-05-26T17:28:15.602000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "GlobalSecondaryIndexes": [
            {
                "IndexName": "GameTitleIndex",
                "KeySchema": [
                    {
                        "AttributeName": "GameTitle",
                        "KeyType": "HASH"
                    },
                    {
                        "AttributeName": "TopScore",
                        "KeyType": "RANGE"
                    }
                ],
                "Projection": {
                    "ProjectionType": "INCLUDE",
                    "NonKeyAttributes": [
                        "UserId"
                    ]
                },
                "IndexStatus": "CREATING",
                "ProvisionedThroughput": {
                    "NumberOfDecreasesToday": 0,
                    "ReadCapacityUnits": 10,
                    "WriteCapacityUnits": 5
                },
                "IndexSizeBytes": 0,
                "ItemCount": 0,
                "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameTitleIndex"
            }
        ]
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 6. Создание таблицы с несколькими глобальными вторичными индексами одновременно

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

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S AttributeName=TopScore,AttributeType=N AttributeName=Date,AttributeType=S \
    --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --global-secondary-indexes file://gsi.json

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

[
    {
        "IndexName": "GameTitleIndex",
        "KeySchema": [
            {
                "AttributeName": "GameTitle",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "TopScore",
                "KeyType": "RANGE"
            }
        ],
        "Projection": {
            "ProjectionType": "ALL"
        },
        "ProvisionedThroughput": {
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        }
    },
    {
        "IndexName": "GameDateIndex",
        "KeySchema": [
            {
                "AttributeName": "GameTitle",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "Date",
                "KeyType": "RANGE"
            }
        ],
        "Projection": {
            "ProjectionType": "ALL"
        },
        "ProvisionedThroughput": {
            "ReadCapacityUnits": 5,
            "WriteCapacityUnits": 5
        }
    }
]

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Date",
                "AttributeType": "S"
            },
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "TopScore",
                "AttributeType": "N"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-08-04T16:40:55.524000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "GlobalSecondaryIndexes": [
            {
                "IndexName": "GameTitleIndex",
                "KeySchema": [
                    {
                        "AttributeName": "GameTitle",
                        "KeyType": "HASH"
                    },
                    {
                        "AttributeName": "TopScore",
                        "KeyType": "RANGE"
                    }
                ],
                "Projection": {
                    "ProjectionType": "ALL"
                },
                "IndexStatus": "CREATING",
                "ProvisionedThroughput": {
                    "NumberOfDecreasesToday": 0,
                    "ReadCapacityUnits": 10,
                    "WriteCapacityUnits": 5
                },
                "IndexSizeBytes": 0,
                "ItemCount": 0,
                "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameTitleIndex"
            },
            {
                "IndexName": "GameDateIndex",
                "KeySchema": [
                    {
                        "AttributeName": "GameTitle",
                        "KeyType": "HASH"
                    },
                    {
                        "AttributeName": "Date",
                        "KeyType": "RANGE"
                    }
                ],
                "Projection": {
                    "ProjectionType": "ALL"
                },
                "IndexStatus": "CREATING",
                "ProvisionedThroughput": {
                    "NumberOfDecreasesToday": 0,
                    "ReadCapacityUnits": 5,
                    "WriteCapacityUnits": 5
                },
                "IndexSizeBytes": 0,
                "ItemCount": 0,
                "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/index/GameDateIndex"
            }
        ]
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 7. Создание таблицы с включенными потоками

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

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \
    --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --stream-specification StreamEnabled=TRUE,StreamViewType=NEW_AND_OLD_IMAGES

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2020-05-27T10:49:34.056000-07:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "StreamSpecification": {
            "StreamEnabled": true,
            "StreamViewType": "NEW_AND_OLD_IMAGES"
        },
        "LatestStreamLabel": "2020-05-27T17:49:34.056",
        "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/stream/2020-05-27T17:49:34.056"
    }
}

Более подробную информацию см. в разделе Основные операции для таблиц в Руководстве разработчика Amazon DynamoDB.

Пример 8. Создание таблицы с включенным потоком только с ключами

В следующем примере создается таблица с именем GameScores с включенными потоками DynamoDB. Только атрибуты ключей измененных элементов записываются в поток.

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \
    --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --stream-specification StreamEnabled=TRUE,StreamViewType=KEYS_ONLY

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2023-05-25T18:45:34.140000+00:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "StreamSpecification": {
            "StreamEnabled": true,
            "StreamViewType": "KEYS_ONLY"
        },
        "LatestStreamLabel": "2023-05-25T18:45:34.140",
        "LatestStreamArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores/stream/2023-05-25T18:45:34.140",
        "DeletionProtectionEnabled": false
    }
}

Более подробную информацию см. в разделе Capture данных об изменениях для потоков DynamoDB в Руководстве разработчика Amazon DynamoDB.

Пример 9. Создание таблицы со стандартным классом нечастого доступа

В следующем примере создается таблица с именем GameScores и присваивается класс таблицы Standard-Infrequent Access (DynamoDB Standard-IA). Этот класс таблиц оптимизирован для хранения данных, являющихся основным фактором затрат.

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \
    --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --table-classSTANDARD_INFREQUENT_ACCESS

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2023-05-25T18:33:07.581000+00:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "TableClassSummary": {
            "TableClass": "STANDARD_INFREQUENT_ACCESS"
        },
        "DeletionProtectionEnabled": false
    }
}

Более подробную информацию см. в разделе Классы таблиц в Руководстве разработчика Amazon DynamoDB.

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

В следующем примере создается таблица с именем GameScores и включается защита от удаления.

aws dynamodb create-table \
    --table-name GameScores \
    --attribute-definitions AttributeName=UserId,AttributeType=S AttributeName=GameTitle,AttributeType=S \
    --key-schema AttributeName=UserId,KeyType=HASH AttributeName=GameTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --deletion-protection-enabled

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "GameTitle",
                "AttributeType": "S"
            },
            {
                "AttributeName": "UserId",
                "AttributeType": "S"
            }
        ],
        "TableName": "GameScores",
        "KeySchema": [
            {
                "AttributeName": "UserId",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "GameTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": "2023-05-25T23:02:17.093000+00:00",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 10,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/GameScores",
        "TableId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "DeletionProtectionEnabled": true
    }
}

Более подробную информацию см. в разделе Использование защиты от удаления в Руководстве разработчика Amazon DynamoDB.

Вывод

ОписаниеТаблицы -> (структура)

Представляет свойства таблицы.

ОпределенияАтрибутов -> (список)

Массив объектов AttributeDefinition. Каждый из этих объектов описывает один атрибут в таблице и схему индекса ключа.

Каждый объект AttributeDefinition в этом массиве состоит из:

AttributeName - Имя атрибута.
AttributeType - Тип данных для атрибута.

(структура)

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

ИмяАтрибута -> (строка)

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

ТипАтрибута -> (строка)

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

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

ИмяТаблицы -> (строка)

Имя таблицы.

СхемаКлючей -> (список)

Структура первичного ключа таблицы. Каждый KeySchemaElement состоит из:

AttributeName - Имя атрибута.
KeyType - Роль атрибута:
- HASH - ключ разбиения
- RANGE - сортирующий ключ

Примечание

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

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

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

(структура)

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

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

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

ИмяАтрибута -> (строка)

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

ТипКлюча -> (строка)

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

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

Примечание

СтатусТаблицы -> (строка)

Текущее состояние таблицы:

CREATING - таблица создается.
UPDATING - конфигурация таблицы/индекса обновляется. Таблица/индекс остаются доступными для операций с данными, когда UPDATING.
DELETING - таблица удаляется.
ACTIVE - таблица готова к использованию.
INACCESSIBLE_ENCRYPTION_CREDENTIALS - ключ KMS, используемый для шифрования таблицы, недоступен. Операции с таблицей могут завершиться ошибкой из-за невозможности использовать ключ KMS. DynamoDB инициирует процесс архивации таблицы, если ключ KMS таблицы остается недоступным более семи дней.
ARCHIVING - таблица архивируется. Операции недоступны до завершения архивации.
ARCHIVED - таблица архивирована. Дополнительную информацию см. в поле ПричинаАрхивации.

ДатаСоздание -> (временная метка)

Дата и время создания таблицы в формате временной метки Unix.

ПропускнаяСпособность -> (структура)

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

ПоследнееУвеличение -> (временная метка)

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

ПоследнееУменьшение -> (временная метка)

Дата и время последнего уменьшения пропускной способности для этой таблицы.

КоличествоУменьшенийСегодня -> (длинное)

Количество уменьшений пропускной способности для этой таблицы в течение текущего календарного дня UTC. Максимальные значения уменьшений пропускной способности см. в разделе «Лимиты сервиса, учетной записи и таблицы» в руководстве разработчика Amazon DynamoDB.

ЕдиницыПропускнойСпособностиЧтения -> (длинное)

Максимальное количество чтений с сильной консистентностью, потребляемых в секунду, прежде чем DynamoDB вернет ThrottlingException. Чтения с нестрогой консистентностью требуют меньших усилий, чем чтения с сильной консистентностью, поэтому значение 50 ReadCapacityUnits в секунду обеспечивает 100 чтений с нестрогой консистентностью ReadCapacityUnits в секунду.

ЕдиницыПропускнойСпособностиЗаписи -> (длинное)

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

РазмерТаблицыБайтах -> (длинное)

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

КоличествоЭлементов -> (длинное)

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

ArnТаблицы -> (строка)

Идентификатор Amazon Resource Name (ARN), который однозначно идентифицирует таблицу.

IdТаблицы -> (строка)

Уникальный идентификатор таблицы, для которой был создан резервный экземпляр.

РезюмеРежимаУчета -> (структура)

Содержит сведения о режиме пропускной способности чтения/записи.

РежимУчета -> (строка)

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

PROVISIONED - Устанавливает режим пропускной способности чтения/записи на PROVISIONED. Рекомендуется использовать PROVISIONED для предсказуемых рабочих нагрузок.
PAY_PER_REQUEST - Устанавливает режим пропускной способности чтения/записи на PAY_PER_REQUEST. Рекомендуется использовать PAY_PER_REQUEST для непредсказуемых рабочих нагрузок.

ПоследнееИзменениеНаПлатеЗаЗапрос -> (временная метка)

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

ЛокальныеВторичныеИндексы -> (список)

Представляет один или несколько локальных вторичных индексов в таблице. Каждый индекс привязан к определённому значению ключа разбиения. Таблицы с одним или несколькими локальными вторичными индексами ограничены размером коллекции элементов, где объём данных в данной коллекции не может превышать 10 ГБ. Каждый элемент состоит из:

IndexName - Название локального вторичного индекса.
KeySchema - Указывает полную схему ключа индекса. Имена атрибутов в схеме ключа должны быть длиной от 1 до 255 символов (включительно). Схема ключа должна начинаться с того же ключа разбиения, что и таблица.
Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются. Каждое описание атрибута состоит из:
- ProjectionType - Один из следующих вариантов:
  - KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
  - INCLUDE - В индекс проектируются только указанные атрибуты таблицы. Список проектируемых атрибутов находится в NonKeyAttributes .
  - ALL - В индекс проектируются все атрибуты таблицы.
- NonKeyAttributes - Список одного или нескольких имён атрибутов, не являющихся ключами, которые проектируются во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если один и тот же атрибут проектируется в два разных индекса, это считается двумя разными атрибутами при определении общего количества. Это ограничение действует только при указании типа проекции INCLUDE . Вы по-прежнему можете указать тип проекции ALL , чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
IndexSizeBytes - Представляет общий размер индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
ItemCount - Представляет количество элементов в индексе. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

Если таблица находится в состоянии DELETING , информация об индексах не будет возвращена.

(структура)

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

IndexName -> (строка)

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

KeySchema -> (список)

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

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

Примечание

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

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

(структура)

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

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

ProjectionType -> (строка)

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

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

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

NonKeyAttributes -> (список)

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

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

(строка)

IndexSizeBytes -> (целое число с длинной точностью)

Общий размер указанного индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

ItemCount -> (целое число с длинной точностью)

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

IndexArn -> (строка)

Уникальный Amazon Resource Name (ARN) индекса.

GlobalSecondaryIndexes -> (список)

Глобальные вторичные индексы, если таковые имеются, в таблице. Каждый индекс привязан к определённому значению ключа разбиения. Каждый элемент состоит из:

Backfilling - Если true, то индекс в настоящее время находится на стадии заполнения. Заполнение происходит только при добавлении нового глобального вторичного индекса в таблицу. Это процесс, в ходе которого DynamoDB заполняет новый индекс данными из таблицы. (Этот атрибут не отображается для индексов, созданных во время операции CreateTable.) Вы можете удалить индекс, который создаётся во время фазы Backfilling, когда IndexStatus установлено в CREATING, и Backfilling имеет значение true. Вы не можете удалить индекс, который создаётся, когда IndexStatus установлено в CREATING, и Backfilling имеет значение false. (Этот атрибут не отображается для индексов, созданных во время операции CreateTable.)
IndexName - Название глобального вторичного индекса.
IndexSizeBytes - Общий размер глобального вторичного индекса в байтах. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
IndexStatus - Текущий статус глобального вторичного индекса:
- CREATING - Индекс создаётся.
- UPDATING - Индекс обновляется.
- DELETING - Индекс удаляется.
- ACTIVE - Индекс готов к использованию.
ItemCount - Количество элементов в глобальном вторичном индексе. DynamoDB обновляет это значение приблизительно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
KeySchema - Указывает полную схему ключа индекса. Имена атрибутов в схеме ключа должны быть длиной от 1 до 255 символов (включительно). Схема ключа должна начинаться с того же ключа разбиения, что и таблица.
Projection - Указывает атрибуты, которые копируются (проектируются) из таблицы в индекс. Они дополняют атрибуты первичного ключа и ключа индекса, которые автоматически проектируются. Каждое описание атрибута состоит из:
- ProjectionType - Один из следующих вариантов:
  - KEYS_ONLY - В индекс проектируются только индекс и первичные ключи.
  - INCLUDE - В дополнение к атрибутам, описанным в KEYS_ONLY , вторичный индекс будет включать другие атрибуты, не являющиеся ключами, которые вы укажете.
  - ALL - В индекс проектируются все атрибуты таблицы.
- NonKeyAttributes - Список одного или нескольких имён атрибутов, не являющихся ключами, которые проектируются во вторичный индекс. Общее количество атрибутов, указанных в NonKeyAttributes , суммарно по всем вторичным индексам, не должно превышать 100. Если один и тот же атрибут проектируется в два разных индекса, это считается двумя разными атрибутами при определении общего количества. Это ограничение действует только при указании типа проекции INCLUDE . Вы по-прежнему можете указать тип проекции ALL , чтобы спроецировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
ProvisionedThroughput - Параметры пропускной способности для глобального вторичного индекса, состоящие из единиц пропускной способности чтения и записи, а также данных об увеличениях и уменьшениях.

Если таблица находится в состоянии DELETING , информация об индексах не будет возвращена.

(структура)

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

IndexName -> (строка)

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

KeySchema -> (список)

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

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

Примечание

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

(структура)

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

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

ProjectionType -> (строка)

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

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

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

NonKeyAttributes -> (список)

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

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

(строка)

IndexStatus -> (строка)

Текущее состояние глобального вторичного индекса:

CREATING - Индекс создаётся.
UPDATING - Индекс обновляется.
DELETING - Индекс удаляется.
ACTIVE - Индекс готов к использованию.

Backfilling -> (булево)

Указывает, выполняется ли в настоящее время заполнение индекса. Заполнение — это процесс чтения элементов из таблицы и определения того, можно ли их добавить в индекс. (Не все элементы подходят: например, ключ разбиения не может иметь одинаковых значений.) Если элемент можно добавить в индекс, DynamoDB добавит его. После обработки всех элементов операция заполнения завершается, и Backfilling принимает значение false.

Вы можете удалить индекс, который создаётся во время фазы Backfilling, когда IndexStatus установлено в CREATING, а Backfilling равно true. Вы не можете удалить индекс, который создаётся, когда IndexStatus установлено в CREATING, а Backfilling равно false.

Примечание

Для индексов, созданных во время операции CreateTable, атрибут Backfilling не отображается в выводе DescribeTable.

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

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

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

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

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

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

Дата и время последнего уменьшения пропускной способности для этой таблицы.

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

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

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

Максимальное количество чтений со строгим согласованностью, потребляемых за секунду, прежде чем DynamoDB вернёт ThrottlingException. Чтения со слабой согласованностью требуют меньше усилий, чем чтение со строгим согласованием, поэтому значение 50 ReadCapacityUnits в секунду обеспечивает 100 чтений со слабой согласованностью в секунду.

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

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

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

Общий размер указанного индекса в байтах. DynamoDB обновляет это значение примерно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

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

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

IndexArn -> (строка)

Amazon Resource Name (ARN), уникально идентифицирующий индекс.

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

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

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

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

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

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

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

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

Представляет значение тёплой пропускной способности (в единицах чтения в секунду и единицах записи в секунду) для указанного вторичного индекса.

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

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

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

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

Status -> (строка)

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

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

Текущая конфигурация DynamoDB Streams для таблицы.

StreamEnabled -> (булево)

Указывает, включены (true) или выключены (false) DynamoDB Streams для таблицы.

StreamViewType -> (строка)

KEYS_ONLY - В поток записываются только атрибуты ключа изменённого элемента.
NEW_IMAGE - В поток записывается весь элемент в том виде, в котором он существует после изменения.
OLD_IMAGE - В поток записывается весь элемент в том виде, в котором он существовал до изменения.
NEW_AND_OLD_IMAGES - В поток записываются как новый, так и старый изображения элемента.

LatestStreamLabel -> (строка)

Маркер времени в формате ISO 8601 для данного потока.

Обратите внимание, что LatestStreamLabel не является уникальным идентификатором для потока, так как возможно, что поток из другой таблицы может иметь ту же метку времени. Однако комбинация следующих трёх элементов гарантированно уникальна:

Идентификатор клиента Amazon Web Services
Имя таблицы
StreamLabel

LatestStreamArn -> (строка)

Amazon Resource Name (ARN), уникально идентифицирующий последний поток для этой таблицы.

GlobalTableVersion -> (строка)

Представляет используемую версию глобальных таблиц, если таблица реплицируется по регионам Amazon Web Services.

Replicas -> (список)

Представляет реплики таблицы.

(структура)

Содержит детали реплики.

RegionName -> (строка)

Название региона.

ReplicaStatus -> (строка)

Текущее состояние реплики:

CREATING - Реплика создается.
UPDATING - Реплика обновляется.
DELETING - Реплика удаляется.
ACTIVE - Реплика готова к использованию.
REGION_DISABLED - Реплика недоступна, так как регион Amazon Web Services отключен.

Примечание

Если регион Amazon Web Services остается недоступным более 20 часов, DynamoDB удалит эту реплику из группы репликации. Реплика не будет удалена, и репликация прекратится для этого региона.

INACCESSIBLE_ENCRYPTION_CREDENTIALS - Ключ KMS, используемый для шифрования таблицы, недоступен.

Примечание

Если ключ KMS остается недоступным более 20 часов, DynamoDB удалит эту реплику из группы репликации. Реплика не будет удалена, и репликация прекратится для этого региона.

ReplicaStatusDescription -> (строка)

Подробная информация о состоянии реплики.

ReplicaStatusPercentProgress -> (строка)

Указывает процент выполнения действия Create, Update или Delete на реплике.

KMSMasterKeyId -> (строка)

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

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

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

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

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

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

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

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

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

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

Представляет значение пропускной способности подогрева для этой реплики.

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

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

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

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

Status -> (строка)

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

GlobalSecondaryIndexes -> (список)

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

(структура)

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

IndexName -> (строка)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Status -> (строка)

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

ReplicaInaccessibleDateTime -> (временная метка)

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

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

Содержит детали класса таблицы.

TableClass -> (строка)

Класс таблицы указанной таблицы. Допустимые значения — STANDARD и STANDARD_INFREQUENT_ACCESS.

LastUpdateDateTime -> (временная метка)

Дата и время последнего обновления класса таблицы.

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

Содержит детали восстановления.

SourceBackupArn -> (строка)

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

SourceTableArn -> (строка)

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

RestoreDateTime -> (временная метка)

Точка времени или время исходной резервной копии.

RestoreInProgress -> (булево)

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

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

Описание состояния шифрования на стороне сервера для указанной таблицы.

Status -> (строка)

Представляет текущее состояние шифрования на стороне сервера. Допустимые значения:

ENABLED - Шифрование на стороне сервера включено.
UPDATING - Шифрование на стороне сервера обновляется.

SSEType -> (строка)

Тип шифрования на стороне сервера. Допустимое значение:

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

KMSMasterKeyArn -> (строка)

ARN ключа KMS, используемого для шифрования KMS.

InaccessibleEncryptionDateTime -> (временная метка)

Указывает время (в формате UNIX epoch) обнаружения DynamoDB, что ключ KMS таблицы недоступен. Этот атрибут будет автоматически очищен, когда DynamoDB обнаружит, что ключ KMS таблицы снова доступен. DynamoDB инициирует процесс архивирования таблицы, когда ключ KMS таблицы остается недоступным в течение более семи дней с этой даты.

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

Содержит информацию об архиве таблицы.

ArchivalDateTime -> (временная метка)

Дата и время, когда DynamoDB инициировал архивирование таблицы (в формате временной метки UNIX).

ArchivalReason -> (строка)

Причина архивирования таблицы DynamoDB. В настоящее время единственное возможное значение:

INACCESSIBLE_ENCRYPTION_CREDENTIALS - Таблица была архивирована из-за недоступности ключа KMS таблицы более семи дней. В момент архивирования была создана резервная копия по требованию.

ArchivalBackupArn -> (строка)

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

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

Содержит сведения о классе таблицы.

TableClass -> (строка)

Класс таблицы указанной таблицы. Допустимые значения — STANDARD и STANDARD_INFREQUENT_ACCESS.

LastUpdateDateTime -> (временная метка)

Дата и время последнего обновления класса таблицы.

DeletionProtectionEnabled -> (булево)

Указывает, включена (true) или отключена (false) защита от удаления для таблицы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Status -> (строка)

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

MultiRegionConsistency -> (строка)

Указывает один из следующих режимов согласованности для глобальной таблицы:

EVENTUAL : Указывает, что глобальная таблица настроена для согласованности в режиме ожидания по нескольким регионам.
STRONG : Указывает, что глобальная таблица настроена для сильной согласованности по нескольким регионам (предварительная версия).

Примечание

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

Если этот параметр не указан, режим согласованности глобальной таблицы по умолчанию — EVENTUAL.