Compartilhar via

az managedcleanroom frontend analytics query

Observação

Essa referência faz parte da extensão managedcleanroom para o CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de consulta de análise de front-end do az managedcleanroom . Saiba mais sobre extensões.

Gerenciar consultas de colaboração.

Comandos

Nome Description Tipo Status
az managedcleanroom frontend analytics query list

Listar consultas para uma colaboração.

 Extension GA
az managedcleanroom frontend analytics query publish

Publique uma consulta na colaboração.

 Extension GA
az managedcleanroom frontend analytics query run

Execute uma consulta na colaboração.

 Extension GA
az managedcleanroom frontend analytics query runhistory

Exibir o histórico de execução de consulta.

 Extension GA
az managedcleanroom frontend analytics query runhistory list

Listar o histórico de execuções de consulta.

 Extension GA
az managedcleanroom frontend analytics query runresult

Exibir os resultados da execução da consulta.

 Extension GA
az managedcleanroom frontend analytics query runresult show

Mostrar detalhes de um resultado de execução de consulta.

 Extension GA
az managedcleanroom frontend analytics query show

Mostrar detalhes da consulta.

 Extension GA
az managedcleanroom frontend analytics query vote

Vote em uma consulta (aceitar ou rejeitar).

 Extension GA

az managedcleanroom frontend analytics query list

Listar consultas para uma colaboração.

az managedcleanroom frontend analytics query list --collaboration-id
                                                  [--api-version {2026-03-01-preview}]

Exemplos

Listar consultas

az managedcleanroom frontend analytics query list -c <collaboration-id>

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics query publish

Publique uma consulta na colaboração.

Publique uma configuração de consulta com segmentos SQL, sequência de execução e mapeamentos de conjunto de dados. Os segmentos de consulta podem ser fornecidos como @file.json (objeto de segmento completo, incluindo executionSequence) ou como cadeias de caracteres SQL embutidas (requer --execution-sequence parameter). A sequência de execução define quais segmentos são executados em paralelo (mesmo número) ou sequencialmente (números diferentes). Não é possível misturar @file.json e agrupar segmentos SQL no mesmo comando.

az managedcleanroom frontend analytics query publish --collaboration-id
                                                     --document-id
                                                     [--acquire-policy-token]
                                                     [--api-version {2026-03-01-preview}]
                                                     [--body]
                                                     [--change-reference]
                                                     [--execution-sequence]
                                                     [--input-datasets]
                                                     [--output-dataset]
                                                     [--query-segment]

Exemplos

Publicar uma consulta com segmentos de arquivos JSON (arquivos de segmento incluem executionSequence)

az managedcleanroom frontend analytics query publish \
  --collaboration-id my-collab-123 \
  --document-id my-query \
  --query-segment @segment1.json \
  --query-segment @segment2.json \
  --query-segment @segment3.json \
  --input-datasets "dataset1:view1,dataset2:view2" \
  --output-dataset "output-dataset:results"

Note: Each segment JSON file should contain:
data, executionSequence, preConditions, postFilters fields

Publicar uma consulta com segmentos SQL embutidos (requer --execution-sequence)

az managedcleanroom frontend analytics query publish \
  --collaboration-id my-collab-123 \
  --document-id my-query \
  --query-segment "SELECT * FROM table1" \
  --query-segment "SELECT * FROM table2" \
  --execution-sequence "1,2" \
  --input-datasets "dataset1:view1" \
  --output-dataset "output-dataset:results"

Publicar uma consulta usando um arquivo de corpo JSON (modo herdado)

az managedcleanroom frontend analytics query publish               --collaboration-id my-collab-123               --document-id my-query               --body @query-config.json

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento de consulta.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
--body

Caminho do arquivo de configuração JSON (@file.json) ou cadeia de caracteres JSON (modo herdado).

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--execution-sequence

Números de sequência de execução separados por vírgulas (por exemplo, "1,1,2"). Deve corresponder à contagem de segmentos.

--input-datasets

Conjuntos de dados de entrada separados por vírgulas como pares datasetId:viewName.

--output-dataset

Conjunto de dados de saída como datasetId:viewName.

--query-segment

SQL do segmento de consulta (@file.sql ou embutido). Repetível. A ordem importa.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics query run

Execute uma consulta na colaboração.

Execute uma consulta publicada com parâmetros de configuração opcionais. Uma ID de execução será gerada automaticamente se não for fornecida.

az managedcleanroom frontend analytics query run --collaboration-id
                                                 --document-id
                                                 [--acquire-policy-token]
                                                 [--api-version {2026-03-01-preview}]
                                                 [--body]
                                                 [--change-reference]
                                                 [--dry-run]
                                                 [--end-date]
                                                 [--start-date]
                                                 [--use-optimizer]

Exemplos

Executar uma consulta com configurações padrão

az managedcleanroom frontend analytics query run               --collaboration-id my-collab-123               --document-id my-query

Executar uma consulta com a execução seca e o intervalo de datas

az managedcleanroom frontend analytics query run               --collaboration-id my-collab-123               --document-id my-query               --dry-run               --start-date "2024-01-01"               --end-date "2024-12-31"

Executar uma consulta com o otimizador habilitado

az managedcleanroom frontend analytics query run               --collaboration-id my-collab-123               --document-id my-query               --use-optimizer

Executar uma consulta usando um arquivo de corpo JSON (modo herdado)

az managedcleanroom frontend analytics query run               --collaboration-id my-collab-123               --document-id my-query               --body @run-config.json

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento de consulta.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
--body

Caminho do arquivo de configuração JSON (@file.json) ou cadeia de caracteres JSON (modo herdado).

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--dry-run

Execute uma execução seca sem executar a consulta.

Propriedade Valor
Valor padrão: False
--end-date

Data de término da execução da consulta.

--start-date

Data de início da execução da consulta.

--use-optimizer

Use o otimizador de consulta.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics query show

Mostrar detalhes da consulta.

az managedcleanroom frontend analytics query show --collaboration-id
                                                  --document-id
                                                  [--api-version {2026-03-01-preview}]

Exemplos

Mostrar detalhes da consulta

az managedcleanroom frontend analytics query show -c <cid> -d <document-id>

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento (conjunto de dados, consulta ou documento de consentimento).

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics query vote

Vote em uma consulta (aceitar ou rejeitar).

Envia um voto para uma consulta na colaboração. Esse ponto de extremidade unificado permite que você aceite ou rejeite uma consulta com um único comando.

Esse comando substitui os comandos preteridos "vote accept" e "vote reject" na versão 1.0.0b4.

az managedcleanroom frontend analytics query vote --collaboration-id
                                                  --document-id
                                                  --vote-action
                                                  [--acquire-policy-token]
                                                  [--api-version {2026-03-01-preview}]
                                                  [--change-reference]
                                                  [--proposal-id]

Exemplos

Aceitar um voto de consulta

az managedcleanroom frontend analytics query vote               --collaboration-id <cid>               --document-id <document-id>               --vote-action accept

Rejeitar um voto de consulta

az managedcleanroom frontend analytics query vote               --collaboration-id <cid>               --document-id <document-id>               --vote-action reject

Aceitar votação de consulta (forma curta)

az managedcleanroom frontend analytics query vote -c <cid> -d <doc-id> --vote-action accept

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento (conjunto de dados, consulta ou documento de consentimento).

--vote-action

Ação de votação (aceitar ou rejeitar).

A ação de votação a ser executada:

  • accept: Aprovar a consulta
  • rejeição: rejeite a consulta.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--proposal-id

ID de proposta opcional.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False