OneLake-snelkoppelingen

Snelkoppelingen in Microsoft OneLake combineren uw gegevens tussen domeinen, clouds en accounts door OneLake de één virtuele data lake voor uw hele onderneming te maken. Fabric ervaringen en analytische engines kunnen verbinding maken met uw bestaande gegevensbronnen, waaronder Azure, Amazon Web Services (AWS) en OneLake via een geïntegreerde naamruimte. OneLake beheert alle machtigingen en referenties, dus u hoeft niet elke Fabric workload afzonderlijk te configureren om verbinding te maken met elke gegevensbron. Daarnaast kunt u sneltoetsen gebruiken om edge-kopieën van gegevens te elimineren en de proceslatentie te verminderen die is gekoppeld aan gegevenskopieën en fasering. Shortcuts blijven ook gesynchroniseerd met de brongegevens, waaronder automatische schema-updates voor shortcuttabellen.

Wat zijn sneltoetsen?

Snelkoppelingen zijn objecten in OneLake die wijzen naar andere opslaglocaties. De locatie kan intern of extern zijn voor OneLake. De locatie waarnaar een snelkoppeling verwijst, is het doelpad van de snelkoppeling. De locatie waar de snelkoppeling wordt weergegeven, is het snelkoppelingspad.

Snelkoppelingen worden weergegeven als mappen in OneLake en elke workload of service die toegang heeft tot OneLake, kan deze gebruiken. Snelkoppelingen gedragen zich als symbolische koppelingen. Ze zijn een onafhankelijk object van het doel. Als u een snelkoppeling verwijdert, blijft het doel onaangetast. Als u een doelpad verplaatst, wijzigt of verwijdert, kan de snelkoppeling kapot gaan.

Diagram waarin wordt getoond hoe een snelkoppeling bestanden en mappen verbindt die zijn opgeslagen op andere locaties.

Waar kan ik snelkoppelingen maken?

U kunt snelkoppelingen maken in lakehouses en Kusto Query Language (KQL)-databases.

U kunt de Fabric-portal gebruiken om interactief snelkoppelingen te maken en u kunt de REST-API gebruiken om programmatisch snelkoppelingen te maken.

Lakehouse

Wanneer u snelkoppelingen in een lakehouse maakt, moet u de mapstructuur van het item begrijpen. Lakehouses hebben twee mappen op het hoogste niveau: de map Tabellen en de map Bestanden . De map Tabellen is bedoeld voor gestructureerde gegevenssets. De bestandenmap is bedoeld voor ongestructureerde of semi-gestructureerde gegevens.

In de map Tabellen kunt u alleen snelkoppelingen maken op het hoogste niveau. OneLake biedt geen ondersteuning voor snelkoppelingen in submappen van de map Tabellen . Snelkoppelingen in de sectie Tabellen verwijzen doorgaans naar interne bronnen in OneLake of koppelen aan andere gegevensassets die voldoen aan de Delta-tabelindeling. Als het doel van de snelkoppeling gegevens bevat in een ondersteunde tabelindeling (zoals Delta), synchroniseert lakehouse automatisch metagegevens van tabellen en herkent de map als een tabel.

Tabelschema's worden automatisch gesynchroniseerd voor alle snelkoppelingstabellen, inclusief zowel nieuwe als bestaande tabellen. Deze synchronisatie zorgt ervoor dat schemawijzigingen in de bron worden weerspiegeld in de snelkoppeling zonder handmatige updates. Snelkoppelingen in de sectie Tabellen kunnen een koppeling maken naar één tabel of een schema, een bovenliggende map voor meerdere tabellen.

Notitie

De Delta-indeling biedt geen ondersteuning voor tabellen met spatietekens in de naam. OneLake herkent geen snelkoppeling met een spatie in de naam als een Delta-tabel in het lakehouse.

In de map bestanden zijn er geen beperkingen op waar u snelkoppelingen kunt maken. U kunt snelkoppelingen maken op elk niveau van de map-hiërarchie. Tabeldetectie vindt niet plaats in de bestandenmap. Snelkoppelingen hier kunnen verwijzen naar interne OneLake- en externe opslagsystemen met data in elk formaat.

Diagram met de weergave Bestanden en de weergave Tabellen naast elkaar.

KQL-databank

Wanneer u een snelkoppeling maakt in een KQL-database, wordt deze weergegeven in de map Snelkoppelingen van de database. De KQL-database behandelt snelkoppelingen als externe tabellen. Als u een query wilt uitvoeren op de snelkoppeling, gebruikt u de external_table functie van de Kusto-querytaal.

Schermopname van snelkoppelingen in een KQL-database.

Snelkoppelingen voor Eventhouse-databases

Wanneer u een snelkoppeling naar een database in een gebeurtenishouse maakt, kunt u ervoor kiezen om alle subitems uit de brondatabase op te nemen of specifieke subitems te selecteren die u wilt delen. Met deze functie voor delen op tabelniveau kunt u veilig, beheerd gegevens delen zonder dat volledige databases beschikbaar worden.

Specifieke subitems selecteren

Wanneer u een nieuwe snelkoppeling naar een database maakt, kunt u kiezen uit de volgende subitemtypen:

  • Tabellen - Reguliere tabellen uit de brondatabase
  • Snelkoppelingstabellen - Tabellen die zelf snelkoppelingen zijn
  • Gerealiseerde weergaven - Vooraf samengestelde weergaven voor geoptimaliseerde query's
  • Functies - Opgeslagen functies voor herbruikbare querylogica

Schermopname van het selecteren van specifieke subitems in een eventhouse-database.

Specifieke subitems selecteren:

  1. In een eventhouse selecteert u + Nieuwe>Databasesnelkoppeling.
  2. Kies een methode voor het identificeren van de brondatabase:
    • OneLake-catalogus: blader en selecteer een database in Fabric.
    • Cluster-URI: voer handmatig een Azure Data Explorer cluster-URI en databasenaam in.
    • Uitnodigingstoken : plak een token dat is uitgegeven door de gegevensproducent. De subitemselectie is vooraf gedefinieerd door de producent.
  3. Selecteer in de sectie Op te nemen subitemsAlle subitems opnemen (standaard) of Specifieke subitems selecteren.
  4. Als u specifieke subitems selecteert, gebruikt u de inlinekiezer om te filteren op type en te zoeken op naam.
  5. Klik op Create om de snelkoppeling te maken.

Notitie

U kunt alleen subitems zien en selecteren die u mag delen. Subitems waarvoor u geen machtiging hebt om te delen, zijn verborgen.

Automatische schemasynchronisatie

Er zijn twee soorten automatische schema-synchronisatie voor eventhouse-databasesnelkoppelingen:

  • Automatische schema-synchronisatie voor de databasesnelkoppeling: Voegt tabellen, snelkoppeltabellen, gematerialiseerde weergaven en functies toe of verwijdert hen. Deze synchronisatie vindt alleen plaats wanneer je een databasesnelkoppeling maakt en Alle subitems opnemen selecteert. Als je alleen een subset van de subitems selecteert, geldt deze synchronisatie niet.
  • Automatische schema-synchronisatie voor een snelkoppelingstabel: Voegt kolommen toe, verwijdert of hernoemt ze, en verandert kolomtypes. Deze synchronisatie gebeurt standaard voor alle snelkoppelingstabellen, tenzij je het uitzet met het KQL-commando in het volgende voorbeeld.

Gebruikers van een share op tabelniveau kunnen alleen subitems op tabelniveau opvragen en weergeven die expliciet zijn opgenomen in de share. Namen van niet-gedeelde subitems zijn niet zichtbaar voor consumenten.

Om automatische schema-synchronisatie voor een snelkoppelingstabel uit te schakelen, voert u het volgende commando uit in de brondatabase:

.create-or-alter external table ExternalTable
kind=delta
(
   h@'https://storageaccount.blob.core.windows.net/container1;secretKey'
) with (AutoUpdateSchema=false)

Subitem-afhankelijkheden

Wanneer u subitems selecteert, verwerkt het systeem automatisch afhankelijkheden:

  • Wanneer u een gerealiseerde weergave of functie selecteert, worden de verwezen tabellen automatisch geselecteerd.
  • Wanneer u de selectie van een gerealiseerde weergave of functie uitschakelt, blijven de verwezen tabellen geselecteerd.
  • Wanneer u de selectie van een tabel ongedaan maakt, worden gerealiseerde weergaven of functies die ervan afhankelijk zijn, automatisch gedeselecteerd.

Notitie

Wanneer u een snelkoppelingstabel opent, kunt u alleen een query uitvoeren op de tabel en de metagegevens ervan weergeven als u machtigingen hebt voor zowel de gevolgde database als de brongegevens van de snelkoppelingstabel. Dezelfde machtigingsvereisten gelden voor functies en gematerialiseerde weergaven die verwijzen naar snelkoppeltabellen.

Waar heb ik toegang tot snelkoppelingen?

Elke Fabric- of niet-Fabric-service die toegang heeft tot gegevens in OneLake, kan snelkoppelingen gebruiken. Snelkoppelingen zijn transparant voor elke service die toegang heeft tot gegevens via de OneLake-API. Snelkoppelingen worden gewoon weergegeven als een andere map in het meer. Apache Spark, SQL, Realtime Intelligence en Analysis Services kunnen allemaal snelkoppelingen gebruiken bij het opvragen van gegevens.

Apache Spark

Apache Spark-notebooks en Apache Spark-jobs kunnen snelkoppelingen gebruiken die u in OneLake maakt. Gebruik relatieve bestandspaden om gegevens rechtstreeks vanuit snelkoppelingen te lezen. Als u bovendien een snelkoppeling maakt in de sectie Tabellen van lakehouse en deze de Delta-indeling heeft, kunt u deze lezen als een beheerde tabel met behulp van de Apache Spark SQL-syntaxis.

df = spark.read.format("delta").load("Tables/MyShortcut")
display(df)

df = spark.sql("SELECT * FROM MyLakehouse.MyShortcut LIMIT 1000")
display(df)

SQL

U kunt snelkoppelingen lezen in de sectie Tabellen van een lakehouse via het SQL-analyse-eindpunt voor de lakehouse. U hebt toegang tot het SQL Analytics-eindpunt via de moduskiezer van het lakehouse of via SQL Server Management Studio (SSMS).

SELECT TOP (100) *
FROM [MyLakehouse].[dbo].[MyShortcut]

Realtime-intelligentie

Snelkoppelingen in KQL-databases worden gezien als externe tabellen. Als u een query wilt uitvoeren op de snelkoppeling, gebruikt u de external_table functie van de Kusto-querytaal.

external_table('MyShortcut')
| take 100

Analyse diensten

U kunt semantische modellen maken voor lakehouses met snelkoppelingen in het onderdeel Tabellen van het lakehouse. Wanneer het semantische model wordt uitgevoerd in de Direct Lake-modus, kan Analysis Services gegevens rechtstreeks vanuit de snelkoppeling lezen.

Niet-Fabric-diensten

Toepassingen en services buiten Fabric hebben ook toegang tot snelkoppelingen via de OneLake-API. OneLake ondersteunt een subset van de ADLS Gen2- en Blob Storage-API's. Zie OneLake-toegang met API's voor meer informatie over de OneLake-API.

https://onelake.dfs.fabric.microsoft.com/MyWorkspace/MyLakhouse/Tables/MyShortcut/MyFile.csv

Soorten sneltoetsen

Snelkoppelingen in OneLake ondersteunen meerdere bestandssysteemgegevensbronnen. Deze bronnen omvatten interne OneLake-locaties en externe of niet-Microsoft bronnen.

U kunt ook snelkoppelingen maken naar on-premises locaties of locaties met netwerkbeperking met behulp van de Fabric on-premises gegevensgateway (OPDG).

Interne OneLake snelkoppelingen

Gebruik interne OneLake-snelkoppelingen om te verwijzen naar gegevens binnen bestaande Fabric items, waaronder:

  • KQL-databanken
  • Meerhuisjes
  • Gespiegelde Azure Databricks catalogi
  • Gespiegelde Databases
  • Semantische modellen
  • SQL-databases
  • Magazijnen

Zie Een interne OneLake-snelkoppeling maken voor instructies voor het maken van een interne snelkoppeling.

De snelkoppeling kan verwijzen naar een maplocatie binnen hetzelfde item, tussen items in dezelfde werkruimte of zelfs naar items in verschillende werkruimten. Wanneer u een snelkoppeling tussen items maakt, hoeven de itemtypen niet overeen te komen. U kunt bijvoorbeeld een snelkoppeling maken in een lakehouse die verwijst naar gegevens in een magazijn.

Wanneer een gebruiker via een snelkoppeling toegang heeft tot gegevens van een andere OneLake-locatie, gebruikt OneLake de identiteit van de aanroepende gebruiker om toegang tot de gegevens te autoriseren. Deze gebruiker moet machtigingen hebben op de doellocatie om de gegevens te kunnen lezen.

Belangrijk

Wanneer gebruikers toegang krijgen tot snelkoppelingen via semantische modellen van Power BI met Direct Lake via SQL of T-SQL-engines in de modus voor gedelegeerde identiteit, wordt de identiteit van de aanroepende gebruiker niet doorgegeven aan het doel van de snelkoppeling. In plaats daarvan wordt de identiteit van de eigenaar van het aanroepende item doorgegeven, waarmee de toegang tot de aanroepende gebruiker wordt gedelegeerd. Als u deze beperking wilt oplossen, gebruikt u Power BI semantische modellen in Direct Lake via OneLake-modus of T-SQL in de gebruikersidentiteitsmodus.

Externe OneLake-snelkoppelingen

Voor gedetailleerde instructies voor het maken van een specifiek snelkoppelingstype selecteert u een artikel in deze lijst met ondersteunde externe bronnen:

Cachebeheer

Caching van shortcuts kan de kosten van uitgaand dataverkeer verminderen die samenhangen met toegang tot gegevens in verschillende clouds. Wanneer OneLake bestanden leest via een externe snelkoppeling, slaat de service de bestanden op in een cache voor de Fabric werkruimte. OneLake reageert op volgende leesaanvragen uit de cache in plaats van de externe opslagprovider. U kunt de bewaarperiode instellen voor bestanden in de cache tussen 1 en 28 dagen. Telkens wanneer u het bestand opent, wordt de bewaarperiode opnieuw ingesteld. Als de externe opslag een recentere versie van het bestand heeft dan de versie van de cache, dient OneLake de aanvraag van de externe opslagprovider en werkt het bestand in de cache bij. Als u geen toegang hebt tot een bestand binnen de geselecteerde bewaarperiode, wordt het uit de cache verwijderd. Afzonderlijke bestanden die groter zijn dan 1 GB, worden niet in de cache opgeslagen.

Notitie

Caching van snelkoppelingen ondersteunt momenteel Google Cloud Storage (GCS), S3, S3 compatibel en on-premises gegevensgateway snelkoppelingen.

Caching wordt ook ondersteund voor on-premises Amazon S3-snelkoppelingen die gebruikmaken van Microsoft Entra service-principal-authenticatie.

Als u caching voor snelkoppelingen wilt inschakelen, opent u het deelvenster Werkruimte-instellingen . Kies het tabblad OneLake. Schakel de cache-instelling in op Op en selecteer de bewaarperiode.

U kunt de cache op elk gewenst moment wissen. Selecteer op dezelfde instellingenpagina de knop Cache opnieuw instellen. Met deze actie worden alle bestanden uit de cache voor snelkoppelingen in deze werkruimte verwijderd.

Schermopname van het deelvenster Werkruimte-instellingen met het tabblad OneLake geselecteerd.

Hoe snelkoppelingen cloudverbindingen gebruiken

ADLS- en S3-snelkoppelingen delegeren autorisatie met behulp van cloudverbindingen. Wanneer u een nieuwe ADLS- of S3-snelkoppeling maakt, maakt u een nieuwe verbinding of selecteert u een bestaande verbinding voor de gegevensbron. Het instellen van een verbinding voor een snelkoppeling is een bindingsbewerking. Alleen gebruikers met machtigingen voor de verbinding kunnen de bindingsbewerking uitvoeren. Als u geen machtiging hebt voor de verbinding, kunt u geen nieuwe snelkoppelingen maken met die verbinding.

Zie Verbindingen voor snelkoppelingen beheren voor meer informatie over het weergeven en bijwerken van cloudverbindingen.

Sneltoetsbeveiliging

Voor snelkoppelingen zijn bepaalde machtigingen vereist om te beheren en te gebruiken. In oneLake-snelkoppelingsbeveiliging worden de machtigingen uitgelegd die u nodig hebt om snelkoppelingen te maken en toegang te krijgen tot gegevens.

Hoe verwerken snelkoppelingen de verwijderingen?

Snelkoppelingen bieden geen ondersteuning voor trapsgewijze verwijderingen. Wanneer u een snelkoppeling verwijdert, verwijdert u alleen het snelkoppelingsobject. De gegevens in het snelkoppelingsdoel blijven ongewijzigd. Als u echter een bestand of map binnen een snelkoppeling verwijdert en u machtigingen hebt in het snelkoppelingsdoel om de verwijderbewerking uit te voeren, verwijdert u ook het bestand of de map in het doel.

Denk bijvoorbeeld aan een lakehouse met het volgende pad erin: MyLakehouse\Files\MyShortcut\Foo\Bar. MyShortcut is een snelkoppeling die verwijst naar een ADLS Gen2-account dat de Foo\Bar-mappen bevat.

Als u verwijdert MyLakehouse\Files\MyShortcut, verwijdert u de snelkoppeling MyShortcut uit het lakehouse, maar blijven de bestanden en mappen in het ADLS Gen2-account Foo\Bar ongewijzigd.

Als u MyLakehouse\Files\MyShortcut\Foo\Bar verwijdert, en u schrijfmachtigingen hebt in het ADLS Gen2-account, verwijdert u de Bar directory uit het ADLS Gen2-account.

Neem als ander voorbeeld een lakehouse met schema-ondersteuning met daarin het volgende pad: MyLakehouse\Tables\MySchemaShortcut\Dir1. MySchemaShortcut is een schemasnelkoppeling die verwijst naar een ADLS Gen2-account dat de map Dir1 bevat.

Als u verwijdert MyLakehouse\Tables\MySchemaShortcut, verwijdert u de snelkoppeling naar het MySchemaShortcut-schema uit het lakehouse, maar blijven de bestanden en mappen in het ADLS Gen2-account Dir1 ongewijzigd.

Als u verwijdert MyLakehouse\Tables\MySchemaShortcut\Dir1en u schrijfmachtigingen hebt in het ADLS Gen2-account, verwijdert u de Dir1-directory uit het ADLS Gen2-account.

Weergave van herkomst in werkruimte

Wanneer u snelkoppelingen maakt tussen meerdere Fabric-items in een werkruimte, kunt u de snelkoppelingsrelaties visualiseren via de weergave van de afstamming van de werkruimte. Selecteer de Herkomstweergave-knop ( ) in de rechterbovenhoek van de Werkruimteverkenner.

Schermopname van het lijnageweergavescherm om de snelkoppelingsrelatie te visualiseren.

Notitie

De afhankelijkheidsweergave is gericht op een enkele werkruimte. Snelkoppelingen naar locaties buiten de geselecteerde werkruimte worden niet weergegeven.

Beperkingen en overwegingen

  • Elk Fabric item ondersteunt maximaal 100.000 snelkoppelingen. In deze context verwijst het termitem naar apps, lakehouses, magazijnen, rapporten en meer.
  • Eén OneLake-pad ondersteunt maximaal 10 sneltoetsen.
  • Het maximale aantal directe snelkoppelingen naar koppelingspaden is 5.
  • Snelkoppelingsnamen, bovenliggende paden en doelpaden mogen de tekens '%' of '+' niet bevatten.
  • Sneltoetsen bieden geen ondersteuning voor niet-Latijnse tekens.
  • Afstamming voor snelkoppelingen naar datawarehouses en semantische modellen is momenteel niet beschikbaar.
  • Een Fabric-snelkoppeling wordt automatisch gesynchroniseerd met de bron. Schema- en metagegevensupdates worden toegepast zonder handmatige tussenkomst, maar de doorgiftetijd kan variëren vanwege de prestaties van de gegevensbron, weergaven in de cache of netwerkconnectiviteit.
  • Het kan tot een minuut duren voordat de Table-API nieuwe snelkoppelingen herkent.
  • Snelkoppelingen voor schema's kunnen alleen worden gemaakt in lakehouses met schemaondersteuning.

Gerelateerde inhoud

  • Last updated on