Modifica avanzata per le query di destinazione dati in Dataflow Gen2 (anteprima)

Quando si configura una destinazione dati in Dataflow Gen2, il sistema crea automaticamente query interne che gestiscono la logica di spostamento e caricamento per la destinazione. Nella maggior parte dei casi, non è necessario interagire direttamente con queste query. Tuttavia, per scenari avanzati in cui è necessario un maggiore controllo sul comportamento di destinazione, è possibile abilitare la modifica avanzata per modificare le query di destinazione direttamente usando il codice M di Power Query.

Prerequisiti

Prima di usare la modifica avanzata per le query di destinazione dei dati, è necessario avere familiarità con:

• Che cos'è Dataflow Gen2?
• Destinazioni dati e impostazioni gestite di Flusso di dati Gen2
• Lingua della formula di Power Query M

Abilitare la modifica avanzata per le query di destinazione dati

Per impostazione predefinita, la funzionalità di modifica avanzata per le query di destinazione dati è disabilitata. È necessario abilitarlo in modo esplicito nelle opzioni del flusso di dati prima di poter accedere all'editor avanzato.

1. Aprire il flusso di dati nell'editor di Power Query.

2. Selezionare Opzioni nella scheda Home della barra multifunzione.

3. Nella finestra di dialogo Opzioni scorrere verso il basso fino alla sezione Destinazioni dati .

4. Selezionare la casella di controllo Abilita modifica avanzata per le query di destinazione dati.

   

5. Viene visualizzata una finestra di dialogo di avviso che illustra che la modifica delle query di destinazione può causare un comportamento imprevisto o interrompere il flusso di dati. Leggere attentamente l'avviso.

   

6. Selezionare OK per confermare e abilitare la funzionalità.

7. Selezionare OK per chiudere la finestra di dialogo Opzioni.

Usare l'editor avanzato per le query di destinazione

Dopo aver abilitato la modifica avanzata, è possibile accedere all'editor avanzato per qualsiasi query di destinazione dati nel flusso di dati.

1. Nel riquadro Query individuare la sezione destinazione dati che mostra le destinazioni configurate.

2. Fare clic con il pulsante destro del mouse sulla destinazione da modificare.

3. Dal menu di scelta rapida selezionare Editor avanzato.

   

4. Viene visualizzata la finestra Editor avanzato che visualizza il codice M per la query di destinazione.

   

   Annotazioni

   L'editor avanzato visualizza un banner di avviso che ricorda che la modifica della query può causare un comportamento imprevisto o interrompere il flusso di dati.

5. Apportare le modifiche al codice M in base alle esigenze.

6. Selezionare OK per salvare le modifiche o Annulla per rimuoverle.

Informazioni sulla struttura di query di destinazione

Quando si apre l'editor avanzato per una query di destinazione, viene visualizzato codice M che segue un modello specifico. Ecco un esempio di query di destinazione tipica per Lakehouse:

let
    Pattern = Lakehouse.Contents([HierarchicalNavigation = null, CreateNavigationProperties = false, EnableFolding = false]),
    Navigation_1 = Pattern{[workspaceId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]}[Data],
    Navigation_2 = Navigation_1{[lakehouseId = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]}[Data],
    TableNavigation = Navigation_2{[Id = "Table", ItemKind = "Table"]}?[Data]?
in
    TableNavigation

Questa query contiene:

• Modello: connessione al tipo di destinazione (ad esempio, Lakehouse.Contents)
• Passaggi di spostamento: passaggi che passano all'area di lavoro, all'elemento e alla tabella specifici
• Output finale: riferimento alla tabella o al file di destinazione

Scenari comuni per la modifica avanzata

Anche se la maggior parte degli utenti non deve modificare direttamente le query di destinazione, ecco alcuni scenari in cui la modifica avanzata potrebbe essere utile:

Modificare gli identificatori di destinazione

Se è necessario aggiornare l'ID dell'area di lavoro, l'ID lakehouse o altri identificatori di destinazione senza riconfigurare l'intera destinazione, è possibile modificarli direttamente nel codice M.

Risolvere i problemi di destinazione

Quando si verificano errori di convalida, la visualizzazione del codice M non elaborato consente di comprendere la configurazione esatta e identificare i potenziali problemi. Per altre informazioni sugli errori di convalida, vedere Regole di convalida delle destinazioni dei dati.

Parametrizzazione avanzata

Mentre l'interfaccia utente standard supporta la parametrizzazione di base per i nomi di tabella, la modifica avanzata consente di parametrizzare altri aspetti della query di destinazione che non sono esposti nell'interfaccia utente.

Considerazioni importanti

Tenere presenti queste considerazioni quando si usa la modifica avanzata:

• Supporto dell'interfaccia utente disabilitato: dopo aver modificato una query di destinazione usando la modifica avanzata, l'interfaccia utente standard per la modifica della destinazione non funziona più. È necessario continuare a usare l'editor avanzato per eventuali ulteriori modifiche a tale destinazione.

• Convalida: le modifiche apportate nell'editor avanzato sono soggette a regole di convalida. Le modifiche non valide causano errori di convalida durante la pubblicazione o l'aggiornamento.

• Tipo restituito: la query di destinazione deve restituire un tipo valido (tabella, binario o Null). La restituzione di altri tipi, ad esempio funzioni o elenchi, causa un DestinationQueryHasUnsupportedScript errore.

• Riferimenti all'origine dati: la query di destinazione deve fare riferimento esattamente a un'origine dati. Il riferimento a più origini dati o nessuna origine dati causa errori di convalida.

• Modifiche non supportate: alcune modifiche non sono supportate e potrebbero causare l'esito negativo del flusso di dati. Testare sempre attentamente le modifiche prima della distribuzione nell'ambiente di produzione.

• Nessun annullamento: le modifiche salvate nell'editor avanzato non possono essere ripristinate automaticamente. È consigliabile documentare la query originale prima di apportare modifiche.

Disabilitare la modifica avanzata

Se non sono più necessarie funzionalità di modifica avanzate, è possibile disabilitare la funzionalità:

1. Selezionare Opzioni nella scheda Home .
2. Nella sezione Destinazioni dati deselezionare la casella di controllo Abilita modifica avanzata per le query di destinazione dati.
3. Selezionare OK per salvare l'impostazione.

Contenuti correlati

• Destinazioni dati e impostazioni gestite di Flusso di dati Gen2
• Regole di convalida delle destinazioni dati
• Aggiornamento del flusso di dati
• Visualizzare la cronologia degli aggiornamenti e monitorare i flussi di dati