Partilhar via


Importar ou exportar dados do Dataverse

Para obter (importar) dados em tabelas Microsoft Dataverse, utilize um ficheiro de folha de cálculo excel, um ficheiro de valores separados por vírgula (CSV) ou um dos muitos conectores disponíveis.

Quando exporta dados de tabelas Dataverse, é exportado como um ficheiro CSV.

Importar usando um conector

Utilize um conector para importar dados de uma seleção de muitas fontes diferentes, tais como Microsoft Excel, Azure, base de dados SQL Server, SharePoint, Access, OData e muitos outros.

  1. Iniciar sessão no Power Apps.
  2. No painel de navegação esquerdo, selecione Tabelas. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  3. Selecione Dados > Obter dados > Obter dados.
  4. A partir da lista Fontes de dados, selecione o conector de onde pretende importar dados.

Para obter informações sobre o conector que pretende utilizar como origem de dados, consulte lista de todos os conectores Power Apps e Lista de todos os conectores publicados pela Microsoft.

Importar a partir de um ficheiro Excel ou CSV

Há duas formas de importar dados do Excel.

Importante

Importe a partir de ficheiro Excel ou CSV utilizando o comando Importar > Importar dados do Excel não está disponível em ambientes GCC, GCC High e DoD. Para contornar esta limitação, na área Tabelas, no Power Apps, selecione Importar > Importar dados e, em seguida, escolha uma origem de dados, como Livro do Excel ou Texto/CSV.

Opção 1: importar ao criar e modificar um modelo de ficheiro

Cada tabela tem colunas obrigatórias que têm de existir no seu ficheiro de entrada. Recomendamos que crie um modelo. Para isso, exporte os dados da tabela. Em seguida, use o mesmo ficheiro e modifique-o com os seus dados. Finalmente, importe o ficheiro modificado de volta para a tabela. A utilização de um modelo pode poupar-lhe tempo porque não terá de especificar as colunas necessárias para cada tabela.

Prepare o modelo de ficheiro

  1. Exportar os dados da tabela.
  2. Defina um plano para garantir que os dados são únicos antes de os importar. Utilize chaves primárias ou chaves alternativas. Mais informações: Garantir a singularidade quando importa dados para uma tabela do Excel ou CSV

Modifique o ficheiro com os seus dados

Copie os dados do ficheiro CSV do ou Excel para o modelo que criou no passo anterior.

Importe o ficheiro

  1. Em powerapps.com, selecione Tabelas no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  2. Selecione Dados, à direita de Obter dados selecione**>** e, em seguida, selecione Obter dados do Excel.
  3. Selecione as tabelas onde quer importar dados e, em seguida, selecione Seguinte.
  4. Na página Importar dados, selecione Enviar e escolha o seu ficheiro. Siga as instruções para carregar o ficheiro.
  5. Depois de o ficheiro ser carregado e Estado de mapeamento indicar Mapeamento bem-sucedido, selecione Importar no canto superior direito. Vá a Resolver problemas de mapeamento erros com o Excel para navegar e corrigir quaisquer erros de mapeamento. Importação de mapeamento bem-sucedido Depois de concluir a importação com êxito, verá o número total de inserções e atualizações.

Opção 2: importar colocando o seu próprio ficheiro de origem

Se for um utilizador avançado e sabe quais as colunas necessárias para uma determinada tabela para tabelas do Dataverse, defina o seu próprio ficheiro de origem Excel ou CSV. Siga os passos indicados em Importar o ficheiro.

Resolver problemas de mapeamento de erros com o Excel

Se obtiver erros de mapeamento depois de carregar o ficheiro, selecione Mapear estado. Veja os passos seguintes para inspecionar e corrigir os erros de mapeamento de coluna.

  1. Utilize o menu pendente à direita, em Mostrar, para percorrer os Colunas não mapeadas, Campos com erro ou Campos Obrigatórios.

    Dica

    • Consoante se obtenha um Aviso ou um Erro, verifique Colunas não mapeadas ou Campos com erro no menu suspenso em Mapeamentos de coluna.
    • Utilize a lógica upsert (Atualizar ou Inserir) para atualizar a linha, se já existir, ou para inserir uma nova linha.
  2. Depois de resolver todos os erros e avisos, selecione Guardar Alterações no canto superior direito. Irá regressar ao ecrã Importar Dados.

  3. Quando a coluna Estado de mapeamento indicar Mapeamento bem-sucedido, selecione Importar no canto superior direito.

Quando a mensagem Importação concluída com sucesso aparece, as inserções totais e atualizações são apresentadas.

Certifique-se da exclusividade quando importa dados para uma tabela a partir do Excel ou CSV

As tabelas Dataverse usam uma chave primária para identificar exclusivamente linhas dentro de uma tabela Dataverse. A chave primária para uma tabela do Dataverse é um identificador exclusivo global (GUID). Forma a base predefinida para a identificação da linha. Operações de dados, tal como importar dados para tabelas do Dataverse fazem surgir as chaves primárias predefinidas.

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

Ficheiro de exportação de exemplo de uma tabela de Conta que mostra o accountid como a chave primária.

Por vezes, uma chave primária poderá não funcionar quando integrada dados a partir de uma origem externa. Utilize o Dataverse para definir chaves alternativas que identificam exclusivamente uma linha no lugar da chave primária.

Exemplo:
Para uma tabela de Conta, poderá definir transactioncurrencyid como uma chave alternativa através da utilização de uma identificação natural baseada em chave. Por exemplo, utilize Dólar Americano em vez do valor GUID 88c6c893-5b45-e811-a953-000d3a33bcb9 apresentado anteriormente. Pode também selecionar símbolo da moeda ou nome da moeda como chaves. Mais informações: Definir chaves alternativas através do portal Power Apps

Exemplo de criação de uma chave alternativa numa tabela de Moeda.

Ficheiro de exportação de exemplo de uma tabela de Conta que mostra o nome da moeda como uma chave natural.

Pode continuar a utilizar chaves primárias como identificadores depois de especificar chaves alternativas. No exemplo anterior, o primeiro ficheiro é ainda válido se GUID são dados válidas.

Exportar Dados

Exporte dados de uma única tabela em um formato CSV (valores separados por vírgula).

  1. Inicie sessão no Power Apps no painel de navegação esquerdo e, em seguida, selecione Tabelas. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.

  2. Selecione Exportar > Exportar dados.

  3. Selecione a tabela a partir da qual pretende exportar dados e, em seguida, selecione Exportar dados.

    Exemplo de exportação de dados de uma tabela de Conta.

  4. Depois de a exportação terminar com sucesso, selecione Descarregar dados exportados para descarregar o ficheiro CSV para a pasta de descarregamento especificada no seu navegador web.

    Exemplo de exportação que mostra a exportação com êxito com ficheiro transferível de ligação.

Nota

As exportações têm um limite de tempo de 12 minutos. Se o volume de dados exportados exceder os 12 minutos, a exportação falhará. Se isto acontecer, exporte dados em segmentos mais pequenos.

Tipos de dados e campos não suportados

Os seguintes tipos de dados não são atualmente suportados para importação ou exportação.

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

Os campos que se seguem são campos de sistema e não são suportados para importação e exportação.

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

Nota

As caraterísticas Get Data from Excel e Export Data não estão atualmente incluídas no Power Apps Developer Plan.

Resolver de problemas de ligação

Os utilizadores podem receber uma mensagem de erro se a ligação que estão a utilizar para exportação necessitar de uma correção. Neste caso, o utilizador recebe uma mensagem de erro que afirma que A ligação ao Dataverse falhou. Consulte a ligação abaixo para saber como corrigir este problema.

Para corrigir este problema:

  1. No Power Apps (make.powerapps.com), selecione Ligações do painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  2. Localize a ligação ao Microsoft Dataverse (legada).
  3. Selecione a ligação Corrigir ligação na coluna Estado e siga as instruções apresentadas no ecrã.

Depois de concluída a correção, repita a exportação.

Permissões

Para importar ou exportar dados, o usuário deve ter o Environment Maker direito de acesso.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).