az managedcleanroom frontend analytics query

Note

Cette référence fait partie de l’extension managedcleanroom pour la Azure CLI (version 2.75.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de requête d’analytique frontend d’az managedcleanroom . Apprenez-en davantage sur les extensions.

Gérer les requêtes de collaboration.

Commandes

Nom Description Type État
az managedcleanroom frontend analytics query cancel-run

Annuler une exécution de requête.

Extension GA
az managedcleanroom frontend analytics query list

Répertorier les requêtes pour une collaboration.

Extension GA
az managedcleanroom frontend analytics query publish

Publiez une requête dans la collaboration.

Extension GA
az managedcleanroom frontend analytics query run

Exécutez une requête dans la collaboration.

Extension GA
az managedcleanroom frontend analytics query runhistory

Afficher l’historique des exécutions de requête.

Extension GA
az managedcleanroom frontend analytics query runhistory list

Répertorier l’historique des exécutions des requêtes.

Extension GA
az managedcleanroom frontend analytics query runresult

Affichez les résultats de l’exécution des requêtes.

Extension GA
az managedcleanroom frontend analytics query runresult show

Afficher les détails d’un résultat d’exécution de requête.

Extension GA
az managedcleanroom frontend analytics query show

Afficher les détails de la requête.

Extension GA
az managedcleanroom frontend analytics query vote

Votez sur une requête (accepter ou rejeter).

Extension GA

az managedcleanroom frontend analytics query cancel-run

Annuler une exécution de requête.

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

Exemples

Annuler une exécution de requête

az managedcleanroom frontend analytics query cancel-run -c <cid> --document-id <document-id> --run-id <run-id>

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

--document-id -d

Identificateur de document (jeu de données, requête ou document de consentement).

--run-id -r

Identificateur d’exécution de requête.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az managedcleanroom frontend analytics query list

Répertorier les requêtes pour une collaboration.

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

Exemples

Répertorier les requêtes

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

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az managedcleanroom frontend analytics query publish

Publiez une requête dans la collaboration.

Publiez une configuration de requête avec des segments SQL, une séquence d’exécution et des mappages de jeux de données. Les segments de requête peuvent être fournis en tant que @file.json (objet segment complet, y compris executionSequence) ou en tant que chaînes SQL inline (nécessite un paramètre --execution-sequence). La séquence d’exécution définit les segments exécutés en parallèle (même nombre) ou séquentiellement (nombres différents). Impossible de combiner @file.json et d’inliner des segments SQL dans la même commande.

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]

Exemples

Publier une requête avec des segments à partir de fichiers JSON (les fichiers segment incluent 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

Publier une requête avec des segments SQL inline (nécessite --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"

Publier une requête à l’aide d’un fichier de corps JSON (mode hérité)

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

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

--document-id -d

Interroger l’identificateur de document.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
--body

Chemin du fichier de configuration JSON (@file.json) ou chaîne JSON (mode hérité).

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--execution-sequence

Nombres de séquences d’exécution séparées par des virgules (par exemple, « 1,1,2 »). Doit correspondre au nombre de segments.

--input-datasets

Jeux de données d’entrée séparés par des virgules en tant que paires datasetId :viewName.

--output-dataset

Jeu de données de sortie en tant que datasetId :viewName.

--query-segment

Segment de requête SQL (@file.sql ou inline). Répétable. L’ordre importe.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az managedcleanroom frontend analytics query run

Exécutez une requête dans la collaboration.

Exécutez une requête publiée avec des paramètres de configuration facultatifs. Un ID d’exécution est généré automatiquement s’il n’est pas fourni.

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]
                                                 [--scale-sku {large, medium, small}]
                                                 [--start-date]
                                                 [--use-optimizer]

Exemples

Exécuter une requête avec les paramètres par défaut

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

Exécuter une requête avec une exécution sèche et une plage de dates

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"

Exécuter une requête avec optimizer activé

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

Exécuter une requête sur une plus grande taille de calcul

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

Exécuter une requête à l’aide d’un fichier de corps JSON (mode hérité)

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

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

--document-id -d

Interroger l’identificateur de document.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
--body

Chemin du fichier de configuration JSON (@file.json) ou chaîne JSON (mode hérité).

Champs facultatifs : runId (généré automatiquement s’il n’est pas fourni), dryRun, startDate, endDate, useOptimizer, scaleSku (petit, moyen ou grand).

--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--dry-run

Effectuez une exécution sèche sans exécuter la requête.

Propriété Valeur
Valeur par défaut: False
--end-date

Date de fin de l’exécution de la requête.

--scale-sku

Taille de calcul pour l’exécution (petite, moyenne ou grande).

S’il est omis, le service par défaut (petit) est utilisé.

Propriété Valeur
Valeurs acceptées: large, medium, small
--start-date

Date de début de l’exécution de la requête.

--use-optimizer

Utilisez l’optimiseur de requête.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az managedcleanroom frontend analytics query show

Afficher les détails de la requête.

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

Exemples

Afficher les détails de la requête

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

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

--document-id -d

Identificateur de document (jeu de données, requête ou document de consentement).

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az managedcleanroom frontend analytics query vote

Votez sur une requête (accepter ou rejeter).

Soumet un vote pour une requête dans la collaboration. Ce point de terminaison unifié vous permet d’accepter ou de rejeter une requête avec une seule commande.

Cette commande remplace les commandes « vote accept » et « vote reject » déconseillées dans la version 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]

Exemples

Accepter un vote de requête

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

Rejeter un vote de requête

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

Accepter le vote de requête (formulaire court)

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

Paramètres obligatoires

--collaboration-id -c

Identificateur de collaboration.

--document-id -d

Identificateur de document (jeu de données, requête ou document de consentement).

--vote-action

Action de vote (accepter ou rejeter).

Action de vote à effectuer :

  • accept : Approuver la requête
  • rejet : rejeter la requête.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--api-version

Version de l’API à utiliser pour cette requête. Valeur par défaut : 2026-03-01-preview.

Propriété Valeur
Valeur par défaut: 2026-03-01-preview
Valeurs acceptées: 2026-03-01-preview
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--proposal-id

ID de proposition facultatif.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False