Criar a sua primeira aplicação do Microsoft Graph Data Connect

O Microsoft Graph Data Connect (Data Connect) aumenta as APIs transacionais com uma forma inteligente de aceder a dados avançados em escala. O Data Connect é ideal para aplicações de macrodados e machine learning, pois permite-lhe desenvolver aplicações para otimização de processos de negócio, inteligência e análise ao expandir os dados do Microsoft 365 para o Microsoft Azure. Através desta oferta, poderá tirar partido do vasto conjunto de computação e armazenamento no Azure, mantendo-se em conformidade com os padrões da indústria e mantendo os seus dados seguros.

O Data Connect utiliza o Microsoft Fabric, Azure Synapse ou Azure Data Factory para copiar dados do Microsoft 365 para o armazenamento da sua aplicação em intervalos configuráveis. Também fornece um conjunto de ferramentas para simplificar a entrega destes dados no Azure, permitindo-lhe aceder às ferramentas de desenvolvimento e alojamento mais aplicáveis disponíveis.

A Conexão de Dados também concede um modelo de controle e consentimento mais granular: você pode gerenciar dados, ver quem está acessando e solicitar propriedades específicas de uma entidade. Isso aprimora o modelo do Microsoft Graph, que concede ou nega acesso a aplicativos a entidades inteiras.

Além disso, pode utilizar o Data Connect para ativar cenários de machine learning para a sua organização. Nesses cenários, você pode criar aplicações que forneçam informações valiosas aos seus participantes, treinar modelos de aprendizado de máquina e até mesmo realizar previsões com base em grandes quantidades de dados adquiridos.

Introdução

Neste tutorial, vai criar a sua primeira aplicação do Data Connect de inquilino único. O fluxo geral seguinte explica o processo de integração do Data Connect.

1. Administração ativa o Data Connect: o primeiro passo na integração é o administrador global ativar o Data Connect.

2. O programador cria uma nova aplicação Microsoft Entra: o programador tem de criar primeiro uma nova aplicação Microsoft Entra.

3. O programador regista a aplicação com o Data Connect: Assim que a aplicação Microsoft Entra for criada, o programador tem de registar a aplicação com o Data Connect através do novo portal de registo para aplicações do Microsoft Graph Data Connect. Neste passo, o programador especifica os dados necessários para a aplicação.

4. Administração aprova a aplicação: depois de o programador ter registado a aplicação no Data Connect, o administrador global pode utilizar o novo portal para o consentimento da aplicação Do Data Connect para rever a aplicação registada e aprová-la.

5. O programador executa os pipelines: Depois de o administrador ter consentido a aplicação, o programador poderá executar os pipelines sem qualquer bloqueio para o consentimento do runtime. A criação e execução do pipeline através de Azure Data Factory ou Azure Synapse permanece a mesma.

Pré-requisitos

Para concluir este tutorial, precisa das seguintes subscrições ou licenças.

• Para este tutorial, recomendamos vivamente que utilize um inquilino do Microsoft 365 para programadores.
• Os inquilinos do Microsoft 365 e do Azure têm de estar no mesmo Microsoft Entra inquilino.
• A subscrição do Azure tem de estar no mesmo inquilino que o inquilino do Microsoft 365.
• Um utilizador no seu inquilino do Microsoft 365 tem a função de Administrador Global ativada. No futuro, este tutorial refere-se a este utilizador como o "administrador". Apenas um utilizador "administrador" pode aprovar a aplicação de teste.
• Um utilizador diferente no seu inquilino do Microsoft 365 com a função Administrador de Aplicações ou Programador de Aplicações . No futuro, este tutorial refere-se a este utilizador como o "programador". O utilizador programador faz a maior parte deste tutorial.

1. Inquilino do Microsoft 365

   • Se não tiver um inquilino do Microsoft 365, poderá qualificar-se para um através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

   Observação

   Não pode aprovar a sua própria aplicação de teste com a mesma conta. Certifique-se de que tem outro membro (ou conta) no seu inquilino que age como administrador.

2. Assinatura do Microsoft Azure

   • Se não tiver uma subscrição do Microsoft Azure, visite a seguinte ligação para obter uma (gratuitamente): Crie a sua Conta Gratuita do Azure.
   • A sua subscrição do Azure tem de estar no mesmo inquilino que o seu inquilino do Microsoft 365 e ambas têm de estar no mesmo Microsoft Entra inquilino.
   • Se a sua subscrição do Azure não estiver no mesmo inquilino que o seu inquilino do Microsoft 365, pode associar a sua subscrição ao Microsoft Entra ID no seu inquilino do Microsoft 365 ao seguir os passos listados em Associar ou adicionar uma subscrição do Azure ao inquilino do Microsoft Entra.

   Observação

   As capturas de ecrã e os exemplos utilizados neste tutorial são de um inquilino de programador do Microsoft 365 com um e-mail de exemplo de utilizadores de teste. Pode utilizar o seu próprio inquilino do Microsoft 365 para executar os mesmos passos. Não são escritos dados no Microsoft 365. É extraída uma cópia dos dados de e-mail de todos os utilizadores num inquilino do Microsoft 365 e copiada para uma conta Armazenamento de Blobs do Azure. Mantém o controlo sobre quem tem acesso aos dados no Armazenamento de Blobs do Azure.

Configurar o seu inquilino do Microsoft 365 e ativar o Microsoft Graph Data Connect

Antes de utilizar o Microsoft Graph Data Connect (Data Connect) pela primeira vez, trabalhe com o seu administrador inquilino do Microsoft 365 para ativar o serviço Data Connect para o seu inquilino.

Para este tutorial, certifique-se de que tem uma conta com privilégios de administrador disponíveis. Tem de concluir este passo para configurar o primeiro pipeline. Recomendamos que tenha, pelo menos, dois utilizadores no seu inquilino do Microsoft 365 com a função de administrador global ativada.

• Função incorporada administrador global.
• Elevar o acesso para obter a função de Administrador Global.

Ativar o Microsoft Graph Data Connect no seu inquilino do Microsoft 365

Configure o seu inquilino do Microsoft 365 para ativar a utilização do Microsoft Graph Data Connect.

1. Abra um browser, aceda ao portal de administração do Microsoft 365 e inicie sessão com o seu utilizador administrador .

2. Selecione Definições > Definições da organização. Poderá ter de selecionar Mostrar tudo antes de poder ver as Definições.

3. No separador Serviços (que deve ser a seleção predefinida), selecione Microsoft Graph Data Connect.

4. Selecione a caixa de verificação para Ativar ou desativar o Microsoft Graph Data Connect para toda a organização e selecione Guardar.

   

Parabéns, acabou de ativar o Microsoft Graph Data Connect para a sua organização!

Configurar a sua aplicação Microsoft Entra

Neste exercício, vai aprender a criar uma aplicação Microsoft Entra. Isto serve como principal de segurança para executar o processo de extração de dados com o Microsoft Graph Data Connect.

1. Inicie sessão no centro de administração do Microsoft Entra com, pelo menos, a função Administrador de Aplicações ouProgramador de Aplicações.

2. Expanda o menu >Identidade selecione Aplicações>Registros de aplicativo>Novo registo.

3. Utilize os seguintes valores para criar uma nova Microsoft Entra aplicação e selecione Registar.

   • Nome: Transferência de Dados do Microsoft Graph Data Connect (indique o nome à sua escolha).
   • Tipos de conta suportados: apenas contas neste diretório organizacional.
   • URI de Redirecionamento: deixe os valores predefinidos.

   

4. Localize o ID da Aplicação (cliente) e copie-o conforme necessário mais adiante neste tutorial. No futuro, isto é referido como o ID do principal de serviço.

5. Localize o ID do Diretório (inquilino) e copie-o conforme necessário mais adiante neste tutorial. No futuro, isto é referido como o ID do inquilino.

   

6. No painel de navegação esquerdo, selecione Certificados & segredos em Gerir.

7. Selecione o botão Novo segredo do cliente. Defina Descrição para qualquer nome, defina Expira para qualquer valor na lista pendente e selecione Adicionar.

   

   • Após a criação do segredo do cliente, certifique-se de que guarda o Valor num local seguro, uma vez que deixará de estar disponível mais tarde; caso contrário, terá de criar um novo.
   • No futuro, o segredo do cliente é conhecido como a chave do principal de serviço.

8. No painel de navegação esquerdo da aplicação, selecione Proprietários.

9. Certifique-se de que a sua conta (se estiver a utilizar um inquilino de programador, utilize a Conta de administrador global) cumpre os seguintes requisitos para ser proprietário de uma aplicação:

   • A sua conta de utilizador corresponde a um utilizador válido no inquilino que não é um nome principal de serviço.
   • A sua conta tem de ter uma licença de Exchange Online atribuída (tem de ter uma caixa de correio).
   • Juntamente com a licença Exchange Online, a sua conta também tem de ter uma subscrição/licença E5 funcional.

10. Verifique se a sua conta está listada como proprietário da aplicação. Se não for esse o caso, adicione-o à lista.

    

Configurar o recurso do Armazenamento do Azure

Neste passo, irá criar uma conta de Armazenamento do Azure onde o Microsoft Graph Data Connect irá armazenar os dados extraídos do Microsoft 365 para processamento adicional.

1. Abra um browser e aceda ao seu portal do Azure.

2. Inicie sessão com uma conta com uma função de Programador de aplicações no seu portal do Azure.

3. Na navegação na barra lateral, selecione Criar um recurso.

4. Localize o tipo de recurso Conta de armazenamento e utilize os seguintes valores para o configurar. Para Desempenho, Redundância e o separador Avançadas, os valores destes campos são um exemplo.

   • Subscrição: selecione a sua subscrição do Azure
   • Grupo de recursos: mgdc-app-resource (ou selecione um grupo de recursos existente)
   • Nome da conta de armazenamento: mgdcdemoap (ou pode atribuir um nome e selecionar a sua própria conta de armazenamento)
   • Região: escolha uma região do Azure na mesma região que a região do Microsoft 365
   • Desempenho: Standard
   • Redundância: Armazenamento georredundante
   • Separador Avançadas:
     • Camada de acesso: Frequente

   

5. Depois de configurar os valores para os separadores Básico eAvançado , deixe as restantes definições como predefinição.

   Observação

   Certifique-se de que, no separador Rede , a opção Ativar o acesso público a partir de todas as redes está ativada. Também pode selecionar a segunda opção Ativar o acesso público a partir de redes virtuais e endereços IP selecionados; no entanto, é necessário executar passos adicionais fora deste tutorial, que estão realçados na secção Endereços IP.

   

6. Reveja que as definições correspondem às apresentadas nos passos anteriores e selecione Criar para finalizar.

7. Após a criação da conta de Armazenamento do Azure, conceda à aplicação Microsoft Entra criou anteriormente o acesso adequado à mesma.

   1. Selecione a conta de Armazenamento do Azure.
   2. No menu da barra lateral, selecione Controlo de acesso (IAM).
   3. Selecione o botão Adicionar no bloco Adicionar uma atribuição de função .
   4. Conceda a função Contribuidor de Dados do Blob de Armazenamento à aplicação que criou anteriormente.
      1. Selecione Contribuidor de Dados do Blob de Armazenamento como Função e clique em Seguinte.
      2. Atribua acesso aUtilizador, grupo ou principal de serviço.
      3. Clique em + Selecionar membros e, no painel direito apresentado, procure a aplicação (Os dados do Microsoft Graph ligam a Transferência de Dados) que criou anteriormente e clique em Selecionar.
   5. Selecione Revisar + atribuir.

   

8. Crie um novo contentor na conta de Armazenamento do Azure mgdcdemoap .

   1. Selecione a conta de Armazenamento do Azure mgdcdemoapp (ou o nome da conta no passo 4).

   2. No menu da barra lateral, selecione Contentores na secção Serviço de armazenamento de dados .

   3. Selecione o botão +Contentor na parte superior da página, utilize os seguintes valores e, em seguida, selecione Criar.

      • Nome: m365mails
      • Nível de acesso público: Privado (sem acesso anónimo)

      

Registar a sua aplicação Microsoft Entra com o Microsoft Graph Data Connect

Como pré-requisito, deve ativar o Data Connect no seu inquilino. Recomendamos que crie uma aplicação Microsoft Entra e um recurso de destino de armazenamento. Também pode configurá-los com o assistente. O processo de registo de aplicações no Data Connect envolve a utilização de um assistente com três separadores: Informações de registo, Conjuntos de dados e Rever + criar.

1. Aceda ao Microsoft Graph Data Connect no portal do Azure. Pode encontrá-la através da barra de pesquisa no portal do Azure

2. Selecione Adicionar ou Adicionar uma nova aplicação.

   

3. Siga o assistente Adicionar para fornecer os detalhes do projeto para o registo. Depois de concluir os campos necessários, selecione Seguinte: Conjuntos >de dados

   1. Subscrição: Selecione uma subscrição para filtrar as seleções seguintes:
      • Grupo de Recursos: Selecione o grupo de recursos que criou anteriormente.
      • Tipo de Destino: Selecione Conta de armazenamento do Azure.
      • Conta de Armazenamento: Selecione a conta de armazenamento que criou anteriormente.
      • URI da Conta de Armazenamento: Selecione a opção com .blob.core.windows.net
   2. ID da Aplicação: Selecione um inquilino Microsoft Entra existente ou crie um novo.
   3. Descrição: Escreva A minha primeira aplicação.
   4. Tipo de Publicação:o Inquilino Único deve ser escolhido automaticamente com base na sua aplicação Microsoft Entra.

   

4. Selecione Seguinte: Conjuntos de >dados .

5. Selecione na lista pendente Conjunto de dados e, na lista pendente Colunas, selecione AllBasicDataSet_v0.Message_v1 . Na nova linha, selecione na lista pendente Conjunto de dados e, na lista pendente Colunas, selecione AllBasicDataSet_v1 .

   

6. Selecione Rever + Criar e, em seguida, Criar.

   

7. Se todos os campos necessários forem fornecidos, o registo da aplicação é apresentado na página de destino.

   

Aprovar a sua aplicação para o Microsoft Graph Data Connect

1. Abra uma nova janela do browser no modo privado, aceda à sua Centro de administração do Microsoft 365 e inicie sessão com o seu utilizador administrador.

1. No painel de navegação esquerdo, selecione Definições Definições > Definições da organização. Poderá ter de selecionar Mostrar tudo antes de poder ver as Definições.

2. Mude para o separador Segurança & privacidade e selecione Aplicações do Microsoft Graph Data Connect.

   

3. No portal de aplicações do Microsoft Graph Data Connect, localize a aplicação que registou anteriormente no Data Connect. Deverá ter um pré-consentimento status na tabela de resumo da aplicação.

   

4. Selecione a sua aplicação para abrir a vista de detalhes da aplicação. Avance para o assistente ao selecionar Seguinte duas vezes para rever os dois conjuntos de dados.

5. No passo final, selecione Aprovar para consentir que a aplicação registada aceda aos dados especificados.

   

6. Aprovar a tabela de resumo da aplicação recarrega com a sua aplicação listada com o status Aprovado.

   

Configurar o recurso do Azure com Azure Synapse ou Azure Data Factory

Este exercício descreve como configurar os seus recursos do Azure e ligar o Microsoft Graph Data Connect (Data Connect) aos mesmos. Neste passo, pode escolher Azure Synapse, Azure Data Factory ou Microsoft Fabric para criar um pipeline para extrair os dados do Microsoft 365 para a conta de Armazenamento do Azure com o Data Connect.

Configurar os recursos do Azure

(Opcional) Visualizar os dados do Microsoft Graph Data Connect no Microsoft Power BI

Este exercício descreve como criar um relatório no Microsoft Power BI para visualizar os seus dados do Microsoft 365 a partir do Microsoft Graph Data Connect.

Verificar o ficheiro JSON no Armazenamento do Azure

1. Abra um browser e aceda ao seu portal do Azure.
2. Em Serviços do Azure, selecione Contas de armazenamento.
3. Selecione a conta de Armazenamento do Azure que criou anteriormente neste tutorial.
4. No painel de navegação esquerdo, selecione Contentores.
5. Escolha o contentor m365mails que criou anteriormente neste tutorial.
6. Deverá ver o ficheiro com um nome GUID no contentor.

Configurar o Power BI

1. Abra a sua aplicação de ambiente de trabalho do Power BI. Se precisar de transferir o Power BI, aceda a Transferir ferramentas e aplicações do Power BI.

2. Selecione Obter Dados, selecione Azure e escolha Armazenamento de Blobs do Azure.

3. Selecione Ligar para estabelecer a ligação entre o Power BI e a sua conta Armazenamento de Blobs do Azure.

   

4. Introduza o nome da Conta de Armazenamento do Azure e o nome do contentor da conta Armazenamento de Blobs do Azure à qual pretende ligar e, em seguida, selecione OK.

   

   Observação

   Pode encontrar o URL do Armazenamento do Azure na Conta de Armazenamento do Azure. Procure nos contentores, escolha o contentor ao qual pretende ligar, aceda ao menu Contexto (...), selecione Propriedades do Contentor e copie o URL.

5. Selecione Transformar Dados e selecione a primeira linha que diz Binário.

   

6. Para obter uma lista com todos os Registos, aceda à opção de alternar Coluna1, selecione sem soltar (ou clique com o botão direito do rato) para selecionar Transformar e, em seguida, selecione JSON.

   

7. Carregue todas as colunas, expanda o seletor Registos a partir da Coluna1 e, em seguida, selecione OK.

   

8. Os resultados são apresentados como Column1.property. Para expandir as colunas com dados aninhados, selecione a opção de alternar em cada coluna e, em seguida, selecione OK.

   • Selecione Fechar & Aplicar e aguarde que a consulta carregue todas as colunas.

   

9. Depois de todas as colunas carregarem, pode criar elementos visuais com os seus dados.

   • Em Dados, selecione Consulta1 para expandir as colunas e escolha as propriedades que pretende visualizar.
   • Em Visualizações, selecione a opção Influenciadores Principais para visualizar os dados.

   Observação

   Neste exemplo, pode determinar se os utilizadores leem as mensagens enviadas por um departamento na sua organização ao analisar cada toRecipientName e a propriedade isRead .

   

10. Agora pode ver os dados JSON do conjunto de dados Messages_v1 do Microsoft Graph Data Connect num relatório do Power BI.

    Observação

    Pode escolher o modo de conectividade de dados (DirectQuery ou Importação) consoante o tamanho dos dados e os requisitos de consulta. Recomendamos que utilize o DirectQuery neste tutorial.

Para modelos de solução que utilizam o Microsoft Graph Data Connect incorporado no Power BI, veja o repositório de soluções do Data Connect no GitHub.

Conteúdo relacionado

• Visão geral da A Conexão de Dados do Microsoft Graph