[ 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 -> (строка)
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 -> (строка)
keyPrefix -> (строка)
singleFileOutput -> (булево)
TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.member -> (структура)
Требуемая настройка для защищённого запроса с типом вывода member.
accountId -> (строка)
distribute -> (структура)
Требуемая настройка для защищённого запроса с типом вывода distribute.
locations -> (список)
Список расположений, где вы хотите распространить результаты защищённого запроса. Каждое расположение должно указать либо пункт назначения S3, либо пункт назначения для участника сотрудничества.
Предупреждение
Вы не можете указать более одного расположения S3.
Вы не можете указать учётную запись исполнителя запроса в качестве расположения участника.
Вы должны включить либо настройку вывода S3, либо для участника сотрудничества для каждого расположения, но не оба.
(структура тегированного объединения)
Указывает, где будут распространяться результаты вашего защищённого запроса. Вы должны настроить либо пункт назначения S3, либо пункт назначения участника сотрудничества.
Примечание
Это структура тегированного объединения. Можно задать только один из следующих ключей верхнего уровня:s3, member.s3 -> (структура)
Содержит настройки для записи результатов запроса в S3.
resultFormat -> (строка)
bucket -> (строка)
keyPrefix -> (строка)
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 -> (строка)
createTime -> (метка времени)
sqlParameters -> (структура)
Параметры SQL защищенного запроса.
queryString -> (строка)
analysisTemplateArn -> (строка)
parameters -> (словарь)
Параметры SQL защищенного запроса.
key -> (строка)
value -> (строка)
status -> (строка)
resultConfiguration -> (структура)
Содержит все необходимые детали для записи результатов запроса.
outputConfiguration -> (структура помеченного союза)
Конфигурация результатов защищенного запроса.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть задан:s3, member, distribute.s3 -> (структура)
Необходимая конфигурация для защищенного запроса с типом вывода s3.
resultFormat -> (строка)
bucket -> (строка)
keyPrefix -> (строка)
singleFileOutput -> (булево)
TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.member -> (структура)
Необходимая конфигурация для защищенного запроса с типом вывода member.
accountId -> (строка)
distribute -> (структура)
Необходимая конфигурация для защищенного запроса с типом вывода distribute.
locations -> (список)
Список расположений, куда вы хотите распределить результаты защищенного запроса. Каждое расположение должно указать либо пункт назначения S3, либо пункт назначения участника сотрудничества.
Предупреждение
Вы не можете указать более одного расположения S3.
Вы не можете указать учетную запись исполнителя запроса в качестве расположения участника.
Вы должны включить либо конфигурацию вывода S3, либо конфигурацию вывода участника для каждого расположения, но не обе.
(структура помеченного союза)
Указывает, куда вы будете распределять результаты защищенного запроса. Вы должны настроить либо пункт назначения S3, либо пункт назначения участника сотрудничества.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть задан:s3, member.s3 -> (структура)
Содержит конфигурацию для записи результатов запроса в S3.
resultFormat -> (строка)
bucket -> (строка)
keyPrefix -> (строка)
singleFileOutput -> (булево)
TRUE ) или как несколько файлов (FALSE ). Этот параметр поддерживается только для анализов с аналитическим движком Spark.member -> (структура)
Содержит детали конфигурации для вывода участника защищенного запроса.
accountId -> (строка)
statistics -> (структура)
Статистика о выполнении защищенного запроса.
totalDurationInMillis -> (целое число)
billedResourceUtilization -> (структура)
Использованные ресурсы, подлежащие оплате.
units -> (число с плавающей точкой)
result -> (структура)
Результат защищенного запроса.
output -> (структура помеченного союза)
Вывод защищенного запроса.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть задан:s3, memberList, distribute.s3 -> (структура)
Если присутствует, вывод для защищенного запроса с типом вывода S3.
location -> (строка)
memberList -> (список)
Список Amazon Web Services учетных записей участников, которые получили результаты запроса.
(структура)
Подробности об участнике, получившем результат запроса.
accountId -> (строка)
distribute -> (структура)
Содержит информацию о выводе для защищенных запросов, использующих тип вывода distribute. Этот тип вывода позволяет отправлять результаты запроса на несколько расположений — либо в S3, либо участникам сотрудничества.
Примечание
Тип выводаdistribute можно использовать только с аналитическим движком Spark.s3 -> (структура)
Содержит информацию о выводе для защищенных запросов с типом вывода S3.
location -> (строка)
memberList -> (список)
Содержит результаты вывода для каждого указанного в конфигурации вывода distribute расположения участника. Каждый элемент предоставляет подробности о распределении результатов участнику сотрудничества.
(структура)
Подробности об участнике, получившем результат запроса.
accountId -> (строка)
error -> (структура)
Ошибка, выброшенная защищенным запросом.
message -> (строка)
code -> (строка)
differentialPrivacy -> (структура)
Параметры чувствительности результатов защищенного запроса, полученные с помощью дифференциальной конфиденциальности.
sensitivityParameters -> (список)
Предоставляет параметры чувствительности, которые помогут лучше понять общее количество шума в результатах запроса.
(структура)
Предоставляет параметры чувствительности.
aggregationType -> (строка)
aggregationExpression -> (строка)
userContributionLimit -> (целое число)
minColumnValue -> (число с плавающей точкой)
maxColumnValue -> (число с плавающей точкой)
computeConfiguration -> (структура помеченного союза)
Конфигурация вычисления для защищенного запроса.
Примечание
Это структура помеченного союза. Только один из следующих верхних ключей может быть задан:worker.worker -> (структура)
Конфигурация рабочего для вычислительной среды.
type -> (строка)
number -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.