az managedcleanroom frontend analytics query

Uwaga / Notatka

To odwołanie jest częścią rozszerzenia managedcleanroom dla Azure CLI (wersja 2.75.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az managedcleanroom fronton analytics query . Dowiedz się więcej o rozszerzeniach.

Zarządzanie zapytaniami współpracy.

Polecenia

Nazwisko Opis Typ Stan
az managedcleanroom frontend analytics query list

Wyświetlanie listy zapytań dotyczących współpracy.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query publish

Opublikuj zapytanie we współpracy.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query run

Uruchom zapytanie we współpracy.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query runhistory

Wyświetl historię uruchamiania zapytania.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query runhistory list

Wyświetlanie listy historii uruchamiania zapytań.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query runresult

Wyświetl wyniki uruchamiania zapytania.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query runresult show

Pokaż szczegóły wyniku uruchomienia zapytania.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query show

Pokaż szczegóły zapytania.

 Extension ogólna dostępność
az managedcleanroom frontend analytics query vote

Zagłosuj na zapytanie (zaakceptuj lub odrzuć).

 Extension ogólna dostępność

az managedcleanroom frontend analytics query list

Wyświetlanie listy zapytań dotyczących współpracy.

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

Przykłady

Wyświetlanie listy zapytań

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

Parametry wymagane

--collaboration-id -c

Identyfikator współpracy.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--api-version

Wersja interfejsu API do użycia dla tego żądania. Ustawienie domyślne: 2026-03-01-preview.

Właściwość Wartość
Domyślna wartość: 2026-03-01-preview
Dopuszczalne wartości: 2026-03-01-preview
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az managedcleanroom frontend analytics query publish

Opublikuj zapytanie we współpracy.

Publikowanie konfiguracji zapytania przy użyciu segmentów SQL, sekwencji wykonywania i mapowań zestawów danych. Segmenty zapytań można podać jako @file.json (pełny obiekt segmentu, w tym executionSequence) lub jako wbudowane ciągi SQL (wymaga parametru --execution-sequence). Sekwencja wykonywania definiuje, które segmenty są uruchamiane równolegle (ta sama liczba) lub sekwencyjnie (różne liczby). Nie można mieszać @file.json i wbudowanych segmentów SQL w tym samym poleceniu.

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]

Przykłady

Publikowanie zapytania z segmentami z plików JSON (pliki segmentów obejmują wykonywanieSequence)

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

Publikowanie zapytania przy użyciu wbudowanych segmentów SQL (wymaga --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"

Publikowanie zapytania przy użyciu pliku treści JSON (starszego trybu)

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

Parametry wymagane

--collaboration-id -c

Identyfikator współpracy.

--document-id -d

Wykonywanie zapytań dotyczących identyfikatora dokumentu.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--api-version

Wersja interfejsu API do użycia dla tego żądania. Ustawienie domyślne: 2026-03-01-preview.

Właściwość Wartość
Domyślna wartość: 2026-03-01-preview
Dopuszczalne wartości: 2026-03-01-preview
--body

Ścieżka pliku konfiguracji JSON (@file.json) lub ciąg JSON (starszy tryb).

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--execution-sequence

Rozdzielone przecinkami numery sekwencji wykonywania (np. "1,1,2"). Musi być zgodna z liczbą segmentów.

--input-datasets

Rozdzielane przecinkami zestawy danych wejściowych jako pary datasetId:viewName.

--output-dataset

Wyjściowy zestaw danych jako datasetId:viewName.

--query-segment

Zapytania dotyczące segmentu SQL (@file.sql lub wbudowane). Powtarzalne. Porządek ma znaczenie.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az managedcleanroom frontend analytics query run

Uruchom zapytanie we współpracy.

Wykonaj opublikowane zapytanie z opcjonalnymi parametrami konfiguracji. Jeśli nie zostanie podany, zostanie automatycznie wygenerowany identyfikator przebiegu.

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]

Przykłady

Uruchamianie zapytania z ustawieniami domyślnymi

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

Uruchamianie zapytania z suchym przebiegiem i zakresem dat

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"

Uruchamianie zapytania z włączonym optymalizatorem

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

Uruchamianie zapytania przy użyciu pliku treści JSON (starszego trybu)

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

Parametry wymagane

--collaboration-id -c

Identyfikator współpracy.

--document-id -d

Wykonywanie zapytań dotyczących identyfikatora dokumentu.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--api-version

Wersja interfejsu API do użycia dla tego żądania. Ustawienie domyślne: 2026-03-01-preview.

Właściwość Wartość
Domyślna wartość: 2026-03-01-preview
Dopuszczalne wartości: 2026-03-01-preview
--body

Ścieżka pliku konfiguracji JSON (@file.json) lub ciąg JSON (starszy tryb).

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--dry-run

Wykonaj suchy przebieg bez wykonywania zapytania.

Właściwość Wartość
Domyślna wartość: False
--end-date

Data zakończenia wykonywania zapytania.

--start-date

Data rozpoczęcia wykonywania zapytania.

--use-optimizer

Użyj optymalizatora zapytań.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az managedcleanroom frontend analytics query show

Pokaż szczegóły zapytania.

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

Przykłady

Pokaż szczegóły zapytania

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

Parametry wymagane

--collaboration-id -c

Identyfikator współpracy.

--document-id -d

Identyfikator dokumentu (zestaw danych, zapytanie lub dokument zgody).

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--api-version

Wersja interfejsu API do użycia dla tego żądania. Ustawienie domyślne: 2026-03-01-preview.

Właściwość Wartość
Domyślna wartość: 2026-03-01-preview
Dopuszczalne wartości: 2026-03-01-preview
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az managedcleanroom frontend analytics query vote

Zagłosuj na zapytanie (zaakceptuj lub odrzuć).

Przesyła głos na zapytanie we współpracy. Ten ujednolicony punkt końcowy umożliwia akceptowanie lub odrzucanie zapytania za pomocą jednego polecenia.

To polecenie zastępuje przestarzałe polecenia "vote accept" i "vote reject" w wersji 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]

Przykłady

Akceptowanie głosowania w zapytaniu

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

Odrzuć głosowanie zapytania

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

Zaakceptuj głosowanie zapytania (krótki formularz)

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

Parametry wymagane

--collaboration-id -c

Identyfikator współpracy.

--document-id -d

Identyfikator dokumentu (zestaw danych, zapytanie lub dokument zgody).

--vote-action

Akcja głosowania (zaakceptuj lub odrzuć).

Akcja głosowania do wykonania:

  • accept: Zatwierdź zapytanie
  • odrzuć: odrzuć zapytanie.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--api-version

Wersja interfejsu API do użycia dla tego żądania. Ustawienie domyślne: 2026-03-01-preview.

Właściwość Wartość
Domyślna wartość: 2026-03-01-preview
Dopuszczalne wartości: 2026-03-01-preview
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--proposal-id

Opcjonalny identyfikator propozycji.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False