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 suportados e como aceder aos esquemas dos conjuntos de dados, às regiões do Microsoft 365 e do Microsoft Azure suportadas e às localizações de armazenamento que o Microsoft Graph Data Connect utiliza através do Azure Synapse ou do Azure Data Factory.

Conjuntos de dados

Atualmente, o Microsoft Graph Data Connect suporta os seguintes conjuntos de dados. Para ver os esquemas de cada conjunto de dados, crie um novo conjunto de dados no Azure Synapse ou no Azure Data Factory e aceda ao separador Esquema.

Atividades

Nome do conjunto de dados Descrição Saiba mais
OutlookContactActivity_v0 Fornece a atividade dos funcionários aos respetivos contactos no Microsoft Outlook. OutlookContactActivity_v0 conjunto de dados
OutlookMailActivity_v0 Fornece a atividade dos funcionários com o respetivo e-mail no Outlook. OutlookMailActivity_v0 conjunto de dados
OutlookMeetingActivity_v0 Fornece a atividade dos funcionários às respetivas reuniões no Outlook. OutlookMeetingActivity_v0 conjunto de dados
TeamsChannelActivity_v0 Fornece a atividade dos utilizadores com os respetivos canais no Microsoft Teams. TeamsChannelActivity_v0 conjunto de dados
TeamsConversationActivity_v0 Fornece a atividade dos funcionários às suas equipas e conversas no Teams. TeamsConversationActivity_v0 conjunto de dados

Registros de chamadas

Nome do conjunto de dados Descrição Saiba mais
TeamsCallRecords_v1 Fornece registos 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 os detalhes de contacto disponíveis no livro de endereços de cada utilizador. Contact_v0 conjunto de dados
Contact_v1 Fornece os detalhes de contacto disponíveis no livro de endereços de cada utilizador. 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 com todos os dispositivos pertencentes a cada utilizador na organização. OwnedDevices_v0 conjunto de dados
RegisteredDevices_v0 Fornece informações detalhadas relacionadas com todos os dispositivos nos quais um utilizador está registado na organização. RegisteredDevices_v0 conjunto de dados
LicenseDetails_v0 Fornece detalhes para as licenças dos utilizadores atribuídas diretamente e as atribuídas transitivamente através 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 individuais de eventos, com base na vista de calendário dos calendários dos utilizadores. CalendarView_v0 conjunto de dados
ConferenceRoomCalendar_v0 Fornece dados calendarView das Salas de Conferência criadas para um inquilino. ConferenceRoomCalendar_v0 conjunto de dados
Event_v0 Fornece todos os eventos dos calendários dos utilizadores. Event_v0 conjunto de dados
Event_v1 Fornece todos os eventos dos calendários dos utilizadores. Event_v1 conjunto de dados

Group

Nome do conjunto de dados Descrição Saiba mais
GroupDetails_v0 Fornece os dados dos grupos do Microsoft Entra ID (Azure AD) para um inquilino. GroupDetails_v0 conjunto de dados
GroupMembers_v0 Gera uma lista de membros diretos de todos os grupos. GroupMembers_v0 conjunto de dados
GroupOwners_v0 Obtém 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 utilizador em pastas de correio. Message_v0 conjunto de dados
Message_v1 Fornece uma coleção de todas as mensagens recebidas por um utilizador em pastas de correio. Message_v1 conjunto de dados
SentItems_v0 Fornece uma coleção de todos os e-mails enviados por todos os utilizadores de um inquilino. SentItems_v0 conjunto de dados
SentItems_v1 Fornece uma coleção de todos os e-mails 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 correio dos utilizadores. Inbox_v1 conjunto de dados
Mailfolder_v0 Fornece informações sobre todas as pastas criadas na caixa de correio de um utilizador. Mailfolder_v0 conjunto de dados
Mailfolder_v2 Fornece as informações sobre todas as pastas de correio criadas na caixa de correio de um utilizador. Mailfolder_v2 conjunto de dados

Configurações da Caixa de Correio

Nome do conjunto de dados Descrição Saiba mais
MailboxSettings_v0 Fornece detalhes sobre as definições da caixa de correio de todos os utilizadores. MailboxSettings_v0 conjunto de dados

Mensagem

Nome do conjunto de dados Descrição Saiba mais
OutlookGroupConversations_v0 Fornece uma coleção de conversações de grupo entre utilizadores do inquilino. OutlookGroupConversations_v0 conjunto de dados
TeamChat_v1 Fornece mensagens de chat do Teams para mensagens de chat um-para-um e de grupo. TeamChat_v1 conjunto de dados
TeamChat_v2 Fornece mensagens de chat do Teams para mensagens de chat um-para-um e de grupo. TeamChat_v2 conjunto de dados
TeamsStandardChannelMessages_v0 Fornece mensagens e mensagens de canais a partir 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á ativada 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 relatórios diretos para os seus utilizadores. DirectReport_v0 conjunto de dados
Manager_v0 Fornece uma lista de utilizadores atribuídos como gestores. 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 monitorizam itens de trabalho ao nível do utilizador. TodoTaskFolders_v0 conjunto de dados
TodoTasks_v0 Identifica tarefas no Microsoft Outlook que controlam itens de trabalho ao nível do utilizador. TodoTasks_v0 conjunto de dados
PlannerTasks_v0 Identifica tarefas no Planner que controlam itens de trabalho ao nível do utilizador. PlannerTasks_v0 conjunto de dados

Usuário

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

OneDrive e SharePoint Online

Nome do conjunto de dados Descrição Exemplo e Esquema
SharePointSites_v1 Contém informações sobre sites do SharePoint. Anteriormente conhecido como SharePointSitesDataset_v0_Preview. SharePointSites_v1
SharePointPermissions_v1 Contém informações sobre permissões de partilha. Anteriormente DocumentSharingDataset_v0_Preview. SharePointPermissions_v1
SharePointGroups_v1 Contém informações do grupo do SharePoint, incluindo detalhes sobre membros do grupo. Anteriormente SharePointGroupsDataset_v0_Preview. SharePointGroups_v1
SharePointFiles_v1 Contém informações sobre ficheiros do SharePoint. A chegar em agosto de 2024. SharePointFiles_v1
SharePointFileActions_v1 Contém informações sobre as ações de ficheiros do SharePoint. SharePointFileActions_v1
OneDriveSyncHealth_v1 Contém informações sobre dispositivos com o OneDrive para Empresas. OneDriveSyncHealth_v1

Viva Insights

Nome do conjunto de dados Descrição Exemplo e Esquema Licença
VivaInsightsDataset_Report_v1_{Viva_Insights_Query_Name} Contém métricas de acordo com a consulta criada pelo utilizador no Viva Insights. Varia de acordo com o relatório. Requer a licença do Viva Insights.

Nota:{Viva_Insights_Query_Name} representa um marcador de posição para o nome da consulta 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 dados do datacenter do Microsoft 365 para o armazenamento do Microsoft Azure, a instância do Azure Synapse ou do Azure Data Factory e a localização de armazenamento do Azure têm de mapear para uma região suportada 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
Emirados Árabes Unidos (E.U.A.)
  • Emirados Árabes Unidos Norte

Coletores

Os sinks são a localização de saída que o Azure Synapse ou o Azure Data Factory utiliza para colocar dados no armazenamento do Azure. O Microsoft Graph Data Connect suporta os seguintes tipos de armazenamento sink:

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 ficheiros de saída são formatados como JSON. Este formato é fixo e a modificação do formato não é suportada. No entanto, pode utilizar 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 a Base de Dados SQL do Azure).

  • Fluxos de dados de mapeamento: Copiar e transformar dados do Microsoft 365 (Office 365) – Azure Data Factory & Azure Synapse | Microsoft Learn |

    • A saída pode estar no formato parquet. Para obter detalhes sobre as transformações de dados suportadas, veja Aplanar a transformação no fluxo de dados de mapeamento.

    • O Microsoft Graph Data Connect sobre fluxos de dados de mapeamento suporta a saída direta dos dados para a BD SQL do Azure.

 

A tabela seguinte indica as áreas suportadas para a atividade de cópia correspondente e fluxos de dados de mapeamento.

Área Atividade de cópia Mapear fluxos de dados
Formatos de dados de saída suportados JSON JSON, Parquet
Transformação de dados (normalização/aplanagem/etc.) Requer um passo de transformação adicional no pipeline do ADF/Synapse Suporta transformações inline
Sinks de dados suportados ADLS gen2, Azure Blob ADLS gen2, Blob do Azure, BD SQL do Azure
Azure VNET IR Sem suporte Com suporte