Configurar a conexão do Dataverse

Este artigo descreve as etapas para criar uma conexão do Dataverse.

Tipos de autenticação com suporte

O conector do Dataverse é compatível com os seguintes tipos de autenticação para cópias e Dataflow Gen2, respectivamente.

Configurar sua conexão para o Dataflow Gen2

Você pode conectar o Dataflow Gen2 ao Dataverse no Microsoft Fabric usando conectores do Power Query. Siga estas etapas para criar sua conexão:

1. Verifique as funcionalidades, as limitações e as considerações para garantir que o cenário seja compatível.
2. Preencha os pré-requisitos para o Dataverse.
3. Obter dados no Fabric.
4. Localize a URL do ambiente do Dataverse.
5. Conecte-se ao Dataverse.

Capabilities

• URL do servidor
• Import
• DirectQuery (modelos semânticos do Power BI)
• Avançado
  • Adicionar colunas de relação

Pré-requisitos

Você deve ter um ambiente do Dataverse.

Você deve ter permissões de leitura para acessar dados em tabelas.

Para usar o conector do Dataverse, a configuração do ponto de extremidade TDS deve estar habilitada em seu ambiente. Mais informações: Gerenciar configurações de recursos e solucionar problemas de conexão usando o SQL para consultar dados

Para usar o conector do Dataverse, uma das portas TCP 1433 ou 5558 precisa estar aberta para se conectar. A porta 1433 é usada automaticamente. No entanto, se a porta 1433 estiver bloqueada, você poderá usar a porta 5558. Para habilitar a porta 5558, você deve acrescentar o número dessa porta à URL do ambiente Dataverse, como yourenvironmentid.crm.dynamics.com, 5558. Mais informações: SQL Server problema de conexão devido a portas fechadas

Obter dados

Para obter dados no Data Factory:

1. No lado esquerdo do Data Factory, selecione Workspaces.

2. No workspace do Data Factory, selecione Novo Fluxo de Dados Gen2> para criar um novo fluxo de dados.

   

3. No Power Query, selecione Obter dados na faixa de opções ou selecione Obter dados de outra origem na exibição atual.

   

4. Na página Escolher fonte de dados, use Pesquisar para pesquisar o nome do conector ou selecione Exibir mais à direita do conector para ver uma lista de todos os conectores disponíveis no serviço do Power BI.

   

5. Se você optar por exibir mais conectores, ainda poderá usar Pesquisar para pesquisar o nome do conector ou escolher uma categoria para ver uma lista de conectores associados a essa categoria.

   

Localizar a URL do ambiente do Dataverse

Se precisar usar a porta 5558 para se conectar ao Dataverse, você precisará encontrar sua URL de ambiente do Dataverse. Abra Power Apps. No canto superior direito da página Power Apps, selecione o ambiente ao qual você vai se conectar. Selecione o Ícone de configurações e selecione Configurações avançadas.

Na nova guia que será aberta no navegador, copie a raiz da URL. Essa URL raiz é a URL exclusiva para seu ambiente. A URL estará no formato https://<yourenvironmentid>.crm.dynamics.com/. Remova "https://" e a barra no final da URL antes de colá-la para se conectar ao seu ambiente. Acrescente a porta 5558 ao final da URL do ambiente, por exemplo, yourenvironmentid.crm.dyamics.com,5558.

Conectar-se ao Dataverse

Para se conectar ao Dataverse do Power Query Online:

1. Selecione a opção Dataverse na página Escolher fonte de dados. Mais informações: Onde obter dados

2. Na página Conectar à fonte de dados, deixe o endereço de URL do servidor em branco. Deixar o endereço em branco irá listar todos os ambientes disponíveis que você tem permissão para usar na janela do Navegador do Power Query.

   

   Observação

   Se você precisar usar a porta 5558 para acessar seus dados, precisará carregar um ambiente específico com a porta 5558 acrescentada no final no endereço da URL do servidor. Nesse caso, acesse Localizar a URL de ambiente do Dataverse para obter instruções sobre como obter o endereço de URL do servidor correto.

3. Se necessário, insira um gateway de dados local se estiver usando dados locais. Por exemplo, se você vai combinar dados do Dataverse e de um banco de dados SQL Server local.

4. Entre em sua conta organizacional.

5. Depois de entrar, selecione Avançar.

6. Na página de navegação, selecione os dados necessários e depois selecione Transformar Dados.

   

Limitações e considerações

Host específico para Excel

O conector Power Query Dataverse dentro do Excel atualmente não dá suporte a clusters de nuvem soberana (por exemplo, China, Alemanha, EUA).

Limites de desempenho e restrição do Dataverse

Para obter informações sobre limites de limitação e desempenho para conexões do Dataverse, acesse Limites e alocações de solicitações. Essas limitações se aplicam ao conector do Dataverse e ao conector do Feed OData ao acessar o mesmo endpoint.

Taxa de recuperação da tabela

Como orientação, a maioria das tabelas padrão é recuperada a uma taxa de aproximadamente 500 linhas por segundo, usando o conector do Dataverse. Leve essa taxa em conta ao decidir se deseja se conectar ao Dataverse ou exportar para o Data Lake. Se você precisar de taxas de recuperação mais rápidas, considere usar o recurso Exportar para Data Lake ou o endpoint TDS (Fluxo de Dados Tabulares). Mais informações: Conexões alternativas do Dataverse.

Conexões alternativas do Dataverse

Há várias maneiras alternativas de extrair e migrar dados do Dataverse:

• Use o recurso Azure Synapse Link em Power Apps para extrair dados do Dataverse para Azure Data Lake Storage Gen2, que podem ser usados para executar análises. Para obter mais informações sobre o recurso Synapse Link do Azure, acesse O que é o Synapse Link do Azure para Dataverse?.

• Use o conector OData para mover dados para dentro e para fora do Dataverse. Para obter mais informações sobre como migrar dados entre ambientes do Dataverse usando o conector OData de fluxos de dados, acesse Migrar dados entre ambientes do Dataverse usando o conector OData de fluxos de dados.

SQL Server problema de conexão devido a portas fechadas

Ao se conectar com o conector do Dataverse, você pode encontrar um erro Unable to connect indicando que ocorreu um erro específico de rede ou instância ao estabelecer uma conexão com SQL Server. Esse erro provavelmente é causado pelas portas TCP 1433 ou 5558 bloqueadas durante a conexão. Para solucionar o erro da porta bloqueada, vá para portas bloqueadas.

Usar consultas de banco de dados nativos com o Dataverse

Você pode se conectar ao Dataverse usando uma instrução SQL personalizada ou uma consulta de banco de dados nativa. Embora não haja nenhuma interface do usuário para essa experiência, você pode inserir a consulta usando o Power Query Advanced Editor. Para usar uma consulta de banco de dados nativo, um banco de dados deve ser especificado como a Origem.

Source = CommonDataService.Database([DATABASE URL])

Depois que uma fonte de banco de dados for definida, você poderá especificar uma consulta nativa usando a função Value.NativeQuery.

myQuery = Value.NativeQuery(Source, [QUERY], null, [EnableFolding=true])

No conjunto, a consulta fica assim.

let
    Source = CommonDataService.Database("[DATABASE]"),
    myQuery = Value.NativeQuery(Source, "[QUERY]", null, [EnableFolding=true])
in
    myQuery

Escrever incorretamente um nome de coluna pode resultar em uma mensagem de erro sobre dobragem de consultas, em vez de coluna ausente.

Acessando grandes quantidades de dados do Dataverse

Consultas em tabelas do Dataverse podem retornar grandes quantidades de dados. Se você estiver usando o conector Power Query Dataverse, qualquer consulta específica que acesse o modelo terá um tempo limite fixo de cinco (5) minutos, independentemente do tamanho dos dados. Para obter mais informações, acesse limitações. Portanto, talvez seja necessário consultar os dados várias vezes para acessar todos os dados no modelo. O uso de várias consultas pode levar um tempo considerável para retornar todos os dados.

Se você estiver usando o conector do Common Data Service (Herdado), é possível usar uma única consulta para acessar todos os dados. Esse conector funciona de forma diferente e retorna o resultado em "páginas" de registros de 5 K. Embora o conector do Common Data Service (Legacy) seja mais eficiente no retorno de grandes quantidades de dados, ainda pode levar um tempo significativo para retornar o resultado.

Em vez de usar esses conectores para acessar grandes quantidades de dados do Dataverse, recomendamos que você use Azure Synapse Link para acessar modelos grandes. O uso do Azure Synapse Link é ainda mais eficiente do que os conectores Power Query Dataverse ou Common Data Service (Herdado) e foi projetado especificamente para cenários de integração de dados.

Problemas de desempenho relacionados às colunas de relação

Erros de visualização podem ocorrer devido a uma limitação conhecida quando o recurso Propriedades de Navegação está habilitado no Dataverse.

Você pode ver uma mensagem como esta, por exemplo: Preview.Error: The type of the current preview value is too complex to display.

Para resolver esse problema, semelhante ao conector do SQL Server, há uma opção disponível para desabilitar as propriedades de navegação (colunas de relação) no conector do Dataverse para melhorar o desempenho. Essa opção pode ser definida nas opções advanced disponíveis no Power Query Online ou pode ser definida usando o parâmetro CreateNavigationProperties=false na função conector do Dataverse.

 Source = CommonDataService.Database("{crminstance}.crm.dynamics.com",[CreateNavigationProperties=false]),

Conteúdo relacionado

• Para obter mais informações sobre esse conector, consulte a documentação do conector do Dataverse.