Compartilhar via


Adicionar dados a uma tabela no Microsoft Dataverse usando Power Query

Neste procedimento, você criará uma tabela no Dataverse e preencherá essa tabela com dados de um feed OData usando o Power Query. Você pode usar as mesmas técnicas para integrar dados dessas fontes online e locais, entre outras:

  • SQL Server
  • Salesforce
  • IBM DB2
  • Access
  • Excel
  • APIs da Web
  • Feeds do OData
  • Arquivos de texto

Você também pode filtrar, transformar e combinar dados antes de carregá-los em uma tabela nova ou existente.

Se não tiver uma licença para o Power Apps, é possível inscrever-se gratuitamente.

Pré-requisitos

Antes de começar a seguir este artigo:

  • Alterne para um ambiente no qual você pode criar tabelas.
  • Você deve ter um Power Apps por plano de usuário ou Power Apps por plano de aplicativo.

Especificar os dados de origem

  1. Entre no Power Apps.

  2. No painel de navegação, selecione Tabelas.

    Captura de tela do painel de navegação com a guia Tabelas selecionada e o painel Tabelas aberto.

  3. No menu de comando, selecione Importar>Importar dados.

  4. Na lista de fontes de dados, selecione OData.

    Captura de tela da seleção de fontes de dados do Power Query aberta e o conector OData enfatizado.

  5. Em Configurações de conexão, digite ou cole a seguinte URL e selecione Avançar:

    https://services.odata.org/V4/Northwind/Northwind.svc/

  6. Na lista de tabelas, marque a caixa de seleção Clientes e, em seguida, clique ou toque em Avançar.

    Captura de tela da caixa de diálogo do navegador do Power Query, com a tabela Clientes selecionada.

  7. (opcional) Modifique o esquema para atender às suas necessidades escolhendo quais colunas incluir, transformando a tabela de uma ou mais maneiras, adicionando um índice ou coluna condicional ou fazendo outras alterações.

  8. No canto inferior direito, selecione Avançar.

Especificar a tabela de destino (Versão prévia)

  1. Em Carregar configurações, selecione Carregar na nova entidade.

    Captura de tela do menu de configurações de carga com o conjunto Carregar na nova tabela.

    Você pode dar outro nome ou nome de exibição à nova entidade, mas deixe os valores padrão para seguir este tutorial à risca.

  2. Na lista de colunas de nome primário exclusivo, selecione ContactName e selecione Avançar.

    Você pode especificar uma coluna de nome primário diferente, mapear uma coluna diferente na tabela de origem para cada coluna na tabela que está criando ou ambas. Você também pode especificar se as colunas de texto na saída da consulta devem ser criadas como Texto multilinha ou texto Single-Line no Dataverse. Para seguir este tutorial exatamente, deixe o mapeamento de coluna padrão.

  3. Selecione Atualizar manualmente para Power Query – Atualizar Configurações e, em seguida, selecione Publicar.

  4. Em Dataverse (próximo à borda esquerda), selecione Tabelas para mostrar a lista de tabelas no banco de dados.

    A entidade Clientes criada com base em um feed OData é exibida como uma entidade personalizada.

    Captura de tela da lista de tabelas padrão e personalizadas com a tabela Clientes enfatizada.

Aviso

Os dados existentes podem ser alterados ou excluídos ao carregar dados em uma tabela do Dataverse enquanto mantém a opção Excluir linhas que não existem mais na saída da consulta ou uma coluna de chave primária definida.

Carregar na tabela existente (Versão prévia)

Se você selecionar Carregar na tabela existente, poderá especificar uma tabela existente do Dataverse para carregar os dados.

Ao selecionar a lista suspensa da tabela, poderá haver até três tabelas recomendadas do Dataverse para selecionar na parte superior da lista suspensa, seguidas por todas as outras tabelas do Dataverse. Essas recomendações de tabela são baseadas na comparação dos metadados de coluna (nomes e tipos de coluna) com os metadados de coluna de tabelas existentes do Dataverse. Até três tabelas do Dataverse são recomendadas, com a recomendação mais forte listada primeiro. Se nenhuma recomendação for encontrada, o menu suspenso por padrão lista todas as tabelas.

Captura de tela da caixa de diálogo Escolher configurações de destino com as tabelas recomendadas.

Após selecionar em qual tabela do Dataverse carregar dados, escolha o método de importação. A opção Acrescentar é selecionada por padrão e adiciona os dados como mais linhas à tabela do Dataverse selecionada anteriormente. A mesclagem atualiza as linhas existentes na tabela do Dataverse. Se Mesclar estiver selecionado, há uma opção para selecionar a coluna chave primária que você quiser usar.

Captura de tela da caixa de diálogo Escolher configurações de destino, com a opção do método de importação exibida.

Mapeamento de colunas (Versão prévia)

Depois de selecionar uma tabela do Dataverse de destino e especificar o método de importação, as colunas serão agrupadas em mapeadas, correspondência possível e não mapeadas. Alterne entre esses agrupamentos selecionando as guias Mapeadas, Correspondência possível ou Não mapeadas, na parte superior ou permaneça na guia padrão, Mostrar tudo, que lista todos os mapeamentos.

Captura de tela da caixa de diálogo Escolher configurações de destino, com a coluna Opções de mapeamento exibida.

Os mapeamentos das colunas origem e destino são agrupados da seguinte maneira:

  • Mapeadas: correspondência semântica de alta confiança entre os significados dos nomes de colunas, e os tipos de dados da coluna são os mesmos.

  • Não mapeadas: não há correspondências de coluna semântica de alta confiança nesta coluna. Se essa coluna for uma coluna obrigatória, você deverá selecionar manualmente uma coluna de origem para mapear esses dados antes de continuar.

  • Correspondência possível: correspondência semântica entre os significados dos nomes das colunas, mas os tipos de dados das colunas de origem e destino são diferentes.

Quando alterações manuais são feitas no mapeamento da coluna de origem, o status muda para Mapeado, a menos que os tipos de dados da coluna sejam diferentes. Nesse caso, o status é atualizado para Possível correspondência. Assim como acontece com todas as correspondências possíveis, uma mensagem de ação recomendada sugere que você volte uma etapa no fluxo de dados e altere o tipo de coluna de origem para corresponder ao tipo de coluna de destino na tabela do Dataverse.

Limitações conhecidas

Atualmente, o mapeamento assistido por IA só pode detectar incompatibilidades de tipo entre colunas. Outros desafios de mapeamento de coluna na lista a seguir não são detectados, pois exigem a visualização dos registros de dados de entrada:

  • Truncamento: alta confiança na correspondência semântica entre a origem e o destino, mas pelo menos um registro na origem tem mais caracteres do que o limite de caracteres da coluna de destino.

  • Limites de valor: alta confiança na correspondência semântica entre a origem e o destino, mas pelo menos um registro na origem contém um valor fora do intervalo dos limites de valor definidos pela coluna de destino.

  • Valores da pesquisa: alta confiança na correspondência semântica entre a origem e o destino, mas pelo menos um registro na origem contém um valor que não se encontra no conjunto de valores da pesquisa, definido pela coluna de destino.

Se uma mensagem de erro sobre permissões for exibida, contate o seu administrador.

Sugestões para seleção de tabela e mapeamento de coluna são fornecidas por uma solução que pode não estar disponível em um ambiente específico do Power Platform. Se essa solução não puder ser detectada, as sugestões para seleção de tabela e mapeamento de coluna não serão fornecidas pelo sistema. No entanto, você pode continuar a proceder manualmente.