az managedcleanroom frontend analytics query

Anmärkning

Den här referensen är en del av tillägget managedcleanroom för Azure CLI (version 2.75.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az managedcleanroom-frågekommando för klientdelsanalys . Läs mer om tillägg.

Hantera samarbetsfrågor.

Kommandon

Name	Description	Typ	Status
az managedcleanroom frontend analytics query list	Lista frågor för ett samarbete.	Extension	GA
az managedcleanroom frontend analytics query publish	Publicera en fråga till samarbetet.	Extension	GA
az managedcleanroom frontend analytics query run	Kör en fråga i samarbetet.	Extension	GA
az managedcleanroom frontend analytics query runhistory	Visa historik för frågekörning.	Extension	GA
az managedcleanroom frontend analytics query runhistory list	Visa en lista över frågekörningshistorik.	Extension	GA
az managedcleanroom frontend analytics query runresult	Visa frågekörningsresultat.	Extension	GA
az managedcleanroom frontend analytics query runresult show	Visa information om ett frågekörningsresultat.	Extension	GA
az managedcleanroom frontend analytics query show	Visa frågeinformation.	Extension	GA
az managedcleanroom frontend analytics query vote	Rösta på en fråga (acceptera eller avvisa).	Extension	GA

az managedcleanroom frontend analytics query list

Lista frågor för ett samarbete.

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

Exempel

Lista frågor

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

Obligatoriska parametrar

--collaboration-id -c

Samarbetsidentifierare.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--api-version

API-version som ska användas för den här begäran. Standard: 2026-03-01-preview.

Egenskap	Värde
Standardvärde:	2026-03-01-preview
Godkända värden:	2026-03-01-preview

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az managedcleanroom frontend analytics query publish

Publicera en fråga till samarbetet.

Publicera en frågekonfiguration med SQL-segment, körningssekvens och datamängdsmappningar. Frågesegment kan anges som @file.json (fullständigt segmentobjekt inklusive executionSequence) eller som infogade SQL-strängar (kräver parametern --execution-sequence). Körningssekvensen definierar vilka segment som körs parallellt (samma nummer) eller sekventiellt (olika tal). Det går inte att blanda @file.json och infoga SQL-segment i samma kommando.

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]

Exempel

Publicera en fråga med segment från JSON-filer (segmentfiler inkluderar 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

Publicera en fråga med infogade SQL-segment (kräver --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"

Publicera en fråga med en JSON-brödtextfil (äldre läge)

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

Obligatoriska parametrar

--collaboration-id -c

Samarbetsidentifierare.

--document-id -d

Frågedokumentidentifierare.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--api-version

API-version som ska användas för den här begäran. Standard: 2026-03-01-preview.

Egenskap	Värde
Standardvärde:	2026-03-01-preview
Godkända värden:	2026-03-01-preview

--body

JSON-konfigurationsfilsökväg (@file.json) eller JSON-sträng (äldre läge).

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--execution-sequence

Kommaavgränsade körningssekvensnummer (t.ex. "1,1,2"). Måste matcha antalet segment.

--input-datasets

Kommaavgränsade indatauppsättningar som datasetId:viewName-par.

--output-dataset

Mata ut datauppsättningen som datasetId:viewName.

--query-segment

Frågesegmentet SQL (@file.sql eller infogat). Repeterbar. Ordning spelar roll.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az managedcleanroom frontend analytics query run

Kör en fråga i samarbetet.

Kör en publicerad fråga med valfria konfigurationsparametrar. Ett körnings-ID genereras automatiskt om det inte tillhandahålls.

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]

Exempel

Köra en fråga med standardinställningar

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

Köra en fråga med torr körning och datumintervall

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"

Köra en fråga med optimeraren aktiverad

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

Köra en fråga med en JSON-brödtextfil (äldre läge)

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

Obligatoriska parametrar

--collaboration-id -c

Samarbetsidentifierare.

--document-id -d

Frågedokumentidentifierare.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--api-version

API-version som ska användas för den här begäran. Standard: 2026-03-01-preview.

Egenskap	Värde
Standardvärde:	2026-03-01-preview
Godkända värden:	2026-03-01-preview

--body

JSON-konfigurationsfilsökväg (@file.json) eller JSON-sträng (äldre läge).

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--dry-run

Utför en torr körning utan att köra frågan.

Egenskap	Värde
Standardvärde:	False

--end-date

Slutdatum för frågekörning.

--start-date

Startdatum för frågekörning.

--use-optimizer

Använd frågeoptimeraren.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az managedcleanroom frontend analytics query show

Visa frågeinformation.

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

Exempel

Visa frågeinformation

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

Obligatoriska parametrar

--collaboration-id -c

Samarbetsidentifierare.

--document-id -d

Dokumentidentifierare (datauppsättning, fråga eller medgivandedokument).

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--api-version

API-version som ska användas för den här begäran. Standard: 2026-03-01-preview.

Egenskap	Värde
Standardvärde:	2026-03-01-preview
Godkända värden:	2026-03-01-preview

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az managedcleanroom frontend analytics query vote

Rösta på en fråga (acceptera eller avvisa).

Skickar en röst för en fråga i samarbetet. Med den här enhetliga slutpunkten kan du acceptera eller avvisa en fråga med ett enda kommando.

Det här kommandot ersätter de inaktuella kommandona "vote accept" och "vote reject" i 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]

Exempel

Acceptera en frågeomröstning

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

Avvisa en frågeomröstning

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

Acceptera frågeröstning (kort formulär)

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

Obligatoriska parametrar

--collaboration-id -c

Samarbetsidentifierare.

--document-id -d

Dokumentidentifierare (datauppsättning, fråga eller medgivandedokument).

--vote-action

Röståtgärd (acceptera eller avvisa).

Röståtgärden som ska utföras:

accept: Godkänn frågan
reject: Avvisa frågan.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--api-version

API-version som ska användas för den här begäran. Standard: 2026-03-01-preview.

Egenskap	Värde
Standardvärde:	2026-03-01-preview
Godkända värden:	2026-03-01-preview

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--proposal-id

Valfritt förslags-ID.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

Feedback

Var den här sidan till hjälp?