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
Identificateur de collaboration.
Identificateur de document (jeu de données, requête ou document de consentement).
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 |
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
Identificateur de collaboration.
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 |
Chemin du fichier de configuration JSON (@file.json) ou chaîne JSON (mode hérité).
ID de référence de modification associé pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
Nombres de séquences d’exécution séparées par des virgules (par exemple, « 1,1,2 »). Doit correspondre au nombre de segments.
Jeux de données d’entrée séparés par des virgules en tant que paires datasetId :viewName.
Jeu de données de sortie en tant que datasetId :viewName.
Segment de requête SQL (@file.sql ou inline). Répétable. L’ordre importe.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
Identificateur de collaboration.
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 |
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).
ID de référence de modification associé pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
Effectuez une exécution sèche sans exécuter la requête.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Date de fin de l’exécution de la requête.
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 |
Date de début de l’exécution de la requête.
Utilisez l’optimiseur de requête.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
Identificateur de collaboration.
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.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
Identificateur de collaboration.
Identificateur de document (jeu de données, requête ou document de consentement).
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 |
ID de référence de modification associé pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
ID de proposition facultatif.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |