Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

восстановление-таблицы-к-определенной-точке-времени

Описание

Восстанавливает указанную таблицу до указанной точки времени в пределах EarliestRestorableDateTime и LatestRestorableDateTime . Вы можете восстановить таблицу до любой точки времени за последние 35 дней. Вы можете установить период восстановления на любое значение от 1 до 35 дней. Любое количество пользователей может выполнить до 50 одновременных восстановлений (любого типа восстановления) в данной учетной записи.

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

Вместе с данными при восстановлении с использованием восстановления к определенной точке времени в новую восстановленную таблицу также включаются:

  • Глобальные вторичные индексы (ГСИ)
  • Локальные вторичные индексы (ЛСИ)
  • Зарезервированная емкость для чтения и записи
  • Настройки шифрования

Предупреждение

Все эти настройки берутся из текущих настроек исходной таблицы на момент восстановления.

Вы должны вручную настроить следующее в восстановленной таблице:

  • Политики автоматического масштабирования
  • Политики IAM
  • Метрики и оповещения Amazon CloudWatch
  • Теги
  • Настройки потока
  • Настройки Time to Live (TTL)
  • Настройки восстановления к определенной точке времени

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

Синтаксис

  restore-table-to-point-in-time
[--source-table-arn <value>]
[--source-table-name <value>]
--target-table-name <value>
[--use-latest-restorable-time | --no-use-latest-restorable-time]
[--restore-date-time <value>]
[--billing-mode-override <value>]
[--global-secondary-index-override <value>]
[--local-secondary-index-override <value>]
[--provisioned-throughput-override <value>]
[--on-demand-throughput-override <value>]
[--sse-specification-override <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]

Параметры

--source-table-arn (строка)

Таблица DynamoDB, которая будет восстановлена. Это значение представляет собой Amazon Resource Name (ARN).

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

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

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

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

--use-latest-restorable-time | --no-use-latest-restorable-time (булево)

Восстановить таблицу до самого последнего возможного момента. LatestRestorableDateTime обычно составляет 5 минут до текущего времени.

--restore-date-time (метка времени)

Время в прошлом, до которого нужно восстановить таблицу.

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

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

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

  • PROVISIONED
  • PAY_PER_REQUEST

--global-secondary-index-override (список)

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

(структура)

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

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 -> (длинное целое число)

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

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

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

--local-secondary-index-override (список)

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

(структура)

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

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 атрибутов.

(строка)

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

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

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

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

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

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

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

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

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

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

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

ReadCapacityUnits=long,WriteCapacityUnits=long

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

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

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

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

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

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

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

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

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

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

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

MaxReadRequestUnits=long,MaxWriteRequestUnits=long

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

{
  "MaxReadRequestUnits": long,
  "MaxWriteRequestUnits": long
}

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

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

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.

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

Enabled=boolean,SSEType=string,KMSMasterKeyId=string

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

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

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

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

Следующий restore-table-to-point-in-time пример восстанавливает таблицу MusicCollection до указанного момента времени.

aws dynamodb restore-table-to-point-in-time \
    --source-table-name MusicCollection \
    --target-table-name MusicCollectionRestore \
    --restore-date-time 1576622404.0

Вывод:

{
    "TableDescription": {
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "TableName": "MusicCollectionRestore",
        "KeySchema": [
            {
                "AttributeName": "Artist",
                "KeyType": "HASH"
            },
            {
                "AttributeName": "SongTitle",
                "KeyType": "RANGE"
            }
        ],
        "TableStatus": "CREATING",
        "CreationDateTime": 1576623311.86,
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "ReadCapacityUnits": 5,
            "WriteCapacityUnits": 5
        },
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollectionRestore",
        "TableId": "befd9e0e-1843-4dc6-a147-d6d00e85cb1f",
        "BillingModeSummary": {
            "BillingMode": "PROVISIONED"
        },
        "RestoreSummary": {
            "SourceTableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
            "RestoreDateTime": 1576622404.0,
            "RestoreInProgress": true
        }
    }
}

Дополнительную информацию см. в разделе Восстановление до определенной точки времени для DynamoDB в Руководстве разработчика 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 - ключ сортировки

Примечание

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

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

Состояние таблицы -> (строка)

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

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

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

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

Зарезервированная пропускная способность -> (структура)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Уникальный Amazon Resource Name (ARN) таблицы.

Идентификатор таблицы -> (строка)

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

Резюме режима оплаты -> (структура)

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

Режим оплаты -> (строка)

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

  • 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 представляет ровно один атрибут первичного ключа. Например, простой первичный ключ будет представлен одним KeySchemaElement (для ключа разбиения). Составной первичный ключ потребует одного KeySchemaElement для ключа разбиения и другого KeySchemaElement для ключа сортировки.

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

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 - Если истинно, индекс в настоящее время находится на стадии заполнения. Заполнение происходит только при добавлении нового глобального вторичного индекса в таблицу. Это процесс, в котором DynamoDB заполняет новый индекс данными из таблицы. (Этот атрибут не отображается для индексов, созданных во время операции CreateTable.) Вы можете удалить индекс, который создается на этапе Backfilling, когда IndexStatus задано как CREATING и Backfilling истинно. Вы не можете удалить индекс, который создается, когда IndexStatus задано как CREATING и Backfilling ложно. (Этот атрибут не отображается для индексов, созданных во время операции 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 внутренней хеш-функции для равномерного распределения элементов данных по разделам на основе значений ключа разбиения.

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

(структура)

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

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

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

AttributeName -> (строка)

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

KeyType -> (строка)

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

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

Примечание

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

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

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, MaxWriteRequestUnits или оба.

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 -> (строка)

Когда элемент в таблице изменяется, StreamViewType определяет, какая информация записывается в поток для этой таблицы. Допустимые значения для 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), когда 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 -> (целое число)

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

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

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

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

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

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

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

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

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

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

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

Status -> (строка)

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

MultiRegionConsistency -> (строка)

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

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

Примечание

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

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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