Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Es gibt verschiedene Möglichkeiten, mithilfe von Code auf Dataverse-Daten zuzugreifen.
- Verwenden Sie das Dataverse SDK für .NET, SDK für Python oder Web-API , um Daten abzurufen, hinzuzufügen und zu ändern.
- Verwenden Sie die Dataverse-Suche, um Dataverse-Daten zu durchsuchen.
- Verwenden Sie den TDS-Endpunkt (Dataverse Tabular Data Stream), um Daten mit SQL abzufragen.
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.
SDK für .NET
Wenn Sie mit .NET arbeiten, empfehlen wir die Verwendung unseres SDK für .NET.
- Verwenden Sie die ServiceClient-Klasse im DataverseServiceClient NuGet-Paket , wenn Sie über eine Clientanwendung verfügen.
- Verwenden Sie das Microsoft.CrmSdk.CoreAssemblies NuGet-Paket , wenn Sie ein Plug-In oder eine benutzerdefinierte Workflowaktivität schreiben.
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.
- Informationen zur Verwendung der Dataverse-Web-API
- Schnellstart: Web-API mit PowerShell und Visual Studio Code
- Schnellstart: Web API Beispiel (C#)
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