Spec-Zone.ru › AWS CLI v2

[ aws . glue ]

create-session

Описание

Создаёт новую сессию.

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

Синтаксис

  create-session
--id <value>
[--description <value>]
--role <value>
--command <value>
[--timeout <value>]
[--idle-timeout <value>]
[--default-arguments <value>]
[--connections <value>]
[--max-capacity <value>]
[--number-of-workers <value>]
[--worker-type <value>]
[--security-configuration <value>]
[--glue-version <value>]
[--tags <value>]
[--request-origin <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]

Параметры

--id (строка)

Идентификатор запроса сессии.

--description (строка)

Описание сессии.

--role (строка)

ARN роли IAM

--command (структура)

SessionCommand, выполняющий задачу.

Name -> (строка)

Указывает имя SessionCommand. Может быть ‘glueetl’ или ‘gluestreaming’.

PythonVersion -> (строка)

Указывает версию Python. Версия Python указывает версию, поддерживаемую для задач типа Spark.

Краткая форма:

Name=string,PythonVersion=string

Синтаксис JSON:

{
  "Name": "string",
  "PythonVersion": "string"
}

--timeout (целое число)

Количество минут до истечения срока действия сессии. По умолчанию для задач Spark ETL — 48 часов (2880 минут). Обратитесь к документации для других типов задач.

--idle-timeout (целое число)

Количество минут бездействия до истечения срока действия сессии. По умолчанию для задач Spark ETL — значение Timeout. Обратитесь к документации для других типов задач.

--default-arguments (массив)

Массив пар ключ-значение. Максимальное количество пар — 75.

key -> (строка)

value -> (строка)

Краткая форма:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--connections (структура)

Количество подключений для сессии.

Connections -> (список)

Список подключений, используемых задачей.

(строка)

Краткая форма:

Connections=string,string

Синтаксис JSON:

{
  "Connections": ["string", ...]
}

--max-capacity (двойное число)

Количество единиц обработки данных Glue (DPU), которые могут быть выделены при выполнении задачи. DPU — это относительная мера вычислительной мощности, состоящая из 4 виртуальных ЦП вычислительной мощности и 16 ГБ памяти.

--number-of-workers (целое число)

Количество рабочих процессов определённого типа WorkerType, используемых для сессии.

--worker-type (строка)

Тип предварительно определённого рабочего процесса, выделяемого при выполнении задачи. Принимает значения G.1X, G.2X, G.4X или G.8X для задач Spark. Принимает значение Z.2X для заметок Ray.

  • Для типа рабочего процесса G.1X каждый рабочий процесс соответствует 1 DPU (4 виртуальных ЦП, 16 ГБ памяти) с диском 94 ГБ и предоставляет 1 исполнитель на рабочий процесс. Мы рекомендуем этот тип рабочего процесса для таких задач, как преобразование данных, объединение и запросы, чтобы предложить масштабируемый и экономичный способ запуска большинства задач.
  • Для типа рабочего процесса G.2X каждый рабочий процесс соответствует 2 DPU (8 виртуальных ЦП, 32 ГБ памяти) с диском 138 ГБ и предоставляет 1 исполнитель на рабочий процесс. Мы рекомендуем этот тип рабочего процесса для таких задач, как преобразование данных, объединение и запросы, чтобы предложить масштабируемый и экономичный способ запуска большинства задач.
  • Для типа рабочего процесса G.4X каждый рабочий процесс соответствует 4 DPU (16 виртуальных ЦП, 64 ГБ памяти) с диском 256 ГБ и предоставляет 1 исполнитель на рабочий процесс. Мы рекомендуем этот тип рабочего процесса для задач, в которых рабочие нагрузки содержат наиболее сложные преобразования, агрегации, объединения и запросы. Этот тип рабочего процесса доступен только для задач Spark ETL Glue версии 3.0 или более поздних версий в следующих регионах Amazon Web Services: США (Восточная, Огайо), США (Восточная, Северная Вирджиния), США (Западная, Орегон), Азиатско-Тихоокеанский регион (Сингапур), Азиатско-Тихоокеанский регион (Сидней), Азиатско-Тихоокеанский регион (Токио), Канада (Центральная), Европа (Франкфурт), Европа (Ирландия) и Европа (Стокгольм).
  • Для типа рабочего процесса G.8X каждый рабочий процесс соответствует 8 DPU (32 виртуальных ЦП, 128 ГБ памяти) с диском 512 ГБ и предоставляет 1 исполнитель на рабочий процесс. Мы рекомендуем этот тип рабочего процесса для задач, в которых рабочие нагрузки содержат наиболее сложные преобразования, агрегации, объединения и запросы. Этот тип рабочего процесса доступен только для задач Spark ETL Glue версии 3.0 или более поздних версий в тех же регионах Amazon Web Services, что и для рабочего процесса типа G.4X.
  • Для типа рабочего процесса Z.2X каждый рабочий процесс соответствует 2 M-DPU (8 виртуальных ЦП, 64 ГБ памяти) с диском 128 ГБ и предоставляет до 8 рабочих процессов Ray на основе автомасштабирования.

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

  • Standard
  • G.1X
  • G.2X
  • G.025X
  • G.4X
  • G.8X
  • Z.2X

--security-configuration (строка)

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

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

Версия Glue определяет версии Apache Spark и Python, которые поддерживает Glue. GlueVersion должна быть больше 2.0.

--tags (массив)

Массив пар ключ-значение (метки), принадлежащих сессии.

key -> (строка)

value -> (строка)

Краткая форма:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--request-origin (строка)

Источник запроса.

--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 (строка)

Регион для использования. Перекрывает настройки config/env.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • вкл
  • выкл
  • авто

--no-sign-request (булево)

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

--ca-bundle (строка)

Сборник сертификатов CA для использования при проверке SSL-сертификатов. Перекрывает настройки config/env.

--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.

Вывод

Сессия -> (структура)

Возвращает объект сессии в ответе.

Id -> (строка)

Идентификатор сессии.

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

Дата и время создания сессии.

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

Статус сессии.

Ошибка -> (строка)

Сообщение об ошибке, отображаемое во время сессии.

Описание -> (строка)

Описание сессии.

Роль -> (строка)

Имя или Amazon Resource Name (ARN) роли IAM, связанной с сессией.

Команда -> (структура)

Объект команды. См. SessionCommand.

Имя -> (строка)

Указывает имя SessionCommand. Может быть 'glueetl' или 'gluestreaming'.

PythonVersion -> (строка)

Указывает версию Python. Версия Python указывает версию, поддерживаемую для задач типа Spark.

DefaultArguments -> (отображение)

Массив отображения пар ключ-значение. Максимальное количество пар — 75.

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

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

Подключения -> (структура)

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

Подключения -> (список)

Список подключений, используемых задачей.

(строка)

Прогресс -> (двойное значение)

Прогресс выполнения кода сессии.

Максимальная емкость -> (двойное значение)

Количество единиц обработки данных Glue (DPUs), которые могут быть выделены при выполнении задачи. DPU — это относительная мера вычислительной мощности, состоящая из 4 виртуальных процессорных ядер (vCPU) вычислительной мощности и 16 ГБ памяти.

SecurityConfiguration -> (строка)

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

GlueVersion -> (строка)

Версия Glue определяет версии Apache Spark и Python, которые поддерживаются Glue. GlueVersion должна быть больше 2.0.

Количество рабочих процессов -> (целое число)

Количество рабочих процессов определенного WorkerType для использования в сессии.

Тип рабочего процесса -> (строка)

Тип предопределенного рабочего процесса, который выделяется при запуске сессии. Принимает значение G.1X , G.2X , G.4X или G.8X для Spark-сессий. Принимает значение Z.2X для Ray-сессий.

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

Дата и время завершения этой сессии.

Время выполнения -> (двойное значение)

Общее время выполнения сессии.

DPUSeconds -> (двойное значение)

DPUs, потребленные сессией (формула: ExecutionTime * MaxCapacity).

Тайм-аут бездействия -> (целое число)

Количество минут бездействия перед истечением срока действия сессии.

Имя профиля -> (строка)

Имя профиля использования Glue, связанного с сессией.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API