Condividi tramite

az managedcleanroom frontend analytics query

Annotazioni

Questo riferimento fa parte dell'estensione managedcleanroom per l'interfaccia della riga di comando di Azure (versione 2.75.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az managedcleanroom front-end analytics query . Altre informazioni sulle estensioni.

Gestire le query di collaborazione.

Comandi

Nome Descrizione Tipo Status
az managedcleanroom frontend analytics query list

Elencare le query per una collaborazione.

 Extension GA
az managedcleanroom frontend analytics query publish

Pubblicare una query nella collaborazione.

 Extension GA
az managedcleanroom frontend analytics query run

Eseguire una query nella collaborazione.

 Extension GA
az managedcleanroom frontend analytics query runhistory

Visualizzare la cronologia di esecuzione delle query.

 Extension GA
az managedcleanroom frontend analytics query runhistory list

Elencare la cronologia di esecuzione delle query.

 Extension GA
az managedcleanroom frontend analytics query runresult

Visualizzare i risultati dell'esecuzione della query.

 Extension GA
az managedcleanroom frontend analytics query runresult show

Visualizzare i dettagli del risultato dell'esecuzione di una query.

 Extension GA
az managedcleanroom frontend analytics query show

Mostra i dettagli della query.

 Extension GA
az managedcleanroom frontend analytics query vote

Votare su una query (accettare o rifiutare).

 Extension GA

az managedcleanroom frontend analytics query list

Elencare le query per una collaborazione.

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

Esempio

Elencare le query

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

Parametri necessari

--collaboration-id -c

Identificatore di collaborazione.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--api-version

Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.

Proprietà Valore
Valore predefinito: 2026-03-01-preview
Valori accettati: 2026-03-01-preview
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az managedcleanroom frontend analytics query publish

Pubblicare una query nella collaborazione.

Pubblicare una configurazione di query con segmenti SQL, sequenza di esecuzione e mapping dei set di dati. I segmenti di query possono essere forniti come @file.json (oggetto segmento completo incluso executionSequence) o come stringhe SQL inline (richiede il parametro --execution-sequence). La sequenza di esecuzione definisce i segmenti eseguiti in parallelo (stesso numero) o sequenziale (numeri diversi). Impossibile combinare @file.json e inline segmenti SQL nello stesso comando.

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]

Esempio

Pubblicare una query con segmenti da file JSON (i file di segmento includono 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

Pubblicare una query con segmenti SQL inline (richiede --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"

Pubblicare una query usando un file del corpo JSON (modalità legacy)

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

Parametri necessari

--collaboration-id -c

Identificatore di collaborazione.

--document-id -d

Identificatore del documento di query.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--api-version

Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.

Proprietà Valore
Valore predefinito: 2026-03-01-preview
Valori accettati: 2026-03-01-preview
--body

Percorso del file di configurazione JSON (@file.json) o stringa JSON (modalità legacy).

--execution-sequence

Numeri di sequenza di esecuzione delimitati da virgole ,ad esempio "1,1,2". Deve corrispondere al numero di segmenti.

--input-datasets

Set di dati di input delimitati da virgole come coppie datasetId:viewName.

--output-dataset

Set di dati di output come datasetId:viewName.

--query-segment

Segmento di query SQL (@file.sql o inline). Ripetibile. L'ordine è importante.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az managedcleanroom frontend analytics query run

Eseguire una query nella collaborazione.

Eseguire una query pubblicata con parametri di configurazione facoltativi. Se non viene specificato, viene generato automaticamente un ID di esecuzione.

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]

Esempio

Eseguire una query con le impostazioni predefinite

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

Eseguire una query con esecuzione secca e intervallo di date

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"

Eseguire una query con Optimizer abilitato

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

Eseguire una query usando un file del corpo JSON (modalità legacy)

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

Parametri necessari

--collaboration-id -c

Identificatore di collaborazione.

--document-id -d

Identificatore del documento di query.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--api-version

Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.

Proprietà Valore
Valore predefinito: 2026-03-01-preview
Valori accettati: 2026-03-01-preview
--body

Percorso del file di configurazione JSON (@file.json) o stringa JSON (modalità legacy).

--dry-run

Eseguire un'esecuzione asciutta senza eseguire la query.

Proprietà Valore
Valore predefinito: False
--end-date

Data di fine per l'esecuzione della query.

--start-date

Data di inizio per l'esecuzione della query.

--use-optimizer

Usare Query Optimizer.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az managedcleanroom frontend analytics query show

Mostra i dettagli della query.

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

Esempio

Visualizzare i dettagli della query

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

Parametri necessari

--collaboration-id -c

Identificatore di collaborazione.

--document-id -d

Identificatore del documento (set di dati, query o documento di consenso).

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--api-version

Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.

Proprietà Valore
Valore predefinito: 2026-03-01-preview
Valori accettati: 2026-03-01-preview
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az managedcleanroom frontend analytics query vote

Votare su una query (accettare o rifiutare).

Invia un voto per una query nella collaborazione. Questo endpoint unificato consente di accettare o rifiutare una query con un singolo comando.

Questo comando sostituisce i comandi deprecati "vote accept" e "vote reject" nella versione 1.0.0b4.

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

Esempio

Accettare un voto di query

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

Rifiutare un voto di query

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

Accettare il voto di query (forma breve)

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

Parametri necessari

--collaboration-id -c

Identificatore di collaborazione.

--document-id -d

Identificatore del documento (set di dati, query o documento di consenso).

--vote-action

Azione di voto (accettare o rifiutare).

Azione di voto da eseguire:

  • accept: Approvare la query
  • reject: rifiuta la query.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--api-version

Versione api da usare per questa richiesta. Impostazione predefinita: 2026-03-01-preview.

Proprietà Valore
Valore predefinito: 2026-03-01-preview
Valori accettati: 2026-03-01-preview
--proposal-id

ID proposta facoltativo.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False