az managedcleanroom frontend analytics query

Hinweis

Diese Referenz ist Teil der managedcleanroom-Erweiterung für die Azure CLI (Version 2.75.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az managedcleanroom-Front-End-Analyseabfragebefehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Abfragen für die Zusammenarbeit.

Befehle

Name	Beschreibung	Typ	Status
az managedcleanroom frontend analytics query list	Listenabfragen für eine Zusammenarbeit auf.	Extension	GA
az managedcleanroom frontend analytics query publish	Veröffentlichen Sie eine Abfrage für die Zusammenarbeit.	Extension	GA
az managedcleanroom frontend analytics query run	Führen Sie eine Abfrage in der Zusammenarbeit aus.	Extension	GA
az managedcleanroom frontend analytics query runhistory	Abfrageausführungsverlauf anzeigen.	Extension	GA
az managedcleanroom frontend analytics query runhistory list	Listenabfrageausführungsverlauf.	Extension	GA
az managedcleanroom frontend analytics query runresult	Abfrageausführungsergebnisse anzeigen.	Extension	GA
az managedcleanroom frontend analytics query runresult show	Details eines Abfrageausführungsergebnisses anzeigen.	Extension	GA
az managedcleanroom frontend analytics query show	Abfragedetails anzeigen.	Extension	GA
az managedcleanroom frontend analytics query vote	Stimmen Sie über eine Abfrage ab (annehmen oder ablehnen).	Extension	GA

az managedcleanroom frontend analytics query list

Listenabfragen für eine Zusammenarbeit auf.

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

Beispiele

Auflisten von Abfragen

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

Erforderliche Parameter

--collaboration-id -c

Bezeichner für die Zusammenarbeit.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--api-version

API-Version, die für diese Anforderung verwendet werden soll. Standard: 2026-03-01-Preview.

Eigenschaft	Wert
Standardwert:	2026-03-01-preview
Zulässige Werte:	2026-03-01-preview

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az managedcleanroom frontend analytics query publish

Veröffentlichen Sie eine Abfrage für die Zusammenarbeit.

Veröffentlichen Sie eine Abfragekonfiguration mit SQL-Segmenten, Ausführungssequenzen und Datasetzuordnungen. Abfragesegmente können als @file.json (vollständiges Segmentobjekt einschließlich executionSequence) oder als Inline-SQL-Zeichenfolgen bereitgestellt werden (erfordert --execution-sequence-Parameter). Die Ausführungssequenz definiert, welche Segmente parallel (gleiche Zahl) oder sequenziell (unterschiedliche Zahlen) ausgeführt werden. Inline-SQL-Segmente können nicht im selben Befehl kombiniert @file.json werden.

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

Beispiele

Veröffentlichen einer Abfrage mit Segmenten aus JSON-Dateien (Segmentdateien umfassen 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

Veröffentlichen einer Abfrage mit Inline-SQL-Segmenten (erfordert --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"

Veröffentlichen einer Abfrage mithilfe einer JSON-Textdatei (Legacymodus)

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

Erforderliche Parameter

--collaboration-id -c

Bezeichner für die Zusammenarbeit.

--document-id -d

Abfragedokumentbezeichner.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--api-version

API-Version, die für diese Anforderung verwendet werden soll. Standard: 2026-03-01-Preview.

Eigenschaft	Wert
Standardwert:	2026-03-01-preview
Zulässige Werte:	2026-03-01-preview

--body

JSON-Konfigurationsdateipfad (@file.json) oder JSON-Zeichenfolge (Legacymodus).

--execution-sequence

Durch Trennzeichen getrennte Ausführungssequenznummern (z. B. "1,1,2"). Muss mit der Segmentanzahl übereinstimmen.

--input-datasets

Durch Trennzeichen getrennte Eingabedatensätze als datasetId:viewName-Paare.

--output-dataset

Ausgabe-Dataset als datasetId:viewName.

--query-segment

Abfragesegment SQL (@file.sql oder Inline). Wiederholbar. Bestellung ist wichtig.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az managedcleanroom frontend analytics query run

Führen Sie eine Abfrage in der Zusammenarbeit aus.

Führen Sie eine veröffentlichte Abfrage mit optionalen Konfigurationsparametern aus. Wenn sie nicht angegeben wird, wird automatisch eine Ausführungs-ID generiert.

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

Beispiele

Ausführen einer Abfrage mit Standardeinstellungen

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

Ausführen einer Abfrage mit Trockenlauf und Datumsbereich

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"

Ausführen einer Abfrage mit aktiviertem Optimierer

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

Ausführen einer Abfrage mithilfe einer JSON-Textkörperdatei (Legacymodus)

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

Erforderliche Parameter

--collaboration-id -c

Bezeichner für die Zusammenarbeit.

--document-id -d

Abfragedokumentbezeichner.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--api-version

API-Version, die für diese Anforderung verwendet werden soll. Standard: 2026-03-01-Preview.

Eigenschaft	Wert
Standardwert:	2026-03-01-preview
Zulässige Werte:	2026-03-01-preview

--body

JSON-Konfigurationsdateipfad (@file.json) oder JSON-Zeichenfolge (Legacymodus).

--dry-run

Führen Sie einen trockenen Vorgang aus, ohne die Abfrage auszuführen.

Eigenschaft	Wert
Standardwert:	False

--end-date

Enddatum für die Abfrageausführung.

--start-date

Startdatum für die Abfrageausführung.

--use-optimizer

Verwenden Sie den Abfrageoptimierer.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az managedcleanroom frontend analytics query show

Abfragedetails anzeigen.

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

Beispiele

Abfragedetails anzeigen

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

Erforderliche Parameter

--collaboration-id -c

Bezeichner für die Zusammenarbeit.

--document-id -d

Dokumentbezeichner (Dataset, Abfrage oder Zustimmungsdokument).

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--api-version

API-Version, die für diese Anforderung verwendet werden soll. Standard: 2026-03-01-Preview.

Eigenschaft	Wert
Standardwert:	2026-03-01-preview
Zulässige Werte:	2026-03-01-preview

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az managedcleanroom frontend analytics query vote

Stimmen Sie über eine Abfrage ab (annehmen oder ablehnen).

Sendet eine Abstimmung für eine Abfrage in der Zusammenarbeit. Mit diesem einheitlichen Endpunkt können Sie eine Abfrage mit einem einzigen Befehl annehmen oder ablehnen.

Dieser Befehl ersetzt die veralteten Befehle "Stimmen akzeptieren" und "Ablehnen" in Version 1.0.0b4.

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

Beispiele

Annehmen einer Abfragestimme

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

Ablehnen einer Abfragestimme

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

Abfragestimme akzeptieren (kurzes Formular)

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

Erforderliche Parameter

--collaboration-id -c

Bezeichner für die Zusammenarbeit.

--document-id -d

Dokumentbezeichner (Dataset, Abfrage oder Zustimmungsdokument).

--vote-action

Abstimmungsaktion (Annehmen oder Ablehnen).

Auszuführende Abstimmungsaktion:

accept: Genehmigen der Abfrage
reject: Reject the query.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--api-version

API-Version, die für diese Anforderung verwendet werden soll. Standard: 2026-03-01-Preview.

Eigenschaft	Wert
Standardwert:	2026-03-01-preview
Zulässige Werte:	2026-03-01-preview

--proposal-id

Optionale Vorschlags-ID.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?

Freigeben über

az managedcleanroom frontend analytics query

Befehle

az managedcleanroom frontend analytics query list

Beispiele

Erforderliche Parameter

Optionale Parameter

az managedcleanroom frontend analytics query publish

Beispiele

Erforderliche Parameter

Optionale Parameter

az managedcleanroom frontend analytics query run

Beispiele

Erforderliche Parameter

Optionale Parameter

az managedcleanroom frontend analytics query show

Beispiele

Erforderliche Parameter

Optionale Parameter

az managedcleanroom frontend analytics query vote

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback