Forbind til Microsoft Fabric OneLake

Forbind Customer Insights - Data direkte til dit Microsoft Fabric OneLake lakehouse for at indsamle data. Fabric OneLake-connectoren læser Delta-tabeller direkte fra dit Fabric-arbejdsområde, så du behøver ikke kopiere eller stagera data i Azure Data Lake.

Understøttede funktioner

Den Fabric OneLake-connector understøtter:

  • Indtagelse af administrerede Delta-tabeller fra Fabric-søhuse.
  • Brug af Fabric-genveje til at give adgang til Delta-tabeller uden for målarbejdsområdet.

Forudsætninger

Før du opretter en Fabric OneLake-datakilde:

Forudsætninger for arbejdsområde

  • Et Microsoft Fabric-arbejdsområde med Delta-tabeller findes i den samme Microsoft Entra-lejer, som bruges af Customer Insights - Data.
  • Den administrator, der opretter eller opdaterer datakilden, skal som minimum have rollen fremviserarbejdsområde .

Dataforudsætninger

  • Tabeller skal have en primærnøglekolonne med unikke, ikke-nul værdier. Streng-, heltals- og GUID-datatyper understøttes som primære nøgler.
  • Tabellerne skal være i Delta-format.
  • Tabeller skal have en minReaderVersion på 3 eller derunder og kun bruge understøttede Delta-funktioner. Du kan finde flere oplysninger under Understøttede Databricks-funktioner og versioner.
  • Det fysiske Delta-tabelnavn (tabelmappen under Tables i et Fabric lakehouse) skal starte med et ASCII-bogstav (A–Z eller a–z) og kun indeholde ASCII-bogstaver, cifre (0–9) og understregninger (_). For eksempel understøttes Orders_2026, men 2026Orders, Sales Orders og Sales-Orders gør ikke. Tabeller med ikke-understøttede navne bliver ikke opdaget. For at inkludere en sådan tabel, omdøb den i Fabric Lakehouse Explorer.

Begrænsninger

Denne funktion har følgende begrænsninger:

  • Filer eller tabeller, der ikke er i Delta-format (for eksempel CSV eller ikke-Delta Parquet), understøttes ikke.
  • Kun én Fabric OneLake-datakilde pr. arbejdsplads. For at indlæse data fra et andet arbejdsområde, opret en anden datakilde eller brug en genvej i Fabric til at vise den eksterne tabel i arbejdsområdet.
  • Fabric data warehouse-tabeller understøttes ikke.
  • Tabeller, der bruger ikke-understøttede Delta-læserfunktioner, understøttes ikke. Se Understøttede Databricks-funktioner og versioner for understøttede funktioner.

Aktivér ekstern adgang til OneLake-data

En Fabric-lejeradministrator skal aktivere ekstern adgang til OneLake-data én gang for Fabric-lejeren. Denne indstilling tillader tjenester som Customer Insights - Data at læse Delta-tabeller fra dine Fabric-søhuse.

  1. Log på Fabric-administrationsportalen som Fabric-administrator.
  2. Vælg Lejerindstillinger.
  3. Under OneLake-indstillinger skal du udvide Brugere kan få adgang til data, der er gemt i OneLake, med apps uden for Fabric.
  4. Sørg for, at togglen er sat til Aktiveret , og anvend den på organisationen eller på specifikke sikkerhedsgrupper, som krævet af din lejerpolitik. Ændringer i lejerindstillinger kan tage op til 15 minutter at træde i kraft.

Føj Customer Insights - Data tjenesteprincipal til arbejdsområdet Fabric

Tilføj Customer Insights - Data serviceprincippet (Dynamics 365 AI for Customer Insights) til Fabric-arbejdsområdet, der er forbundet til Customer Insights - Data med mindst bidragyderrollen, så det kan læse Delta-tabeller under kørsel og skrive en lille mængde metadata for hver tabel. Som bedste praksis skal du placere tjenesteprincipalen i en sikkerhedsgruppe.

Aktivér tjenesteprincipalen i Fabric-lejeren

  1. Log på Fabric-administrationsportalen som Fabric-administrator.
  2. Vælg Lejerindstillinger. Rul til Udviklerindstillinger.
  3. Aktivér Tjenesteprincipaler kan kalde Fabric offentlige API'er.

Føj tjenesteprincipalen eller sikkerhedsgruppen til det Fabric arbejdsområde

  1. Åbn Fabric-arbejdsområdet, der er forbundet til Customer Insights - Data.
  2. Vælg Administrer adgang.
  3. Vælg Tilføj personer eller grupper.
  4. Søg efter tjenesteprincipalens navn eller den sikkerhedsgruppe, der indeholder det.
  5. Tildel rollen Bidragyder .

Giv adgang til OneLake genvejsmål

Hvis en OneLake-genvej bruger passthrough-godkendelse til at få adgang til et lakehouse i et andet arbejdsområde i samme lejer, skal du give Dynamics 365 AI for Customer Insights-tjenesteprincipalen adgang til målet ved hjælp af en af følgende muligheder:

  • Adgang til arbejdsområdet: Tilføj serviceprincipalen til målarbejdsområdet med Bidragyder-rollen . Dette giver bredere læse- og skriveadgang på tværs af det arbejdsområde.
  • Kun læseadgang til Lakehouse: Del mållakehouse'et med serviceprincipalen, og giv Læs og Læs alle med Apache Spark. Dette giver skrivebeskyttet adgang til det pågældende lakehouse uden medlemskab af arbejdsområdet. Læs alle med Apache Spark tillader også læsning via OneLake API'er; Læs alle med SQL analytics-endpoint alene gør det ikke. Du kan finde flere oplysninger i Lakehouse-deling og tilladelser.

Disse muligheder gælder kun for genvejsmålet. Behold bidragyderrollen på arbejdsområdet forbundet til Customer Insights - Data, som indeholder genvejen.

Genveje, der bruger delegeret autentificering, inklusive eksterne genveje, tilgår målet via deres konfigurerede forbindelsesidentitet i stedet. For mere information, se Genvejsgodkendelsesmodeller.

Opret forbindelse til data i Fabric OneLake

  1. I Customer Insights - Data skal du gå til Data>Datakilder.

  2. Vælg Tilføj en datakilde.

  3. Vælg Microsoft Fabric OneLake.

  4. Angiv følgende oplysninger:

    • Datakildenavn – Et unikt navn til at identificere datakilden i Customer Insights - Data. Du kan ikke ændre navnet på datakilden, efter du har gemt den.
    • Description(valgfrit) – en kort beskrivelse af de data, som kilden indeholder.
    • Workspace – Fabric-arbejdsområdet, der indeholder de Delta-tabeller, der skal indlæses.
    • Aktiver Private Link – Hvis arbejdsområdet er beskyttet af Fabric indgående adgangsbeskyttelse, sæt kryds ved at aktivere Private Link for at forbinde ved at bruge en Azure Private Link. Du kan finde flere oplysninger i Opret forbindelse til et Microsoft Fabric-arbejdsområde med aktiveret beskyttelse af indgående adgang.

    Skærmbillede af panelet Tilføj en datakilde med Fabric OneLake valgt.

  5. Vælg Næste. Customer Insights - Data viser delta-tabeller med understøttede fysiske tabelnavne på tværs af lakehouses i det valgte arbejdsområde. Navne i denne liste bruger mønsteret <lakehouse>_Lakehouse_<schema>_<table>. Tjek det fysiske tabelnavn (<table>) mod navnereglen, ikke det samlede navn i listen.

  6. Vælg Medtag for hver tabel, du vil indtage.

    Skærmbilledet af siden Tilføj Fabric Delta-tabeller med tabeller fra lakehouses med to valgte tabeller.

    Tips

    Hvis der ikke er listet tabeller, skal du sikre dig, at du har opfyldt forudsætningerne for at levere Customer Insights - Data. Hvis tabeller vises, og en specifik tabel ikke er listet, bekræft at tabellen er en managed Delta-tabel i et Fabric lakehouse, at arbejdsområdet indeholder den, og at dens fysiske tabelnavn opfylder navnekravene. Tabeller, der er gemt i en Fabric data warehouse, er ikke opført, da disse tabeller er eksponeret som SQL-tabeller.

  7. For hver valgt tabel, hvor en primærnøgle ikke automatisk registreres, vises Required under Primærnøgle. For hver af disse tabeller:

    1. Vælg Obligatorisk. Panelet Rediger tabel åbnes.
    2. Vælg kolonnen Primærnøgle . Den primære nøgle skal være entydig og må ikke indeholde null-værdier eller manglende værdier.
    3. Vælg Luk for at gemme og lukke panelet.
  8. Hvis du vil aktivere dataprofilering i en tabel, skal du vælge tallet under Kolonner for den pågældende tabel. Siden Administrer attributter åbnes.

    Skærmbillede af siden Administrer attributter, der viser kolonner, dataformater og afkrydsningsfelter for dataprofilering.

    1. Gennemse formatet Navn og Data for hver kolonne.
    2. Vælg Dataprofilering for hele tabellen eller for individuelle kolonner. Dataprofilering er som standard slået fra.
    3. Vælg Udført.
  9. Vælg Næste, gennemse oversigten, og vælg derefter Gem.

Datakilde-siden åbner og viser den nye datakilde i Status Opdatering.

Indlæsning af data kan tage tid, mens tabeller læses og metadata oprettes. Efter en vellykket opdatering kan du gennemgå de indsamlede data på siden Tabeller . Data indlæst til Customer Insights - Data overføres og behandles i den geografiske placering af Customer Insights - Data-miljøet. Du kan få flere oplysninger under Microsoft Center for sikkerhed og rettighedsadministration.

Tips

Vælg en status for at åbne panelet Fremskridtsdetaljer , hvor du kan se opgavefremskridt, eller vælg Annuller opgaven for at stoppe opgaven.

Rediger en Fabric OneLake-datakilde

Du kan redigere en datakildeforbindelse for at tilføje tabeller og fjerne tabeller, hvis der ikke findes nogen downstream-afhængigheder af tabellen. Du kan ikke ændre navnet på datakilden eller arbejdsområdet.

  1. Gå til Data>Datakilder. Ved siden af den datakilde, du vil opdatere, vælg Rediger.

  2. Opdater følgende oplysninger:

  3. Vælg Næste.

  4. Vælg Medtag for hver tabel, du vil indtage.

  5. For hver valgt tabel, hvor der ikke registreres en primær nøgle, vises Påkrævet under Primær nøgle. For hver af disse tabeller:

    1. Vælg Obligatorisk. Panelet Rediger tabel åbnes.
    2. Vælg den primære nøgle. Den primære nøgle skal være entydig og må ikke indeholde null-værdier eller manglende værdier.
    3. Vælg Luk for at gemme og lukke panelet.
  6. Hvis du vil aktivere dataprofilering i en tabel, skal du vælge tallet under Kolonner for den pågældende tabel. Siden Administrer attributter åbnes.

    Skærmbillede af siden Administrer attributter, der viser kolonner, dataformater og afkrydsningsfelter for dataprofilering.

    1. Gennemse formatet Navn og Data for hver kolonne.
    2. Vælg Dataprofilering for hele tabellen eller for individuelle kolonner. Dataprofilering er som standard slået fra.
    3. Vælg Udført.
  7. Vælg Næste, gennemse oversigten, og vælg derefter Gem.

Styre skemaændringer

Hvis du ændrer skemaet for en tabel, som Customer Insights - Data er konfigureret til at indlæse, forårsager ændringen typisk en fejl ved dataopdatering. For at opdatere skemaet for forbindelsen, se Administrer skemaændringer.

Delta-logs og dataopdateringer

Customer Insights - Data bruger Delta-logs ved dataindsamling og kræver alle logversioner siden forrige opdatering. For at undgå opdateringsfejl på grund af manglende Delta-logs:

  • Bevar en længere Delta-logversionshistorik end din længste opdateringsrytme. Hvis en udviklingsforekomst f.eks. kun opdaterer data hver anden uge, skal du bevare mindst tre ugers versionshistorik.
  • I dit Fabric lakehouse skal du angive både delta.logRetentionDuration og delta.deletedFileRetentionDuration til en passende værdi.
  • Undgå aggressive operationer på tabeller, som Customer Insights - Data indtager.

Hvis Delta-logversioner mangler (for eksempel efter en aggressiv VACUUM operation), kør manuelt en fuld opdatering af tabellen. For at lære mere, se Kør manuelt en fuld opdatering på en Delta-tabel.

Almindeligt problem

Siden Add Fabric Delta-tabeller virker uresponsiv, og der vises ingen tabeller

Customer Insights - Data kan ikke læse listen over tabeller i arbejdsområdet. En eller flere af følgende situationer kan forårsage dette problem: