Certificazione Connessione or di Power Query

Articolo
01/18/2024

Nota

Questo articolo descrive i requisiti e il processo per inviare un connettore personalizzato di Power Query per la certificazione. Leggere attentamente l'intero articolo prima di avviare il processo di certificazione.

Introduzione

Con Power Query SDK, tutti gli utenti possono creare un connettore Power Query personalizzato per connettersi a un'origine dati da Power Query. Attualmente, i connettori personalizzati sono supportati solo nei modelli semantici di Power BI (Power BI Desktop e servizio Power BI) e richiedono l'uso di un gateway dati locale per l'aggiornamento tramite servizio Power BI. I connettori personalizzati devono essere distribuiti singolarmente dallo sviluppatore.

I proprietari dell'origine dati che sviluppano un connettore personalizzato per l'origine dati potrebbero voler distribuire il connettore personalizzato in modo più ampio agli utenti di Power Query. Dopo aver creato, usato e convalidato un connettore personalizzato dagli utenti finali, il proprietario dell'origine dati può inviarlo per la certificazione Microsoft.

La certificazione di un connettore personalizzato di Power Query rende il connettore disponibile pubblicamente, predefinito, all'interno di modelli semantici di Power BI (Power BI Desktop e servizio Power BI), flussi di dati di Power BI e datamarts di Power BI. I connettori certificati sono supportati in PowerBI.com e in tutte le versioni di Power BI Premium.

I connettori certificati sono:

Gestito dallo sviluppatore partner
Supportato dallo sviluppatore partner
Certificato da Microsoft
Distribuito da Microsoft

Microsoft collabora con i partner per verificare che dispongano del supporto per la manutenzione, ma i problemi dei clienti con il connettore stesso verranno indirizzati allo sviluppatore partner.

Differenze tra connettore certificato e connettore personalizzato

I connettori certificati sono predefiniti in Power BI Desktop e distribuiti nel servizio Power BI, nei flussi di dati di Power BI e nei datamarts di Power BI. I connettori personalizzati sono supportati solo nei modelli semantici di Power BI e devono essere caricati in Power BI Desktop, come descritto in Caricamento dell'estensione in Power BI Desktop. I connettori certificati e personalizzati possono essere aggiornati tramite Power BI Desktop o il servizio Power BI tramite un gateway dati locale implementando un test Connessione ion. Il gateway dati locale è necessario per i connettori personalizzati.

I connettori certificati in Power BI Desktop con un'implementazione TestConnection supportano anche l'aggiornamento end-to-end tramite il cloud (servizio Power BI) senza la necessità di un gateway dati locale. L'ambiente servizio Power BI ospita essenzialmente un "gateway cloud" che viene eseguito in modo simile al gateway locale. Dopo la certificazione, il connettore viene distribuito in questo ambiente in modo che sia disponibile per tutti i clienti di Power BI.

Entrambi i connettori personalizzati e certificati con componenti aggiuntivi (ad esempio, il driver ODBC) richiedono l'installazione del componente aggiuntivo nel computer dell'utente finale e richiedono il gateway dati locale, a meno che il componente aggiuntivo non venga distribuito nel cloud Power BI. Attualmente non vengono certificati e distribuiti nuovi componenti aggiuntivi nel cloud Power BI, quindi la certificazione dei connettori con una dipendenza da un componente aggiuntivo non rimuoverà il requisito del gateway dati locale.

Distribuzione del connettore personalizzato

I connettori personalizzati possono e devono essere distribuiti agli utenti finali prima della certificazione.

Poiché M è un linguaggio versatile che, come illustrato in Gestione dell'autenticazione, ha la capacità di interagire con le credenziali archiviate, è necessario offrire agli utenti un modo per consentire solo l'esecuzione di connettori attendibili.

Dal punto di vista di uno sviluppatore, gli sviluppatori devono autofirmare il connettore personalizzato e fornire agli utenti le informazioni (identificazione personale) per caricarlo in modo sicuro.

Dal punto di vista di un utente, gli utenti devono usare l'identificazione personale dello sviluppatore per considerare attendibile e caricare in modo sicuro il connettore personalizzato da usare. In alternativa, gli utenti possono scegliere di ridurre le impostazioni di sicurezza per consentire il caricamento del codice non certificato da Microsoft o da un altro sviluppatore, ma questa opzione non è consigliata.

Cenni preliminari sulla certificazione

Prerequisiti

Per garantire la migliore esperienza per i clienti, vengono considerati solo i connettori che soddisfano un set di prerequisiti per la certificazione:

Il connettore deve essere per un prodotto pubblico.
Il connettore deve essere considerato completo del codice per una versione di versione iniziale. Il programma consente iterazioni e aggiornamenti frequenti. Si noti che Microsoft non offre assistenza tecnica o consulenza per lo sviluppo di connettori personalizzati. È consigliabile usare risorse pubbliche, ad esempio la documentazione dell'SDK e il repository di esempi. Se hai bisogno di ulteriore assistenza, possiamo condividere un elenco di noti consulenti per lo sviluppo di connettori personalizzati del settore di terze parti che potresti voler coinvolgere direttamente, separati da qualsiasi programma o partnership Microsoft. Si noti che Microsoft non è affiliata a nessuno di questi consulenti e non è responsabile dell'uso dei propri servizi. Microsoft fornisce l'elenco per praticità e senza garanzie, raccomandazioni o garanzie. Per altre informazioni, contattare il contatto di certificazione Microsoft.
Lo sviluppatore deve fornire una stima per l'utilizzo. È consigliabile che gli sviluppatori di connettori per prodotti molto boutique usino le funzionalità di autofirma del connettore per fornirle direttamente al cliente.
Il connettore deve essere già reso disponibile ai clienti direttamente per soddisfare le esigenze degli utenti o uno scenario aziendale. Questi criteri possono essere soddisfatti usando un programma di anteprima privata distribuendo il connettore completato direttamente agli utenti finali e alle organizzazioni tramite la firma automatica. Ogni utente o organizzazione deve essere in grado di fornire commenti e suggerimenti e convalidare la necessità aziendale del connettore e che il connettore funzioni correttamente per soddisfare i requisiti aziendali.
Il connettore deve funzionare correttamente a un livello previsto di utilizzo da parte dei clienti.
Nel forum idee di Power BI deve essere presente un thread guidato dai clienti per indicare la richiesta di rendere il connettore disponibile pubblicamente in Power BI Desktop. Non esiste una soglia di engagement impostata. Tuttavia, maggiore è l'impegno, maggiore è la domanda evidenziata per il connettore.

Questi prerequisiti esistono per garantire che i connettori in fase di certificazione abbiano una notevole necessità di usare clienti e aziende e supportare la post-certificazione.

Processi e sequenze temporali

I connettori certificati vengono rilasciati con versioni mensili di Power BI Desktop, quindi le scadenze per ogni versione funzionano da ogni data di rilascio di Power BI Desktop. La durata prevista del processo di certificazione dalla registrazione alla versione varia a seconda della qualità e della complessità dell'invio del connettore. Microsoft non fornisce garanzie specifiche sulla sequenza temporale per quanto riguarda la revisione e l'approvazione del connettore. Le scadenze rigide per ogni revisione del connettore sono descritte nei passaggi seguenti, ma Microsoft non garantisce la conformità a queste sequenze temporali.

Registrazione: notifica della finalità per certificare il connettore personalizzato. Questa registrazione deve essere eseguita entro il 15 del mese, due mesi prima del rilascio di Power BI Desktop di destinazione.
- Ad esempio, per la versione di Aprile di Power BI Desktop, la scadenza sarà il 15 febbraio.
Invio: invio di file del connettore per la revisione di Microsoft. Questo invio deve verificarsi entro il primo del mese prima del rilascio di Power BI Desktop di destinazione.
- Ad esempio, per la versione di Aprile di Power BI Desktop, la scadenza sarà il 1° marzo.
Revisione tecnica: finalizzazione dei file del connettore, passando la revisione e la certificazione Microsoft. Questa verifica deve verificarsi entro il 15 del mese prima del rilascio di Power BI Desktop di destinazione.
- Ad esempio, per la versione di Aprile di Power BI Desktop, la scadenza sarà il 15 marzo.

A causa della complessità delle revisioni tecniche e dei potenziali ritardi, della riprogettazione e dei problemi di test, è consigliabile inviare in anticipo con un lungo lead time per il rilascio iniziale e la certificazione. Se si ritiene che il connettore sia importante per offrire a pochi clienti un sovraccarico minimo, è consigliabile eseguire la firma automatica e fornirla in questo modo.

Requisiti di certificazione

Abbiamo un determinato set di requisiti per la certificazione. Microsoft riconosce che non tutti gli sviluppatori possono soddisfare questi requisiti e si spera di introdurre un set di funzionalità che gestirà le esigenze dello sviluppatore in breve ordine.

File di invio (artefatti)

Verificare che i file del connettore inviati includano tutti i seguenti elementi:

file Connessione or (con estensione mez)
- Il file con estensione mez deve seguire gli standard di stile e deve essere denominato in modo analogo al nome del prodotto o del servizio. Non deve includere parole come "Power BI", "Connessione or" o "API".
- Denominare il file con estensione mez: ProductName.mez
File di Power BI Desktop (con estensione pbix) per i test
- Per testare il connettore, è necessario un report di Power BI di esempio (con estensione pbix).
- Il report deve includere almeno una query per testare ogni elemento nella tabella di spostamento.
- Se non esiste uno schema impostato, ad esempio database, il report deve includere una query per ogni "tipo" di tabella che il connettore può gestire.
Testare l'account nell'origine dati
- L'account di test viene usato per testare e risolvere i problemi del connettore.
- Fornire un account di test permanente, in modo da poter usare lo stesso account per certificare eventuali aggiornamenti futuri.
Istruzioni di test
- Fornire qualsiasi documentazione su come usare il connettore e testarne le funzionalità.
Collegamenti a dipendenze esterne (ad esempio, driver ODBC)

Caratteristiche e stile

Il connettore deve seguire un set di regole di funzionalità e stile per soddisfare uno standard di usabilità coerente con altri connettori certificati.

Il connettore DEVE:
- Usare il formato del documento sezione.
- Contiene un'intestazione o una struttura della versione sopra il documento di sezione.
- Specificare i metadati della documentazione della funzione.
- Disporre del gestore Test Connessione ion.
- Seguire le convenzioni di denominazione , ad esempio DataSourceKind.FunctionName. Non deve includere parole come "Power BI", "Connessione or" o "API".
- Impostare il flag Beta su True alla versione iniziale.
Deve FunctionName avere senso per il dominio , ad esempio "Contenuto", "Tabelle", "Documento", "Database" e così via.
Il connettore DEVE:
- Hanno icone.
- Specificare una tabella di spostamento.
- Inserire le stringhe in un resources.resx file. Gli URL e i valori devono essere hardcoded nel codice del connettore e non devono essere inseriti nel resources.resx file.

Sicurezza

Esistono considerazioni di sicurezza specifiche che il connettore deve gestire.

Se Extension.CurrentCredentials() viene usato:
- L'utilizzo è obbligatorio? In tal caso, dove vengono inviate le credenziali?
- È garantito che le richieste vengano effettuate tramite HTTPS?
  - È possibile usare la funzione helper di imposizione HTTPS.
- Se le credenziali vengono inviate tramite Web.Contents() GET:
  - Può essere trasformato in post?
  - Se è necessario GET, il connettore DEVE usare il CredentialQueryString record nel Web.Contents() record delle opzioni per passare credenziali sensibili.
Se vengono usate funzioni Diagnostics.*:
- Convalidare ciò che viene tracciato; i dati non devono contenere informazioni personali o grandi quantità di dati non necessari.
- Se è stata implementata una traccia significativa nello sviluppo, è necessario implementare una variabile o un flag di funzionalità che determina se la traccia deve essere attiva. Questa traccia deve essere disattivata prima dell'invio per la certificazione.
Se Expression.Evaluate() viene usato:
- Convalidare la provenienza dell'espressione e il relativo contenuto( ovvero, può costruire in modo dinamico le chiamate a Extension.CurrentCredentials() e così via).
- L'oggetto Expression non deve essere fornito dall'utente né deve accettare l'input dell'utente.
- L'oggetto Expression non deve essere dinamico, ovvero recuperato da una chiamata Web.

Registrazione per la certificazione

Se si è interessati a ottenere la certificazione del connettore personalizzato, assicurarsi che lo scenario e il connettore soddisfino i prerequisiti e i requisiti descritti in questo articolo. In caso contrario, si verificheranno ritardi nella certificazione perché il team richiederà di risolvere eventuali problemi o incoerenze prima di procedere con la certificazione.

Assicurarsi che il connettore sia completo e sia stato testato sia nella creazione in Power BI Desktop che nell'aggiornamento e nell'utilizzo nel servizio Power BI. Assicurarsi di aver testato l'aggiornamento end-to-end completo nel servizio Power BI tramite l'uso di un gateway dati locale.

Per iniziare, completare il modulo di registrazione e un contatto Microsoft verrà contattato per iniziare il processo.

Dopo la certificazione

Dopo aver certificato e rilasciato il connettore tramite Power BI Desktop e servizio Power BI, è necessario eseguire alcune operazioni per assicurarsi di poter usare correttamente il connettore certificato disponibile pubblicamente disponibile per la produzione.

L'utente e gli utenti finali devono usare la versione del connettore certificato inclusa in Power BI Desktop e il gateway dati locale e rimuovere eventuali file con estensione mez o pqx esistenti (connettori personalizzati) usati prima della certificazione. In caso contrario, è possibile che il connettore personalizzato di test venga usato inavvertitamente da Power Query anziché dal connettore appena certificato.
I connettori personalizzati devono essere usati solo per testare le nuove versioni del connettore.
Quando si lavora con utenti finali e clienti, assicurarsi che comprendano la versione del connettore personalizzata usata nei test prima della certificazione deve essere rimossa al termine del test e la nuova versione del connettore certificato è disponibile.

App modello (scelta consigliata)

Dopo aver sviluppato un connettore in un'origine dati, è consigliabile aiutare i clienti a iniziare rapidamente creando un'app modello. Un'app modello fornisce ai clienti un report predefinito connesso ai dati che possono usare in modo predefinito o personalizzare in base alle esigenze.