Trabalhar com dados usando código no Microsoft Dataverse

Há várias maneiras diferentes de acessar dados do Dataverse usando código.

• Use o SDK do Dataverse para .NET, SDK para Python ou API Web para recuperar, adicionar e modificar dados.
• Use a busca do Dataverse para pesquisar dados do Dataverse.
• Use o ponto de extremidade TDS (Fluxo de Dados Tabulares) do Dataverse para consultar dados com SQL.

Este artigo apresenta as opções que você precisa para trabalhar com dados do Dataverse usando código.

Recuperar, adicionar e modificar dados

O Dataverse fornece duas maneiras de recuperar, adicionar e modificar dados: SDK para .NET &API Web. Escolha aquele que melhor corresponda aos requisitos, às suas habilidades e às preferências.

SDK para .NET

Se você estiver trabalhando com o .NET, recomendamos usar nosso SDK para .NET.

• Use a classe ServiceClient no pacote NuGet DataverseServiceClient se você tiver um aplicativo de cliente.
• Use o pacote NuGet Microsoft.CrmSdk.CoreAssemblies ao escrever um plug-in ou uma atividade de fluxo de trabalho personalizada.

O SDK do Dataverse para .NET dá suporte a destinos de build para .NET Framework e .NET 6+. No entanto, as atividades de plug-in e fluxo de trabalho personalizado devem usar o .NET Framework.

Se você estiver usando nosso módulo do PowerShell ou nosso controle de login personalizado com um aplicativo cliente Windows, utilize o Xrm.Tooling

• Usar o SDK para .NET
• Início Rápido: Executar um SDK para solicitação .NET (C#)

SDK para Python

Se você estiver trabalhando com o Python, recomendamos usar nosso SDK para Python. O SDK permite que cientistas de dados e desenvolvedores criem, acessem e gerentem dados de negócios do Dataverse usando a programação do Python. O SDK do Dataverse para Python implementa paradigmas comuns de programação do Python e práticas recomendadas, fornece uma interface Python mais natural para o Dataverse e dá suporte a contribuições da comunidade.

Mais informações: Introdução

Web API

A API Web do Dataverse é em um ponto de extremidade do RESTful OData v4. Use a API Web para qualquer linguagem de programação que dê suporte a solicitações HTTP e autenticação usando o OAuth 2.0, incluindo o .NET.

• Saiba como usar a API Web do Dataverse
• Início Rápido: API Web com o PowerShell e o Visual Studio Code
• Início Rápido: Exemplo de API Web (C#)

Pesquisar dados do Dataverse

A pesquisa do Dataverse fornece resultados de pesquisa rápidos e abrangentes em várias tabelas, em uma única lista, classificadas por relevância. Ele também fornece recursos para dar suporte a sugestões e experiências de preenchimento automático em aplicativos.

A pesquisa tem um ponto de extremidade nativo e há mensagens do Dataverse que você pode usar na API da Web ou no SDK para .NET.

Saiba como pesquisar registros do Dataverse

Consultar dados com SQL

O conector do Dataverse do Power Query usa o ponto de extremidade Dataverse Tabular Data Stream (TDS) para recuperar dados usando o DATAverse SQL, um subconjunto do Transact-SQL.

A recuperação de dados usando o SSMS (SQL Management Studio) é um recurso de visualização.

Saiba como usar o SQL para consultar dados

Limitações de tamanho de payload de requisição e resposta

O tamanho máximo da carga para qualquer solicitação enviada ao Dataverse é de 128 MB. As solicitações com cargas acima desse limite recebem um código de status HTTP muito grande de carga 413 na resposta.

Há uma limitação de tamanho de 1 GB no tamanho de uma resposta retornada pelo Dataverse. Poucas APIs ou consultas são capazes de retornar tantos dados. Se você encontrar esse limite, deverá considerar quais outras opções estão disponíveis para obter os dados em várias solicitações menores.

Os payloads de endpoint SOAP preteridos usam dados XML serializados que são muito mais verbosos do que os payloads de dados JSON serializados que a Web API utiliza. É menos provável que você encontre erros em que a carga de solicitação ou resposta seja muito grande quando você usa a API Web. Saiba mais sobre o endpoint SOAP legado