создание пользовательской версии движка базы данных

Описание

Создает пользовательскую версию движка базы данных (CEV).

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

Синтаксис

  create-custom-db-engine-version
--engine <value>
--engine-version <value>
[--database-installation-files-s3-bucket-name <value>]
[--database-installation-files-s3-prefix <value>]
[--image-id <value>]
[--kms-key-id <value>]
[--description <value>]
[--manifest <value>]
[--tags <value>]
[--source-custom-db-engine-version-identifier <value>]
[--use-aws-provided-latest-image | --no-use-aws-provided-latest-image]
[--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]

Параметры

--engine (строка)

Движок базы данных. RDS Custom для Oracle поддерживает следующие значения:

custom-oracle-ee
custom-oracle-ee-cdb
custom-oracle-se2
custom-oracle-se2-cdb

--engine-version (строка)

Имя вашей CEV. Формат имени — 19.*настраиваемая_строка*. Например, допустимое имя CEV — 19.my_cev1. Это значение обязательно для RDS Custom для Oracle, но необязательно для Amazon RDS. Сочетание Engine и EngineVersion уникально для каждого клиента в каждом регионе.

--database-installation-files-s3-bucket-name (строка)

Имя ведра Amazon S3, содержащего файлы установки базы данных для вашей CEV. Например, допустимое имя ведра — my-custom-installation-files.

--database-installation-files-s3-prefix (строка)

Директория в Amazon S3, содержащая файлы установки базы данных для вашей CEV. Например, допустимое имя ведра — 123456789012/cev1. Если этот параметр не указан, префикс не предполагается.

--image-id (строка)

Идентификатор Amazon Machine Image (AMI). Для RDS Custom для SQL Server требуется идентификатор AMI для создания CEV. Для RDS Custom для Oracle по умолчанию используется самый последний доступный AMI, но вы можете указать идентификатор AMI, использовавшийся в другой CEV Oracle. Найдите AMI, используемые вашими CEV, вызвав операцию DescribeDBEngineVersions.

--kms-key-id (строка)

Идентификатор ключа KMS Amazon Web Services для шифрования CEV. Симметричный ключ KMS необходим для RDS Custom, но необязателен для Amazon RDS.

Если у вас есть существующий симметричный ключ KMS в вашей учетной записи, вы можете использовать его с RDS Custom. Дальнейшие действия не требуются. Если у вас ещё нет симметричного ключа KMS в вашей учетной записи, следуйте инструкциям в разделе Создание симметричного ключа шифрования KMS в Руководстве разработчика Amazon Web Services Key Management Service.

Вы можете выбрать один и тот же симметричный ключ при создании CEV и экземпляра базы данных или разные ключи.

--description (строка)

Необязательное описание вашей CEV.

--manifest (строка)

Манифест CEV, представляющий собой JSON-документ, описывающий файлы установки .zip, хранящиеся в Amazon S3. Укажите пары имя/значение в файле или в строке с кавычками. RDS Custom применяет исправления в том порядке, в котором они перечислены.

Следующие поля JSON допустимы:

MediaImportTemplateVersion

Версия манифеста CEV. Дата имеет формат YYYY-MM-DD.

databaseInstallationFileNames

Упорядоченный список файлов установки для CEV.

opatchFileNames

Упорядоченный список установочных файлов OPatch, используемых для движка базы данных Oracle.

psuRuPatchFileNames

Исправления PSU и RU для этой CEV.

OtherPatchFileNames

Исправления, которые не входят в список исправления PSU и RU. Amazon RDS применяет эти исправления после применения исправлений PSU и RU.

Дополнительную информацию см. в разделе Создание манифеста CEV в Руководстве пользователя Amazon RDS.

--tags (список)

Список тегов.

Дополнительную информацию см. в разделе Маркировка ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Маркировка ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.

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

Ключ — это требуемое имя тега. Значение строки может составлять от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

Значение -> (строка)

Значение — это необязательное значение тега. Значение строки может составлять от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

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

Key=string,Value=string ...

JSON-синтаксис:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--source-custom-db-engine-version-identifier (строка)

ARN CEV, используемый в качестве источника для создания новой CEV. Вы можете указать другой Amazon Machine Image (AMI), используя либо Source, либо UseAwsProvidedLatestImage. Вы не можете указать другой JSON-манифест, когда вы указываете SourceCustomDbEngineVersionIdentifier.

--use-aws-provided-latest-image | --no-use-aws-provided-latest-image (логическое значение)

Указывает, следует ли использовать последнюю предоставленную службой Amazon Machine Image (AMI) для CEV. Если вы указываете UseAwsProvidedLatestImage, вы также не можете указать ImageId.

--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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

Двигатель -> (строка)

Название базы данных движка.

EngineVersion -> (строка)

Номер версии базы данных движка.

DBParameterGroupFamily -> (строка)

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

DBEngineDescription -> (строка)

Описание базы данных движка.

DBEngineVersionDescription -> (строка)

Описание версии базы данных движка.

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

Набор символов по умолчанию для новых экземпляров этой версии движка, если параметр CharacterSetName API CreateDBInstance не указан.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

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

Изображение EC2

ImageId -> (строка)

Значение, указывающее ID AMI.

Status -> (строка)

Значение, указывающее состояние пользовательской версии движка (CEV).

DBEngineMediaType -> (строка)

Значение, указывающее поставщика носителей исходного AMI на основе операции использования. Применимо для RDS Custom для SQL Server.

SupportedCharacterSets -> (список)

Список наборов символов, поддерживаемых этим движком для параметра CharacterSetName операции CreateDBInstance.

(структура)

Этот тип данных используется как элемент ответа в действии DescribeDBEngineVersions.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

SupportedNcharCharacterSets -> (список)

Список наборов символов, поддерживаемых движком Oracle DB для параметра NcharCharacterSetName операции CreateDBInstance.

(структура)

Этот тип данных используется как элемент ответа в действии DescribeDBEngineVersions.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

ValidUpgradeTarget -> (список)

Список версий движков, к которым можно выполнить обновление этой версии базы данных движка.

(структура)

Версия базы данных движка, к которой можно обновить экземпляр DB.

Engine -> (строка)

Название целевого базы данных движка для обновления.

EngineVersion -> (строка)

Номер версии целевого базы данных движка для обновления.

Description -> (строка)

Версия базы данных движка, к которой можно обновить экземпляр DB.

AutoUpgrade -> (булево)

Указывает, применяется ли целевая версия к исходным экземплярам DB, у которых AutoMinorVersionUpgrade установлено в значение true.

Этот параметр динамический и устанавливается RDS.

IsMajorVersionUpgrade -> (булево)

Указывает, требуется ли для обновления до целевой версии обновление основной версии базы данных движка.

SupportedEngineModes -> (список)

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

(строка)

SupportsParallelQuery -> (булево)

Указывает, можно ли использовать параллельный запрос Aurora с целевой версией движка.

SupportsGlobalDatabases -> (булево)

Указывает, можно ли использовать глобальные базы данных Aurora с целевой версией движка.

SupportsBabelfish -> (булево)

Указывает, можно ли использовать Babelfish для Aurora PostgreSQL с целевой версией движка.

SupportsLimitlessDatabase -> (булево)

Указывает, поддерживает ли версия движка баз данных Aurora Limitless Database.

SupportsLocalWriteForwarding -> (булево)

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

Применимо к: только кластерам баз данных Aurora

SupportsIntegrations -> (булево)

Указывает, поддерживает ли версия движка баз данных нулевые интеграции ETL с Amazon Redshift.

SupportedTimezones -> (список)

Список часовых поясов, поддерживаемых этим движком для параметра Timezone действия CreateDBInstance.

(структура)

Часовой пояс, связанный с DBInstance или DBSnapshot. Этот тип данных является элементом в ответе на действия DescribeDBInstances, DescribeDBSnapshots и DescribeDBEngineVersions.

TimezoneName -> (строка)

Название часового пояса.

ExportableLogTypes -> (список)

Типы журналов, доступные базе данных движка для экспорта в CloudWatch Logs.

(строка)

SupportsLogExportsToCloudwatchLogs -> (булево)

Указывает, поддерживает ли версия движка экспорт типов журналов, указанных в ExportableLogTypes, в CloudWatch Logs.

SupportsReadReplica -> (булево)

Указывает, поддерживает ли версия базы данных движка реплики чтения.

SupportedEngineModes -> (список)

Список поддерживаемых режимов базы данных движка.

(строка)

SupportedFeatureNames -> (список)

Список функций, поддерживаемых базой данных движка.

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

Для определения поддерживаемых функций для определенного базы данных движка и версии базы данных движка с помощью CLI используйте следующую команду:

aws rds describe-db-engine-versions --engine <engine_name> --engine-version <engine_version>

Например, для определения поддерживаемых функций для RDS для PostgreSQL версии 13.3 с помощью CLI используйте следующую команду:

aws rds describe-db-engine-versions --engine postgres --engine-version 13.3

Поддерживаемые функции перечислены в SupportedFeatureNames в выводе.

(строка)

Status -> (строка)

Состояние версии базы данных движка, либо available, либо deprecated.

SupportsParallelQuery -> (булево)

Указывает, можно ли использовать параллельный запрос Aurora с определенной версией базы данных движка.

SupportsGlobalDatabases -> (булево)

Указывает, можно ли использовать глобальные базы данных Aurora с определенной версией базы данных движка.

MajorEngineVersion -> (строка)

Основная версия движка CEV.

DatabaseInstallationFilesS3BucketName -> (строка)

Название ведра Amazon S3, содержащего файлы установки базы данных.

DatabaseInstallationFilesS3Prefix -> (строка)

Каталог Amazon S3, содержащий файлы установки базы данных. Если не указан, то не предполагается никакого префикса.

DBEngineVersionArn -> (строка)

ARN пользовательской версии движка.

KMSKeyId -> (строка)

Идентификатор ключа Amazon Web Services KMS для зашифрованного CEV. Этот параметр требуется для RDS Custom, но является необязательным для Amazon RDS.

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

Время создания версии базы данных движка.

TagList -> (список)

Список тегов.

Дополнительную информацию см. в разделе Тегирование ресурсов Amazon RDS в руководстве пользователя Amazon RDS или в разделе Тегирование ресурсов Amazon Aurora и Amazon RDS в руководстве пользователя Amazon Aurora.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.

Key -> (строка)

Ключ — это обязательное имя тега. Строковое значение может быть длиной от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).

Value -> (строка)

Значение — это необязательное значение тега. Строковое значение может быть длиной от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).

SupportsBabelfish -> (булево)

Указывает, поддерживает ли версия движка Babelfish для Aurora PostgreSQL.

CustomDBEngineVersionManifest -> (строка)

Строка JSON, которая перечисляет файлы установки и параметры, которые RDS Custom использует для создания пользовательской версии движка (CEV). RDS Custom применяет исправления в том порядке, в котором они перечислены в манифесте. Можно установить домашнюю папку Oracle, базу Oracle и пользователя и группу UNIX/Linux с помощью параметров установки. Дополнительную информацию см. в разделе JSON-полях в манифесте CEV в руководстве пользователя Amazon RDS.

SupportsLimitlessDatabase -> (булево)

Указывает, поддерживает ли версия движка баз данных Aurora Limitless Database.

SupportsCertificateRotationWithoutRestart -> (булево)

Указывает, поддерживает ли версия движка вращение сертификата сервера без перезапуска экземпляра DB.

SupportedCACertificateIdentifiers -> (список)

Список поддерживаемых идентификаторов сертификатов CA.

Дополнительную информацию см. в разделе Использование SSL/TLS для шифрования подключения к экземпляру DB в руководстве пользователя Amazon RDS и Использование SSL/TLS для шифрования подключения к кластеру баз данных в руководстве пользователя Amazon Aurora.

(строка)

SupportsLocalWriteForwarding -> (булево)

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

Применимо к: только кластерам баз данных Aurora

SupportsIntegrations -> (булево)

Указывает, поддерживает ли версия движка баз данных нулевые интеграции ETL с Amazon Redshift.

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

Указывает любые свойства или ограничения Aurora Serverless v2, которые отличаются между версиями движков Aurora. Можно протестировать значения этого атрибута при выборе версии Aurora для использования в новом или обновленном кластере DB. Также можно получить версию существующего кластера DB и проверить, поддерживает ли эта версия определенные функции Aurora Serverless v2, прежде чем пытаться использовать эти функции.

MinCapacity -> (число)

Если минимальная емкость составляет 0 ACU, версия движка поддерживает функцию автоматической паузы/возобновления Aurora Serverless v2.

MaxCapacity -> (число)

Указывает верхний предел емкости Aurora Serverless v2 для определенной версии движка. В зависимости от версии движка максимальная емкость кластера Aurora Serverless v2 может быть 256 или 128.