Importar dados do Excel e exportar dados para o CSV

Para obter (importar) dados para tabelas do Microsoft Dataverse, use um arquivo de planilha do Excel ou um arquivo de valores separados por vírgula (CSV).

Quando você exporta dados de tabela do Dataverse, eles são exportados como um arquivo CSV.

Importar de um arquivo Excel ou CSV

Existem duas maneiras de importar dados do Excel.

• Opção 1: Importar criando e modificando um modelo de arquivo
• Opção 2: Importar trazendo seu próprio arquivo de origem

Opção 1: Importar criando e modificando um modelo de arquivo

Cada tabela tem colunas obrigatórias que devem existir no arquivo de entrada. É recomendável que você crie um modelo. Para fazer isso, exporte dados da tabela. Use o mesmo arquivo e modifique-o com seus dados. Por fim, importe o arquivo modificado de volta para a tabela. Usar um modelo poderá economizar tempo porque você não precisará especificar as colunas necessárias para cada tabela.

Preparar o modelo de arquivo

1. Exportar dados da tabela.
2. Defina um plano para verificar se os dados são exclusivos antes de importá-los. Use chaves primárias ou alternativas. Mais informações: Garanta a exclusividade ao importar dados para uma tabela do Excel ou CSV

Modificar o arquivo com seus dados

Copiar dados do arquivo Excel ou CSV para o modelo que você criou na etapa anterior.

Importar o arquivo

1. Em powerapps.com, selecione Tabelas no painel de navegação à esquerda. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
2. Selecione Importar>Importar dados do Excel.
3. Selecione as tabelas em que deseja importar dados e, em seguida, selecione Avançar.
4. Na página Importar dados, selecione Carregar e escolha seu arquivo. Siga os avisos para carregar o arquivo.
5. Depois que o arquivo for carregado e o Status do mapeamento indicar Mapeamento com êxito, selecione Importar no canto superior direito. Vá para Solucionar erros de mapeamento com o Excel para navegar e corrigir erros de mapeamento. Após a importação terminar com êxito, você verá o número total de inserções e atualizações.

Nova importação do Excel (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

A nova experiência de importação permite que os usuários importem dados diretamente de um arquivo do Excel para tabelas existentes do Dataverse usando uma interface do usuário unificada. Essa experiência melhora o método de importação original oferecendo:

• Mapeamento assistido: usa a pesquisa baseada em vetores para fornecer sugestões de mapeamento de coluna mais relevantes contextualmente.
• Seleção de planilha: os usuários podem escolher de qual planilha importar de dentro de um arquivo Excel com várias planilhas.
• Notificações: comentários em tempo real sobre o status da importação, incluindo estados de êxito, em andamento e de erro.
• Logs de erros: logs disponíveis para download para ajudar os usuários a autodiagnosticar e resolver problemas.
• Melhorias de desempenho: a ingestão assíncrona oferece melhor confiabilidade e velocidade para arquivos grandes.

Pré-requisitos

Para usar o recurso, um administrador do Power Platform deve habilitar a configuração de ambiente Importar Excel para tabela existente com mapeamento assistido no centro de administração do Power Platform. Selecione o ambiente e, em seguida, escolha Configurações>Produto>Recursos e habilite a configuração "Importar o Excel para tabela existente com mapeamento assistido".

Etapas de Importação do Excel (versão preliminar)

1. Acesse a tabela para a qual pretende importar dados e, em seguida, na barra de comandos, selecione Importar>Importar do Excel (Versão preliminar).
2. Carregue seu arquivo do Excel e selecione a planilha a ser importada.
   
3. Mapear colunas. Uma chave primária é necessária se você quiser atualizar os registros existentes na tabela. Se nenhuma chave primária for selecionada (opção "Nenhuma"), todos os registros da planilha do Excel ou do arquivo CSV serão adicionados como novos registros.
4. Revise o resumo e selecione Importar.

Monitore o status da importação a partir de notificações:

• Em andamento: atividade de importação em andamento com a mensagem Seus dados estão sendo importados exibida.
• Êxito: os dados foram processados ou indexados com a mensagem Upload concluído exibida.
• Erro: Upload concluído com alguns erros exibido que inclui um link para baixar logs para solução de problemas.

Opção 2: Importar trazendo seu próprio arquivo de origem

Se você for um usuário avançado e conhecer as colunas necessárias de determinada tabela para tabelas do Dataverse, defina seu próprio arquivo de origem Excel ou CSV. Siga as etapas em Importar o arquivo.

Solucionar erros de mapeamento com o Excel

Se você receber erros de mapeamento após carregar seu arquivo, selecione Status do mapa. Execute as etapas a seguir para inspecionar e retificar os erros do mapeamento de coluna.

1. Use o menu suspenso à direita, em Exibir, para seguir as etapas de Colunas não mapeadas, Campos com erro ou Campos Obrigatórios.

   Dica

   • Dependendo se você receber um Aviso ou um Erro, inspecione Colunas não mapeadas ou Campos com erro por meio do menu suspenso em Mapeamentos de Coluna.
   • Use a lógica do upsert (Atualizar ou Inserir) para atualizar a linha, se ela já existir, ou para inserir uma nova linha.

2. Após resolver todos os avisos e erros, selecione Salvar alterações no canto superior direito. Você voltará para a tela Importar Dados.

3. Quando a coluna Status do mapeamento mostrar Mapeamento com êxito, selecione Importar no canto superior direito.

Quando aparecer a mensagem Importação concluída com êxito, o total de inserções e atualizações serão exibidos.

Garanta a exclusividade quando importar dados para uma tabela do Excel ou CSV

Tabelas do Dataverse usam uma chave primária para identificar exclusivamente linhas em uma tabela do Dataverse. A chave primária de uma tabela do Dataverse é um identificador global exclusivo (GUID). Ela forma a base padrão da identificação da linha. Operações de dados, como importação de dados para tabelas do Dataverse, formam a base das chaves primárias padrão.

Exemplo:
A chave primária de uma tabela Conta é accountid.

Às vezes, uma chave primária pode não funcionar quando você integra dados de uma fonte externa. Use o Dataverse para definir chaves alternativas que identificam, de forma única, uma linha no lugar de uma chave primária.

Exemplo:
Para uma tabela Conta, você deve definir transactioncurrencyid como uma chave alternativa usando uma identificação baseada em chave natural. Por exemplo, use Dólar americano em vez do valor GUID 88c6c893-5b45-e811-a953-000d3a33bcb9 mostrado acima. Você também pode escolher símbolo da moeda ou nome da moeda como chaves. Mais informações: Definir chaves alternativas usando o portal do Power Apps

Você ainda pode usar chaves primárias como identificadores após especificar chaves alternativas. No exemplo acima, o primeiro arquivo ainda será válido se GUIDs forem dados válidos.

Exportar dados

Exporte dados de uma única tabela em um formato de valor separado por vírgulas (CSV).

1. Entre no Power Apps e, no painel de navegação à esquerda, selecione Tabelas. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.

2. Selecione Exportar>Exportar dados.

3. Selecione a tabela da qual você deseja exportar dados e, em seguida, selecione Exportar dados.

   

4. Após a exportação ser concluída com êxito, selecione Baixar dados exportados para baixar o arquivo CSV para a pasta de download especificada em seu navegador da web.

   

Tipos de dados e campos não suportados

Os tipos de dados a seguir não têm suporte para importação ou exportação no momento.

• Fuso horário
• Escolhas (seleção múltipla)
• Imagem
• Arquivo

Os campos a seguir são campos do sistema e não têm suporte para importação e exportação.

• Ownerid
• Createdby
• Createdonbehalfby
• Createdon
• Modifiedby
• Modifiedonbehalfby
• Modifiedon
• Overriddencreatedon

Importar usando um conector

Use um conector para importar dados de uma seleção de muitas fontes diferentes, como Azure, banco de dados do SQL Server, SharePoint, Access, OData e muito mais. Mais informações: Criar e usar fluxos de dados no Power Apps

Consultar também

Tabelas no Dataverse