Configurar o Microsoft 365 em uma atividade de cópia
Os pipelines de dados do Microsoft Fabric integram-se à conexão de dados do Microsoft Graph, permitindo que você traga os dados organizacionais avançados em seu locatário do Microsoft 365 para o Fabric e o Azure de forma escalável e crie aplicativos de análise e extraia insights com base nesses valiosos ativos de dados. A integração com o Privileged Access Management fornece controle de acesso seguro para os valiosos dados selecionados no Microsoft 365. Consulte este link para obter uma visão geral da conexão de dados do Microsoft Graph.
Este artigo descreve como usar a atividade de cópia em um pipeline de dados para copiar dados do Microsoft 365. Por enquanto, dentro de uma única atividade de cópia, você pode ingerir dados do Microsoft 365 no Microsoft Fabric Lakehouse Table, Azure Blob Storage, Azure Data Lake Storage Gen1 e Azure Data Lake Storage Gen2. O formato de dados suportado é Avro, texto delimitado, JSON, ORC e formato Parquet.
Pré-requisitos
Para copiar dados do Microsoft 365, você precisa concluir as seguintes etapas de pré-requisito:
- O administrador do locatário do Microsoft 365 deve concluir as ações de integração conforme descrito aqui.
- Crie e configure um aplicativo Web Microsoft Entra no Microsoft Entra ID. Para obter instruções, vá para Criar um aplicativo Microsoft Entra.
- Anote os seguintes valores, que você usa para definir a conexão para o Microsoft 365: ID do locatário. Para obter instruções, vá para Obter ID do locatário.
- ID do aplicativo e chave do aplicativo. Para obter instruções, vá para Obter ID do aplicativo e chave de autenticação. Adicione a identidade do usuário que fará a solicitação de acesso a dados como o proprietário do aplicativo Web Microsoft Entra (do proprietário Adicionar proprietário das configurações>>do aplicativo >Web Microsoft Entra).
- A identidade do usuário deve estar na organização do Microsoft 365 da qual você está recebendo dados e não deve ser um usuário convidado.
Aprovar novos pedidos de acesso a dados
Se você estiver solicitando dados para esse contexto pela primeira vez (uma combinação de qual tabela de dados está sendo acessada, em qual conta de destino são os dados que estão sendo carregados e qual identidade de usuário está fazendo a solicitação de acesso a dados), o status da atividade de cópia será exibido como Em andamento. Somente quando você selecionar o link Detalhes em Ações o status será exibido como RequestingConsent. Um membro do grupo de aprovadores de acesso a dados precisa aprovar a solicitação no Gerenciamento de Acesso Privilegiado antes que a extração de dados possa prosseguir.
Consulte as perguntas frequentes sobre como o aprovador pode aprovar a solicitação de acesso a dados. Consulte o artigo Integração de conexão de dados com PAM para obter uma explicação da integração geral com o Privileged Access Management, incluindo como configurar o grupo de aprovadores de acesso a dados.
Configuração suportada
Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.
- General (Geral)
- Source
- Mapeamento
- Administração
Geral
Para a configuração da guia Geral, vá para Geral.
Source
As propriedades a seguir são suportadas para o Microsoft 365 na guia Origem de uma atividade de cópia.
As seguintes propriedades são necessárias:
- Tipo de armazenamento de dados: Selecione Externo.
- Conexão: Selecione uma conexão do Microsoft 365 na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do Microsoft 365 selecionando Novo.
- Tabela: Nome da tabela a ser extraída do Microsoft 365. Você pode visualizar os dados de exemplo selecionando Visualizar dados de exemplo.
Em Avançado, você pode especificar os seguintes campos:
Escopo: Você pode selecionar Todos os usuários ou grupos no locatário do Microsoft 365 ou Selecionar grupos do locatário do Microsoft 365
Se você selecionar Todos os usuários ou grupos no locatário do Microsoft 365, o filtro de escopo será exibido.
- Filtro de escopo: você pode usar uma expressão de predicado aplicada em todo o locatário para filtrar as linhas específicas a serem extraídas do Microsoft 365. O formato de predicado deve corresponder ao formato de consulta das APIs do Microsoft Graph, por exemplo
https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.
Se você selecionar Selecionar grupos do locatário do Microsoft 365, poderá selecionar Adicionar grupos de usuários para selecionar grupos do locatário do Microsoft 365. Use essa propriedade para selecionar até 10 grupos de usuários para os quais os dados são recuperados. Se nenhum grupo for especificado, os dados serão retornados para toda a organização.
- Filtro de escopo: você pode usar uma expressão de predicado aplicada em todo o locatário para filtrar as linhas específicas a serem extraídas do Microsoft 365. O formato de predicado deve corresponder ao formato de consulta das APIs do Microsoft Graph, por exemplo
Filtro de data: especifique o nome da coluna de filtro DateTime. Use essa propriedade para limitar o intervalo de tempo para o qual os dados do Microsoft 365 são extraídos. Se o conjunto de dados tiver uma ou mais colunas DateTime, você precisará especificar uma coluna aqui. Consulte Filtragem para obter uma lista de conjuntos de dados que exigem esse filtro DateTime.
Especifique a hora de início (UTC) e a hora de término (UTC) para filtrar quando selecionar uma coluna de filtro DateTime.
Mapeamento
Para a configuração da guia Mapeamento, vá para Configurar seus mapeamentos na guia mapeamento.
Definições
Para a configuração da guia Configurações , vá para Configurar suas outras configurações na guia configurações.
Resumo da tabela
As tabelas a seguir contêm mais informações sobre a atividade de cópia no Microsoft 365.
Fonte da informação
| Nome | Descrição | valor | Obrigatório | Propriedade de script JSON |
|---|---|---|---|---|
| Tipo de armazenamento de dados | Seu tipo de armazenamento de dados. | Externa | Sim | / |
| Ligação | Sua conexão com o armazenamento de dados de origem. | <A sua ligação> | Sim | ligação |
| Tabela | Nome da tabela a ser extraída do Microsoft 365. | <tabela> | Sim | tabela |
| Scope | Quando o grupo de usuários não é especificado, você pode usar uma expressão de predicado aplicada em todo o locatário para filtrar as linhas específicas a serem extraídas do Microsoft 365. O formato de predicado deve corresponder ao formato de consulta das APIs do Microsoft Graph, por exemplo https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<o seu âmbito> | Sim | âmbito |
| Filtro de escopo | Quando a allowedGroups propriedade não é especificada, você pode usar uma expressão de predicado que é aplicada em todo o locatário para filtrar as linhas específicas para extrair do Microsoft 365. O formato de predicado deve corresponder ao formato de consulta das APIs do Microsoft Graph, por exemplo https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<Filtro de escopo> | Não | userScopeFilterUri |
| ID do grupo | Predicado de seleção de grupo. Use essa propriedade para selecionar até 10 grupos de usuários para os quais os dados são recuperados. Se nenhum grupo for especificado, os dados serão retornados para toda a organização. | <ID do grupo> | Não | allowedGrupos |
| Filtro de data (Nome da coluna) |
Nome da coluna de filtro DateTime. Use essa propriedade para limitar o intervalo de tempo para o qual os dados do Microsoft 365 são extraídos. | <sua coluna de filtro DateTime> | Sim, se os dados tiverem uma ou mais colunas DateTime. | dateFilterColumn |
| Hora de início (UTC) | Inicie o valor DateTime para filtrar. | <hora de início> | Sim, se dateFilterColumn especificado |
startTime |
| Hora de fim (UTC) | Valor DateTime final para filtrar. | <hora de fim> | Sim, se dateFilterColumn especificado |
endTime |