Connettersi a Microsoft Fabric OneLake (anteprima)

[Questo articolo è una documentazione preliminare soggetta a modifiche].

Connettersi alle tabelle Delta gestite in una Microsoft Fabric OneLake lakehouse e inserire i dati in Dynamics 365 Contact Center. Il connettore Fabric OneLake legge le tabelle Delta direttamente dall'area di lavoro Fabric, quindi non è necessario copiare o preparare i dati in Azure Data Lake Storage prima.

Motivi principali per connettersi ai dati archiviati in Fabric OneLake:

  • Inserire tabelle Delta direttamente da una Fabric lakehouse senza un livello di archiviazione intermedio.
  • Ridurre lo spostamento dei dati, i costi di archiviazione e la manutenzione della pipeline.
  • Usare Fabric collegamenti per inserire tabelle Delta da altre origini o aree di lavoro in un'unica lakehouse e quindi inserirle tramite una connessione.

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.

Prerequisiti

Prima di creare un'origine dati Fabric OneLake:

Prerequisiti dell'area di lavoro

  • Area di lavoro Microsoft Fabric che contiene una o più lakehouse con le tabelle Delta da inserire. L'area di lavoro Fabric e l'ambiente di Customer Insights - Dati devono trovarsi nello stesso tenant Microsoft Entra.
  • L'amministratore che crea o aggiorna l'origine dati deve avere almeno il ruolo dell'area di lavoro Visualizzatore.

Prerequisiti dei dati

  • È possibile inserire tabelle Delta managed Delta in una Fabric lakehouse. I file (ad esempio CSV o Parquet non Delta) e le tabelle Fabric Data Warehouse non sono supportati.
  • Ogni tabella Delta deve avere una colonna chiave primaria con valori univoci e non Null. I tipi di dati String, Integer e GUID sono supportati come chiavi primarie.
  • Le tabelle Delta esposte tramite le scorciatoie di Fabric sono supportate.
  • Customer Insights - Dati supporta il lettore Databricks versione 1 o 2. Customer Insights - Dati non supporta la lettura delle tabelle Delta con vettori di eliminazione abilitati. I vettori di eliminazione richiedono il lettore Delta versione 3, che non è supportato. Altre informazioni: Funzionalità di Databricks supportate.

Limitazioni dell'anteprima

Durante l'anteprima pubblica si applicano le limitazioni seguenti:

  • Un'origine dati OneLake di Fabric per ogni area di lavoro. Per acquisire dati da un'altra area di lavoro, crea un'altra origine dati o usa una scorciatoia di Fabric.
  • Modifica di un'origine dati OneLake Fabric esistente non è supportata. Per modificare le tabelle selezionate, rimuovere l'origine dati e crearne una nuova. Rimuovere prima tutte le dipendenze downstream . La modifica delle connessioni esistenti è pianificata prima della disponibilità generale.
  • L'Aggiornamento sul posto da un'origine dati esistente di tabelle Delta di Azure Data Lake a un'origine dati di Fabric OneLake non è ancora disponibile. L'aggiornamento in-place è previsto prima della disponibilità generale.

Abilitare l'accesso esterno ai dati di OneLake

Un amministratore tenant di Fabric deve abilitare l'accesso esterno a OneLake data once per ogni tenant Fabric. Questa impostazione consente al servizio Customer Insights - Dati di leggere le tabelle Delta dalle Fabric lakehouse.

  1. Accedere al portale di amministrazione di Fabric come amministratore di Fabric.
  2. Seleziona Impostazioni del locatario.
  3. In impostazioni di OneLake, espandi Gli utenti possono accedere ai dati archiviati in OneLake con app esterne a Fabric.
  4. Impostare l'interruttore su Abilitato e applicare l'impostazione all'intera organizzazione (o a gruppi di sicurezza specifici, come richiesto dai criteri del tenant).

Annotazioni

L'applicazione delle modifiche alle impostazioni del tenant può richiedere fino a 15 minuti.

Aggiungere l'entità servizio di Customer Insights - Dati all'area di lavoro di Fabric

Aggiungere il service principal di Customer Insights - Dati (Dynamics 365 AI for Customer Insights) all'area di lavoro di Fabric con almeno il ruolo Contributor, in modo che possa leggere le tabelle Delta in fase di esecuzione e scrivere una piccola quantità di metadati per ogni tabella. Come procedura consigliata, inserire l'entità servizio in un gruppo di sicurezza.

Abilita il service principal nel tenant di Fabric

  1. Accedere al portale di amministrazione di Fabric come amministratore di Fabric.
  2. Seleziona Impostazioni del locatario. Scorrere fino a Impostazioni sviluppatore.
  3. Abilita Le entità servizio possono chiamare le API pubbliche di Fabric.

Aggiungere l'entità servizio o il gruppo di sicurezza all'area di lavoro di Fabric

  1. Aprire l'area di lavoro di Fabric.
  2. Seleziona Gestisci accesso.
  3. Selezionare Aggiungi persone o gruppi.
  4. Cerca il nome dell'entità servizio o il gruppo di sicurezza che la contiene.
  5. Assegnare il ruolo Collaboratore .

Connettersi ai dati di Fabric OneLake

I nomi e i nomi delle tabelle delle origini dati devono iniziare con una lettera e possono contenere solo lettere, numeri e caratteri speciali. Non è anche possibile rinominare un'origine dati dopo averla salvata. Quando si crea l'origine dati Fabric OneLake, usa l'identità dell'amministratore di Customer Insights - Dati che la configura.

  1. In Customer Insights - Dati, vai a Data>Data sources.

  2. Seleziona Aggiungere un'origine dati.

  3. Selezionare Microsoft Fabric OneLake (anteprima).

  4. Immettere le informazioni seguenti:

    • Nome origine dati : nome univoco per l'origine dati. I processi downstream fanno riferimento a questo nome e non è possibile modificarlo in un secondo momento.
    • Description(facoltativo): breve descrizione dei dati contenuti nell'origine.
    • Workspace: area di lavoro Fabric che contiene la lakehouse con le tabelle Delta da inserire.

    Schermata del riquadro

    Annotazioni

    Ogni origine dati Fabric OneLake è connessa a una singola area di lavoro. Per inserire tabelle da un'area di lavoro diversa, creare un'altra origine dati per tale area di lavoro oppure usare un collegamento Fabric per fare riferimento alle tabelle dall'area di lavoro connessa.

  5. Seleziona Avanti. Customer Insights - Dati elenca ogni tabella Delta trovata in tutti i lakehouse dell'area di lavoro selezionata. I nomi delle tabelle usano il modello <lakehouse>_Lakehouse_<schema>_<table>.

  6. Selezionare Includi per ogni tabella da inserire.

    Schermata della pagina

    Tip

    Se non viene visualizzata una tabella, verificare che si tratti di una tabella Delta gestita in una Fabric lakehouse e che l'area di lavoro lo contenga. Le tabelle archiviate in un Fabric Data Warehouse non sono elencate.

  7. Per ciascuna tabella selezionata in cui non è rilevata una chiave primaria, Obbligatorio compare sotto Chiave primaria. Per ciascuna di queste tabelle:

    1. Seleziona Obbligatoria. Verrà visualizzato il pannello Modifica tabella .
    2. Scegli la chiave primaria. La chiave primaria deve essere univoca e non può contenere valori Null o mancanti.
    3. Seleziona Chiudi per salvare e chiudere il pannello.

  8. Per abilitare la profilatura dei dati in una tabella, selezionare il numero in Colonne per tale tabella. Verrà visualizzata la pagina Gestisci attributi .

    Screenshot della pagina Gestisci attributi che mostra le caselle di controllo colonne, formati di dati e profilatura dei dati.

    1. Esaminare il formato Nome e Dati per ogni colonna.
    2. Selezionare Profilatura dati per l'intera tabella o per singole colonne. Per impostazione predefinita, la profilatura dei dati è disattivata.
    3. Selezionare Done.

  9. Selezionare Avanti, esaminare il riepilogo e quindi selezionare Salva.

Viene visualizzata la pagina Origini dati e viene visualizzata la nuova origine dati in Stato aggiornamento .

Il caricamento dei dati può richiedere tempo. Dopo un aggiornamento riuscito, è possibile esaminare i dati inseriti dalla pagina Tabelle . Dati acquisiti in Customer Insights - Dati: i trasferimenti e l'elaborazione dei dati avvengono nell'area geografica dell'ambiente Customer Insights - Dati. Altre informazioni sono disponibili presso il Microsoft Trust Center.

Tip

Essitono stati per attività e processi. La maggior parte dei processi dipende da altri processi upstream, come le origini dati e gli aggiornamenti della profilazione dei dati.

Selezionare lo stato per aprire il riquadro Dettagli avanzamento e visualizzare lo stato di avanzamento delle attività. Per annullare il processo, seleziona Annulla processo nella parte inferiore del riquadro.

In ogni attività puoi selezionare il collegamento Vedi dettagli per altre informazioni sullo stato, ad esempio tempo di elaborazione, data dell'ultima elaborazione ed eventuali errori e avvisi applicabili associati all'attività o al processo. Seleziona Visualizza stato del sistema nella parte inferiore del pannello per vedere altri processi nel sistema.

Funzionalità supportate

Il connettore Fabric OneLake supporta:

  • Inserimento di tabelle Delta da Fabric lakehouses.
  • Tabelle delta esposte tramite collegamenti Fabric (inclusi collegamenti a OneLake, Azure Data Lake Storage Gen2, Amazon S3 e Google Cloud Storage).
  • Aggiornamento incrementale con versioning Delta.

Funzionalità non supportate

Le funzionalità seguenti non sono supportate durante l'anteprima:

  • tabelle Fabric Data Warehouse
  • File o tabelle che non sono in formato Delta , ad esempio CSV o Parquet non Delta.
  • Connessioni a un lakehouse in più aree di lavoro di Fabric da un'unica origine dati. Usa le scorciatoie oppure crea altre origini dati.

Gestione delle modifiche allo schema

Se si aggiunge o si rimuove una colonna dallo schema di una tabella Delta, Customer Insights - Dati esegue un aggiornamento completo dei dati. L'elaborazione degli aggiornamenti completi richiede più tempo rispetto agli aggiornamenti incrementali.

Se lo schema di origine cambia dopo la creazione dell'origine dati, viene visualizzato un errore di mancata corrispondenza dello schema e chiede di aggiornare l'origine dati. Poiché non è possibile modificare durante l'anteprima, rimuovere e ricreare l'origine dati per recepire il nuovo schema. L'aggiornamento dello schema in loco è previsto per la fase GA.

Viaggio nel tempo delta e aggiornamenti dei dati

Customer Insights - Dati usa la cronologia delle versioni Delta durante l'acquisizione dei dati. Customer Insights - Dati richiede tutte le versioni del log dall'ultimo aggiornamento. Per evitare errori di aggiornamento completo causati da versioni Delta mancanti:

  • Mantenere una cronologia delle versioni del log Delta più lunga rispetto alla frequenza di aggiornamento più lunga. Ad esempio, se un'istanza di sviluppo aggiorna solo i dati ogni due settimane, mantenere almeno tre settimane di cronologia delle versioni.
  • Nella Fabric lakehouse impostare sia delta.logRetentionDuration che delta.deletedFileRetentionDuration su un valore appropriato.
  • Evitare operazioni aggressive di VACUUM contro le tabelle acquisite da Customer Insights - Dati.

Se mancano le versioni Delta (ad esempio, dopo una VACUUM o dopo che la tabella viene ricreata), ricreare l'origine dati per attivare un aggiornamento completo.

Problema comune

La pagina Aggiungi tabelle Delta di Fabric sembra bloccata, non viene visualizzata alcuna tabella

Una o entrambe le situazioni seguenti possono causare questo problema:

  • Last updated on