[ 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 (строка)
--table-name (строка)
--retention-properties (структура)
Срок хранения хранилища памяти и магнитного хранилища.
MemoryStoreRetentionPeriodInHours -> (целое число)
MagneticStoreRetentionPeriodInDays -> (целое число)
Сокращённый синтаксис:
MemoryStoreRetentionPeriodInHours=long,MagneticStoreRetentionPeriodInDays=long
Синтаксис JSON:
{
"MemoryStoreRetentionPeriodInHours": long,
"MagneticStoreRetentionPeriodInDays": long
}
--magnetic-store-write-properties (структура)
Содержит свойства для установки в таблице при включении записи в магнитное хранилище.
EnableMagneticStoreWrites -> (логическое значение)
MagneticStoreRejectedDataLocation -> (структура)
Местоположение для записи отчётов об ошибках для записей, отклоненных асинхронно при записи в магнитное хранилище.
S3Configuration -> (структура)
Настройка расположения S3 для записи отчётов об ошибках для записей, отклонённых асинхронно при записи в магнитное хранилище.
BucketName -> (строка)
ObjectKeyPrefix -> (строка)
EncryptionOption -> (строка)
KmsKeyId -> (строка)
Сокращённый синтаксис:
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 -> (строка)
TableName -> (строка)
DatabaseName -> (строка)
TableStatus -> (строка)
Текущее состояние таблицы:
-
DELETING- Таблица удаляется. -
ACTIVE- Таблица готова к использованию.
RetentionProperties -> (структура)
Срок хранения для кэша памяти и магнитного хранилища.
MemoryStoreRetentionPeriodInHours -> (целое число)
MagneticStoreRetentionPeriodInDays -> (целое число)
CreationTime -> (метка времени)
LastUpdatedTime -> (метка времени)
MagneticStoreWriteProperties -> (структура)
Содержит свойства для настройки таблицы при включении записи в магнитное хранилище.
EnableMagneticStoreWrites -> (булево)
MagneticStoreRejectedDataLocation -> (структура)
Расположение для записи отчетов об ошибках для записей, отклоненных асинхронно во время записи в магнитное хранилище.
S3Configuration -> (структура)
Настройка расположения в S3 для записи отчетов об ошибках для записей, отклоненных асинхронно во время записи в магнитное хранилище.
BucketName -> (строка)
ObjectKeyPrefix -> (строка)
EncryptionOption -> (строка)
KmsKeyId -> (строка)
Schema -> (структура)
Схема таблицы.
CompositePartitionKey -> (список)
Непустой список ключевых атрибутов, определяющих атрибуты, используемые для разбиения данных таблицы. Порядок в списке определяет иерархию разбиения. Имя и тип каждого ключевого атрибута разбиения, а также порядок ключевых атрибутов разбиения не могут быть изменены после создания таблицы. Однако уровень применения каждого ключевого атрибута разбиения может быть изменен.
(структура)
Атрибут, используемый для разбиения данных в таблице. Ключ измерения разбивает данные с использованием значений измерения, указанного именем измерения, в качестве ключевого атрибута разбиения, а ключевой атрибут меры разбивает данные с использованием имен мер (значений столбца «имя_меры»).
Type -> (строка)
Name -> (строка)
EnforcementInRecord -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.