Conjuntos de dados, regiões e coletores com suporte da Conexão de dados do Microsoft Graph

A Conexão de Dados do Microsoft Graph dá suporte a vários conjuntos de dados, regiões de dados e locais de armazenamentos do Microsoft Azure. Este artigo descreve os conjuntos de dados com suporte e como acessar os esquemas do conjunto de dados, as regiões do Microsoft 365 e do Microsoft Azure com suporte e os locais de armazenamento que o Microsoft Graph Data Connect utiliza por meio do Azure Synapse ou do Azure Data Factory.

Conjuntos de dados

No momento, o Microsoft Graph Data Connect tem suporte para os seguintes conjuntos de dados. Para exibir os esquemas de cada conjunto de dados, crie um novo conjunto de dados no Azure Synapse ou no Azure Data Factory e vá para a guia Esquema.

Atividades

Nome do conjunto de dados Descrição Saiba mais
OutlookContactActivity_v0 Fornece a atividade dos funcionários com seus contatos no Microsoft Outlook. OutlookContactActivity_v0 conjunto de dados
OutlookMailActivity_v0 Fornece a atividade dos funcionários com seu email no Outlook. OutlookMailActivity_v0 conjunto de dados
OutlookMeetingActivity_v0 Fornece a atividade dos funcionários com suas reuniões no Outlook. OutlookMeetingActivity_v0 conjunto de dados
TeamsChannelActivity_v0 Fornece a atividade dos funcionários com seus canais no Microsoft Teams. TeamsChannelActivity_v0 conjunto de dados
TeamsConversationActivity_v0 Fornece a atividade dos funcionários com suas equipes e chats no Teams. TeamsConversationActivity_v0 conjunto de dados

Registros de chamadas

Nome do conjunto de dados Descrição Saiba mais
TeamsCallRecords_v1 Fornece registros de atividades de chamadas e reuniões do Teams. TeamsCallRecords_v1 conjunto de dados

Canal

Nome do conjunto de dados Descrição Saiba mais
TeamsChannelDetails_v0 Gera uma lista de canais do Microsoft Teams. TeamsChannelDetails_v0 conjunto de dados

Contato

Nome do conjunto de dados Descrição Saiba mais
Contact_v0 Fornece detalhes de contato disponíveis no catálogo de endereços de cada usuário. Contact_v0 conjunto de dados
Contact_v1 Fornece os detalhes de contato disponíveis no catálogo de endereços de cada usuário. Contact_v1 conjunto de dados

Dispositivos e licenças

Nome do conjunto de dados Descrição Saiba mais
OwnedDevices_v0 Fornece informações detalhadas relacionadas a todos os dispositivos pertencentes a cada usuário na organização. OwnedDevices_v0 conjunto de dados
RegisteredDevices_v0 Fornece informações detalhadas relacionadas a todos os dispositivos nos quais um usuário está registrado na organização. RegisteredDevices_v0 conjunto de dados
LicenseDetails_v0 Fornece detalhes das licenças dos usuários que são atribuídas diretamente e aquelas atribuídas transitivamente por meio de associações em grupos licenciados. LicenseDetails_v0 conjunto de dados

Evento

Nome do conjunto de dados Descrição Saiba mais
CalendarView_v0 Fornece ocorrências, exceções e instâncias únicas de eventos, com base no modo de exibição de calendário dos calendários dos usuários. CalendarView_v0 conjunto de dados
ConferenceRoomCalendar_v0 Fornece dados CalendarView das Salas de Conferência criadas para um locatário. ConferenceRoomCalendar_v0 conjunto de dados
Event_v0 Fornece todos os eventos dos calendários dos usuários. Event_v0 conjunto de dados
Event_v1 Fornece todos os eventos dos calendários dos usuários. Event_v1 conjunto de dados

Group

Nome do conjunto de dados Descrição Saiba mais
GroupDetails_v0 Fornece os dados de grupos do Microsoft Entra ID (Azure AD) para um locatário. GroupDetails_v0 conjunto de dados
GroupMembers_v0 Gera uma lista de membros diretos de todos os grupos. GroupMembers_v0 conjunto de dados
GroupOwners_v0 Recupera a lista de todos os proprietários do grupo. GroupOwners_v0 conjunto de dados

Email

Nome do conjunto de dados Descrição Saiba mais
Message_v0 Fornece uma coleção de todas as mensagens recebidas por um usuário em pastas de email. Message_v0 conjunto de dados
Message_v1 Fornece uma coleção de todas as mensagens recebidas por um usuário em pastas de email. Message_v1 conjunto de dados
SentItems_v0 Fornece uma coleção de todos os emails enviados por todos os usuários de um locatário. SentItems_v0 conjunto de dados
SentItems_v1 Fornece uma coleção de todos os emails enviados com alguns campos adicionais. SentItems_v1 conjunto de dados

Pasta de email

Nome do conjunto de dados Descrição Saiba mais
Inbox_v1 Fornece as mensagens das pastas de email dos usuários. Inbox_v1 conjunto de dados
Mailfolder_v0 Fornece informações sobre todas as pastas criadas na caixa de correio de um usuário. Mailfolder_v0 conjunto de dados
Mailfolder_v2 Fornece as informações sobre todas as pastas de email criadas na caixa de correio de um usuário. Mailfolder_v2 conjunto de dados

Configurações da Caixa de Correio

Nome do conjunto de dados Descrição Saiba mais
MailboxSettings_v0 Fornece detalhes das configurações de caixa de correio de todos os usuários. MailboxSettings_v0 conjunto de dados

Mensagem

Nome do conjunto de dados Descrição Saiba mais
OutlookGroupConversations_v0 Fornece uma coleção de conversas em grupo entre usuários do locatário. OutlookGroupConversations_v0 conjunto de dados
TeamChat_v1 Fornece mensagens de chat do Teams para mensagens de chat individuais ou em grupo. TeamChat_v1 conjunto de dados
TeamChat_v2 Fornece mensagens de chat do Teams para mensagens de chat individuais ou em grupo. TeamChat_v2 conjunto de dados
TeamsStandardChannelMessages_v0 Fornece mensagens e postagens de canal de canais padrão no Teams. TeamsStandardChannelMessages_v0 conjunto de dados

Reuniões on-line

Nome do conjunto de dados Descrição Saiba mais
TeamsTranscript_v1 Fornece transcrições de chamadas e reuniões no Teams quando a transcrição está habilitada para uma reunião ou chamada. TeamsTranscript_v1 conjunto de dados

Hierarquia da organização

Nome do conjunto de dados Descrição Saiba mais
DirectReport_v0 Fornece detalhes de todos os subordinados diretos para seus usuários. DirectReport_v0 conjunto de dados
Manager_v0 Fornece uma lista de usuários atribuídos como gerentes. Manager_v0 conjunto de dados

Tarefa

Nome do conjunto de dados Descrição Saiba mais
TodoTaskFolders_v0 Identifica pastas de tarefas no Microsoft Outlook que rastreiam itens de trabalho no nível do usuário. TodoTaskFolders_v0 conjunto de dados
TodoTasks_v0 Identifica tarefas no Microsoft Outlook que rastreiam itens de trabalho no nível do usuário. TodoTasks_v0 conjunto de dados
PlannerTasks_v0 Identifica tarefas no Planner que acompanham itens de trabalho no nível do usuário. PlannerTasks_v0 conjunto de dados

Usuário

Nome do conjunto de dados Descrição Saiba mais
User_v0 Fornece detalhes do usuário armazenados para todas as contas de usuário do Microsoft Entra ID (Azure AD) criadas para um locatário específico. User_v0 conjunto de dados
User_v1 Fornece detalhes do usuário armazenados para todas as contas de usuário do Microsoft Entra ID (Azure AD). User_v1 conjunto de dados

OneDrive e SharePoint Online

Nome do conjunto de dados Descrição Amostra e esquema
SharePointSites_v1 Contém informações sobre sites do SharePoint. SharePointSites_v1
SharePointPermissions_v1 Contém informações sobre permissões de compartilhamento. SharePointPermissions_v1
SharePointGroups_v1 Contém informações de grupo do SharePoint, incluindo detalhes sobre os membros do grupo. SharePointGroups_v1
SharePointFiles_v1 Contém informações sobre arquivos do SharePoint. SharePointFiles_v1
SharePointFileActions_v1 Contém informações sobre ações de arquivo do SharePoint. SharePointFileActions_v1
OneDriveSyncHealth_v1 Contém informações sobre dispositivos que executam o OneDrive corporativo ou de estudante. OneDriveSyncHealth_v1
OneDriveSyncErrors_v1 Contém detalhes sobre erros em dispositivos executando o OneDrive para trabalho ou escola. OneDriveSyncErrors_v1

Viva Insights

Nome do conjunto de dados Descrição Amostra e esquema Licença
VivaInsightsDataset_Report_v1_{Viva_Insights_Query_Name} Contém métricas de acordo com a consulta criada pelo usuário no Viva Insights. Variável por relatório. Requer licença do Viva Insights.

Observação:{Viva_Insights_Query_Name} representa um espaço reservado para o nome da consulta do Viva Insights que, quando combinado com VivaInsightsDataset_Report_v1_, forma o nome do conjunto de dados.

Regiões

A Conexão de Dados do Microsoft Graph dá suporte à extração de dados de diversas regiões do Microsoft 365. Para mover com êxito os dados do data center do Microsoft 365 para o armazenamento do Microsoft Azure, a instância do Azure Synapse ou Azure Data Factory e o local de armazenamento do Azure devem ser mapeados para uma região com suporte para a localização dos dados do Microsoft 365.

A tabela a seguir indica quais regiões do Microsoft 365 têm suporte e as regiões do Azure correspondentes necessárias para a movimentação de dados.

Região do Office Região do Azure
Ásia – Pacífico
  • Leste da Ásia
  • Sudeste da Ásia
Austrália
  • Leste da Austrália
  • Sudeste da Austrália
Europa
  • Norte da Europa
  • Europa Ocidental
América do Norte
  • EUA Central
  • Leste dos EUA
  • Leste 2 dos EUA
  • Centro-Norte dos EUA
  • Centro-Sul dos EUA
  • Centro-Oeste dos EUA
  • Oeste dos EUA
  • Oeste 2 dos EUA
Brasil
  • Sul do Brasil
Reino Unido
  • Sul do Reino Unido
  • Oeste do Reino Unido do Reino Unido
Canadá (CAN)
  • Canadá Central
  • Leste do Canadá
Japão (JPN)
  • Oeste do Japão
  • Leste do Japão
Índia (IND)
  • Sul da Índia
  • Índia Central
Coreia (KOR)
  • Coréia Central
  • Sul da Coreia
Suíça (CHE)
  • Suíça (Norte)
Alemanha (DEU)
  • Centro-Oeste da Alemanha
Noruega (NOR)
  • Noruega Leste
França (FRA)
  • França Central
EAU (EAU)
  • Emirados Árabes Unidos Norte

Coletores

Os coletores são o local de saída que o Azure Synapse ou o Azure Data Factory usa para colocar dados no armazenamento do Azure. O Microsoft Graph Data Connect dá suporte aos seguintes tipos de armazenamento de coletor:

Os coletores possuem as seguintes características:

  • A autenticação da Entidade de Serviço é o único mecanismo de autenticação com suporte para todos os tipos de coletores em uma atividade de cópia com o Microsoft 365 como a origem.

  • Ao usar o Armazenamento de Blob do Azure como coletor, certifique-se de que o aplicativo tem acesso de Colaborador de Dados de Armazenamento de Blob para o local de Armazenamento de Blob do Azure.

  • Para a atividade de cópia, os arquivos de saída são formatados como JSON. Esse formato foi corrigido e não há suporte para modificação de formato. No entanto, você pode usar o Azure Synapse ou o Azure Data Factory para copiar o resultado de um pipeline do Microsoft Graph Data Connect para outro mecanismo de armazenamento (como o Banco de Dados SQL do Azure).

  • Mapeamento de fluxos de dados: Copiar e transformar dados do Microsoft 365 (Office 365) - Azure Data Factory & Azure Synapse | Microsoft Learn |

    • A saída pode ser no formato parquet. Para obter detalhes sobre as transformações de dados com suporte, consulte Transformação de nivelamento no fluxo de dados de mapeamento.

    • O Microsoft Graph Data Connect no mapeamento de fluxos de dados dá suporte à saída direta dos dados no banco de dados SQL do Azure.

 

A tabela a seguir indica as áreas com suporte para a atividade de cópia correspondente e os fluxos de dados de mapeamento.

Área atividade Copy Fluxos de dados de mapeamento
Formatos de dados de saída com suporte JSON JSON, Parquet
Transformação de dados (normalização/nivelamento/etc.) Requer etapa de transformação adicional no pipeline do ADF/Synapse Dá suporte a transformações embutidas
Coletores de dados com suporte ADLS gen2, Blob do Azure ADLS gen2, Blob do Azure, Banco de Dados SQL do Azure
IR da VNET do Azure Sem suporte Com suporte