Compartilhar via


Common Data Service (Herdado)

Observação

O conector do Common Data Service (Legacy) foi substituído pelo conector Power Query Dataverse. Na maioria dos casos, recomendamos que você use o conector do Dataverse em vez do conector do Common Data Service (Legacy). No entanto, pode haver casos limitados em que é necessário escolher o conector do Common Data Service (Legacy). Esses casos são descritos em Quando usar o conector do Common Data Service (Legacy).

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Dynamics 365 Customer Insights
Tipos de autenticação Conta organizacional

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a cronogramas de implantação e funcionalidades específicas do host.

Pré-requisitos

Você deve ter um ambiente Common Data Service (Legacy) com permissões de maker para acessar o portal e permissões de leitura para acessar dados em tabelas.

Funcionalidades com suporte

  • Servidor URL
  • Avançado
    • Reordenar colunas
    • Adicionar coluna de exibição

Conectar-se ao Common Data Service (Herdado) do Power Query Desktop

Para se conectar ao Common Data Service (Herdado) de Power Query Desktop:

  1. Selecione Common Data Service (Herdado) na experiência para obter dados. A experiência para obter dados no Power Query Desktop varia entre aplicativos. Para saber mais informações sobre a experiência para obter dados no Power Query Desktop para seu aplicativo, acesse Onde obter dados.

  2. Insira a URL do ambiente Common Data Service (Legado) dos dados que você deseja carregar. Use o formato https://<yourenvironmentid.crm.dynamics.com/>. Mais informações: Localizando sua URL de ambiente do Dataverse

    Seleção de URL do servidor.

    Quando a tabela é carregada na caixa de diálogo Navegador, por padrão, as colunas na tabela são reordenadas em ordem alfabética pelos nomes das colunas. Se você não quiser que as colunas sejam reordenadas, nas configurações avançadas, insira falso em Reordenar colunas.

    Também quando a tabela é carregada, por padrão, se a tabela contiver campos de lista de seleção, uma nova coluna com o nome do campo de lista de seleção com _display acrescentada no final do nome é adicionada à tabela. Se você não quiser que a coluna de exibição do campo de lista de seleção seja adicionada, nas configurações avançadas insira falso na coluna Adicionar exibição.

    Quando terminar de preencher as informações relevantes, selecione OK.

  3. Se esta for a primeira vez que você está se conectando a este site, selecione Entrar e insira suas credenciais. Depois, selecione Conectar.

    Entrar neste site.

  4. No Navegador, selecione o dado desejado e carregue ou transforme os dados.

    Carregue ou transforme os dados no navagador.

Conectar-se ao Common Data Service (Legacy) do Power Query Online

Para se conectar ao Common Data Service (Legacy) do Power Query Online:

  1. Selecione a opção Common Data Service (Herdado) na experiência para obter dados. Cada aplicativo acessa de uma forma diferente a experiência para obter dados do Power Query Online. Para saber mais informações sobre como acessar a experiência para obter dados do Power Query Online pelo seu aplicativo, acesse Onde obter dados.

    Captura de tela da janela obter dados escolher fonte de dados no Power Query Online.

  2. Insira o endereço de URL do servidor dos dados que deseja carregar.

    Insira o servidor de URL.

  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 com a conta corporativa.

  5. Depois de entrar, selecione Avançar.

  6. Na página do Navegador, selecione os dados necessários e Transformar dados.

Localizando sua URL de ambiente do Common Data Service (Legacy)

Abrir o Power Apps. No canto superior direito da página do Power Apps, selecione o ambiente ao qual você vai se conectar. Selecione o Ícone de configurações. ícone de configurações e, em seguida, selecione Configurações avançadas.

Na nova guia do navegador que se abrir, copie a raiz da URL. Essa URL raiz é a URL exclusiva para seu ambiente. A URL estará no formato https://<yourenvironmentid.crm.dynamics.com/>. Mantenha essa URL em algum lugar à mão para que você possa usá-la mais tarde, por exemplo, ao criar relatórios do Power BI.

Local da URL do ambiente do Common Data Service (Legacy).

Quando usar o conector do Common Data Service (Legacy)

O Dataverse é a substituição direta para o conector do Common Data Service. No entanto, pode haver momentos em que é necessário escolher o conector do Common Data Service (Legacy) em vez do conector do Dataverse:

Há certos tipos de dados TDS (Fluxo de Dados Tabulares) com suporte no OData ao usar o Common Data Service (Legacy) que não têm suporte no Dataverse. Os tipos de dados com suporte e sem suporte são listados em Como o SQL do Dataverse difere do Transact-SQL.

Todos esses recursos serão adicionados ao conector do Dataverse no futuro, momento em que o conector do Common Data Service (Legacy) estará obsoleto.

Para obter mais informações: Como acessar grandes modelos semânticos

Limitações e problemas

Limites de desempenho e limitação da API OData do Dataverse

Para obter informações sobre limites de desempenho e limitação OData API para conexões do Dataverse, acesse Limites e alocações de Solicitações. Essas limitações se aplicam ao conector da Common Data Source (Legacy) (que usa a API OData como um detalhe de implementação) e ao conector do Feed OData ao acessar o mesmo ponto de extremidade.

Taxa de recuperação da tabela

Como diretriz, a maioria das tabelas padrão é recuperada a uma taxa de aproximadamente 500 linhas por segundo usando o conector Common Data Service (Herdado). 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 conector do Dataverse. 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:

Observação

O conector do Dataverse e as APIs OData destinam-se a atender a cenários analíticos em que os volumes de dados são relativamente pequenos. A abordagem recomendada para extração de dados em massa é "Azure Synapse Link".

A consulta de colunas de exibição deve incluir o campo na consulta

Ao usar esse conector, se você estiver incluindo <colunas de campo>display, também deverá incluir <o campo> na consulta ou a coluna de <campo>_display poderá ser nula. Por exemplo:

Table.SelectColumns(#"Navigation 1", {"statuscode", "statuscode_display"})

Se statuscode não estiver incluído, statuscode_display poderá ficar nulo e errado.

Como acessar grandes modelos semânticos

Os modelos semânticos do Power BI contidos no Dataverse podem ser muito grandes. Se você estiver usando o conector Power Query Dataverse, qualquer consulta específica que acesse o modelo deverá retornar menos de 80 MB de dados. 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 (Legacy), poderá usar uma única consulta para acessar todos os dados no modelo semântico. Esse conector funciona de forma diferente e retorna o resultado em "páginas" de registros de 5K. 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 modelos semânticos, recomendamos que você use Azure Synapse Link. Usar Azure Synapse Link é ainda mais eficiente que os conectores Power Query Dataverse ou Common Data Service (Legacy) e ele foi projetado especificamente em cenários de integração de dados.