Configurare Microsoft 365 in un'attività di copia
Le pipeline di dati di Microsoft Fabric si integrano con la connessione ai dati di Microsoft Graph, consentendo di trasferire i dati aziendali avanzati nel tenant di Microsoft 365 in Fabric e Azure in modo scalabile e creare applicazioni di analisi ed estrarre informazioni dettagliate basate su questi asset di dati preziosi. L'integrazione con Privileged Access Management fornisce il controllo di accesso protetto per i dati curati preziosi in Microsoft 365. Per una panoramica della connessione dati di Microsoft Graph, vedere questo collegamento .
Questo articolo illustra come usare l'attività di copia in una pipeline di dati per copiare dati da Microsoft 365. Per il momento, all'interno di una singola attività di copia, è possibile inserire dati da Microsoft 365 in Microsoft Fabric Lakehouse Table, Archiviazione BLOB di Azure, Azure Data Lake Archiviazione Gen1 e Azure Data Lake Archiviazione Gen2. Il formato di dati supportato è Avro, Testo delimitato, JSON, ORC e formato Parquet.
Prerequisiti
Per copiare dati da Microsoft 365, è necessario completare i passaggi prerequisiti seguenti:
- L'amministratore del tenant di Microsoft 365 deve completare le azioni di onboarding come descritto qui.
- Creare e configurare un'applicazione Web Microsoft Entra in Microsoft Entra ID. Per istruzioni, vedere Creare un'applicazione Microsoft Entra.
- Prendere nota dei valori seguenti, usati per definire la connessione per Microsoft 365: ID tenant. Per istruzioni, vedere Ottenere l'ID tenant.
- ID applicazione e chiave di autenticazione. Per istruzioni, vedere Ottenere l'ID applicazione e la chiave di autenticazione. Aggiungere l'identità utente che eseguirà la richiesta di accesso ai dati come proprietario dell'applicazione Web Microsoft Entra (dall'applicazione Web Microsoft Entra Impostazioni> Owners>Aggiungi proprietario).>
- L'identità utente deve trovarsi nell'organizzazione di Microsoft 365 da cui si ricevono dati e non deve essere un utente guest.
Approvazione di nuove richieste di accesso ai dati
Se si richiedono dati per questo contesto per la prima volta (una combinazione della tabella dati a cui si accede, quale account di destinazione è i dati caricati e in quale identità utente effettua la richiesta di accesso ai dati), lo stato dell'attività di copia viene visualizzato come In corso. Solo quando si seleziona il collegamento Dettagli in Azioni lo stato verrà visualizzato come RequestingConsent. Un membro del gruppo dei responsabili dell'approvazione dell'accesso ai dati deve approvare la richiesta in Privileged Access Management prima che l'estrazione dei dati prosegua.
Fare riferimento alle domande frequenti su come il responsabile approvazione può approvare la richiesta di accesso ai dati. Per una spiegazione dell'integrazione complessiva con Privileged Access Management, vedere l'articolo Integrazione della connessione dati con PAM , tra cui come configurare il gruppo di responsabili approvazione dell'accesso ai dati.
Configurazione supportata
Per la configurazione di ogni scheda nell'attività di copia, passare rispettivamente alle sezioni seguenti.
Generali
Per la configurazione della scheda Generale , passare a Generale.
Origine
Le proprietà seguenti sono supportate per Microsoft 365 nella scheda Origine di un'attività di copia.
Sono necessarie le proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Connessione ion: selezionare una connessione a Microsoft 365 dall'elenco delle connessioni. Se non esiste alcuna connessione, creare una nuova connessione a Microsoft 365 selezionando Nuovo.
- Tabella: nome della tabella da estrarre da Microsoft 365. È possibile visualizzare in anteprima i dati di esempio selezionando Anteprima dati di esempio.
In Avanzate è possibile specificare i campi seguenti:
Ambito: è possibile selezionare Tutti gli utenti o i gruppi nel tenant di Microsoft 365 o Selezionare i gruppi dal tenant di Microsoft 365
Se si seleziona Tutti gli utenti o i gruppi nel tenant di Microsoft 365, viene visualizzato il filtro di ambito.
- Filtro ambito: è possibile usare un'espressione di predicato applicata all'intero tenant per filtrare le righe specifiche da estrarre da Microsoft 365. Il formato del predicato deve corrispondere al formato di query delle API Microsoft Graph, ad esempio
https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.
Se si seleziona Seleziona gruppi dal tenant di Microsoft 365, è possibile selezionare Aggiungi gruppi di utenti per selezionare i gruppi dal tenant di Microsoft 365. Utilizzare questa proprietà per selezionare fino a 10 gruppi di utenti per i quali vengono recuperati i dati. Se non vengono specificati gruppi, i dati vengono restituiti per l'intera organizzazione.
- Filtro ambito: è possibile usare un'espressione di predicato applicata all'intero tenant per filtrare le righe specifiche da estrarre da Microsoft 365. Il formato del predicato deve corrispondere al formato di query delle API Microsoft Graph, ad esempio
Filtro data: specificare il nome della colonna del filtro DateTime. Utilizzare questa proprietà per limitare l'intervallo di tempo per il quale vengono estratti i dati di Microsoft 365. Se il set di dati include una o più colonne DateTime, è necessario specificare una colonna qui. Fare riferimento a Filtro per un elenco di set di dati che richiedono questo filtro DateTime.
Specificare l'ora di inizio (UTC) e l'ora di fine (UTC) da filtrare quando si seleziona una colonna di filtro DateTime.
Mapping
Per la configurazione della scheda Mapping , passare a Configurare i mapping nella scheda Mapping.
Impostazione
Per la configurazione della scheda Impostazioni, passare a Configurare le altre impostazioni nella scheda Impostazioni.
Riepilogo tabella
Le tabelle seguenti contengono altre informazioni sull'attività di copia in Microsoft 365.
Informazioni sull'origine
| Nome | Descrizione | Valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | Esterno | Sì | / |
| Connessione | Connessione all'archivio dati di origine. | <connessione> | Sì | connection |
| Tabella | Nome della tabella da estrarre da Microsoft 365. | <table> | Sì | table |
| Scope | Quando il gruppo di utenti non è specificato, è possibile usare un'espressione di predicato applicata all'intero tenant per filtrare le righe specifiche da estrarre da Microsoft 365. Il formato del predicato deve corrispondere al formato di query delle API Microsoft Graph, ad esempio https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<ambito> | Sì | ambito |
| Filtro ambito | Quando la allowedGroups proprietà non è specificata, è possibile usare un'espressione di predicato applicata all'intero tenant per filtrare le righe specifiche da estrarre da Microsoft 365. Il formato del predicato deve corrispondere al formato di query delle API Microsoft Graph, ad esempio https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<filtro ambito> | No | userScopeFilterUri |
| ID gruppo | Predicato di selezione del gruppo. Utilizzare questa proprietà per selezionare fino a 10 gruppi di utenti per i quali vengono recuperati i dati. Se non vengono specificati gruppi, i dati vengono restituiti per l'intera organizzazione. | <ID gruppo> | No | allowedGroups |
| Filtro data (Nome colonna) |
Nome della colonna del filtro DateTime. Utilizzare questa proprietà per limitare l'intervallo di tempo per il quale vengono estratti i dati di Microsoft 365. | <colonna del filtro DateTime> | Sì se i dati hanno una o più colonne DateTime. | dateFilterColumn |
| Ora di inizio (UTC) | Valore DateTime iniziale da filtrare. | <ora di inizio> | Sì se dateFilterColumn è specificato |
startTime |
| Ora di fine (UTC) | Valore DateTime di fine su cui filtrare. | <ora di fine> | Sì se dateFilterColumn è specificato |
endTime |
Contenuto correlato
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per