Configurar sua conexão Dataverse

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

Tipos de autenticação suportados

O conector Dataverse suporta os seguintes tipos de autenticação para cópia e Dataflow Gen2, respectivamente.

Configurar sua conexão para Dataflow Gen2

Podes ligar o Dataflow Gen2 ao Dataverse no Microsoft Fabric usando conectores Power Query. Siga estes passos para criar a sua ligação:

1. Verifique capacidades, limitações e considerações para garantir que o seu cenário é suportado.
2. Pré-requisitos completos para o Dataverse.
3. Obtenha dados no Fabric.
4. Encontre a URL do seu ambiente Dataverse.
5. Liga-te ao Dataverse.

Capabilities

• URL do servidor
• Import
• DirectQuery (modelos semânticos do Power BI)
• Avançado
  • Incluir colunas de relacionamento

Pré-requisitos

Você deve ter um ambiente Dataverse.

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

Para usar o conector Dataverse, a configuração do ponto de extremidade TDS deve estar habilitada no seu ambiente. Mais informações: Gerir definições de funcionalidades e resolução de problemas de ligação usando SQL para consultar dados

Para usar o conector 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ê pode usar a porta 5558. Para habilitar a porta 5558, você deve acrescentar esse número de porta à URL do ambiente Dataverse, como yourenvironmentid.crm.dynamics.com, 5558. Mais informações: Problema de conexão do SQL Server devido a portas fechadas

Obter dados

Para obter dados no Data Factory:

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

2. No espaço de trabalho do Data Factory, selecione Novo>Dataflow Gen2 para criar um novo fluxo de dados.

   

3. No Power Query, selecione Obter dados no friso ou selecione Obter dados de outra origem na vista atual.

   

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

   

5. Se optares por visualizar mais conectores, podes ainda usar a Pesquisa para encontrar o nome do conector ou escolher uma categoria para ver uma lista de conectores associados a essa categoria.

   

Encontre o URL do seu ambiente Dataverse

Se você precisar usar a porta 5558 para se conectar ao Dataverse, será necessário encontrar a URL do ambiente Dataverse. Abrir Power Apps. No canto superior direito da página do Power Apps, selecione o ambiente a que se vai ligar. Selecione o Ícone de Definições e depois selecione Definições Avançadas.

Na nova guia do navegador que se abre, copie o início do endereço URL. Este URL raiz é o URL exclusivo para o seu ambiente. A URL está no formato https://<yourenvironmentid>.crm.dynamics.com/. Certifique-se de remover https:// e o / à direita do URL antes de colá-lo para se conectar ao seu ambiente. Anexe a porta 5558 ao final da URL do ambiente, por exemplo , yourenvironmentid.crm.dyamics.com,5558.

Ligar ao Dataverse

Para se ligar ao Dataverse a partir do Power Query Online:

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

2. Na página Conectar à fonte de dados, deixe o endereço URL do servidor em branco. Deixar o endereço em branco lista todos os ambientes disponíveis para os quais tens permissão na janela do Power Query Navigator.

   

   Observação

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

3. Se necessário, insira um gateway de dados local se você estiver usando dados locais. Por exemplo, se vais combinar dados do Dataverse com uma base de dados SQL Server local.

4. Inicie sessão na sua conta organizacional.

5. Quando tiver conseguido iniciar sessão, selecione Próximo.

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

   

Limitações e considerações

Especificação de host do Excel

O conector Power Query Dataverse dentro do Excel não suporta atualmente clusters de nuvem soberanos (por exemplo, China, Alemanha, EUA).

Limites de desempenho e limitação do Dataverse

Para obter informações sobre limites de desempenho e restrições para conexões Dataverse, consulte Limites e alocações de solicitações. Essas limitações se aplicam ao conector Dataverse e ao conector OData Feed ao acessar o mesmo ponto de extremidade.

Taxa de recuperação de dados da tabela

Como diretriz, a maioria das tabelas padrão são recuperadas a uma taxa de aproximadamente 500 linhas por segundo usando o conector Dataverse. Tenha esta taxa em conta ao decidir se quer ligar-se 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 ponto de extremidade TDS (Tabular Data Stream). Para obter mais informações, vá para conexões Alternativas do Dataverse.

Conexões Dataverse alternativas

Existem várias formas alternativas de extrair e migrar dados do Dataverse:

• Use a funcionalidade Azure Synapse Link no Power Apps para extrair dados do Dataverse para o Azure Data Lake Storage Gen2, que depois pode ser usado para executar análises. Para mais informações sobre a funcionalidade Azure Synapse Link, consulte O que é Azure Synapse Link for Dataverse?.

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

Problema de ligação ao SQL Server devido a portas fechadas

Ao ligar com o conector Dataverse, pode encontrar um erro Unable to connect indicando que ocorreu um erro específico de rede ou instância ao estabelecer uma ligação com SQL Server. Este erro é provavelmente causado pelo bloqueio das portas TCP 1433 ou 5558 durante a ligação. Para solucionar o erro de porta bloqueada, vá para Portas bloqueadas.

Usando consultas de banco de dados nativas 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 exista uma interface de utilizador para esta experiência, pode introduzir a consulta usando o Power Query Advanced Editor. Para usar uma consulta de banco de dados nativa, um banco de dados deve ser especificado como a origem.

Source = CommonDataService.Database([DATABASE URL])

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

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

No conjunto, a consulta tem esta aparência.

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

Se escrever incorretamente o nome de uma coluna, pode resultar numa mensagem de erro sobre "Query Folding" em vez de uma coluna em falta.

Acessando grandes quantidades de dados do Dataverse

As consultas em tabelas Dataverse podem retornar grandes quantidades de dados. Se estiveres a usar o conector Power Query Dataverse, qualquer consulta específica que aceda ao modelo tem um timeout fixo de cinco (5) minutos, independentemente do tamanho dos dados. Para obter mais informações, vá para limitações. Por isso, pode ser necessário consultar os dados várias vezes para aceder a todos os dados do modelo. O uso de várias consultas pode levar uma quantidade considerável de tempo para retornar todos os dados.

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

Em vez de usar estes conectores para aceder a grandes quantidades de dados do Dataverse, recomendamos que utilize Azure Synapse Link para aceder a grandes modelos. Usar o Azure Synapse Link é ainda mais eficiente do que os conectores Power Query Dataverse ou Common Data Service (Legacy), e foi especificamente concebido para cenários de integração de dados.

Problemas de desempenho relacionados com colunas de relações

Erros de pré-visualização podem ocorrer devido a uma limitação conhecida quando a funcionalidade de Propriedades de Navegação está ativada no Dataverse.

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

Para resolver este problema, semelhante ao conector SQL Server, existe uma opção para desativar propriedades de navegação (colunas de relação) no conector Dataverse para melhorar o desempenho. Esta opção pode ser definida nas opções avançadas disponíveis no Power Query Online, ou pode ser definida usando o parâmetro CreateNavigationProperties=false na função do conector Dataverse.

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

Conteúdo relacionado

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