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 de 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 de Azure Synapse ou Azure Data Factory.

Conjuntos de dados

Atualmente, o Microsoft Graph Data Connect dá suporte aos seguintes conjuntos de dados. Para exibir os esquemas de cada conjunto de dados, crie um novo conjunto de dados em Azure Synapse ou Azure Data Factory e acesse 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. conjunto de dados OutlookContactActivity_v0
OutlookMailActivity_v0 Fornece a atividade dos funcionários com seu email no Outlook. conjunto de dados OutlookMailActivity_v0
OutlookMeetingActivity_v0 Fornece a atividade dos funcionários com suas reuniões no Outlook. conjunto de dados OutlookMeetingActivity_v0
TeamsChannelActivity_v0 Fornece a atividade dos usuários com seus canais no Microsoft Teams. conjunto de dados TeamsChannelActivity_v0
TeamsConversationActivity_v0 Fornece a atividade dos funcionários com suas equipes e chats no Teams. conjunto de dados TeamsConversationActivity_v0

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. conjunto de dados TeamsCallRecords_v1

Canal

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

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. conjunto de dados Contact_v0
Contact_v1 Fornece os detalhes de contato disponíveis no catálogo de endereços de cada usuário. conjunto de dados Contact_v1

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 da organização. conjunto de dados OwnedDevices_v0
RegisteredDevices_v0 Fornece informações detalhadas relacionadas a todos os dispositivos em que um usuário está registrado na organização. conjunto de dados RegisteredDevices_v0
LicenseDetails_v0 Fornece detalhes sobre as licenças dos usuários que são atribuídas diretamente e aquelas atribuídas transitivamente por meio de associações em grupos licenciados. conjunto de dados LicenseDetails_v0

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 exibição de calendário dos calendários dos usuários. conjunto de dados CalendarView_v0
ConferenceRoomCalendar_v0 Fornece dados calendarview das Salas de Conferência criadas para um locatário. conjunto de dados ConferenceRoomCalendar_v0
Event_v0 Fornece todos os eventos dos calendários dos usuários. conjunto de dados Event_v0
Event_v1 Fornece todos os eventos dos calendários dos usuários. conjunto de dados Event_v1

Agrupar

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

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. conjunto de dados Message_v0
Message_v1 Fornece uma coleção de todas as mensagens recebidas por um usuário em pastas de email. conjunto de dados Message_v1
SentItems_v0 Fornece uma coleção de todos os emails enviados por todos os usuários de um locatário. conjunto de dados SentItems_v0
SentItems_v1 Fornece uma coleção de todos os emails enviados com alguns campos adicionais. conjunto de dados SentItems_v1

Pasta de email

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

Configurações da Caixa de Correio

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

Mensagem

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

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 uma chamada. conjunto de dados TeamsTranscript_v1

Hierarquia da organização

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

Tarefa

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

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 Microsoft Entra ID (Azure AD) criadas para um locatário específico. conjunto de dados User_v0
User_v1 Fornece detalhes do usuário armazenados para todas as contas de usuário Microsoft Entra ID (Azure AD). conjunto de dados User_v1

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 compartilhamento. Anteriormente DocumentSharingDataset_v0_Preview. SharePointPermissions_v1
SharePointGroups_v1 Contém informações de grupo do SharePoint, incluindo detalhes sobre membros do grupo. Anteriormente SharePointGroupsDataset_v0_Preview. SharePointGroups_v1
SharePointFiles_v1 Contém informações sobre arquivos do SharePoint. Chegando em junho de 2024. SharePointFiles_v1
SharePointFileActions_v1 Contém informações sobre ações de arquivo do SharePoint. Chegando em março de 2024. SharePointFileActions_v1
OneDriveSyncHealth_v1 Contém informações sobre dispositivos que executam OneDrive for Business. Chegando em março de 2024. OneDriveSyncHealth_v1

Viva Insights

Nome do conjunto de dados Descrição Exemplo e esquema Licença
VivaInsightsDataset_PersonReport_v1 Contém Viva Insights métricas. Requer licença Viva Insights

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 data center do Microsoft 365 para o armazenamento do Microsoft Azure, a instância Azure Synapse ou Azure Data Factory e o local de armazenamento do Azure devem mapear 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 Azure Synapse ou 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 atividade de cópia, os arquivos de saída são formatados como JSON. Esse formato é corrigido e não há suporte para modificar o formato. No entanto, você pode usar Azure Synapse ou Azure Data Factory para copiar o resultado de um pipeline do Microsoft Graph Data Connect em outro mecanismo de armazenamento (como SQL do Azure Banco de Dados).

  • 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 com suporte, consulte Achatar a transformação no fluxo de dados de mapeamento.

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

 

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

Área atividade Copy Mapeamento de fluxos de dados
Formatos de dados de saída com suporte JSON JSON
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, Azure Blob ADLS gen2, Blob do Azure, SQL do Azure DB
Azure VNET IR Sem suporte Com suporte