az managedcleanroom frontend analytics query

Nota:

Esta referencia forma parte de la extensión managedcleanroom para la CLI de Azure (versión 2.75.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az managedcleanroom frontend analytics query . Obtenga más información sobre las extensiones.

Administrar consultas de colaboración.

Comandos

Nombre Description Tipo Estado
az managedcleanroom frontend analytics query list

Enumera las consultas de una colaboración.

 Extension GA
az managedcleanroom frontend analytics query publish

Publique una consulta en la colaboración.

 Extension GA
az managedcleanroom frontend analytics query run

Ejecute una consulta en la colaboración.

 Extension GA
az managedcleanroom frontend analytics query runhistory

Vea el historial de ejecución de consultas.

 Extension GA
az managedcleanroom frontend analytics query runhistory list

Enumerar el historial de ejecución de consultas.

 Extension GA
az managedcleanroom frontend analytics query runresult

Ver los resultados de la ejecución de la consulta.

 Extension GA
az managedcleanroom frontend analytics query runresult show

Mostrar detalles de un resultado de ejecución de consulta.

 Extension GA
az managedcleanroom frontend analytics query show

Mostrar los detalles de la consulta.

 Extension GA
az managedcleanroom frontend analytics query vote

Votar en una consulta (aceptar o rechazar).

 Extension GA

az managedcleanroom frontend analytics query list

Enumera las consultas de una colaboración.

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

Ejemplos

Enumerar consultas

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

Parámetros requeridos

--collaboration-id -c

Identificador de colaboración.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version

Versión de API que se va a usar para esta solicitud. Valor predeterminado: 2026-03-01-preview.

Propiedad Valor
Valor predeterminado: 2026-03-01-preview
Valores aceptados: 2026-03-01-preview
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az managedcleanroom frontend analytics query publish

Publique una consulta en la colaboración.

Publique una configuración de consulta con segmentos SQL, secuencia de ejecución y asignaciones de conjuntos de datos. Los segmentos de consulta se pueden proporcionar como @file.json (objeto de segmento completo, incluida executionSequence) o como cadenas SQL insertadas (requiere el parámetro --execution-sequence). La secuencia de ejecución define qué segmentos se ejecutan en paralelo (mismo número) o secuencialmente (números diferentes). No se pueden mezclar @file.json y insertar segmentos SQL en el mismo 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]

Ejemplos

Publicación de una consulta con segmentos de archivos JSON (los archivos de segmento incluyen 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

Publicación de una consulta con segmentos SQL insertados (requiere --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"

Publicación de una consulta mediante un archivo de cuerpo JSON (modo heredado)

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

Parámetros requeridos

--collaboration-id -c

Identificador de colaboración.

--document-id -d

Identificador de documento de consulta.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--api-version

Versión de API que se va a usar para esta solicitud. Valor predeterminado: 2026-03-01-preview.

Propiedad Valor
Valor predeterminado: 2026-03-01-preview
Valores aceptados: 2026-03-01-preview
--body

Ruta de acceso del archivo de configuración JSON (@file.json) o cadena JSON (modo heredado).

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--execution-sequence

Números de secuencia de ejecución separados por comas (por ejemplo, "1,1,2"). Debe coincidir con el recuento de segmentos.

--input-datasets

Conjuntos de datos de entrada separados por comas como pares datasetId:viewName.

--output-dataset

Conjunto de datos de salida como datasetId:viewName.

--query-segment

Sql del segmento de consulta (@file.sql o insertado). Repetible. El orden es importante.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az managedcleanroom frontend analytics query run

Ejecute una consulta en la colaboración.

Ejecute una consulta publicada con parámetros de configuración opcionales. Si no se proporciona, se genera automáticamente un identificador de ejecución.

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]

Ejemplos

Ejecución de una consulta con la configuración predeterminada

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

Ejecución de una consulta con ejecución seca y intervalo de fechas

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"

Ejecución de una consulta con el optimizador habilitado

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

Ejecución de una consulta mediante un archivo de cuerpo JSON (modo heredado)

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

Parámetros requeridos

--collaboration-id -c

Identificador de colaboración.

--document-id -d

Identificador de documento de consulta.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--api-version

Versión de API que se va a usar para esta solicitud. Valor predeterminado: 2026-03-01-preview.

Propiedad Valor
Valor predeterminado: 2026-03-01-preview
Valores aceptados: 2026-03-01-preview
--body

Ruta de acceso del archivo de configuración JSON (@file.json) o cadena JSON (modo heredado).

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--dry-run

Realice una ejecución seca sin ejecutar la consulta.

Propiedad Valor
Valor predeterminado: False
--end-date

Fecha de finalización de la ejecución de la consulta.

--start-date

Fecha de inicio para la ejecución de consultas.

--use-optimizer

Use el optimizador de consultas.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az managedcleanroom frontend analytics query show

Mostrar los detalles de la consulta.

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

Ejemplos

Mostrar los detalles de la consulta

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

Parámetros requeridos

--collaboration-id -c

Identificador de colaboración.

--document-id -d

Identificador de documento (conjunto de datos, consulta o documento de consentimiento).

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version

Versión de API que se va a usar para esta solicitud. Valor predeterminado: 2026-03-01-preview.

Propiedad Valor
Valor predeterminado: 2026-03-01-preview
Valores aceptados: 2026-03-01-preview
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az managedcleanroom frontend analytics query vote

Votar en una consulta (aceptar o rechazar).

Envía un voto para una consulta en la colaboración. Este punto de conexión unificado permite aceptar o rechazar una consulta con un solo comando.

Este comando reemplaza los comandos "vote accept" y "vote reject" en la versión 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]

Ejemplos

Aceptar un voto de consulta

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

Rechazar un voto de consulta

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

Aceptar voto de consulta (formato corto)

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

Parámetros requeridos

--collaboration-id -c

Identificador de colaboración.

--document-id -d

Identificador de documento (conjunto de datos, consulta o documento de consentimiento).

--vote-action

Acción de voto (aceptar o rechazar).

Acción de voto que se va a realizar:

  • accept: Aprobar la consulta
  • reject: rechace la consulta.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--api-version

Versión de API que se va a usar para esta solicitud. Valor predeterminado: 2026-03-01-preview.

Propiedad Valor
Valor predeterminado: 2026-03-01-preview
Valores aceptados: 2026-03-01-preview
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--proposal-id

Id. de propuesta opcional.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False