Arbeiten mit Daten mit Hilfe von Code in Microsoft Dataverse

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

• Verwenden Sie das Dataverse SDK für .NET oder die Web-API, um Daten abzurufen, hinzuzufügen und zu ändern.
• Verwenden Sie die Dataverse Suche, um Dataverse-Daten zu suchen.
• Verwenden Sie den Endpunkt für den tabellarischen Dataverse Datenstrom (TDS), um Daten mit SQL abzufragen.

Dieser Artikel stellt die Möglichkeiten vor, die Ihnen zur Verfügung stehen, um mithilfe von Code mit Dataverse-Daten zu arbeiten.

Daten abrufen, hinzufügen und ändern

Dataverse bietet zwei Möglichkeiten, um Daten abzurufen, hinzuzufügen und zu ändern: SDK für .NET und die Web-API. Wählen Sie die, die den Anforderungen, Ihren Fähigkeiten und Vorlieben am besten entspricht.

SDK für .NET

Wenn Sie mit .NET arbeiten, sollten Sie unser SDK für .NET verwenden.

• Verwenden Sie die ServiceClient-Klasse im DataverseServiceClient NuGet-Paket, wenn Sie eine Clientanwendung haben.
• Verwenden Sie das Paket Microsoft.CrmSdk.CoreAssemblies NuGet , wenn Sie ein Plug-In oder ein benutzerdefiniertes Workflowaktivität schreiben.

Das Dataverse-SDK für .NET unterstützt das Erstellen von Zielen für .NET Framework und .NET 6+. Plug-Ins und Workflowaktivitäten müssen jedoch .NET Framework verwenden.

Wenn Sie unser PowerShell-Modul oder unser benutzerdefiniertes Anmelde-Steuerelement mit einer Windows-Client-Anwendung verwenden, verwenden Sie das Xrm.Tooling

• Das SDK für .NET verwenden
• Schnellstart: Eine SDK für .NET-Anforderung ausführen (C#)

Internet-API

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

• Mehr über die 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 von der Web-API oder dem SDK für .NET aus verwenden können.

Mehr zur Suche nach Dataverse-Datensätzen

Daten mit SQL abfragen

Der Power Query Dataverse Connector verwendet den Endpunkt für den tabellarischen Dataverse-Datenstrom (TDS), um Daten mit Dataverse SQL abzurufen, einer Teilmenge von Transact-SQL.

Das Abrufen von Daten mit SQL Management Studio (SSMS) ist eine Vorschaufunktion.

Erfahren Sie, SQL zum Abfragen von Daten zu verwenden

Größenbeschränkungen für Anfragen und Antwort-Nutzlasten

Die maximale Nutzlastgröße für alle an Dataverse gesendeten Anfragen beträgt 128 MB. Anfragen mit Nutzlasten über diesem Grenzwert erhalten den HTTP-Statuscode 413 Payload Too Large im Antwort.

Es gibt eine Größenbeschränkung von 1 GB für die Größe einer Dataverse zurückgegebenen Antwort. Nur wenige APIs oder Abfragen können so viele Daten zurückgeben. Wenn Sie auf diesen Grenzwert stoßen, sollten Sie überlegen, welche anderen Optionen verfügbar sind, um die Daten in mehreren, kleineren Anfragen abzurufen.

Die veralteten SOAP-Nutzdaten Endpunkt verwenden serialisierte XML-Daten, die wesentlich ausführlicher sind als die serialisierten JSON-Datennutzdaten, die die Web-API verwendet. Bei Verwendung der Web-API ist die Wahrscheinlichkeit geringer, dass Fehler auftreten, bei denen die Anforderung oder die Antwort-Nutzlast zu groß ist. Erfahren Sie mehr über das alte SOAP Endpunkt