создать-группу-работы
Описание
Создает группу работы с указанным именем. Группа работы может быть группой работы, поддерживающей Apache Spark, или группой работы Athena SQL.
См. также: AWS API документацию
Синтаксис
create-work-group
--name <value>
[--configuration <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]
Параметры
--name (строка)
--configuration (структура)
Содержит конфигурационную информацию для создания рабочей группы Athena SQL или рабочей группы Athena с поддержкой Spark. Конфигурация рабочей группы Athena SQL включает расположение в Amazon S3, где хранятся результаты запросов и вычислений, конфигурацию шифрования, если она используется для шифрования результатов запросов, включение метрик Amazon CloudWatch для рабочей группы, лимит сканирования в байтах (отсечка) за запрос, если он указан, и переопределение настроек рабочей группы (указанных с помощью EnforceWorkGroupConfiguration ) в WorkGroupConfiguration клиентскими настройками. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration.
ResultConfiguration -> (структура)
Конфигурация рабочей группы, которая включает расположение в Amazon S3 для хранения результатов запросов и вычислений, а также опцию шифрования, если она используется для результатов запросов и вычислений. Для выполнения запроса необходимо указать местоположение результатов запроса одним из способов: либо в рабочей группе с помощью этого параметра, либо для отдельных запросов (клиентская сторона) с помощью ResultConfiguration$OutputLocation. Если ни один из них не установлен, Athena выдаёт ошибку о том, что местоположение вывода не указано.
OutputLocation -> (строка)
s3://path/to/query/bucket/. Для выполнения запроса необходимо указать местоположение результатов запроса одним из способов: либо для отдельных запросов с использованием этого параметра (клиентская сторона), либо в рабочей группе с помощью WorkGroupConfiguration. Если ни один из них не установлен, Athena выдаёт ошибку о том, что местоположение вывода не указано. Если настройки рабочей группы переопределяют клиентские настройки, запрос использует настройки, указанные для рабочей группы. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration.EncryptionConfiguration -> (структура)
Если результаты запросов и вычислений шифруются в Amazon S3, указывает используемую опцию шифрования (например, SSE_KMS или CSE_KMS) и информацию о ключе. Это клиентская настройка. Если настройки рабочей группы переопределяют клиентские настройки, запрос использует конфигурацию шифрования, указанную для рабочей группы, а также расположение для хранения результатов запросов, указанное в рабочей группе. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек рабочей группы клиентскими настройками.
EncryptionOption -> (строка)
Указывает, используется ли шифрование Amazon S3 на стороне сервера с ключами Amazon S3 (SSE_S3), шифрование на стороне сервера с ключами KMS (SSE_KMS) или клиентское шифрование с ключами KMS (CSE_KMS).
Если запрос выполняется в рабочей группе, и рабочая группа переопределяет клиентские настройки, используется настройка шифрования рабочей группы. Она определяет, должны ли результаты запросов шифроваться для всех запросов, выполняемых в этой рабочей группе.
KmsKey -> (строка)
SSE_KMS и CSE_KMS, это ARN или ID ключа KMS.ExpectedBucketOwner -> (строка)
Идентификатор учётной записи Amazon Web Services, который ожидается как владелец ведра Amazon S3, указанного в ResultConfiguration$OutputLocation. Если установлено, Athena использует значение для ExpectedBucketOwner при выполнении вызовов Amazon S3 к указанному местоположению вывода. Если ExpectedBucketOwner идентификатор учётной записи Amazon Web Services не соответствует фактическому владельцу ведра Amazon S3, вызов завершается ошибкой доступа.
Это клиентская настройка. Если настройки рабочей группы переопределяют клиентские настройки, запрос использует настройку ExpectedBucketOwner, указанную для рабочей группы, а также расположение для хранения результатов запросов, указанное в рабочей группе. См. WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек рабочей группы клиентскими настройками.
AclConfiguration -> (структура)
Указывает, что для управления владением сохранёнными результатами запросов должен быть установлен предварительно настроенный ACL Amazon S3. В настоящее время поддерживается только предварительно настроенный ACL BUCKET_OWNER_FULL_CONTROL. Это клиентская настройка. Если настройки рабочей группы переопределяют клиентские настройки, запрос использует конфигурацию ACL, указанную для рабочей группы, а также расположение для хранения результатов запросов, указанное в рабочей группе. Для получения дополнительной информации см. WorkGroupConfiguration$EnforceWorkGroupConfiguration и Переопределение настроек рабочей группы клиентскими настройками.
S3AclOption -> (строка)
BUCKET_OWNER_FULL_CONTROL. Если запрос выполняется в рабочей группе, и рабочая группа переопределяет клиентские настройки, предварительно настроенный ACL Amazon S3, указанный в настройках рабочей группы, используется для всех запросов, выполняемых в рабочей группе. Дополнительную информацию о предварительно настроенных ACL Amazon S3 см. в разделе Предварительно настроенные ACL в руководстве пользователя Amazon S3.EnforceWorkGroupConfiguration -> (булево)
PublishCloudWatchMetricsEnabled -> (булево)
BytesScannedCutoffPerQuery -> (целое число)
RequesterPaysEnabled -> (булево)
true, позволяет членам, назначенным в рабочую группу, ссылаться на ведра Amazon S3 Requester Pays в запросах. Если установлено false, члены рабочей группы не могут запрашивать данные из ведёр Requester Pays, и запросы, которые извлекают данные из ведёр Requester Pays, вызывают ошибку. По умолчанию false. Дополнительную информацию о ведрах Requester Pays см. в разделе Ведра Requester Pays в руководстве разработчика Amazon Simple Storage Service.EngineVersion -> (структура)
Версия движка, которую используют все запросы, выполняемые в рабочей группе. Запросы в рабочей группе AmazonAthenaPreviewFunctionality выполняются на предварительной версии движка независимо от этой настройки.
SelectedEngineVersion -> (строка)
ListEngineVersions, включая AUTO. По умолчанию AUTO.EffectiveEngineVersion -> (строка)
CreateWorkGroup или UpdateWorkGroup, поле EffectiveEngineVersion игнорируется.AdditionalConfiguration -> (строка)
ExecutionRole -> (строка)
CustomerContentEncryptionConfiguration -> (структура)
Указывает ключ KMS, который используется для шифрования хранилищ данных пользователя в Athena. Эта настройка не применяется к рабочим группам Athena SQL.
KmsKey -> (строка)
EnableMinimumEncryptionConfiguration -> (булево)
Принудительно устанавливает минимальный уровень шифрования для рабочей группы для результатов запросов и вычислений, которые записываются в Amazon S3. При включении пользователи рабочей группы могут установить уровень шифрования только до минимального уровня, установленного администратором, или выше при отправке запросов.
Настройка EnforceWorkGroupConfiguration имеет приоритет над флагом EnableMinimumEncryptionConfiguration. Это означает, что если EnforceWorkGroupConfiguration равно true, флаг EnableMinimumEncryptionConfiguration игнорируется, и используется конфигурация шифрования рабочей группы.
IdentityCenterConfiguration -> (структура)
Указывает, поддерживает ли рабочая группа IAM Identity Center.
EnableIdentityCenter -> (булево)
IdentityCenterInstanceArn -> (строка)
QueryResultsS3AccessGrantsConfiguration -> (структура)
Указывает, включены ли для результатов запросов разрешения доступа к Amazon S3.
EnableS3AccessGrants -> (булево)
CreateUserLevelPrefix -> (булево)
AuthenticationType -> (строка)
DIRECTORY_IDENTITY.Краткая запись синтаксиса:
ResultConfiguration={OutputLocation=string,EncryptionConfiguration={EncryptionOption=string,KmsKey=string},ExpectedBucketOwner=string,AclConfiguration={S3AclOption=string}},EnforceWorkGroupConfiguration=boolean,PublishCloudWatchMetricsEnabled=boolean,BytesScannedCutoffPerQuery=long,RequesterPaysEnabled=boolean,EngineVersion={SelectedEngineVersion=string,EffectiveEngineVersion=string},AdditionalConfiguration=string,ExecutionRole=string,CustomerContentEncryptionConfiguration={KmsKey=string},EnableMinimumEncryptionConfiguration=boolean,IdentityCenterConfiguration={EnableIdentityCenter=boolean,IdentityCenterInstanceArn=string},QueryResultsS3AccessGrantsConfiguration={EnableS3AccessGrants=boolean,CreateUserLevelPrefix=boolean,AuthenticationType=string}
Синтаксис JSON:
{
"ResultConfiguration": {
"OutputLocation": "string",
"EncryptionConfiguration": {
"EncryptionOption": "SSE_S3"|"SSE_KMS"|"CSE_KMS",
"KmsKey": "string"
},
"ExpectedBucketOwner": "string",
"AclConfiguration": {
"S3AclOption": "BUCKET_OWNER_FULL_CONTROL"
}
},
"EnforceWorkGroupConfiguration": true|false,
"PublishCloudWatchMetricsEnabled": true|false,
"BytesScannedCutoffPerQuery": long,
"RequesterPaysEnabled": true|false,
"EngineVersion": {
"SelectedEngineVersion": "string",
"EffectiveEngineVersion": "string"
},
"AdditionalConfiguration": "string",
"ExecutionRole": "string",
"CustomerContentEncryptionConfiguration": {
"KmsKey": "string"
},
"EnableMinimumEncryptionConfiguration": true|false,
"IdentityCenterConfiguration": {
"EnableIdentityCenter": true|false,
"IdentityCenterInstanceArn": "string"
},
"QueryResultsS3AccessGrantsConfiguration": {
"EnableS3AccessGrants": true|false,
"CreateUserLevelPrefix": true|false,
"AuthenticationType": "DIRECTORY_IDENTITY"
}
}
--description (строка)
--tags (список)
Список тегов, разделённых запятыми, которые нужно добавить к создаваемой рабочей группе.
(структура)
Метка, которую вы назначаете ресурсу. Ресурсы Athena включают рабочие группы, каталоги данных и резервы ресурсов. Каждая метка состоит из ключа и необязательного значения, которые вы определяете. Например, вы можете использовать метки для категоризации ресурсов Athena по назначению, владельцу или среде. Используйте согласованный набор ключей меток, чтобы облегчить поиск и фильтрацию ресурсов в вашей учётной записи. См. Рекомендации по меткам для получения рекомендаций. Ключи меток могут содержать от 1 до 128 символов Юникода UTF-8, а значения меток — от 0 до 256 символов Юникода UTF-8. Метки могут содержать буквы и цифры, отображаемые в UTF-8, а также следующие символы: + - = . _ : / @. Ключи и значения меток чувствительны к регистру. Ключи меток должны быть уникальными для каждого ресурса. Если вы указываете более одной метки, разделяйте их запятыми.
Key -> (строка)
Value -> (строка)
Краткая запись синтаксиса:
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
- text
- таблица
- 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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, характерные для Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для создания рабочей группы
Следующий create-work-group пример создает рабочую группу под названием Data_Analyst_Group с местом хранения результатов запроса s3://amzn-s3-demo-bucket. Команда создает рабочую группу, которая переопределяет настройки конфигурации клиента, включая место хранения результатов запроса. Команда также включает метрики CloudWatch и добавляет три пары тегов "ключ-значение" в рабочую группу, чтобы отличать ее от других рабочих групп. Обратите внимание, что аргумент --configuration не содержит пробелов перед запятыми, разделяющими его параметры.
aws athena create-work-group \
--name Data_Analyst_Group \
--configuration ResultConfiguration={OutputLocation="s3://amzn-s3-demo-bucket"},EnforceWorkGroupConfiguration="true",PublishCloudWatchMetricsEnabled="true" \
--description "Workgroup for data analysts" \
--tags Key=Division,Value=West Key=Location,Value=Seattle Key=Team,Value="Big Data"
Эта команда не производит никакого вывода. Чтобы увидеть результаты, используйте aws athena get-work-group --work-group Data_Analyst_Group.
Дополнительную информацию см. в разделе Управление рабочими группами в Руководстве пользователя Amazon Athena.
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.