Spec-Zone.ru › AWS CLI v2

[ aws . timestream-write ]

изменение-таблицы

Описание

Изменяет срок хранения памяти и магнитного хранилища для вашей таблицы Timestream. Обратите внимание, что изменение срока хранения вступает в силу немедленно. Например, если период хранения памяти изначально был установлен на 2 часа, а затем изменён на 24 часа, хранилище памяти будет способно хранить 24 часа данных, но будет заполнено 24 часами данных через 22 часа после внесения этого изменения. Timestream не извлекает данные из магнитного хранилища для заполнения хранилища памяти.

Подробности см. в примере кода.

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

Синтаксис

  update-table
--database-name <value>
--table-name <value>
[--retention-properties <value>]
[--magnetic-store-write-properties <value>]
[--schema <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]

Параметры

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

Имя базы данных Timestream.

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

Имя таблицы Timestream.

--retention-properties (структура)

Срок хранения хранилища памяти и магнитного хранилища.

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

Срок, в течение которого данные должны храниться в хранилище памяти.

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

Срок, в течение которого данные должны храниться в магнитном хранилище.

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

MemoryStoreRetentionPeriodInHours=long,MagneticStoreRetentionPeriodInDays=long

Синтаксис JSON:

{
  "MemoryStoreRetentionPeriodInHours": long,
  "MagneticStoreRetentionPeriodInDays": long
}

--magnetic-store-write-properties (структура)

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

EnableMagneticStoreWrites -> (логическое значение)

Флаг для включения записи в магнитное хранилище.

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

Местоположение для записи отчётов об ошибках для записей, отклоненных асинхронно при записи в магнитное хранилище.

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

Настройка расположения S3 для записи отчётов об ошибках для записей, отклонённых асинхронно при записи в магнитное хранилище.

BucketName -> (строка)

Имя ведра пользовательского S3 ведра.

ObjectKeyPrefix -> (строка)

Префикс имени объекта для пользовательского S3 расположения.

EncryptionOption -> (строка)

Вариант шифрования для пользовательского S3 расположения. Доступные варианты — шифрование на стороне сервера S3 с управляемым ключом S3 или управляемым ключом Amazon Web Services.

KmsKeyId -> (строка)

Идентификатор ключа KMS для пользовательского S3 расположения при шифровании с управляемым ключом Amazon Web Services.

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

EnableMagneticStoreWrites=boolean,MagneticStoreRejectedDataLocation={S3Configuration={BucketName=string,ObjectKeyPrefix=string,EncryptionOption=string,KmsKeyId=string}}

Синтаксис JSON:

{
  "EnableMagneticStoreWrites": true|false,
  "MagneticStoreRejectedDataLocation": {
    "S3Configuration": {
      "BucketName": "string",
      "ObjectKeyPrefix": "string",
      "EncryptionOption": "SSE_S3"|"SSE_KMS",
      "KmsKeyId": "string"
    }
  }
}

--schema (структура)

Схема таблицы.

CompositePartitionKey -> (список)

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

(структура)

Атрибут, используемый для разбиения данных в таблице. Ключ измерения разбиения данных с использованием значений измерения, указанных именем измерения в качестве ключевой партиции, а ключ измерения — с использованием имён мер (значений столбца «measure_name»).

Type -> (строка)

Тип ключевой партиции. Доступные варианты — ИЗМЕРЕНИЕ (ключ измерения) и МЕРЫ (ключ измерения).

Name -> (строка)

Имя атрибута, используемого для ключа измерения.

EnforcementInRecord -> (строка)

Уровень принуждения для указания ключа измерения в импортированных записях. Доступные варианты — ОБЯЗАТЕЛЬНЫЙ (ключ измерения должен быть указан) и НЕОБЯЗАТЕЛЬНЫЙ (ключ измерения указывать необязательно).

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

CompositePartitionKey=[{Type=string,Name=string,EnforcementInRecord=string},{Type=string,Name=string,EnforcementInRecord=string}]

Синтаксис JSON:

{
  "CompositePartitionKey": [
    {
      "Type": "DIMENSION"|"MEASURE",
      "Name": "string",
      "EnforcementInRecord": "REQUIRED"|"OPTIONAL"
    }
    ...
  ]
}

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

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

Вывод

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

Обновленная таблица Timestream.

Arn -> (строка)

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

TableName -> (строка)

Имя таблицы Timestream.

DatabaseName -> (строка)

Имя базы данных Timestream, содержащей эту таблицу.

TableStatus -> (строка)

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

  • DELETING - Таблица удаляется.
  • ACTIVE - Таблица готова к использованию.

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

Срок хранения для кэша памяти и магнитного хранилища.

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

Срок хранения данных в кэше памяти.

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

Срок хранения данных в магнитном хранилище.

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

Время создания таблицы Timestream.

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

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

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

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

EnableMagneticStoreWrites -> (булево)

Флаг для включения записи в магнитное хранилище.

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

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

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

Настройка расположения в S3 для записи отчетов об ошибках для записей, отклоненных асинхронно во время записи в магнитное хранилище.

BucketName -> (строка)

Имя ведра клиента в S3.

ObjectKeyPrefix -> (строка)

Префикс ключа объекта для расположения клиента в S3.

EncryptionOption -> (строка)

Вариант шифрования для расположения клиента в S3. Варианты: шифрование на сервере S3 с ключом от S3 или управляемый Amazon Web Services ключ.

KmsKeyId -> (строка)

Идентификатор ключа KMS для расположения клиента в S3 при шифровании с управляемым Amazon Web Services ключом.

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

Схема таблицы.

CompositePartitionKey -> (список)

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

(структура)

Атрибут, используемый для разбиения данных в таблице. Ключ измерения разбивает данные с использованием значений измерения, указанного именем измерения, в качестве ключевого атрибута разбиения, а ключевой атрибут меры разбивает данные с использованием имен мер (значений столбца «имя_меры»).

Type -> (строка)

Тип ключевого атрибута разбиения. Варианты: ИЗМЕРЕНИЕ (ключ измерения) и МЕРЫ (ключ меры).

Name -> (строка)

Имя атрибута, используемого для ключа измерения.

EnforcementInRecord -> (строка)

Уровень применения для указания ключа измерения в импортированных записях. Варианты: ОБЯЗАТЕЛЬНО (ключ измерения должен быть указан) и НЕОБЯЗАТЕЛЬНО (ключ измерения не должен быть указан).

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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