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 de Azure Synapse ou 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 Azure Data Factory e aceda ao separador Esquema.
Atividades
Registros de chamadas
Canal
| 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
Group
Email
Pasta de email
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
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
Tarefa
Usuário
| Nome do conjunto de dados |
Descrição |
Saiba mais |
| User_v0 |
Fornece detalhes de utilizador armazenados para todas as contas de utilizador 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 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. |
SharePointSites_v1 |
| SharePointPermissions_v1 |
Contém informações sobre permissões de partilha. |
SharePointPermissions_v1 |
| SharePointGroups_v1 |
Contém informações do grupo do SharePoint, incluindo detalhes sobre membros do grupo. |
SharePointGroups_v1 |
| SharePointFiles_v1 |
Contém informações sobre ficheiros do SharePoint. |
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 trabalho ou escola. |
OneDriveSyncHealth_v1 |
| OneDriveSyncErrors_v1 |
Contém detalhes sobre erros em dispositivos com o OneDrive para trabalho ou escola. |
OneDriveSyncErrors_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 Viva Insights licença. |
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 seu armazenamento do Microsoft Azure, a instância de Azure Synapse ou 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 |
|
|
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) |
|
|
Alemanha (DEU) |
|
|
Noruega (NOR) |
|
|
França (FRA) |
|
|
Emirados Árabes Unidos (E.U.A.) |
- Emirados Árabes Unidos Norte
|
Coletores
Os sinks são a localização de saída que Azure Synapse ou 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 Azure Synapse ou Azure Data Factory para copiar o resultado de um pipeline do Microsoft Graph Data Connect para outro mecanismo de armazenamento (como SQL do Azure Base 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 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 SQL do Azure BD.
A tabela seguinte indica as áreas suportadas para a atividade de cópia correspondente e fluxos de dados de mapeamento.
| Área |
atividade Copy |
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 SQL do Azure DB |
| Azure VNET IR |
Sem suporte |
Com suporte |
Conteúdo relacionado