Dataverse

Zusammenfassung

Voraussetzungen

Sie benötigen eine Dataverse-Umgebung.

Sie müssen über Leseberechtigungen verfügen, um auf Daten in Tabellen zugreifen zu können.

Um den Dataverse Connector zu verwenden, muss die Einstellung TDS-Endpunkt aktivieren in Ihrer Umgebung aktiviert sein. Weitere Informationen: Verwalten von Featureeinstellungen und Behandeln von Verbindungsproblemen mithilfe von SQL zum Abfragen von Daten

Um den Dataverse-Connector verwenden zu können, muss zum Herstellen einer Verbindung einer der TCP-Ports 1433 oder 5558 geöffnet sein. Port 1433 wird automatisch verwendet. Falls Port 1433 jedoch blockiert ist, können Sie stattdessen Port 5558 verwenden. Um Port 5558 zu aktivieren, müssen Sie diese Portnummer an die Dataverse-Umgebungs-URL anfügen, z. B. yourenvironmentid.crm.dynamics.com, 5558. Weitere Informationen: SQL Server Verbindungsproblem aufgrund geschlossener Ports

Unterstützte Funktionen

• Server-URL
• Importieren
• DirectQuery (Power BI Semantikmodelle)
• Erweitert
  • Beziehungsspalten einbeziehen

Herstellen einer Verbindung mit Dataverse über Power Query Desktop

So stellen Sie eine Verbindung mit Dataverse von Power Query Desktop her:

1. Wählen Sie unter Daten abrufen die Option Dataverse aus. Weitere Informationen: Wo man Daten erhält

2. Wenn Sie zum ersten Mal eine Verbindung mit dieser Website herstellen, wählen Sie "Anmelden" aus, und geben Sie Ihre Anmeldeinformationen ein. Wählen Sie dann Verbinden aus.

   

3. Wählen Sie in Navigator die erforderlichen Daten aus, und laden oder transformieren Sie dann die Daten.

   

4. Wenn Sie Power Query von Power BI Desktop verwenden, werden Sie aufgefordert, entweder den Import oder DirectQuery Datenkonnektivitätsmodus auszuwählen. Klicken Sie anschließend auf OK.

   

Herstellen einer Verbindung mit Dataverse von Power Query Online

So stellen Sie eine Verbindung mit Dataverse von Power Query Online her:

1. Wählen Sie auf der Seite Datenquelle auswählen die Option Dataverse aus. Weitere Informationen: Wo man Daten erhält

2. Lassen Sie auf der Seite Mit Datenquelle verbinden die Server-URL-Adresse leer. Wenn Sie die Adresse leer lassen, werden alle verfügbaren Umgebungen aufgelistet, die Sie im Power Query Navigator-Fenster verwenden dürfen.

   

   Hinweis

   Wenn Sie Port 5558 für den Zugriff auf Ihre Daten verwenden müssen, müssen Sie eine bestimmte Umgebung laden, wobei Port 5558 am Ende der Server-URL-Adresse angefügt wird. In diesem Fall finden Sie unter Ermitteln der URL Ihrer Dataverse-Umgebung Anweisungen zum Abrufen der richtigen Server-URL-Adresse.

3. Geben Sie gegebenenfalls ein lokales Datengateway ein, wenn Sie lokale Daten verwenden möchten. Wenn Sie beispielsweise Daten aus Dataverse und einer lokalen SQL Server-Datenbank kombinieren möchten.

4. Melden Sie sich bei Ihrem Organisationskonto an.

5. Wenn Sie sich erfolgreich angemeldet haben, wählen Sie "Weiter" aus.

6. Wählen Sie auf der Navigationsseite die gewünschten Daten aus, und wählen Sie dann "Daten transformieren" aus.

   

Verbinden mithilfe erweiterter Optionen

Power Query Online bietet erweiterte Optionen, die Sie bei Bedarf zu Ihrer Abfrage hinzufügen können.

In der folgenden Tabelle sind die erweiterten Optionen aufgeführt, die Sie in Power Query Online festlegen können.

Nachdem Sie die erweiterten Optionen ausgewählt haben, die Sie benötigen, wählen Sie Weiter aus, um eine Verbindung mit Dataverse herzustellen.

Ermitteln der URL Ihrer Dataverse-Umgebung

Wenn Sie Port 5558 zum Herstellen einer Verbindung mit Dataverse verwenden müssen, müssen Sie die URL Ihrer Dataverse-Umgebung ermitteln. Öffnen Sie Power Apps. Wählen Sie oben rechts auf der Seite Power Apps die Umgebung aus, mit der Sie eine Verbindung herstellen möchten. Wählen Sie das Symbol "Einstellungen" und dann " Erweiterte Einstellungen".

In der neuen Browser-Registerkarte, die sich öffnet, kopieren Sie die Wurzel der URL. Diese Stamm-URL ist die eindeutige URL für Ihre Umgebung. Die URL hat das Format „https://<yourenvironmentid>.crm.dynamics.com/“. Achten Sie darauf, https:// und den nachgestellten / zu entfernen, bevor Sie die URL einfügen, um eine Verbindung mit Ihrer Umgebung herzustellen. Fügen Sie Port 5558 am Ende der Umgebungs-URL an, z. B. yourenvironmentid.crm.dyamics.com,5558.

Wann der Common Data Service (Legacy)-Connector verwendet wird

Dataverse ersetzt den Common Data Service-Connector unmittelbar. Es kann jedoch vorkommen, dass anstelle des Dataverse-Connectors der Common Data Service (Legacy)-Connector ausgewählt werden muss:

Es gibt bestimmte TDS-Datentypen (Tabular Data Stream), die in OData bei der Verwendung von Common Data Service (Legacy) unterstützt und in Dataverse nicht unterstützt werden. Die unterstützten und nicht unterstützten Datentypen sind in Wie sich Dataverse SQL von Transact-SQL unterscheidet aufgeführt.

Alle diese Features werden dem Dataverse-Connector künftig hinzugefügt. Zu diesem Zeitpunkt wird der Common Data Service (Legacy)-Connector veraltet sein.

Weitere Informationen: Zugreifen auf große Dataverse-Datenmengen

Einschränkungen und Überlegungen

Spezifisch für Excel-Host

Der Power Query Dataverse Connector in Excel unterstützt derzeit keine souveränen Cloudcluster (z. B. China, Deutschland, USA).

Leistungs- und Drosselungsgrenzwerte in Dataverse

Informationen zu Leistungs- und Drosselungsgrenzwerten für Dataverse-Verbindungen finden Sie unter Grenzwerte und Zuteilungen für Anforderungen. Diese Grenzwerte gelten beim Zugriff auf denselben Endpunkt sowohl für den Dataverse-Connector als auch für den OData-Feed-Connector.

Tabellenabrufrate

Die meisten Standardtabellen werden in der Regel mit einer Rate von ca. 500 Zeilen pro Sekunde mithilfe des Dataverse-Connectors abgerufen. Berücksichtigen Sie diese Rate bei der Entscheidung, ob Sie eine Verbindung mit Dataverse herstellen oder in Data Lake exportieren möchten. Wenn Sie schnellere Abrufraten benötigen, sollten Sie die Funktion „In Data Lake exportieren“ oder den TDS-Endpunkt (Tabular Data Stream) verwenden. Weitere Informationen finden Sie unter Alternative Dataverse-Verbindungen

Alternative Dataverse-Verbindungen

Es gibt verschiedene alternative Methoden zum Extrahieren und Migrieren von Daten aus Dataverse:

• Verwenden Sie das Feature Azure Synapse Link in Power Apps, um Daten aus Dataverse in Azure Data Lake Storage Gen2 zu extrahieren, die dann zum Ausführen von Analysen verwendet werden können. Weitere Informationen zum Azure Synapse Link-Feature finden Sie unter What is Azure Synapse Link for Dataverse?.

• Verwenden Sie den OData-Connector, um Daten in und aus Dataverse zu verschieben. Weitere Informationen zur Migration von Daten zwischen Dataverse-Umgebungen mithilfe des OData-Connectors für Datenflüsse finden Sie unter "Migrieren von Daten zwischen Dataverse-Umgebungen mithilfe des OData-Connectors für Datenflüsse".

SQL Server Verbindungsproblem aufgrund geschlossener Ports

Beim Herstellen einer Verbindung mit dem Dataverse-Connector tritt möglicherweise ein Kann keine Verbindung herstellen fehler auf, der angibt, dass beim Herstellen einer Verbindung mit SQL Server ein Netzwerk- oder instanzspezifischer Fehler aufgetreten ist. Dieser Fehler wird wahrscheinlich dadurch verursacht, dass die TCP-Ports 1433 oder 5558 während der Verbindung blockiert werden. Informationen zum Beheben des Fehlers wegen blockierter Ports finden Sie unter Blockierte Ports.

Verwenden nativer Datenbankabfragen mit Dataverse

Sie können mit einer benutzerdefinierten SQL-Anweisung oder einer nativen Datenbankabfrage eine Verbindung mit Dataverse herstellen. Obwohl keine Benutzeroberfläche für diese Funktion vorhanden ist, können Sie die Abfrage mithilfe des Power Query Advanced Editors eingeben. Für eine Datenbankabfrage muss eine Datenbank als Quelle angegeben werden.

Source = CommonDataService.Database([DATABASE URL])

Nachdem Sie eine Datenbankquelle definiert haben, können Sie mit der Funktion Value.NativeQuery eine native Abfrage angeben.

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

Insgesamt sieht die Abfrage wie folgt aus.

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

Wenn ein Spaltenname falsch geschrieben wird, kann statt einer Fehlermeldung über eine fehlende Spalte möglicherweise eine Meldung zu Query Folding angezeigt werden.

Zugriff auf große Datenmengen in Dataverse

Abfragen für Dataverse-Tabellen können große Datenmengen zurückgeben. Wenn Sie den Power Query Dataverse-Connector verwenden, verfügt jede bestimmte Abfrage, die auf das Modell zugreift, unabhängig von der Größe der Daten über ein festes Zeitlimit von fünf (5) Minuten. Weitere Informationen finden Sie unter Grenzwerte. Daher müssen Sie die Daten möglicherweise mehrmals abfragen, um auf alle Daten im Modell zuzugreifen. Bei mehreren Abfragen kann es eine Weile dauern, bis alle Daten zurückgegeben wurden.

Wenn Sie den Common Data Service (Legacy) Connector verwenden, können Sie eine einzelne Abfrage verwenden, um auf alle Daten zuzugreifen. Dieser Connector funktioniert anders und gibt das Ergebnis auf „Seiten“ mit jeweils 5.000 Datensätzen zurück. Obwohl der Common Data Service (Legacy)-Connector bei der Rückgabe großer Datenmengen effizienter ist, kann es dennoch einige Zeit dauern, bis das Ergebnis zurückgegeben wurde.

Anstelle dieser Connectors für den Zugriff auf große Datenmengen in Dataverse empfehlen wir, Azure Synapse Link für den Zugriff auf große Modelle zu verwenden. Die Verwendung von Azure Synapse Link ist noch effizienter als der Power Query Dataverse- oder Common Data Service(Legacy)-Connectors und ist speziell für Datenintegrationsszenarien konzipiert.

Leistungsprobleme im Zusammenhang mit Relationenspalten

Vorschaufehler können aufgrund einer bekannten Einschränkung auftreten, wenn das Feature "Navigationseigenschaften " in Dataverse aktiviert ist.

Sie könnten eine Meldung wie diese sehen, z. B.: Preview.Error: The type of the current preview value is too complex to display.

Um dieses Problem zu beheben, ähnlich wie der SQL Server Connector, gibt es eine Option zum Deaktivieren von Navigationseigenschaften (Beziehungsspalten) im Dataverse-Connector, um die Leistung zu verbessern. Diese Option kann in den optionen advanced in Power Query Online verfügbar sein, oder sie kann mit dem Parameter CreateNavigationProperties=false in der Dataverse Connector-Funktion festgelegt werden.

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