Dataverse

Riepilogo

Prerequisiti

È necessario disporre di un ambiente Dataverse.

È necessario disporre delle autorizzazioni di lettura per accedere ai dati all'interno delle tabelle.

Per usare il connettore Dataverse, l'impostazione dell'endpoint TDS deve essere abilitata nell'ambiente in uso. Altre informazioni: Gestire le impostazioni delle funzionalità e Risolvere i problemi di connessione usando SQL per eseguire query sui dati

Per usare il connettore Dataverse, è necessario aprire una delle porte TCP 1433 o 5558 per la connessione. La porta 1433 viene usata automaticamente. Tuttavia, se la porta 1433 è bloccata, è possibile usare invece la porta 5558. Per abilitare la porta 5558, è necessario aggiungere tale numero di porta all'URL dell'ambiente Dataverse, ad esempio yourenvironmentid.crm.dynamics.com, 5558. Altre informazioni: SQL Server problema di connessione a causa di porte chiuse

Capacità supportate

• URL server
• Importa
• DirectQuery (modelli semantici Power BI)
• Avanzato
  • Includi colonne di relazioni

Connettersi a Dataverse da Power Query Desktop

Per connettersi a Dataverse da Power Query Desktop:

1. Selezionare l'opzione Dataverse in Recupera dati. Altre informazioni: Dove ottenere i dati

2. Se ci si connette a questo sito per la prima volta, selezionare Accedi e immettere le credenziali. Selezionare quindi Connetti.

   

3. In Strumento di navigazione selezionare i dati necessari, quindi caricare o trasformare i dati.

   

4. Se si usa Power Query da Power BI Desktop, viene chiesto di selezionare la modalità di connettività dati Import o DirectQuery. Quindi, seleziona OK.

   

Connettersi a Dataverse da Power Query Online

Per connettersi a Dataverse da Power Query Online:

1. Selezionare l'opzione Dataverse nella pagina Scegli origine dati. Altre informazioni: Dove ottenere i dati

2. Nella pagina Connetti all'origine dati, lasciare vuoto l'indirizzo URL del server. Se si lascia vuoto l'indirizzo, vengono elencati tutti gli ambienti disponibili che si è autorizzati a usare nella finestra Navigatore di Power Query.

   

   Nota

   Se è necessario usare la porta 5558 per accedere ai dati, sarà necessario caricare un ambiente specifico con la porta 5558 aggiunta alla fine nell'indirizzo URL del server. In questo caso, passare a Ricerca dell'URL dell'ambiente Dataverse per istruzioni su come ottenere l'indirizzo URL del server corretto.

3. Se necessario, immettere un gateway dati locale se si prevede di usare dati in sede. Ad esempio, se si intende combinare i dati di Dataverse e un database SQL Server locale.

4. Accedere all'account aziendale.

5. Dopo aver eseguito l'accesso, selezionare Avanti.

6. Nella pagina di spostamento selezionare i dati necessari e quindi selezionare Trasforma dati.

   

Connettersi tramite opzioni avanzate

Power Query Online offre opzioni avanzate che è possibile aggiungere alla query, se necessario.

Nella tabella seguente sono elencate le opzioni avanzate che è possibile impostare in Power Query Online.

Dopo aver selezionato le opzioni avanzate necessarie, selezionare Avanti per connettersi a Dataverse.

Ricerca dell'URL dell'ambiente Dataverse

Se è necessario usare la porta 5558 per connettersi a Dataverse, è necessario trovare l'URL dell'ambiente Dataverse. Aprire Power Apps. Nell'angolo in alto a destra della pagina Power Apps selezionare l'ambiente a cui ci si connetterà. Selezionare Impostazioni, quindi selezionare Impostazioni avanzate.

Nella nuova scheda del browser visualizzata copiare la radice dell'URL. Questo URL principale è l'URL univoco per il tuo ambiente. L'URL è nel formato di https://<yourenvironmentid>.crm.dynamics.com/. Assicurati di rimuovere 'https://' e la barra finale '/' dall'URL prima di incollarlo per connetterti all'ambiente. Aggiungere la porta 5558 alla fine dell'URL dell'ambiente, ad esempio yourenvironmentid.crm.dyamics.com.5558.

Quando usare il connettore Common Data Service (legacy)

Dataverse è la sostituzione diretta del connettore Common Data Service. In alcuni casi, tuttavia, potrebbe essere necessario scegliere il connettore Common Data Service (legacy) anziché il connettore Dataverse :

Esistono alcuni tipi di dati TDS (Tabular Data Stream) supportati in OData quando si usa Common Data Service (legacy) che non sono supportati in Dataverse. I tipi di dati supportati e non supportati sono elencati in Come Dataverse SQL differisce da Transact-SQL.

Tutte queste funzionalità verranno aggiunte al connettore Dataverse in futuro, in cui il connettore Common Data Service (Legacy) sarà deprecato.

Altre informazioni: Accesso a grandi quantità di dati di Dataverse

Limitazioni e considerazioni

Specifico dell'host Excel

Il connettore Power Query Dataverse all'interno di Excel attualmente non supporta cluster cloud sovrani ( ad esempio Cina, Germania, Stati Uniti).

Prestazioni del Dataverse e limiti di limitazione delle risorse

Per informazioni sui limiti di prestazioni e limitazioni per le connessioni Dataverse, consultare Limiti e allocazioni delle richieste. Queste limitazioni si applicano sia al connettore Dataverse che al connettore feed OData quando si accede allo stesso endpoint.

Frequenza di recupero delle tabelle

Come linea guida, la maggior parte delle tabelle predefinite viene recuperata a una velocità di circa 500 righe al secondo usando il connettore Dataverse. Tenere conto di questo tasso quando si sta decidendo se connettersi a Dataverse o esportare in un data lake. Se sono necessarie velocità di recupero più veloci, è consigliabile usare la funzionalità Esporta in data lake o l'endpoint TDS (Tabular Data Stream). Per altre informazioni, vedere Connessioni alternative a Dataverse.

Connessioni alternative a Dataverse

Esistono diversi modi alternativi per estrarre e eseguire la migrazione dei dati da Dataverse:

• Usare la funzionalità Azure Synapse Link in Power Apps per estrarre dati da Dataverse in Azure Data Lake Storage Gen2, che può quindi essere usata per eseguire l'analisi. Per ulteriori informazioni sulla funzionalità Azure Synapse Link, visitare Cos'è Azure Synapse Link per Dataverse?.

• Usare il connettore OData per spostare i dati da e verso Dataverse. Per altre informazioni su come eseguire la migrazione dei dati tra ambienti Dataverse usando il connettore OData dei flussi di dati, vedere Eseguire la migrazione dei dati tra ambienti Dataverse usando il connettore OData dei flussi di dati.

SQL Server problema di connessione a causa di porte chiuse

Quando ci si connette al connettore Dataverse, è possibile che si verifichi un errore Unable to connect che indica che si è verificato un errore specifico di rete o istanza durante la creazione di una connessione a SQL Server. Questo errore è probabilmente causato dalle porte TCP 1433 o 5558 bloccate durante la connessione. Per risolvere l'errore di porta bloccata, passare a Porte bloccate.

Uso di query di database native con Dataverse

È possibile connettersi a Dataverse usando un'istruzione SQL personalizzata o una query di database nativa. Anche se non esiste un'interfaccia utente per questa esperienza, è possibile immettere la query usando il Power Query Advanced Editor. Per usare una query di database nativa, è necessario specificare un database come origine.

Source = CommonDataService.Database([DATABASE URL])

Dopo aver definito un'origine di database, è possibile specificare una query nativa usando la funzione Value.NativeQuery .

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

Globalmente, la query appare così.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Digitare erroneamente un nome di colonna potrebbe comportare un messaggio di errore sulla piegatura della query invece che un messaggio su una colonna mancante.

Accesso a grandi quantità di dati di Dataverse

Le query sulle tabelle di Dataverse possono restituire grandi quantità di dati. Se si usa il connettore Power Query Dataverse, qualsiasi query specifica che accede al modello ha un timeout fisso di cinque (5) minuti indipendentemente dalle dimensioni dei dati. Per altre informazioni, vedere Limitazioni. Potrebbe quindi essere necessario eseguire più query sui dati per accedere a tutti i dati nel modello. L'uso di più query può richiedere molto tempo per restituire tutti i dati.

Se si usa il connettore Common Data Service (Legacy), è possibile usare una singola query per accedere a tutti i dati. Questo connettore funziona in modo diverso e restituisce il risultato in "pagine" di record da 5 K. Anche se il connettore Common Data Service (legacy) è più efficiente nella restituzione di grandi quantità di dati, può comunque richiedere molto tempo per restituire il risultato.

Anziché usare questi connettori per accedere a grandi quantità di dati di Dataverse, è consigliabile usare Azure Synapse Link per accedere a modelli di grandi dimensioni. L'uso di Azure Synapse Link è ancora più efficiente rispetto ai connettori dataverse o Common Data Service (legacy) di Power Query ed è progettato in modo specifico per gli scenari di integrazione dei dati.

Problemi di performance correlati alle colonne di relazione

Gli errori di anteprima possono verificarsi a causa di una limitazione nota quando la funzionalità Proprietà di spostamento è abilitata in Dataverse.

È possibile visualizzare un messaggio simile al seguente, ad esempio: Preview.Error: The type of the current preview value is too complex to display.

Per risolvere questo problema, analogamente al connettore SQL Server, è disponibile un'opzione per disabilitare le proprietà di navigazione (colonne di relazione) nel connettore Dataverse per migliorare le prestazioni. Questa opzione può essere impostata nelle opzioni advanced disponibili in Power Query Online oppure può essere impostata usando il parametro CreateNavigationProperties=false nella funzione connettore Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),