Compartilhar via


Iniciando (prévia)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Neste artigo, descrevemos como configurar seu ambiente python para acessar o Dataverse por meio do SDK do Dataverse para Python. Em seguida, mostramos alguns exemplos de codificação simples para começar.

Pré-requisitos

  • Acesso de leitura/gravação a um ambiente do Dataverse. Um ambiente de avaliação pode ser usado.
  • Um ambiente do Python 3.10+ ativado.
  • Acesso à rede a pypi.org para obter os pacotes do SDK.

Instalar o SDK e as dependências

Em uma janela de terminal, execute o comando a seguir. Isso instala o SDK do pypi.org.

pip install PowerPlatform-Dataverse-Client

Conectar-se ao Dataverse

Este exemplo de código importa os tipos de cliente e de configuração dos pacotes do SDK e estabelece uma conexão com seu ambiente do Dataverse. Certifique-se de alterar 'myorg' na URL para o nome correto do seu ambiente.

from azure.identity import InteractiveBrowserCredential
from PowerPlatform.Dataverse.client import DataverseClient
from PowerPlatform.Dataverse.core.config import DataverseConfig

cfg = DataverseConfig()  # defaults to language_code=1033
client = DataverseClient(base_url="https://<myorg>.crm.dynamics.com", 
    InteractiveBrowserCredential(), config=cfg)

Você pode personalizar a conexão utilizando configurações opcionais ajustáveis de HTTP para lidar com tempos limite de conexão, novas tentativas etc. Acesse essas configurações por meio de cfg.http_retries, cfg.http_backoff e cfg.http_timeout.

Agora que você tem uma conexão de cliente estabelecida com um ambiente do Dataverse, pode começar a usar o SDK para trabalhar com dados corporativos, metadados de tabela e muito mais. O próximo artigo abordará alguns exemplos dessas operações.

Antes de sair desta página, observe que você não pode trabalhar com o Dataverse efetivamente, a menos que tenha algum conhecimento do Dataverse. Fornecemos um artigo de guia rápido que ensina as noções básicas.

Próximas etapas