Condividi tramite


Usare la visualizzazione query DAX

Con la vista query DAX in Power BI, è possibile visualizzare e usare query DAX (Data Analysis Expressions) nei modelli semantici.

Query DAX

In Power BI le formule DAX vengono usate per definire diversi tipi di calcoli per i dati, ma possono essere usate anche per definire la sicurezza dei ruoli. Le query DAX, d'altra parte, possono essere usate per restituire dati dal modello.

Le query DAX sono simili alle query SQL in quanto possono mostrare i dati già presenti. Le query DAX non creano elementi nel modello o negli oggetti visivi del report.

Le query DAX hanno due parti principali:

  • Istruzione EVALUATE , obbligatoria. Specifica cosa e come vengono restituiti i dati nella query.
  • Istruzione DEFINE , facoltativa. Consente di definire formule DAX, ad esempio una misura, da usare nella query. Le misure possono essere aggiunte al modello usando CodeLens quando vengono usate in DEFINE.

Per altre informazioni sull'uso delle query, vedere Query DAX nel riferimento a DAX.

Aprire la vista query DAX

In Power BI Desktop selezionare l'icona Visualizzazione query DAX sul lato sinistro.

Screenshot dell'icona della visualizzazione query DAX in Power BI Desktop.

Layout della visualizzazione query DAX

Verrà ora esaminata in dettaglio la visualizzazione query DAX in Power BI Desktop.

Diagramma che mostra il layout della visualizzazione query DAX.

La vista query DAX include questi elementi:

Barra multifunzione

La barra multifunzione della visualizzazione query DAX include azioni comuni usate per la scrittura di query DAX.

Screenshot della barra multifunzione della visualizzazione query DAX.

Esaminiamo più in dettaglio gli elementi della barra multifunzione:

Formatta query

Selezionare il pulsante Formatta query della barra multifunzione oppure usare MAIUSC+ALT+F per formattare la query corrente. La query è rientrata con le schede. Le funzioni DAX vengono modificate in UPPERCA edizione Standard e vengono aggiunte righe aggiuntive. La formattazione della query DAX è considerata una procedura consigliata e migliora la leggibilità delle query DAX. La formattazione rientra anche in modo che sia possibile comprimere ed espandere sezioni della query.

Screenshot del pulsante Formatta query.

Commento e annullamento del commento

Selezionare il pulsante della barra multifunzione Commento per aggiungere una doppia barra rovesciata (//) all'inizio della riga in cui si trova il cursore o tutte le righe selezionate. Questo commenta le righe e quando viene eseguita la query DAX, tali righe vengono ignorate.

Selezionare il pulsante Rimuovi commento della barra multifunzione da rimuovere // all'inizio di qualsiasi riga in cui si trova il cursore o tutte le righe selezionate. Non funziona sulle righe in cui viene aggiunta la notazione di commento a più righe.

È anche possibile usare CTRL+/ per alternare il commento e rimuovere il commento.

Screenshot dei pulsanti Comment e Rimuovi commento nella barra multifunzione della visualizzazione query DAX.

Trova e sostituisci

Selezionare il pulsante Trova della barra multifunzione o premere CTRL+F per cercare testo nell'editor di query DAX. Trova include opzioni per trovare maiuscole e minuscole, trovare una corrispondenza tra parole intere, usare un'espressione regolare e scorrere tutte le corrispondenze per la query corrente. È anche possibile selezionare la freccia di espansione a sinistra della casella Trova per immettere Sostituisci.

Screenshot del pulsante Trova nella barra multifunzione della visualizzazione query DAX.

Selezionare il pulsante Sostituisci sulla barra multifunzione oppure premere CTRL+H per cercare e sostituire il testo nell'editor di query DAX. Replace include opzioni per mantenere il caso e sostituire uno alla volta o tutti contemporaneamente.

Screenshot della funzionalità Sostituisci nella barra multifunzione della visualizzazione query DAX.

Riquadro comandi

Selezionare il pulsante della barra multifunzione del riquadro comandi oppure premere CTRL+ALT+P per aprire la casella del riquadro comandi. È possibile cercare altre azioni dell'editor di query DAX e visualizzare i tasti di scelta rapida associati.

Screenshot del riquadro comandi della visualizzazione query DAX.

Barra dei comandi

La barra dei comandi della vista query DAX include le azioni più importanti quando si usa la visualizzazione query DAX. Il pulsante Esegui esegue la query DAX o le righe selezionate di una query. Lo stato di una query dopo l'esecuzione viene visualizzato nella barra di stato inferiore.

Screenshot della barra dei comandi della visualizzazione query DAX.

Quando una query è in esecuzione, il pulsante diventa un pulsante Annulla , che può essere usato per arrestare una query in esecuzione.

Screenshot dell'annullamento della visualizzazione query DAX.

Editor di query DAX

La vista query DAX include un editor di query in cui è possibile scrivere e modificare query. È più che una barra della formula DAX più grande. È più potente e presenta molte analogie con l'editor DAX disponibile in VS Code.

L'editor di query DAX include gli elementi seguenti:

Suggerimenti e IntelliSense

Digitare la query e ottenere assistenza con i suggerimenti e IntelliSense durante la modifica.

Screenshot dell'editor di query DAX intelliSense.

Usare INVIO o TAB per aggiungere intellisense evidenziato oppure MAIUSC+INVIO o ALT+INVIO per passare a un'altra riga senza aggiungere l'opzione intellisense. Se si seleziona ESC, viene chiusa una delle sovrimpressioni.

Passare il puntatore del mouse per visualizzare le formule delle misure

Quando una misura è inclusa nella query DAX, è possibile passare il puntatore del mouse su di essa per visualizzare la formula, il nome e la descrizione.

Screenshot del passaggio del mouse per visualizzare la funzionalità della formula della misura.

Selezionare questa opzione per visualizzare le azioni rapide della lampadina

Se si seleziona una misura in un'istruzione EVALUATE in una query senza un'istruzione DEFINE, viene visualizzata la lampadina delle azioni rapide. Selezionare Definisci o Definisci con riferimenti per creare un'istruzione DEFINE con la formula di questa misura con o senza le formule DAX della misura di riferimento.

Aggiornare le misure del modello usando CodeLens

L'uso di DEFINE MEASURE è utile durante la creazione di misure. È possibile modificare più misure in una finestra e quindi eseguire la query per visualizzare i risultati di tutti o solo alcuni di essi con colonne specifiche raggruppate in base a colonne. Non è necessario creare un oggetto visivo tabella nella visualizzazione Report e passare da una formula all'altra. CodeLens esegue ulteriormente questo passaggio fornendo richieste quando la misura esiste già nel modello o, in caso contrario, può aggiungerla.

Misurare il flusso di lavoro di aggiornamento

Le azioni rapide a lampadina e CodeLens possono essere usate insieme in un flusso di lavoro completo:

  1. Nel menu di scelta rapida di una misura scegliere Query rapide, quindi Valuta per creare la query in una nuova scheda Query.
  2. Selezionare la misura nella query per definire o definire con riferimenti, aggiungendo l'istruzione DEFINE.
  3. Apportare aggiornamenti delle espressioni alla misura, quindi eseguire la query DAX per visualizzare la modifica.
  4. Quando la modifica viene visualizzata come previsto, usare la misura CodeLens Update: Sovrascrivi per salvarla di nuovo nel modello.

Ecco un modo più visivo per comprendere il flusso di lavoro:

Diagramma del flusso di lavoro.

Griglia risultati

Quando viene eseguita una query, i risultati vengono visualizzati nella griglia Risultati .

Screenshot della griglia dei risultati.

Se nell'editor di query sono presenti più istruzioni EVALUATE, è possibile restituire più risultati. È possibile usare l'elenco a discesa Risultato per spostarsi tra di essi. Il pulsante Copia copia l'intera griglia come tabella delimitata da tabulazioni con intestazioni. La griglia può essere ridimensionata usando le frecce dell'angolo superiore destro o manualmente con il cursore sul bordo tra la griglia dei risultati e l'editor di query.

Se la query genera un errore, viene visualizzata la griglia dei risultati.

Screenshot del messaggio di errore nella griglia dei risultati.

Un pulsante di copia trasferisce l'errore negli Appunti. L'inizio dell'errore indica dove si trova nella query l'errore. Nell'immagine precedente l'errore è:

"Query (4, 23) Impossibile determinare il valore per 'Sales 2'. La colonna non esiste o non esiste alcuna riga corrente per questa colonna".

E "Query (4, 23)" indica che l'errore è alla riga 4 e al carattere 23.

Schede query

La vista query DAX può avere più schede di query, che possono essere rinominate o rimosse. Mostrano anche lo stato corrente della query.

Screenshot delle schede Query.

Ogni scheda include un indicatore di stato:

  • Non viene visualizzato alcun indicatore prima dell'esecuzione di una query.
  • Un segno di spunta verde indica un'esecuzione di query riuscita.
  • Una croce rossa indica che si è verificato un errore.
  • Un quadrato pieno in un cerchio indica che la query è stata annullata.
  • Un orologio indica che la query è in esecuzione.

Le query possono essere eseguite in background, consentendo di continuare a lavorare su altre schede di query.

Salvataggio di query DAX

Le schede delle query della vista query DAX vengono salvate nel file quando si salva da Power BI Desktop, in modo da poter continuare la posizione in cui è stato interrotto quando si apre di nuovo il file. Se si usa la modalità sviluppatore per salvare un progetto di Power BI, ogni scheda query viene inclusa come file con estensione dax nella cartella DAXQueries della cartella del modello semantico. Per altre informazioni, vedere la documentazione relativa alla modalità sviluppatore di Power BI.

Attualmente non è possibile visualizzare o modificare le query DAX nel servizio Power BI. I visualizzatori del report o del modello semantico non visualizzano le query DAX salvate con il modello semantico.

Riquadro Dati

Il riquadro Dati mostra gli elementi del modello che consentono di scrivere query. I percorsi di modifica per la maggior parte di questi elementi sono bloccati nella visualizzazione query.

Query rapide

Il menu di scelta rapida del riquadro dati include query rapide. Usare query rapide per creare query in una nuova scheda query per tabelle, colonne e misure. Le query rapide sono progettate per migliorare la produttività per le attività comuni e creare in modo che possano essere facilmente modificate ulteriormente. Tutte le query rapide vengono create in una nuova scheda query e vengono eseguite automaticamente.

Ovunque

Definire tutte le misure nel modello crea una query con tutte le formule di misura visualizzate in una query. Cercare facilmente tutte le formule di misura.

Tabelle
  • Mostra le prime 100 righe crea una query usando edizione Standard LECTCOLUMNS() per visualizzare le prime 100 righe della tabella. Le colonne sono elencate in ogni riga per consentire una modifica semplice impostando come commento le righe. È incluso anche un ORDER BY per specificare l'ordinamento.

    Screenshot della mostra le prime 100 righe.

  • Mostra statistiche di colonna crea una query che mostra informazioni statistiche per ogni colonna della tabella. Vedere molte delle formule per informazioni su come aggregare le colonne come MIN, MAX, AVERAGE, COUNT e altro ancora.

  • Definire tutte le misure in questa tabella crea una query con le formule di misura di questa tabella visualizzate in una query.

Colonne
  • Mostra anteprima dati crea una query usando DISTINCT() per visualizzare i valori di una colonna.

    Screenshot dell'anteprima dei dati mostra.

  • Mostra statistiche colonna crea una query che mostra informazioni statistiche per questa colonna specifica. Per informazioni su come aggregare la colonna come MIN, MAX, AVERAGE, COUNT e altro ancora, vedere molte formule. La query restituita varia a seconda del tipo di dati della colonna, con statistiche diverse per le colonne numeriche, di testo e di data.

    Screenshot dell'anteprima della colonna mostra.

Misure
  • Evaluate crea una query per visualizzare il risultato della misura. SUMMARIZECOLUMNS() viene usato in modo da poter aggiungere in qualsiasi gruppo per colonne per visualizzare la misura in base a gruppi specifici, ad esempio Country, Product e così via.

    Screenshot della misura di valutazione.

  • Definire e valutare crea una query per visualizzare il risultato della misura e mostrare la formula della misura in un'istruzione DEFINE che può quindi essere modificata.

    Screenshot della misura di definizione e valutazione.

  • Definire con riferimenti e valutare crea una query per visualizzare il risultato della misura e mostrare non solo la formula della misura in un'istruzione DEFINE che può essere modificata, ma anche qualsiasi altra misura a cui si fa riferimento nella formula della misura. Modificare qualsiasi parte nel contesto completo della misura.

    Screenshot della definizione con riferimenti e valutazione.

Recupero di query DAX visive da analizzatore prestazioni

Gli oggetti visivi nella visualizzazione Report recuperano dati dal modello creando una query DAX. La query visiva può essere visualizzata nella vista query DAX usando analizzatore prestazioni. analizzatore prestazioni può fornire informazioni dettagliate sul motivo per cui un oggetto visivo potrebbe mostrare un valore imprevisto o semplicemente come modo per avviare rapidamente una query che è possibile modificare ulteriormente.

Nella visualizzazione Report passare alla barra multifunzione Ottimizza e quindi selezionare analizzatore prestazioni. Selezionare Avvia registrazione e quindi Aggiorna oggetti visivi. Nella tabella seguente espandere un oggetto visivo per visualizzare le opzioni per copiare la query o eseguirla nella visualizzazione query DAX. Se si seleziona Esegui in visualizzazione query DAX, la query visiva viene aggiunta come nuova scheda Query nella vista query DAX e quindi viene eseguita.

Screenshot delle query DAX visive nella funzionalità analizzatore prestazioni.

Considerazioni e limitazioni

La vista query DAX è attualmente in anteprima. Tenere presente quanto segue:

  • Aggiornare il modello: sovrascrivere la misura CodeLens rimuove i commenti nella formula DAX.
  • Modello di aggiornamento: la sovrascrittura delle misure CodeLens non viene visualizzata solo con modifiche di formattazione.
  • Aggiornare il modello: sovrascrivere le misure codeLens possono inserire righe aggiuntive quando si verifica un errore di sintassi.
  • 500+ righe nell'editor di query DAX hanno un ritardo notevole durante la digitazione.
  • Le azioni rapide lampadine per le misure vengono visualizzate solo quando nella scheda query non è presente alcuna istruzione DEFINE.
  • Format query interrompe la funzione RANKX.
  • Il riquadro comandi mostra i comandi che non funzionano ancora.
  • Le schede delle query non consentono ancora lo spostamento.
  • La griglia dei risultati non mostra ancora colonne e misure con il formato specificato, ad esempio Valuta, Numero intero con migliaia e così via.
  • Scaricare questo file da servizio Power BI non includerà le query DAX salvate nel modello semantico pubblicato.
  • La configurazione dell'integrazione Git iniziale dall'area di lavoro non includerà le query DAX salvate nel modello semantico pubblicato. Per altre informazioni, vedere Integrazione git di Fabric.

Esistono alcune limitazioni da tenere presenti:

  • Massimo 15 MB di dati per query. Dopo il superamento di 15 MB, la riga corrente viene completata, ma non vengono scritte righe aggiuntive.
  • Massimo 1.000.000 valori per query. Se si esegue una query per 20 colonne, è possibile ottenere un massimo di 50.000 righe (1 milione diviso per 20).
  • Definire tutte le misure in questa tabella o modello non è disponibile quando sono presenti più di 500 misure.