Premiers pas

Cet article explique comment configurer votre environnement de Python pour accéder à Dataverse via le Kit de développement logiciel (SDK) Dataverse pour Python. Il montre ensuite quelques exemples de codage simples pour vous aider à démarrer.

Prerequisites

  • Accès en lecture/écriture à un environnement Dataverse. Vous pouvez utiliser un environnement d’évaluation.
  • Authentification OAuth configurée pour votre application.
  • Environnement Python 3.10+ activé.
  • Pandas version 2.0.0+.
  • L’accès réseau à pypi.org pour obtenir les packages du Kit de développement logiciel (SDK).

Installer le Kit de développement logiciel (SDK) et les dépendances

À partir d’une fenêtre de terminal, exécutez la commande suivante. Cette commande installe la dernière version stable du Kit de développement logiciel (SDK) à partir d’un package pypi.org .

pip install PowerPlatform-Dataverse-Client

Exécutez la commande suivante pour installer le Kit de développement logiciel (SDK) à partir de la source GitHub du projet au lieu du package. Installez le client à partir du package PyPi ou à partir de la source, mais pas les deux.

git clone <https://github.com/microsoft/PowerPlatform-DataverseClient-Python.git>
cd PowerPlatform-DataverseClient-Python
pip install -e .

Installer Claude Skill globalement

Pour améliorer l’expérience de développement Python, vous pouvez éventuellement installer deux Compétences Claude lors de l’installation du Kit de développement logiciel (SDK) à partir d’un package.

pip install PowerPlatform-Dataverse-Client && dataverse-install-claude-skill

Important

Les compétences sont automatiquement chargées lors de l’installation à partir de la source.

Les deux compétences sont décrites dans la liste suivante :

  • dataverse-sdk-use: appliquez les meilleures pratiques pour l’utilisation du Kit de développement logiciel (SDK) dans vos applications.
  • dataverse-sdk-dev: fournissez des conseils pour le développement et la contribution au SDK lui-même.

Les compétences fonctionnent à la fois avec l’interface CLI Claude Code et l’extension Visual Studio Code. Une fois installé, Claude utilise automatiquement la compétence appropriée lors de l’utilisation des opérations Dataverse. Pour plus d’informations sur Claude Skill, consultez Compétences de l’agent. Une fois installé, vous pouvez trouver les définitions de compétences dans les fichiers .claude/skills/dataverse-sdk-use/SKILL.md et .claude/skills/dataverse-sdk-dev/SKILL.md sur votre ordinateur de développement.

Se connecter à Dataverse

Le kit SDK client nécessite toute implémentation Azure Identity TokenCredential pour l’authentification OAuth avec Dataverse.

Cet exemple de code importe le client Dataverse et Azure Types d’identité et établit une connexion à un environnement Dataverse. Veillez à passer myorg de l’URL au nom correct de votre environnement.

from azure.identity import (
    InteractiveBrowserCredential, 
    ClientSecretCredential,
    CertificateCredential,
    AzureCliCredential
)
from PowerPlatform.Dataverse.client import DataverseClient

# Development options
credential = InteractiveBrowserCredential()  # Browser authentication
# credential = AzureCliCredential()          # If logged in via 'az login'

# Production options  
# credential = ClientSecretCredential(tenant_id, client_id, client_secret)
# credential = CertificateCredential(tenant_id, client_id, cert_path)

client = DataverseClient("https://myorg.crm.dynamics.com", credential)

Vous pouvez personnaliser la connexion à l’aide de paramètres http facultatifs pour gérer les délais d’expiration de connexion, les nouvelles tentatives, etc. Accédez à ces paramètres via la classe DataverseConfig .

Maintenant que vous disposez d’une connexion cliente établie à un environnement Dataverse, vous pouvez commencer à utiliser le Kit de développement logiciel (SDK) pour travailler avec des données métier, des métadonnées de table, etc. L’article suivant décrit quelques exemples de ces opérations.

Pour plus d’informations, consultez Utiliser OAuth avec Dataverse.

Espaces de noms

Le package PowerPlatform.Dataverse.operations contient des modules qui organisent les opérations du Kit de développement logiciel (SDK) en groupes logiques, comme décrit dans le tableau suivant.

Nom Description
client.records Créer, mettre à jour, supprimer et obtenir des enregistrements (requêtes uniques ou paginés)
client.query Opérations de requête et de recherche
client.tables Gestion des métadonnées de table et de colonne
client.files Opérations de téléchargement de fichier
client.dataframe Prise en charge de Pandas DataFrame
client.batch Opérations par lots

Pour obtenir des exemples d’utilisation de ces opérations, consultez les articles sur l’interrogation des données et l’utilisation des données .

Étapes suivantes

  • Last updated on