Spec-Zone.ru › AWS CLI v2

[ aws . cleanrooms ]

start-protected-query

Описание

Создаёт защищённый запрос, который запускается Clean Rooms.

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

Синтаксис

  start-protected-query
--type <value>
--membership-identifier <value>
--sql-parameters <value>
[--result-configuration <value>]
[--compute-configuration <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]

Параметры

--type (строка)

Тип защищённого запроса для запуска.

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

  • SQL

--membership-identifier (строка)

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

--sql-parameters (структура)

Параметры защищённого SQL-запроса.

queryString -> (строка)

Строка запроса, которая должна быть отправлена.

analysisTemplateArn -> (строка)

Amazon Resource Name (ARN), связанный с шаблоном анализа в рамках сотрудничества.

parameters -> (массив)

Параметры SQL защищённого запроса.

key -> (строка)

value -> (строка)

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

queryString=string,analysisTemplateArn=string,parameters={KeyName1=string,KeyName2=string}

Синтаксис JSON:

{
  "queryString": "string",
  "analysisTemplateArn": "string",
  "parameters": {"string": "string"
    ...}
}

--result-configuration (структура)

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

outputConfiguration -> (структура тегированного объединения)

Настройка результатов защищённого запроса.

Примечание

Это структура тегированного объединения. Можно задать только один из следующих ключей верхнего уровня: s3, member, distribute.

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

Требуемая настройка для защищённого запроса с типом вывода s3.

resultFormat -> (строка)

Желаемый формат файла результата.

bucket -> (строка)

Ведро S3 для выгрузки результатов защищённого запроса.

keyPrefix -> (строка)

Префикс S3 для выгрузки результатов защищённого запроса.

singleFileOutput -> (булево)

Указывает, должны ли файлы выводиться как один файл (TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.

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

Требуемая настройка для защищённого запроса с типом вывода member.

accountId -> (строка)

Уникальный идентификатор учётной записи.

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

Требуемая настройка для защищённого запроса с типом вывода distribute.

locations -> (список)

Список расположений, где вы хотите распространить результаты защищённого запроса. Каждое расположение должно указать либо пункт назначения S3, либо пункт назначения для участника сотрудничества.

Предупреждение

Вы не можете указать более одного расположения S3.

Вы не можете указать учётную запись исполнителя запроса в качестве расположения участника.

Вы должны включить либо настройку вывода S3, либо для участника сотрудничества для каждого расположения, но не оба.

(структура тегированного объединения)

Указывает, где будут распространяться результаты вашего защищённого запроса. Вы должны настроить либо пункт назначения S3, либо пункт назначения участника сотрудничества.

Примечание

Это структура тегированного объединения. Можно задать только один из следующих ключей верхнего уровня: s3, member.

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

Содержит настройки для записи результатов запроса в S3.

resultFormat -> (строка)

Желаемый формат файла результата.

bucket -> (строка)

Ведро S3 для выгрузки результатов защищённого запроса.

keyPrefix -> (строка)

Префикс S3 для выгрузки результатов защищённого запроса.

singleFileOutput -> (булево)

Указывает, должны ли файлы выводиться как один файл (TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.

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

Содержит детали конфигурации для вывода результатов запроса участнику.

accountId -> (строка)

Уникальный идентификатор учётной записи.

Синтаксис JSON:

{
  "outputConfiguration": {
    "s3": {
      "resultFormat": "CSV"|"PARQUET",
      "bucket": "string",
      "keyPrefix": "string",
      "singleFileOutput": true|false
    },
    "member": {
      "accountId": "string"
    },
    "distribute": {
      "locations": [
        {
          "s3": {
            "resultFormat": "CSV"|"PARQUET",
            "bucket": "string",
            "keyPrefix": "string",
            "singleFileOutput": true|false
          },
          "member": {
            "accountId": "string"
          }
        }
        ...
      ]
    }
  }
}

--compute-configuration (структура тегированного объединения)

Настройки вычислений для защищённого запроса.

Примечание

Это структура тегированного объединения. Можно задать только один из следующих ключей верхнего уровня: worker.

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

Настройки исполнителя для среды вычислений.

type -> (строка)

Тип конфигурации вычислений исполнителя.

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

Количество исполнителей.

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

worker={type=string,number=integer}

Синтаксис JSON:

{
  "worker": {
    "type": "CR.1X"|"CR.4X",
    "number": integer
  }
}

--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
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование конкретного профиля из файла учетных данных.

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

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

Вывод

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

Защищенный запрос.

id -> (строка)

Идентификатор экземпляра защищенного запроса.

membershipId -> (строка)

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

membershipArn -> (строка)

ARN членства.

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

Время создания защищенного запроса.

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

Параметры SQL защищенного запроса.

queryString -> (строка)

Строка запроса для отправки.

analysisTemplateArn -> (строка)

Amazon Resource Name (ARN), связанный с шаблоном анализа в рамках сотрудничества.

parameters -> (словарь)

Параметры SQL защищенного запроса.

key -> (строка)

value -> (строка)

status -> (строка)

Статус запроса.

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

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

outputConfiguration -> (структура помеченного союза)

Конфигурация результатов защищенного запроса.

Примечание

Это структура помеченного союза. Только один из следующих верхних ключей может быть задан: s3, member, distribute.

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

Необходимая конфигурация для защищенного запроса с типом вывода s3.

resultFormat -> (строка)

Предполагаемый формат файла результата.

bucket -> (строка)

Ведро S3 для выгрузки результатов защищенного запроса.

keyPrefix -> (строка)

Префикс S3 для выгрузки результатов защищенного запроса.

singleFileOutput -> (булево)

Указывает, следует ли выводить файлы как один файл (TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.

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

Необходимая конфигурация для защищенного запроса с типом вывода member.

accountId -> (строка)

Уникальный идентификатор учетной записи.

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

Необходимая конфигурация для защищенного запроса с типом вывода distribute.

locations -> (список)

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

Предупреждение

Вы не можете указать более одного расположения S3.

Вы не можете указать учетную запись исполнителя запроса в качестве расположения участника.

Вы должны включить либо конфигурацию вывода S3, либо конфигурацию вывода участника для каждого расположения, но не обе.

(структура помеченного союза)

Указывает, куда вы будете распределять результаты защищенного запроса. Вы должны настроить либо пункт назначения S3, либо пункт назначения участника сотрудничества.

Примечание

Это структура помеченного союза. Только один из следующих верхних ключей может быть задан: s3, member.

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

Содержит конфигурацию для записи результатов запроса в S3.

resultFormat -> (строка)

Предполагаемый формат файла результата.

bucket -> (строка)

Ведро S3 для выгрузки результатов защищенного запроса.

keyPrefix -> (строка)

Префикс S3 для выгрузки результатов защищенного запроса.

singleFileOutput -> (булево)

Указывает, следует ли выводить файлы как один файл (TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.

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

Содержит детали конфигурации для вывода участника защищенного запроса.

accountId -> (строка)

Уникальный идентификатор учетной записи.

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

Статистика о выполнении защищенного запроса.

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

Продолжительность защищенного запроса с момента создания до завершения запроса в миллисекундах.

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

Использованные ресурсы, подлежащие оплате.

units -> (число с плавающей точкой)

Количество часов, за которые были начислены Clean Rooms Processing Unit (CRPU).

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

Результат защищенного запроса.

output -> (структура помеченного союза)

Вывод защищенного запроса.

Примечание

Это структура помеченного союза. Только один из следующих верхних ключей может быть задан: s3, memberList, distribute.

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

Если присутствует, вывод для защищенного запроса с типом вывода S3.

location -> (строка)

Расположение результата в S3.

memberList -> (список)

Список Amazon Web Services учетных записей участников, которые получили результаты запроса.

(структура)

Подробности об участнике, получившем результат запроса.

accountId -> (строка)

Идентификатор Amazon Web Services учетной записи участника в рамках сотрудничества, который может получать результаты запроса.

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

Содержит информацию о выводе для защищенных запросов, использующих тип вывода distribute. Этот тип вывода позволяет отправлять результаты запроса на несколько расположений — либо в S3, либо участникам сотрудничества.

Примечание

Тип вывода distribute можно использовать только с аналитическим движком Spark.

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

Содержит информацию о выводе для защищенных запросов с типом вывода S3.

location -> (строка)

Расположение результата в S3.

memberList -> (список)

Содержит результаты вывода для каждого указанного в конфигурации вывода distribute расположения участника. Каждый элемент предоставляет подробности о распределении результатов участнику сотрудничества.

(структура)

Подробности об участнике, получившем результат запроса.

accountId -> (строка)

Идентификатор Amazon Web Services учетной записи участника в рамках сотрудничества, который может получать результаты запроса.

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

Ошибка, выброшенная защищенным запросом.

message -> (строка)

Описание причины сбоя запроса.

code -> (строка)

Код ошибки.

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

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

sensitivityParameters -> (список)

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

(структура)

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

aggregationType -> (строка)

Тип агрегирующей функции, которая была выполнена.

aggregationExpression -> (строка)

Агрегирующее выражение, которое было выполнено.

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

Максимальное количество строк, внесенных пользователем в SQL-запрос.

minColumnValue -> (число с плавающей точкой)

Нижняя граница агрегирующего выражения.

maxColumnValue -> (число с плавающей точкой)

Верхняя граница агрегирующего выражения.

computeConfiguration -> (структура помеченного союза)

Конфигурация вычисления для защищенного запроса.

Примечание

Это структура помеченного союза. Только один из следующих верхних ключей может быть задан: worker.

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

Конфигурация рабочего для вычислительной среды.

type -> (строка)

Тип конфигурации вычисления рабочего.

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

Количество рабочих.

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

Spec-Zone.ru

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