Exercício: importar dados para o banco de dados do Microsoft Dataverse

  • 10 minutos

Você pode importar dados para seu banco de dados do Microsoft Dataverse em massa de várias fontes, incluindo Excel, Access, SharePoint, SQL e muitos outros.

Observação

A tabela Pet do Dataverse referenciada nesta unidade foi criada no exercício anterior. Para importar alguns outros dados, as etapas imediatamente abaixo explicam como criar uma lista rápida do SharePoint para que você pratique a importação para a tabela Pet.

Criar dados de importação de exemplo

  1. Antes de examinar como importar dados para a tabela do Dataverse, vamos criar uma lista do SharePoint a ser usada como tabela. Se precisar de ajuda para encontrar o SharePoint, em uma guia separada do navegador, acesse office.com ou Microsoft 365 e entre em sua conta corporativa ou de estudante.

  2. No canto superior esquerdo da janela, selecione a caixa waffle do inicializador de aplicativos e, em seguida, SharePoint. Em seguida, você pode navegar para o site do SharePoint no qual deseja criar a lista.

  3. Selecione Nova>Lista na barra de comandos do site do SharePoint.

  4. Selecione Lista em branco no menu pop-up Criar uma lista.

  5. Adicione um nome para a lista "Animais de estimação do SharePoint" e selecione Criar.

  6. Na lista recém-criada que aparece, vamos criar colunas que correspondam à tabela de dados Animais de estimação, criada no exercício anterior. Selecione Adicionar coluna e adicione as seguintes colunas ao lado do campo Title como os seguintes tipos de dados:

    Nome Tipo de dados
    PetSpecies Linha única de texto
    Breed Linha única de texto
    AppointmentDate Data e hora

  7. Em seguida, queremos adicionar dados para que tenhamos algo para importar. Adicione dados à tabela para que ela se pareça com esta captura de tela:

    Captura de tela mostrando a lista do SharePoint de Animais de Estimação.

  8. Agora retorne à tela inicial do site do SharePoint e copie a URL do site do SharePoint, até o nome do site.

    Importante

    Não inclua nenhum sufixo nas listas, apenas inclua a URL de sua página inicial. (Exemplo: https://yourOrganization.sharepoint.com/sites/yourSharePointsite)

Agora, estamos prontos para importar alguns dados para a nossa tabela do Dataverse. Mantenha a guia do navegador do SharePoint aberta para referência.

Importar dados para sua tabela do Dataverse

  1. Em uma guia separada do navegador, acesse a página inicial do Power Apps e, no painel de navegação esquerdo, selecione Tabelas.

  2. Selecione a tabela Pet e selecione Importar e Importar dados no menu da barra de comandos.

  3. Essa ação inicia o importador de dados do Power Query. Na janela Escolher fonte de dados que é exibida, selecione Lista do SharePoint Online como sua fonte. Se necessário, você poderá digitar SharePoint no campo de pesquisa para restringir os resultados.

  4. Depois que a janela do Power Query mudar para Conectar-se à fonte de dados, insira a URL da página do SharePoint copiada anteriormente no campo de entrada de URL do site (você pode voltar para a guia aberta na página inicial do SharePoint e copiá-la, se necessário). Após colar a URL, pode ser necessário entrar com suas credenciais de conexão. Assim que suas credenciais estiverem prontas, selecione Avançar no canto inferior direito para continuar.

  5. Na etapa Escolher dados, exibida agora, podemos selecionar uma ou mais listas ou bibliotecas de documentos que queremos importar. A seleção na lista de tabelas disponíveis no painel esquerdo faz com que os dados sejam exibidos na tela. Procure a lista que acabou de criar chamada Animais de estimação do SharePoint e selecione-a.

  6. Assim que os dados de "SharePoint Pets aparecerem", você poderá selecionar o botão Avançar no canto inferior direito.

  7. Você verá o editor do Power Query exibindo Consultas e o conteúdo mostrado na visualização anterior. O editor do Power Query permite moldar os dados antes de importá-los para o Dataverse. Você pode escolher as colunas que deseja importar selecionando Escolher colunas. Por outro lado, você pode remover qualquer uma das colunas que não deseja importar, usando o botão Remover colunas na parte superior da janela. Se você cometer um erro, as Etapas aplicadas no lado direito da janela acompanharão as alterações e você poderá cancelar essa etapa para desfazer a última ação. Não se preocupe: você não está modificando a fonte de dados, apenas filtrando o que vai importar.

    Por padrão, o Power Query escolhe todas as colunas, mas não precisamos importar todos os dados aqui.

  8. Selecione Escolher colunas na guia "Gerenciar colunas" no cabeçalho.

  9. Selecione apenas as colunas Title, PetSpecies, Breed, AppointmentDate e selecione OK para continuar.

    Captura de tela do pop-up Escolher colunas com as colunas nomeadas selecionadas. Observe que Etapas aplicadas adiciona uma etapa de "Escolher colunas".

    Dica

    Se você cometer um erro, poderá selecionar o "X" à esquerda da etapa em Etapas aplicadas. Então você poderá corrigir a etapa.

  10. Assim que a tabela de consulta tiver as colunas Title, PetSpecies, Breed e AppointmentDate, selecione o botão Avançar para continuar.

  11. Na etapa Mapear tabelas do Power Query, em Configurações de carregamento, selecione Carregar na tabela existente. Você pode consultar a imagem imediatamente abaixo para ver as etapas a seguir (numeradas de acordo com as etapas).

    Captura de tela da janela de tabelas de mapas exibida mostrando a lista suspensa para a tabela de destino.

  12. Selecione a tabela na qual deseja carregar os dados por meio do menu suspenso chamado Tabela recomendada. Você precisará procurar sua tabela Pet. Lembre-se de que a tabela do Dataverse Petque criamos tem um prefixo antes dela com um caractere de sublinhado. Nesse exemplo, a tabela se chama cref2_Pet, mas sua tabela terá um prefixo diferente antes de "_Pet".

  13. Observe como a seção Mapeamento de coluna tem as colunas de destino de nossa tabela Pet. Selecione o botão Mapeamento automático. O botão Mapear automaticamente permite que o Power Apps determine a melhor forma de corresponder às colunas Origem e Destino. No entanto, você também pode usar os menus suspensos para corresponder às colunas do SharePoint. Portanto, é útil ter nomes semelhantes para facilitar o mapeamento. Talvez seja necessário selecionar manualmente o campo Title para a coluna de destino PetName e, da mesma forma, PetSpecies para Species.

    Quando todas as colunas de origem corresponderem às colunas de destino, selecione Avançar no canto inferior direito da janela.

  14. A etapa Atualizar configurações oferece a capacidade de configurar uma agenda de atualização se você quer atualizar os dados da mesma fonte regularmente. Nesse caso, deixaremos configurado como Atualizar manualmente, pois queremos importá-la apenas uma vez. Selecione Publicar no canto inferior direito da janela.

    Se você receber avisos, preste atenção nas mensagens e volte para a tela de edição da consulta para formatar os dados.

  15. Se você publicar e não receber nenhum aviso e a tela da tabela for atualizada (poderá levar alguns instantes), verá que os dados foram importados para sua lista. Se você não a vir imediatamente, tente atualizar o navegador. Lembre-se também de carregar os dados em uma tabela existente (consulte etapa 11).

Embora esse exemplo tenha usado o SharePoint como fonte de importação de dados, as etapas são semelhantes a qualquer fonte de dados que você deseja importar para sua lista.