создать-группу-параметров-базы-данных-кластера
Описание
Создаёт новую группу параметров кластера баз данных.
Параметры в группе параметров кластера баз данных применяются ко всем экземплярам в кластере баз данных.
Группа параметров кластера баз данных изначально создаётся с параметрами по умолчанию для базы данных, используемой экземплярами в кластере баз данных. Чтобы задать пользовательские значения для любых параметров, вы должны изменить группу после её создания с помощью ModifyDBClusterParameterGroup . После создания группы параметров кластера баз данных, необходимо ассоциировать её с вашим кластером баз данных с помощью ModifyDBCluster .
Когда вы ассоциируете новую группу параметров кластера баз данных с работающим кластером баз данных Aurora, перезапустите экземпляры баз данных в кластере баз данных без переключения для того, чтобы новые параметры кластера баз данных и связанные настройки вступили в силу.
Когда вы ассоциируете новую группу параметров кластера баз данных с работающим кластером баз данных Multi-AZ, перезапустите кластер баз данных без переключения для того, чтобы новые параметры кластера баз данных и связанные настройки вступили в силу.
Предупреждение
После создания группы параметров кластера баз данных, вы должны подождать не менее 5 минут перед созданием первого кластера баз данных, который использует эту группу параметров кластера баз данных в качестве группы параметров по умолчанию. Это позволяет Amazon RDS полностью завершить действие создания до того, как группа параметров кластера баз данных будет использоваться в качестве группы параметров по умолчанию для нового кластера баз данных. Это особенно важно для параметров, критически важных при создании базы данных по умолчанию для кластера баз данных, таких как кодировка символов для базы данных по умолчанию, определённой параметромcharacter_set_database. Вы можете использовать опцию «Группы параметров» в консоли Amazon RDS или операцию DescribeDBClusterParameters для проверки того, что ваша группа параметров кластера баз данных была создана или изменена.Дополнительную информацию об Amazon Aurora см. в разделе Что такое Amazon Aurora? в Руководстве пользователя Amazon Aurora.
Дополнительную информацию о кластерах баз данных Multi-AZ см. в разделе Развёртывания кластеров баз данных Multi-AZ в Руководстве пользователя Amazon RDS.
См. также: Документация API AWS
Синтаксис
create-db-cluster-parameter-group
--db-cluster-parameter-group-name <value>
--db-parameter-group-family <value>
--description <value>
[--tags <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]
Параметры
--db-cluster-parameter-group-name (строка)
Имя группы параметров кластера баз данных.
Ограничения:
- Не должно совпадать с именем существующей группы параметров кластера баз данных.
Примечание
Это значение хранится как строка в нижнем регистре.--db-parameter-group-family (строка)
Имя семейства группы параметров кластера баз данных. Группа параметров кластера баз данных может быть связана только с одним семейством группы параметров кластера баз данных и может быть применена только к кластеру баз данных, работающему с базой данных и версией движка, совместимыми с этим семейством группы параметров кластера баз данных.
Пример: aurora-mysql5.7 , aurora-mysql8.0
Пример: aurora-postgresql14
Пример: mysql8.0
Пример: postgres13
Чтобы перечислить все доступные семейства групп параметров для движка баз данных, используйте следующую команду:
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>Например, чтобы перечислить все доступные семейства групп параметров для движка баз данных Aurora PostgreSQL, используйте следующую команду:
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresqlПримечание
Вывод содержит дубликаты.Следующие являются допустимыми значениями движка баз данных:
aurora-mysqlaurora-postgresqlmysqlpostgres
--description (строка)
--tags (список)
Теги для назначения группе параметров кластера баз данных.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, состоящие из пары ключ-значение.
Дополнительную информацию см. в разделе Размещение тегов ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Размещение тегов ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.
Ключ -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Значение -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "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 (логическое значение)
Включить отладочную запись в журнал.
--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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с Руководством пользователя AWS CLI.
Если не указано иное, все примеры имеют правила цитирования, подобные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Чтобы создать группу параметров кластера баз данных
Следующий create-db-cluster-parameter-group пример создаёт группу параметров кластера баз данных.
aws rds create-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup \
--db-parameter-group-family aurora5.6 \
--description "My new cluster parameter group"
Вывод:
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "aurora5.6",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
}
Дополнительную информацию см. в разделе Создание группы параметров кластера баз данных в Руководстве пользователя Amazon Aurora.
Вывод
DBClusterParameterGroup -> (структура)
Содержит сведения о группе параметров кластера баз данных Amazon RDS.
Этот тип данных используется в качестве элемента ответа в действии DescribeDBClusterParameterGroups.
DBClusterParameterGroupName -> (строка)
DBParameterGroupFamily -> (строка)
Description -> (строка)
DBClusterParameterGroupArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.