create-cluster

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

Чтобы создать дополнительные базы данных после создания кластера, подключитесь к кластеру с помощью SQL-клиента и используйте SQL-команды для создания базы данных. Дополнительную информацию см. в руководстве разработчика базы данных Amazon Redshift по созданию базы данных.

По умолчанию: dev

Ограничения:

• Должно содержать от 1 до 64 буквенно-цифровых символов.
• Должно содержать только строчные буквы.
• Не должно быть зарезервированным словом службы. Список зарезервированных слов см. в руководстве разработчика базы данных Amazon Redshift по зарезервированным словам.

Уникальный идентификатор кластера. Вы используете этот идентификатор для ссылки на кластер в последующих операциях с кластером, таких как удаление или изменение. Идентификатор также отображается в консоли Amazon Redshift.

Ограничения:

• Должно содержать от 1 до 63 буквенно-цифровых символов или дефисов.
• Буквы должны быть строчными.
• Первый символ должен быть буквой.
• Не должно заканчиваться дефисом и не должно содержать два последовательных дефиса.
• Должно быть уникальным для всех кластеров в учетной записи Amazon Web Services.

Пример: myexamplecluster

Тип кластера. Когда тип кластера указан как

• single-node, параметр NumberOfNodes не требуется.
• multi-node, параметр NumberOfNodes требуется.

Допустимые значения: multi-node | single-node

По умолчанию: multi-node

Тип узла, который необходимо зарезервировать для кластера. Дополнительную информацию о типах узлов см. в разделе Работа с кластерами в руководстве по управлению кластерами Amazon Redshift.

Допустимые значения: dc2.large | dc2.8xlarge | ra3.large | ra3.xlplus | ra3.4xlarge | ra3.16xlarge

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

Ограничения:

• Должно содержать от 1 до 128 буквенно-цифровых символов или дефисов. Имя пользователя не может быть PUBLIC.
• Должно содержать только строчные буквы, цифры, символ подчеркивания, плюс, точку, символ @ или дефис.
• Первый символ должен быть буквой.
• Не должно содержать двоеточия (:) или косую черту (/).
• Не должно быть зарезервированным словом. Список зарезервированных слов см. в руководстве разработчика базы данных Amazon Redshift по зарезервированным словам.

Пароль, связанный с учетной записью администратора кластера, который создается.

Вы не можете использовать MasterUserPassword, если ManageMasterPassword равно true.

Ограничения:

• Длина должна быть от 8 до 64 символов.
• Должно содержать хотя бы одну заглавную букву.
• Должно содержать хотя бы одну строчную букву.
• Должно содержать хотя бы одну цифру.
• Может содержать любые печатные ASCII-символы (код ASCII 33-126) кроме ' (одинарная кавычка), " (двойная кавычка), \ , / или @ .

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

По умолчанию: группа безопасности по умолчанию для Amazon Redshift.

(строка)

Список групп безопасности виртуальной частной сети (VPC), которые необходимо связать с кластером.

По умолчанию: с кластером связана группа безопасности VPC по умолчанию.

(строка)

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

Если этот параметр не указан, результирующий кластер будет развернут вне виртуальной частной сети (VPC).

Зона доступности EC2 (AZ), в которой вы хотите, чтобы Amazon Redshift развернул кластер. Например, если у вас несколько EC2-инстансов, работающих в определенной зоне доступности, вы можете развернуть кластер в той же зоне, чтобы снизить сетевую задержку.

По умолчанию: случайная, выбранная системой, зона доступности в регионе, указанном конечной точкой.

Пример: us-east-2d

Ограничение: указанная зона доступности должна находиться в том же регионе, что и текущая конечная точка.

Еженедельный интервал времени (в формате UTC), в течение которого может происходить автоматическое техническое обслуживание кластера.

Формат: ddd:hh24:mi-ddd:hh24:mi

По умолчанию: 30-минутный интервал, выбранный случайным образом из 8-часового временного блока в каждом регионе, в случайный день недели. Дополнительную информацию о временных блоках для каждого региона см. в руководстве по управлению кластерами Amazon Redshift в разделе "Окна технического обслуживания".

Допустимые дни: Пн | Вт | Ср | Чт | Пт | Сб | Вс

Ограничения: минимальный 30-минутный интервал.

Имя группы параметров, которая должна быть связана с этим кластером.

По умолчанию: группа параметров кластера Amazon Redshift по умолчанию. Дополнительную информацию о группе параметров по умолчанию см. в разделе Работа с группами параметров Amazon Redshift.

Ограничения:

• Должно содержать от 1 до 255 буквенно-цифровых символов или дефисов.
• Первый символ должен быть буквой.
• Не должно заканчиваться дефисом и не должно содержать два последовательных дефиса.

Количество дней, в течение которых сохраняются автоматические снимки. Если значение равно 0, автоматические снимки отключены. Даже если автоматические снимки отключены, вы по-прежнему можете создавать ручные снимки при необходимости с помощью CreateClusterSnapshot.

Автоматические снимки нельзя отключить для типов узлов RA3. Установите период автоматического хранения от 1 до 35 дней.

По умолчанию: 1

Ограничения: значение должно быть от 0 до 35.

Количество дней, в течение которых сохраняется ручной снимок по умолчанию. Если значение равно -1, снимок хранится неопределенно долго. Это значение не изменяет период хранения существующих снимков.

Значение должно быть либо -1, либо целым числом от 1 до 3653.

Номер порта, на котором кластер принимает входящие соединения.

Доступ к кластеру возможен только через строки подключения JDBC и ODBC. Часть строки подключения требует порта, на котором кластер будет принимать входящие соединения.

По умолчанию: 5439

Допустимые значения:

• Для кластеров с узлами ra3 - выберите порт в диапазонах 5431-5455 или 8191-8215. (Если у вас есть существующий кластер с узлами ra3, вам не нужно менять порт на эти диапазоны.)
• Для кластеров с узлами dc2 - выберите порт в диапазоне 1150-65535.

Версия программного обеспечения Amazon Redshift, которую вы хотите развернуть на кластере.

Выбранная версия работает на всех узлах кластера.

Ограничения: в настоящее время доступна только версия 1.0.

Пример: 1.0

Если true, обновления основных версий могут применяться во время окна технического обслуживания к Amazon Redshift-движку, работающему на кластере.

При выпуске новой основной версии Amazon Redshift-движка вы можете запросить, чтобы служба автоматически применяла обновления во время окна технического обслуживания к Amazon Redshift-движку, работающему на вашем кластере.

По умолчанию: true

Количество вычислительных узлов в кластере. Этот параметр требуется, когда параметр ClusterType указан как multi-node.

Дополнительную информацию о том, сколько узлов вам нужно, см. в разделе Работа с кластерами в руководстве по управлению кластерами Amazon Redshift.

Если вы не укажете этот параметр, вы получите кластер с одним узлом. При запросе многоузлового кластера необходимо указать количество узлов, которые вы хотите в кластере.

По умолчанию: 1

Ограничения: значение должно быть не менее 1 и не более 100.

Если true, к кластеру можно получить доступ из общедоступной сети.

По умолчанию: false

Если true, данные в кластере шифруются в состоянии покоя. Если вы установите значение этого параметра на false, запрос завершится ошибкой.

По умолчанию: true

Адрес Elastic IP (EIP) для кластера.

Ограничения: кластер должен быть развернут в EC2-VPC и доступен через шлюз в Интернет. Не указывайте адрес Elastic IP для общедоступного кластера, в котором включено перераспределение зоны доступности. Дополнительную информацию о развертывании кластеров в EC2-VPC см. в руководстве по управлению кластерами Amazon Redshift в разделе Поддерживаемые платформы для запуска вашего кластера.

Список экземпляров тегов.

(структура)

Параметр, указывающий, нужно ли создавать кластер с включенным расширенным маршрутизацией VPC. Для создания кластера, использующего расширенную маршрутизацию VPC, кластер должен находиться в VPC. Дополнительную информацию см. в руководстве по управлению кластерами Amazon Redshift в разделе Расширенная маршрутизация VPC.

Если этот параметр равен true, расширенная маршрутизация VPC включена.

По умолчанию: false

Список ролей управления идентификацией и доступом (IAM), которые могут использоваться кластером для доступа к другим службам Amazon Web Services. Вам необходимо указать роли IAM в формате Amazon Resource Name (ARN).

Максимальное количество ролей IAM, которые вы можете ассоциировать, ограничено квотой. Дополнительную информацию можно найти в разделе «Квоты и ограничения» в руководстве по управлению кластерами Amazon Redshift.

(строка)

Этот параметр устарел. Он не устанавливает состояние конфигурации AQUA. Amazon Redshift автоматически определяет, использовать ли AQUA (Advanced Query Accelerator).

Возможные значения:

• enabled
• disabled
• auto

Создание кластера с минимальным набором параметров

В этом примере создается кластер с минимальным набором параметров. По умолчанию вывод осуществляется в формате JSON.

Команда:

aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster

Результат:

{
   "Cluster": {
      "NodeType": "dw.hs1.xlarge",
      "ClusterVersion": "1.0",
      "PubliclyAccessible": "true",
      "MasterUsername": "adminuser",
      "ClusterParameterGroups": [
         {
            "ParameterApplyStatus": "in-sync",
            "ParameterGroupName": "default.redshift-1.0"
         } ],
      "ClusterSecurityGroups": [
         {
            "Status": "active",
            "ClusterSecurityGroupName": "default"
         } ],
      "AllowVersionUpgrade": true,
      "VpcSecurityGroups": \[],
      "PreferredMaintenanceWindow": "sat:03:30-sat:04:00",
      "AutomatedSnapshotRetentionPeriod": 1,
      "ClusterStatus": "creating",
      "ClusterIdentifier": "mycluster",
      "DBName": "dev",
      "NumberOfNodes": 2,
      "PendingModifiedValues": {
         "MasterUserPassword": "\****"
      }
   },
   "ResponseMetadata": {
      "RequestId": "7cf4bcfc-64dd-11e2-bea9-49e0ce183f07"
   }
}

Описывает кластер.

ClusterIdentifier -> (строка)

NodeType -> (строка)

ClusterStatus -> (строка)

ClusterAvailabilityStatus -> (строка)

ModifyStatus -> (строка)

MasterUsername -> (строка)

DBName -> (строка)

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

ClusterCreateTime -> (временная метка)

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

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

ClusterSecurityGroups -> (список)

VpcSecurityGroups -> (список)

ClusterParameterGroups -> (список)

ClusterSubnetGroupName -> (строка)

VpcId -> (строка)

AvailabilityZone -> (строка)

PreferredMaintenanceWindow -> (строка)

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

ClusterVersion -> (строка)

AllowVersionUpgrade -> (булево)

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

PubliclyAccessible -> (булево)

Encrypted -> (булево)

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

ПрогрессПередачиДанных -> (структура)

СтатусHsm -> (структура)

СтатусКопииСнимокКластера -> (структура)

ОткрытыйКлючКластера -> (строка)

УзлыКластера -> (список)

СтатусElasticIp -> (структура)

НомерРевизииКластера -> (строка)

Теги -> (список)

ИдентификаторKmsКлюча -> (строка)

УлучшенноеVPCМаршрутирование -> (булево)

РолиIam -> (список)

ОжидаемыеДействия -> (список)

ИмяПланаТехническогоОбслуживания -> (строка)

ElasticResizeКоличествоУзловВарианты -> (строка)

ОтложенныеОкнаТехническогоОбслуживания -> (список)

ИдентификаторГрафикаСнимков -> (строка)

СостояниеГрафикаСнимков -> (строка)

ОжидаемоеВремяСледующегоГрафикаСнимков -> (метка времени)

СтатусОжидаемогоСледующегоГрафикаСнимков -> (строка)

ВремяНачалаСледующегоОкнаТехническогоОбслуживания -> (метка времени)

ИнформацияОИзмененииМасштаба -> (структура)

СтатусПеремещенияВЗонУДоступности -> (строка)

ArnПространстваИменКластера -> (строка)

ОбщаяЕмкостьХранилищаВМегабайтах -> (длинное)

КонфигурацияAqua -> (структура)

ArnРолиIamПоУмолчанию -> (строка)

СтатусОбменаЗарезервированнымиУзлами -> (структура)

ПользовательскоеДоменноеИмя -> (строка)

ПользовательскийДоменныйСертификатArn -> (строка)

СрокДействияПользовательскогоДоменногоСертификата -> (метка времени)

MasterPasswordSecretArn -> (string)

MasterPasswordSecretKmsKeyId -> (string)

IpAddressType -> (string)

MultiAZ -> (string)

MultiAZSecondary -> (structure)