Dataverse

Resumo

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

Capacidades suportadas

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

Ligue-se ao Dataverse a partir do Power Query Desktop

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

1. Selecione a opção Dataverse em Obter dados. Para obter mais informações: Onde obter dados

2. Se você estiver se conectando a este site pela primeira vez, selecione Entrar e insira suas credenciais. Em seguida, selecione Conectar.

   

3. No Navigator, selecione os dados de que necessita e, em seguida, carregue ou transforme os dados.

   

4. Se estiveres a usar o Power Query a partir do Power BI Desktop, serás solicitado a selecionar o modo de conectividade de dados Import ou DirectQuery. Em seguida, selecione OK.

   

Ligue-se ao Dataverse a partir do Power Query Online

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.

   

   Nota

   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 de que precisa e depois selecione Transformar Dados.

   

Conecte-se usando opções avançadas

O Power Query Online oferece opções avançadas que pode adicionar à sua consulta, se necessário.

A tabela seguinte lista as opções avançadas que pode definir no Power Query Online.

Depois de selecionar as opções avançadas necessárias, selecione Avançar para se conectar ao Dataverse.

Localizando a URL do 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.

Quando usar o conector Common Data Service (Legacy)

O Dataverse é o substituto direto do conector do Common Data Service. No entanto, pode haver momentos em que seja necessário escolher o conector Common Data Service (Legacy) em vez do conector Dataverse:

Há certos tipos de dados TDS (Tabular Data Stream) que são suportados no OData ao usar o Common Data Service (Legacy) que não são suportados no Dataverse. Os tipos de dados suportados e não suportados estão listados em Como o SQL do Dataverse difere do Transact-SQL.

Todos esses recursos serão adicionados ao conector Dataverse no futuro, quando o conector Common Data Service (Legacy) será preterido.

Para obter mais informações: Acessando grandes quantidades de dados do Dataverse

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. Leve essa taxa em consideração 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 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 maneiras 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 é o Azure Synapse Link para 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. 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 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]),