Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

удалить-таблицу

Описание

Операция DeleteTable удаляет таблицу и все ее элементы. После запроса DeleteTable указанная таблица находится в состоянии DELETING, пока DynamoDB не завершит удаление. Если таблица находится в состоянии ACTIVE, ее можно удалить. Если таблица находится в состояниях CREATING или UPDATING, DynamoDB возвращает ошибку ResourceInUseException. Если указанная таблица не существует, DynamoDB возвращает ошибку ResourceNotFoundException. Если таблица уже находится в состоянии DELETING, ошибка не возвращается.

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

Для глобальных таблиц эта операция применяется только к глобальным таблицам, использующим версию 2019.11.21 (текущая версия).

Примечание

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

При удалении таблицы также удаляются все индексы этой таблицы.

Если в таблице включены потоки DynamoDB Streams, соответствующий поток этой таблицы переходит в состояние DISABLED, и поток автоматически удаляется через 24 часа.

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

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

Синтаксис

  delete-table
--table-name <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]

Параметры

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

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

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

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

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

--debug (булево)

Включает отладку.

--endpoint-url (строка)

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

--no-verify-ssl (булево)

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

--no-paginate (булево)

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--no-sign-request (булево)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

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

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

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

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Для удаления таблицы

Следующий пример delete-table удаляет таблицу MusicCollection.

aws dynamodb delete-table \
    --table-name MusicCollection

Вывод:

{
    "TableDescription": {
        "TableStatus": "DELETING",
        "TableSizeBytes": 0,
        "ItemCount": 0,
        "TableName": "MusicCollection",
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "WriteCapacityUnits": 5,
            "ReadCapacityUnits": 5
        }
    }
}

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

Вывод

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

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

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

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

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

  • AttributeName - Название атрибута.
  • AttributeType - Тип данных для атрибута.

(структура)

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

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

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

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

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

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

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

Название таблицы.

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

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

  • AttributeName - Название атрибута.
  • KeyType - Роль атрибута:
    • HASH - ключ разбиения
    • RANGE - ключ сортировки

Примечание

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

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

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

(структура)

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

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

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

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

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

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

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

  • 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 нестрого согласованных ReadCapacityUnits в секунду.

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

Максимальное количество записей, потребляемых в секунду, прежде чем 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. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение применяется только при указании ProjectionType INCLUDE. Вы все равно можете указать ProjectionType ALL, чтобы спроектировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
  • IndexSizeBytes - Представляет общий размер индекса в байтах. DynamoDB обновляет это значение примерно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.
  • ItemCount - Представляет количество элементов в индексе. DynamoDB обновляет это значение примерно каждые шесть часов. Недавние изменения могут не отражаться в этом значении.

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

(структура)

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

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

(строка)

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. Если вы проектируете один и тот же атрибут в два разных индекса, это учитывается как два отдельных атрибута при определении общего количества. Это ограничение применяется только при указании ProjectionType INCLUDE. Вы все равно можете указать ProjectionType ALL, чтобы спроектировать все атрибуты из исходной таблицы, даже если таблица содержит более 100 атрибутов.
  • ProvisionedThroughput - Параметры пропускной способности по предопределению для глобального вторичного индекса, состоящие из единиц емкости чтения и записи, а также данные об увеличении и уменьшении.

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

(структура)

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

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

(строка)

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 несогласованных ReadCapacityUnits в секунду.

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 epoch) обнаружения DynamoDB недоступности ключа KMS таблицы. Это свойство автоматически сбросится, когда DynamoDB обнаружит доступность ключа KMS таблицы снова. DynamoDB инициирует процесс архивации таблицы, когда ключ KMS таблицы остается недоступным более семи дней с этой даты.

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

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

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

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

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