Como realizar consultas SQL no Dynamics 365 CRM usando o protocolo TDS

Como realizar consultas SQL no Dynamics 365 CRM usando o protocolo TDS

Seguindo a mesma demanda de trabalho do meu artigo anterior, onde eu precisava importar os dados de algumas entidades do Dynamics 365 CRM, para um banco de dados SQL Server, para realizar algumas análises e transformações. Com isso fui pesquisar na internet possíveis soluções e posteriormente fui perguntar para algumas pessoas da comunidade que eu participo, se alguém já tinha executado essa tarefa ou feito algo similar, quando me apresentaram essa solução que eu achei sensacional, onde eu poderia se conectar com o Common Data Service (Banco de dados do Dynamics 365), via TDS (Basicamente um protocolo que usa comunicação cliente-servidor com o SQL Server), ou seja eu poderia abrir o meu SQL Server Management Studio e começar a fazer consultas SQL com as entidades do Dynamics 365, que facilitam muito mais a vida do que usar os métodos convencionais de conexão com a base de dados do mesmo, que são o Web Service e Web API, onde ambos necessitam de desenvolvimento para realizar consultas e capturar esses dados para posteriormente realizar integrações.

Possíveis usos dos dados do Dynamics com TDS

Você pode criar uma aplicação .NET (ou outras linguagens) para se conectar ao Dynamics usando TDS, utilizando uma string de conexão similar a essa

Server=<orgname>.crm2.dynamics.com,5558;Authentication=Active Directory Password;Database=<orgname>.com;User Id=<user name(email address)>;Password=<password>;

Não foi fornecido texto alternativo para esta imagem

Utilizar o Power BI como nesse artigo da Microsoft, para se conectar ao Dynamics utilizando o conector do SQL Server e realizar consultas usando SQL.

Não foi fornecido texto alternativo para esta imagem

Utilizar o SQL Server Management Studio para realizar consultas utilizando SQL para realizar consultas no Dynamics 365

Não foi fornecido texto alternativo para esta imagem

Pré-Requisitos

  1. Baixar ou abrir o SQL Server Management Studio (18.4 ou posterior)
  1. Habilitar o endpoint TDS no seu ambiente do Dynamics 365.

Habilitando o TDS em seu Ambiente Dynamics

Abra a Central de Administração da Power Platform, clique no ambiente em que deseja habilitar o endpoint TDS, depois acesse configurações.

Não foi fornecido texto alternativo para esta imagem

Em Produto clique na “setinha”, para abrir o leque de opções como na imagem abaixo, após visualizar as opções clique em recursos.

Não foi fornecido texto alternativo para esta imagem

Na página de recursos, habilite a opção “Ponto de extremidade TDS“, assim finalizando a configuração necessária do ambiente.

Não foi fornecido texto alternativo para esta imagem

Se conectando a Base de Dados do Dynamics 365

Nesse exemplo vou utilizar o SQL Server Management Studio para realizar essa conexão, pois acredito que seja a interface mais recomendada e utilizada para realizar consultas ao SQL Server. https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/cds-sql-query

A conexão deve seguir esse estrutura:

  • Nome do Servidor : seucrm.crm2.dynamics.com,5558
  • Autenticação : Azure Active Directory – senha
  • Senha : senha do email informado
 

Não foi fornecido texto alternativo para esta imagem

Após se conectar irá aparecer a estrutura do servidor com todas tabelas, semelhante a imagem abaixo

Não foi fornecido texto alternativo para esta imagem

Com a conexão criada você pode criar consultas SQL e realizar suas análises.

Não foi fornecido texto alternativo para esta imagem

Para mais informações acesse a documentação oficial da Microsoft

https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/cds-sql-query

Observações Importantes

  • SQL for CDS ainda está em preview, desta forma, existem regiões que ainda não possuem esta opção disponível por hora
  • Para ter acesso ao preview é necessário que a versão de nosso CDS seja igual ou superior a 9.1.0.17437
  • A base de dados do CDS será disponibilizada em modo somente leitura (read-only). Assim, não podemos criar, alterar ou excluir nenhum registro, tabela ou relacionamento.
  •  Existe uma limitação de Tempo de Execução da consulta de 2 minutos, ou seja você deve utilizar esse recurso para consultas que não são muito complexas e que não demandem mais que dois minutos para retornar todos os dados solicitados

Referências

https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/cds-sql-query

Deixe uma resposta