Utiliser des données à l’aide de code dans Microsoft Dataverse

Il existe plusieurs façons d’accéder aux données Dataverse à l’aide du code.

• Utilisez le Kit de développement logiciel (SDK) Dataverse pour .NET, le SDK pour Python ou l’API web pour récupérer, ajouter et modifier des données.
• Utilisez la recherche Dataverse pour explorer les données Dataverse.
• Utilisez le point de terminaison TDS (Dataverse Tabular Data Stream) pour interroger des données avec SQL.

Cet article présente les options que vous devez utiliser avec les données Dataverse à l’aide du code.

Récupérer, ajouter et modifier des données

Dataverse fournit deux façons de récupérer, d’ajouter et de modifier des données : sdk pour l’API .NET &Web. Choisissez celui qui correspond le mieux aux exigences, à vos compétences et à vos préférences.

Kit de développement logiciel (SDK) pour .NET

Si vous utilisez .NET, nous vous recommandons d’utiliser notre Kit de développement logiciel (SDK) pour .NET.

• Utilisez la classe ServiceClient dans le package NuGet DataverseServiceClient si vous disposez d’une application cliente.
• Utilisez le package NuGet Microsoft.CrmSdk.CoreAssemblies lorsque vous écrivez un plug-in ou une activité de flux de travail personnalisée.

Le Kit de développement logiciel (SDK) Dataverse pour .NET prend en charge les cibles de génération pour .NET Framework et .NET 6+. Toutefois, les activités de plug-in et de workflow personnalisées doivent utiliser .NET Framework.

Si vous utilisez notre module PowerShell ou que vous utilisez notre contrôle de connexion personnalisé avec une application cliente Windows, utilisez Xrm.Tooling

• Utiliser le Kit de développement logiciel (SDK) pour .NET
• Démarrage rapide : Exécuter un Kit de développement logiciel (SDK) pour la requête .NET (C#)

Kit SDK pour Python

Si vous utilisez Python, nous vous recommandons d’utiliser notre Kit de développement logiciel (SDK) pour Python. Le Kit de développement logiciel (SDK) permet aux scientifiques et développeurs de données de créer, d’accéder et de gérer des données métier Dataverse à l’aide de la programmation Python. Le Kit de développement logiciel (SDK) Dataverse pour Python implémente des paradigmes de programmation Python courants et des bonnes pratiques, fournit une interface Python plus naturelle à Dataverse et prend en charge les contributions de la communauté.

Pour plus d’informations : Démarrage

API Web

L’API web Dataverse est un point de terminaison RESTful OData v4. Utilisez l’API web pour tout langage de programmation qui prend en charge les requêtes HTTP et l’authentification à l’aide d’OAuth 2.0, y compris .NET.

• Apprendre à utiliser l’API web Dataverse
• Démarrage rapide : API web avec PowerShell et Visual Studio Code
• Démarrage rapide : exemple de l’API Web (C#)

Rechercher des données Dataverse

La recherche Dataverse fournit des résultats de recherche rapides et complets sur plusieurs tables, dans une seule liste, triée par pertinence. Il fournit également des fonctionnalités permettant de prendre en charge des suggestions et des expériences de saisie automatique dans les applications.

La recherche a un point de terminaison natif et il existe des messages Dataverse que vous pouvez utiliser à partir de l’API web ou du Kit de développement logiciel (SDK) pour .NET.

Découvrez comment rechercher des enregistrements Dataverse

Interroger des données avec SQL

Le connecteur Dataverse Power Query utilise le point de terminaison TDS (Dataverse Tabular Data Stream) pour récupérer des données à l’aide de Dataverse SQL, un sous-ensemble de Transact-SQL.

La récupération de données à l’aide de SQL Management Studio (SSMS) est une fonctionnalité en préversion.

Apprendre à utiliser SQL pour interroger des données

Limitations de taille de la charge utile de requête et de réponse

La taille maximale de la charge utile pour toute requête envoyée à Dataverse est de 128 Mo. Les requêtes dont la charge utile dépasse cette limite reçoivent un code d’état HTTP 413 Demande Entité Trop Large dans la réponse.

Il existe une limitation de taille de 1 Go sur la taille d’une réponse retournée par Dataverse. Peu d’API ou de requêtes sont capables de retourner ces données. Si vous rencontrez cette limite, vous devez prendre en compte les autres options disponibles pour obtenir les données dans plusieurs demandes plus petites.

Les charges utiles des endpoints SOAP dépréciés utilisent des données XML sérialisées beaucoup plus verbeuses que les charges utiles de données JSON sérialisées utilisées par l’API Web. Vous êtes moins susceptible de rencontrer des erreurs où la charge utile de requête ou de réponse est trop importante lorsque vous utilisez l’API web. En savoir plus sur le point de terminaison SOAP hérité