Panoramica di Power Query SDK

  • Articolo

Power Query SDK è un set di strumenti progettati per creare connettori di Power Query. Questi connettori vengono spesso definiti connettori personalizzati o estensioni di Power Query.

I connettori personalizzati consentono di creare nuove origini dati o personalizzare ed estendere un'origine esistente. I casi d'uso comuni in cui può verificarsi questa situazione includono:

  • Creazione di una visualizzazione semplice per l'analista aziendale per un'API REST.
  • Fornire informazioni personalizzate per un'origine supportata da Power Query con un connettore esistente, ad esempio un servizio OData o un driver ODBC.
  • Implementazione del flusso di autenticazione OAuth v2 per un'offerta SaaS.
  • Esposizione di una visualizzazione limitata o filtrata sull'origine dati per migliorare l'usabilità.
  • Abilitazione di DirectQuery per un'origine dati tramite un driver ODBC.

Installazione di Power Query SDK

Sono attualmente disponibili due versioni di Power Query SDK:

  • Visual Studio Power Query SDK: rilasciato nel 2017 come estensione per Visual Studio 2017 e 2019.
  • Visual Studio Code Power Query SDK (anteprima): rilasciato nel 2022 come nuovo e consigliato modo per creare connettori di Power Query.

È consigliabile che tutti gli sviluppatori installino e usino visual Studio Code Power Query SDK (anteprima) appena rilasciati perché questa versione sarà l'SDK predefinito in futuro.

Visual Studio Power Query SDK

Seguire questa procedura per installare Visual Studio Power Query SDK:

  1. Installare Power Query SDK da Visual Studio Marketplace.
  2. Creare un nuovo progetto connettore dati.
  3. Definire la logica del connettore.
  4. Compilare il progetto per produrre un file di estensione.

Funzionalità di anteprima.

Visual Studio Code Power Query SDK (anteprima)

Nota

Il nuovo SDK di Power Query per Visual Studio Code è attualmente disponibile in anteprima pubblica a partire da settembre 2022.

Installare il nuovo SDK di Power Query di Visual Studio Code dalla sezione Visual Studio Code di Visual Studio Marketplace. Selezionare Installa per installare l'SDK.

processo di sviluppo di Connessione or

Anche se è possibile usare Visual Studio Code o Visual Studio Power Query SDK, entrambi usano un processo simile per lo sviluppo di un connettore a livello generale.

Le sezioni seguenti descrivono, a livello generale, il processo più comune per creare un connettore Power Query usando l'SDK.

Creazione di una nuova estensione

Quando si crea un nuovo progetto (Visual Studio Power Query SDK) o una nuova area di lavoro (Visual Studio Code Power Query SDK), iniziare con i file di base seguenti:

  • file di definizione Connessione or (<connectorName.pq>)
  • Un file di query (<connectorName.query.pq>)
  • Un file di risorse stringa (resources.resx)
  • File PNG di varie dimensioni usate per creare icone

Il file di definizione del connettore inizierà con una descrizione dell'origine dati vuota. Altre informazioni su un'origine dati nel contesto di Power Query SDK sono disponibili nell'articolo sulla gestione dell'accesso ai dati.

Test in corso

Power Query SDK offre funzionalità di esecuzione di query di base, che consentono di testare l'estensione senza dover passare a Power BI Desktop.

File di test di query

Oltre al file di estensione, i progetti data Connessione or possono avere un file di query (name.query.pq). Questo file può essere usato per eseguire query di test all'interno di Visual Studio. La valutazione della query includerà automaticamente il codice di estensione, senza dover registrare il file con estensione pqx, consentendo di chiamare o testare le funzioni condivise nel codice dell'estensione.

Il file di query può contenere una singola espressione ( ad esempio , HelloWorld.Contents()), un'espressione let (ad esempio ciò che genera Power Query) o un documento di sezione.

Crea e distribuisci

La compilazione del progetto produce il file con estensione mez o il file di estensione.

Le estensioni di Power Query vengono raggruppate in un file ZIP e date un'estensione di file mez. In fase di esecuzione Power BI Desktop carica le estensioni da [Documenti]\Microsoft Power BI Desktop\Connessione ors personalizzati.

Nota

I progetti di data Connessione or non supportano i passaggi di post-compilazione personalizzati per copiare il file di estensione nella directory [Documents]\Microsoft Power BI Desktop\Custom Connessione ors. Se si vuole eseguire questa operazione, è possibile usare un'estensione di terze parti.

Le estensioni vengono definite all'interno di un documento di sezione M. Un documento di sezione ha un formato leggermente diverso rispetto ai documenti di query generati in Power Query. Il codice importato da Power Query richiede in genere modifiche per adattarsi a un documento di sezione, ma le modifiche sono minime. Le differenze dei documenti di sezione da tenere presenti includono:

  • Iniziano con una dichiarazione di sezione (ad esempio, section HelloWorld;).
  • Ogni espressione termina con un punto e virgola (ad esempio, a = 1; o b = let c = 1 + 2 in c;).
  • Tutte le funzioni e le variabili sono locali nel documento della sezione, a meno che non siano contrassegnate come condivise. Le funzioni condivise diventano visibili ad altre query/funzioni e possono essere considerate come esportazioni per l'estensione, ovvero diventano chiamabili da Power Query.

Altre informazioni sui documenti della sezione M sono disponibili nella specifica del linguaggio M.

Distribuzione dei connettori dati

I connettori di Power Query possono essere usati in Power BI Desktop o nell'esperienza Power Query Online, ad esempio flussi di dati di Power BI, datamarts di Power BI e altre esperienze.

Power BI Desktop

Gli utenti di Power BI Desktop possono seguire la procedura seguente per usare un connettore personalizzato di Power Query:

  1. Copiare il file di estensione (.mez o.pqx) in [Documents]/Power BI Desktop/Custom Connessione ors.
  2. In Power BI Desktop selezionare l'opzione (non consigliata) Consenti il caricamento di qualsiasi estensione senza convalida o avviso in Opzioni file>e impostazioni>Opzioni>Estensioni dati di sicurezza.>
  3. Riavviare Power BI Desktop.

Power BI Desktop caricherà automaticamente le estensioni al riavvio.

In alternativa, come proprietario dell'origine dati e del connettore, è possibile inviare il connettore al programma di certificazione di Power Query Connessione or in modo che venga fornito con Power BI Desktop in ogni versione.

Power Query Online

Nota

Il team di Power Query sta lavorando duramente per abilitare tutti i connettori certificati di Power Query nell'esperienza Power Query Online.

Nell'esperienza Power Query Online vengono visualizzati solo i connettori certificati di Power Query. Per altre informazioni sul programma di certificazione del connettore Power Query, vedere Power Query Connessione or Certification (Certificazione del Connessione or di Power Query).