create-table
Описание
Операция CreateTable добавляет новую таблицу в указанный хранилище ключей. В пределах хранилища ключей имена таблиц должны быть уникальными.
CreateTable является асинхронной операцией. При получении запроса статус таблицы устанавливается в CREATING . Вы можете отслеживать статус создания новой таблицы, используя операцию GetTable, которая возвращает текущее состояние status таблицы. Вы можете начать использовать таблицу, когда статус станет ACTIVE .Дополнительную информацию см. в разделе Создание таблицы в Руководстве разработчика Amazon Keyspaces.
См. также: Документация API AWS
Синтаксис
create-table
--keyspace-name <value>
--table-name <value>
--schema-definition <value>
[--comment <value>]
[--capacity-specification <value>]
[--encryption-specification <value>]
[--point-in-time-recovery <value>]
[--ttl <value>]
[--default-time-to-live <value>]
[--tags <value>]
[--client-side-timestamps <value>]
[--auto-scaling-specification <value>]
[--replica-specifications <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]
Параметры
--keyspace-name (строка)
--table-name (строка)
--schema-definition (структура)
schemaDefinition состоит из следующих параметров.
Для каждой создаваемой колонки:
-
name- Имя колонки. -
type- Тип данных Amazon Keyspaces. Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon Keyspaces.
Первичный ключ таблицы состоит из следующих колонок:
-
partitionKeys- Ключ разбиения может быть одиночной колонкой или составным значением, состоящим из двух или более колонок. Часть первичного ключа, относящаяся к ключу разбиения, обязательна и определяет, как Amazon Keyspaces хранит данные. -
name- Имя каждой колонки ключа разбиения. -
clusteringKeys- Необязательная часть колонки кластеризации первичного ключа определяет, как данные кластеризуются и сортируются в каждом разделе. -
name- Имя колонки кластеризации. -
orderBy- Устанавливает модификатор порядка возрастания (ASC) или убывания (DESC). Для определения колонки как статической используйтеstaticColumns- Статические колонки хранят значения, общие для всех строк в одном и том же разделе: -
name- Имя колонки. -
type- Тип данных Amazon Keyspaces.
allColumns -> (список)
Обычные колонки таблицы.
(структура)
Имена и типы данных обычных колонок.
name -> (строка)
type -> (строка)
partitionKeys -> (список)
Колонки, являющиеся частью ключа разбиения таблицы.
(структура)
Часть первичного ключа, относящаяся к ключу разбиения, обязательна и определяет, как Amazon Keyspaces хранит данные. Ключ разбиения может быть одиночной колонкой или составным значением, состоящим из двух или более колонок.
name -> (строка)
clusteringKeys -> (список)
Колонки, являющиеся частью ключа кластеризации таблицы.
(структура)
Необязательная часть колонки кластеризации первичного ключа определяет, как данные кластеризуются и сортируются в каждом разделе.
name -> (строка)
orderBy -> (строка)
ASC ) или убывания (DESC ).staticColumns -> (список)
Колонки, определённые как STATIC . Статические колонки хранят значения, общие для всех строк в одном и том же разделе.
(структура)
Статические колонки таблицы. Статические колонки хранят значения, общие для всех строк в одном и том же разделе.
name -> (строка)
Сокращённый синтаксис:
allColumns=[{name=string,type=string},{name=string,type=string}],partitionKeys=[{name=string},{name=string}],clusteringKeys=[{name=string,orderBy=string},{name=string,orderBy=string}],staticColumns=[{name=string},{name=string}]
Синтаксис JSON:
{
"allColumns": [
{
"name": "string",
"type": "string"
}
...
],
"partitionKeys": [
{
"name": "string"
}
...
],
"clusteringKeys": [
{
"name": "string",
"orderBy": "ASC"|"DESC"
}
...
],
"staticColumns": [
{
"name": "string"
}
...
]
}
--comment (структура)
Этот параметр позволяет ввести описание таблицы.
message -> (строка)
Сокращённый синтаксис:
message=string
Синтаксис JSON:
{
"message": "string"
}
--capacity-specification (структура)
Указывает режим пропускной способности чтения/записи для таблицы. Варианты:
-
throughputMode:PAY_PER_REQUESTи -
throughputMode:PROVISIONED- Режим с заданной пропускной способностью требуетreadCapacityUnitsиwriteCapacityUnitsв качестве входных данных.
По умолчанию throughput_mode:PAY_PER_REQUEST.
Дополнительную информацию см. в разделе «Режимы пропускной способности чтения/записи» в руководстве разработчика Amazon Keyspaces.
throughputMode -> (строка)
Режим пропускной способности чтения/записи таблицы. Варианты:
-
throughputMode:PAY_PER_REQUESTи -
throughputMode:PROVISIONED- Режим с заданной пропускной способностью требуетreadCapacityUnitsиwriteCapacityUnitsв качестве входных данных.
По умолчанию throughput_mode:PAY_PER_REQUEST.
Дополнительную информацию см. в разделе «Режимы пропускной способности чтения/записи» в руководстве разработчика Amazon Keyspaces.
readCapacityUnits -> (целое)
read, определённых в read capacity units (RCUs).writeCapacityUnits -> (целое)
write, определённых в write capacity units (WCUs).Сокращённый синтаксис:
throughputMode=string,readCapacityUnits=long,writeCapacityUnits=long
Синтаксис JSON:
{
"throughputMode": "PAY_PER_REQUEST"|"PROVISIONED",
"readCapacityUnits": long,
"writeCapacityUnits": long
}
--encryption-specification (структура)
Указывает, как управляется ключ шифрования для шифрования на уровне хранения в таблице. Вы можете выбрать один из следующих ключей KMS:
-
type:AWS_OWNED_KMS_KEY- Этот ключ принадлежит Amazon Keyspaces. -
type:CUSTOMER_MANAGED_KMS_KEY- Этот ключ хранится в вашем аккаунте и создаётся, принадлежит и управляется вами. Этот вариант требуетkms_key_identifierключа KMS в формате Amazon Resource Name (ARN).
По умолчанию type:AWS_OWNED_KMS_KEY.
Дополнительную информацию см. в разделе «Шифрование на уровне хранения» в руководстве разработчика Amazon Keyspaces.
type -> (строка)
Параметр шифрования, указанный для таблицы. Вы можете выбрать один из следующих ключей KMS:
-
type:AWS_OWNED_KMS_KEY- Этот ключ принадлежит Amazon Keyspaces. -
type:CUSTOMER_MANAGED_KMS_KEY- Этот ключ хранится в вашем аккаунте и создаётся, принадлежит и управляется вами. Этот вариант требуетkms_key_identifierключа KMS в формате Amazon Resource Name (ARN).
По умолчанию type:AWS_OWNED_KMS_KEY.
Дополнительную информацию см. в разделе «Шифрование на уровне хранения» в руководстве разработчика Amazon Keyspaces.
kmsKeyIdentifier -> (строка)
kms_key_identifier:ARN.Сокращённый синтаксис:
type=string,kmsKeyIdentifier=string
Синтаксис JSON:
{
"type": "CUSTOMER_MANAGED_KMS_KEY"|"AWS_OWNED_KMS_KEY",
"kmsKeyIdentifier": "string"
}
--point-in-time-recovery (структура)
Указывает, включён или отключён pointInTimeRecovery для таблицы. Варианты:
status=ENABLEDstatus=DISABLED
Если не указано, по умолчанию status=DISABLED.
Дополнительную информацию см. в разделе «Восстановление по состоянию на определённую точку времени» в руководстве разработчика Amazon Keyspaces.
status -> (строка)
Варианты:
status=ENABLEDstatus=DISABLED
Сокращённый синтаксис:
status=string
Синтаксис JSON:
{
"status": "ENABLED"|"DISABLED"
}
--ttl (структура)
Включает пользовательские настройки Time to Live для таблицы. Варианты:
status:enabledstatus:disabled
По умолчанию status:disabled. После включения ttl его нельзя отключить для таблицы.
Дополнительную информацию см. в разделе «Истечение срока действия данных с помощью Amazon Keyspaces Time to Live (TTL)» в руководстве разработчика Amazon Keyspaces.
status -> (строка)
Сокращённый синтаксис:
status=string
Синтаксис JSON:
{
"status": "ENABLED"
}
--default-time-to-live (целое число)
Значение Time to Live по умолчанию в секундах для таблицы.
Дополнительную информацию см. в разделе «Установка значения TTL по умолчанию для таблицы» в руководстве разработчика Amazon Keyspaces.
--tags (список)
Список пар ключ-значение тегов, которые необходимо добавить к ресурсу.
Дополнительную информацию см. в разделе «Добавление тегов и меток к ресурсам Amazon Keyspaces» в руководстве разработчика Amazon Keyspaces.
(структура)
Описание тега. Тег — это пара ключ-значение. Вы можете добавить до 50 тегов к одному ресурсу Amazon Keyspaces.
Названия и значения тегов, назначенные Amazon Web Services, автоматически получают префикс aws:, который пользователь не может назначить. Названия тегов, назначенные Amazon Web Services, не учитываются в лимите тегов в 50. Названия тегов, назначенные пользователем, имеют префикс user: в отчете об распределении затрат. Вы не можете отменить применение тега.
Дополнительную информацию см. в разделе «Добавление тегов и меток к ресурсам Amazon Keyspaces» в руководстве разработчика Amazon Keyspaces.
key -> (строка)
value -> (строка)
Сокращённый синтаксис:
key=string,value=string ...
Синтаксис JSON:
[
{
"key": "string",
"value": "string"
}
...
]
--client-side-timestamps (структура)
Включает отметки времени на стороне клиента для таблицы. По умолчанию данная настройка отключена. Вы можете включить отметки времени на стороне клиента с помощью следующего параметра:
status: "enabled"
После включения отметки времени на стороне клиента для таблицы, данную настройку отключить нельзя.
status -> (строка)
Сокращённый синтаксис:
status=string
Синтаксис JSON:
{
"status": "ENABLED"
}
--auto-scaling-specification (структура)
Дополнительные настройки автоматического масштабирования для таблицы в режиме выделенной пропускной способности. Указывает, может ли служба автоматически управлять пропускной способностью для вас.
Автоматическое масштабирование помогает эффективно выделять пропускную способность для переменных рабочих нагрузок, автоматически увеличивая и уменьшая емкость чтения и записи вашей таблицы в ответ на трафик приложения. Дополнительную информацию см. в разделе Автоматическое управление пропускной способностью с помощью автоматического масштабирования Amazon Keyspaces в руководстве разработчика Amazon Keyspaces.
По умолчанию автоматическое масштабирование для таблицы отключено.
writeCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования для емкости записи таблицы.
autoScalingDisabled -> (булево)
false.minimumUnits -> (длинное целое число)
maximumUnits -> (длинное целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику автоматического масштабирования target tracking. С этой политикой автоматическое масштабирование Amazon Keyspaces гарантирует, что отношение потребляемой к выделенной емкости таблицы остается на или около указанного вами целевого значения. Вы определяете целевое значение как процент от 20 до 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Число от 20 до 90.
disableScaleIn -> (булево)
Указывает, включено ли scale-in.
Когда автоматическое масштабирование автоматически уменьшает емкость таблицы, таблица масштабируется внутрь. Когда установлены политики масштабирования, они не могут уменьшить масштаб таблицы ниже ее минимальной емкости.
scaleInCooldown -> (целое число)
Указывает период охлаждения scale-in.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
scaleOutCooldown -> (целое число)
Указывает период охлаждения для масштабирования наружу.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
targetValue -> (двойное)
Указывает целевое значение для политики автоматического масштабирования с отслеживанием целевого значения.
Автоматическое масштабирование Amazon Keyspaces автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Это гарантирует, что отношение потребляемой емкости к выделенной емкости остается на или около этого значения. Вы определяете targetValue как процент. Число от 20 до 90.
readCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования для емкости чтения таблицы.
autoScalingDisabled -> (булево)
false.minimumUnits -> (длинное целое число)
maximumUnits -> (длинное целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику автоматического масштабирования target tracking. С этой политикой автоматическое масштабирование Amazon Keyspaces гарантирует, что отношение потребляемой к выделенной емкости таблицы остается на или около указанного вами целевого значения. Вы определяете целевое значение как процент от 20 до 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Число от 20 до 90.
disableScaleIn -> (булево)
Указывает, включено ли scale-in.
Когда автоматическое масштабирование автоматически уменьшает емкость таблицы, таблица масштабируется внутрь. Когда установлены политики масштабирования, они не могут уменьшить масштаб таблицы ниже ее минимальной емкости.
scaleInCooldown -> (целое число)
Указывает период охлаждения scale-in.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
scaleOutCooldown -> (целое число)
Указывает период охлаждения для масштабирования наружу.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
targetValue -> (двойное)
Указывает целевое значение для политики автоматического масштабирования с отслеживанием целевого значения.
Автоматическое масштабирование Amazon Keyspaces автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Это гарантирует, что отношение потребляемой емкости к выделенной емкости остается на или около этого значения. Вы определяете targetValue как процент. Число от 20 до 90.
Синтаксис JSON:
{
"writeCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
}
}
--replica-specifications (список)
Необязательные параметры региона Amazon Web Services для таблицы в нескольких регионах. Эти настройки переопределяют общие параметры таблицы для указанного региона.
Для таблицы в нескольких регионах в режиме выделенной пропускной способности вы можете настроить емкость чтения таблицы по-разному для каждой реплики региона. Однако емкость записи остается синхронизированной между всеми репликами, чтобы обеспечить достаточную емкость для репликации записей по всем регионам. Чтобы определить емкость чтения реплики таблицы в определенном регионе, вы можете настроить следующие параметры.
-
region: Регион, где применяются эти настройки. (Обязательно) -
readCapacityUnits: Выделенные единицы емкости чтения. (Необязательно) -
readCapacityAutoScaling: Настройки автоматического масштабирования емкости чтения для таблицы. (Необязательно)
(структура)
Региональные настройки Amazon Web Services для таблицы в нескольких регионах.
Для таблицы в нескольких регионах вы можете настроить емкость чтения по отдельности для каждого региона Amazon Web Services. Вы можете сделать это, настроив следующие параметры.
-
region: Регион, где применяются эти настройки. (Обязательно) -
readCapacityUnits: Выделенные единицы емкости чтения. (Необязательно) -
readCapacityAutoScaling: Настройки автоматического масштабирования емкости чтения для таблицы. (Необязательно)
region -> (строка)
readCapacityUnits -> (длинное целое число)
readCapacityAutoScaling -> (структура)
Настройки автоматического масштабирования емкости чтения для таблицы в нескольких регионах в указанном регионе Amazon Web Services.
autoScalingDisabled -> (булево)
false.minimumUnits -> (длинное целое число)
maximumUnits -> (длинное целое число)
scalingPolicy -> (структура)
Amazon Keyspaces поддерживает политику автоматического масштабирования target tracking. С этой политикой автоматическое масштабирование Amazon Keyspaces гарантирует, что отношение потребляемой к выделенной емкости таблицы остается на или около указанного вами целевого значения. Вы определяете целевое значение как процент от 20 до 90.
targetTrackingScalingPolicyConfiguration -> (структура)
Автоматическое масштабирование автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Число от 20 до 90.
disableScaleIn -> (булево)
Указывает, включено ли scale-in.
Когда автоматическое масштабирование автоматически уменьшает емкость таблицы, таблица масштабируется внутрь. Когда установлены политики масштабирования, они не могут уменьшить масштаб таблицы ниже ее минимальной емкости.
scaleInCooldown -> (целое число)
Указывает период охлаждения scale-in.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
scaleOutCooldown -> (целое число)
Указывает период охлаждения для масштабирования наружу.
Период охлаждения в секундах между операциями масштабирования, позволяющий таблице стабилизироваться перед началом другой операции масштабирования.
targetValue -> (двойное)
Указывает целевое значение для политики автоматического масштабирования с отслеживанием целевого значения.
Автоматическое масштабирование Amazon Keyspaces автоматически увеличивает емкость, когда трафик превышает эту целевую скорость использования, и уменьшает ее, когда она опускается ниже целевой. Это гарантирует, что отношение потребляемой емкости к выделенной емкости остается на или около этого значения. Вы определяете targetValue как процент. Число от 20 до 90.
Синтаксис JSON:
[
{
"region": "string",
"readCapacityUnits": long,
"readCapacityAutoScaling": {
"autoScalingDisabled": true|false,
"minimumUnits": long,
"maximumUnits": long,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": true|false,
"scaleInCooldown": integer,
"scaleOutCooldown": integer,
"targetValue": double
}
}
}
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если предоставлено значение null или значение 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.
Вывод
resourceArn -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.