az managedcleanroom frontend analytics query

Opmerking

Deze verwijzing maakt deel uit van de extensie managedcleanroom voor de Azure CLI (versie 2.75.0 of hoger). De extensie installeert automatisch de eerste keer dat u een queryopdracht az managedcleanroom frontend analytics uitvoert. Meer informatie over uitbreidingen.

Samenwerkingsquery's beheren.

Opdracht

Naam Description Type Status
az managedcleanroom frontend analytics query cancel-run

Een queryuitvoering annuleren.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query list

Geef query's weer voor een samenwerking.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query publish

Publiceer een query naar de samenwerking.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query run

Voer een query uit in de samenwerking.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query runhistory

Uitvoeringsgeschiedenis van query's weergeven.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query runhistory list

Lijst met uitvoeringsgeschiedenis van query's.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query runresult

Resultaten van queryuitvoering weergeven.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query runresult show

Details van een queryuitvoeringsresultaat weergeven.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query show

Querydetails weergeven.

 Extension Algemene Vergadering
az managedcleanroom frontend analytics query vote

Stem op een query (accepteren of afwijzen).

 Extension Algemene Vergadering

az managedcleanroom frontend analytics query cancel-run

Een queryuitvoering annuleren.

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

Voorbeelden

Een queryuitvoering annuleren

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

--document-id -d

Document-id (gegevensset, query of toestemmingsdocument).

--run-id -r

Queryuitvoerings-id.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az managedcleanroom frontend analytics query list

Geef query's weer voor een samenwerking.

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

Voorbeelden

Query's weergeven

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az managedcleanroom frontend analytics query publish

Publiceer een query naar de samenwerking.

Publiceer een queryconfiguratie met SQL-segmenten, uitvoeringsreeksen en gegevenssettoewijzingen. Querysegmenten kunnen worden opgegeven als @file.json (volledig segmentobject, inclusief executionSequence) of als inline SQL-tekenreeksen (vereist parameter --execution-sequence). De uitvoeringsreeks definieert welke segmenten parallel (hetzelfde getal) of opeenvolgend (verschillende getallen) worden uitgevoerd. Kan sql-segmenten niet combineren @file.json en inline in dezelfde opdracht.

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]

Voorbeelden

Een query publiceren met segmenten uit JSON-bestanden (segmentbestanden omvatten 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

Een query publiceren met inline SQL-segmenten (vereist --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"

Een query publiceren met behulp van een JSON-hoofdbestand (verouderde modus)

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

--document-id -d

Query's uitvoeren op document-id.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
--body

Pad naar JSON-configuratiebestand (@file.json) of JSON-tekenreeks (verouderde modus).

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--execution-sequence

Door komma's gescheiden uitvoeringsreeksnummers (bijvoorbeeld '1,1,2'). Moet overeenkomen met het aantal segmenten.

--input-datasets

Door komma's gescheiden invoergegevenssets als datasetId:viewName-paren.

--output-dataset

Uitvoergegevensset als datasetId:viewName.

--query-segment

Querysegment SQL (@file.sql of inline). Herhaalbare. Orde is belangrijk.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az managedcleanroom frontend analytics query run

Voer een query uit in de samenwerking.

Voer een gepubliceerde query uit met optionele configuratieparameters. Er wordt automatisch een uitvoerings-id gegenereerd als deze niet is opgegeven.

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]

Voorbeelden

Een query uitvoeren met standaardinstellingen

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

Een query uitvoeren met een drooguitvoering en een datumbereik

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"

Een query uitvoeren waarvoor optimizer is ingeschakeld

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

Een query uitvoeren op een grotere rekenkracht

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

Een query uitvoeren met behulp van een JSON-hoofdbestand (verouderde modus)

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

--document-id -d

Query's uitvoeren op document-id.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
--body

Pad naar JSON-configuratiebestand (@file.json) of JSON-tekenreeks (verouderde modus).

Optionele velden: runId (automatisch gegenereerd indien niet opgegeven), dryRun, startDate, endDate, useOptimizer, scaleSku (klein, gemiddeld of groot).

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--dry-run

Voer een droge uitvoering uit zonder de query uit te voeren.

Eigenschap Waarde
Default value: False
--end-date

Einddatum voor het uitvoeren van query's.

--scale-sku

Rekenkracht voor de uitvoering (klein, gemiddeld of groot).

Als u dit weglaat, wordt de standaardwaarde van de service (klein) gebruikt.

Eigenschap Waarde
Geaccepteerde waarden: large, medium, small
--start-date

Begindatum voor het uitvoeren van query's.

--use-optimizer

Gebruik de optimalisatiefunctie voor query's.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az managedcleanroom frontend analytics query show

Querydetails weergeven.

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

Voorbeelden

Querydetails weergeven

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

--document-id -d

Document-id (gegevensset, query of toestemmingsdocument).

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az managedcleanroom frontend analytics query vote

Stem op een query (accepteren of afwijzen).

Hiermee wordt een stem verzonden voor een query in de samenwerking. Met dit geïntegreerde eindpunt kunt u een query met één opdracht accepteren of afwijzen.

Met deze opdracht worden de afgeschafte opdrachten 'vote accept' en 'vote reject' vervangen in versie 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]

Voorbeelden

Een querystem accepteren

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

Een querystem weigeren

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

Stem van query accepteren (korte vorm)

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

Vereiste parameters

--collaboration-id -c

Samenwerkings-id.

--document-id -d

Document-id (gegevensset, query of toestemmingsdocument).

--vote-action

Stemactie (accepteren of afwijzen).

De stemactie die moet worden uitgevoerd:

  • accepteren: de query goedkeuren
  • weigeren: De query weigeren.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--api-version

API-versie die moet worden gebruikt voor deze aanvraag. Standaard: 2026-03-01-preview.

Eigenschap Waarde
Default value: 2026-03-01-preview
Geaccepteerde waarden: 2026-03-01-preview
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--proposal-id

Optionele voorstel-id.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False