Freigeben über


Arbeiten mit Daten mithilfe von Code in Microsoft Dataverse

Es gibt verschiedene Möglichkeiten, mithilfe von Code auf Dataverse-Daten zuzugreifen.

In diesem Artikel werden die Optionen vorgestellt, mit denen Sie mit Dataverse-Daten mithilfe von Code arbeiten müssen.

Abrufen, Hinzufügen und Ändern von Daten

Dataverse bietet zwei Möglichkeiten zum Abrufen, Hinzufügen und Ändern von Daten: SDK für .NET & Web-API. Wählen Sie die Option aus, die den Anforderungen, Ihren Fähigkeiten und Vorlieben am besten entspricht.

Flussdiagramm zum Auswählen des Programmierstils

SDK für .NET

Wenn Sie mit .NET arbeiten, empfehlen wir die Verwendung unseres SDK für .NET.

Das Dataverse SDK für .NET unterstützt Build-Ziele für das .NET Framework und .NET 6+. Plug-In- und benutzerdefinierte Workflowaktivitäten müssen jedoch .NET Framework verwenden.

Wenn Sie unser PowerShell-Modul oder unser benutzerdefiniertes Anmeldesteuerelement mit einer Windows-Clientanwendung verwenden, verwenden Sie die Xrm.Tooling

SDK für Python

Wenn Sie mit Python arbeiten, empfehlen wir die Verwendung unseres SDK für Python. Das SDK ermöglicht Data Scientists und Entwicklern das Erstellen, Zugreifen auf und Manager von Dataverse-Geschäftsdaten mithilfe der Python-Programmierung. Das Dataverse SDK für Python implementiert gängige Python-Programmierparadigma und bewährte Methoden, bietet eine natürlichere Python-Schnittstelle zu Dataverse und unterstützt Communitybeiträge.

Weitere Informationen: Erste Schritte

Web-API

Die Dataverse-Web-API ist ein OData v4 RESTful-Endpunkt. Verwenden Sie die Web-API für jede Programmiersprache, die HTTP-Anforderungen und Authentifizierung mit OAuth 2.0 unterstützt, einschließlich .NET.

Dataverse-Daten durchsuchen

Dataverse liefert schnelle und umfassende Suchergebnisse für mehrere Tabellen in einer Liste, sortiert nach Relevanz. Es bietet auch Funktionen zur Unterstützung von Vorschlägen und Autovervollständigungserlebnissen in Apps.

Die Suche verfügt über einen nativen Endpunkt, und es gibt Dataverse-Nachrichten, die Sie über die Web-API oder das SDK für .NET verwenden können.

Informationen zum Suchen nach Dataverse-Datensätzen

Abfragen von Daten mit SQL

Der Power Query Dataverse-Connector verwendet den TDS-Endpunkt (Dataverse Tabular Data Stream), um Daten mithilfe von Dataverse SQL abzurufen, einer Teilmenge von Transact-SQL.

Das Abrufen von Daten mit SQL Management Studio (SSMS) ist ein Vorschaufeature.

Informationen zur Verwendung von SQL zum Abfragen von Daten

Einschränkungen für die Größe der Anforderungs- und Antwort-Payload

Die maximale Nutzlastgröße für jede an Dataverse gesendete Anforderung beträgt 128 MB. Anforderungen mit Nutzlasten über diesem Grenzwert erhalten in der Antwort einen 413 Nutzlast zu groß HTTP-Statuscode.

Es gibt eine Größenbeschränkung von 1 GB für die Größe einer Antwort, die Dataverse zurückgibt. Nur wenige APIs oder Abfragen sind fähig, so viele Daten zurückzugeben. Wenn dieser Grenzwert auftritt, sollten Sie überlegen, welche anderen Optionen verfügbar sind, um die Daten in mehreren, kleineren Anforderungen abzurufen.

Die veralteten SOAP-Endpunktnutzlasten verwenden serialisierte XML-Daten, die viel ausführlicher sind als die serialisierten JSON-Datennutzlasten, die die Web-API verwendet. Es treten weniger Fehler auf, bei denen die Anforderungs- oder Antwortnutzlast zu groß ist, wenn Sie die Web-API verwenden. Erfahren Sie mehr über den älteren SOAP-Endpunkt