OneLake-snelkoppelingen maken in een KQL-database

OneLake is één, geïntegreerde, logische data lake voor Microsoft Fabric voor het opslaan van lakehouses, magazijnen, KQL-databases en andere items. Snelkoppelingen zijn ingesloten verwijzingen in OneLake die verwijzen naar de opslaglocaties van andere bestanden zonder de oorspronkelijke gegevens te verplaatsen. De ingesloten verwijzing maakt het alsof de bestanden en mappen lokaal worden opgeslagen, maar in werkelijkheid; ze bestaan in een andere opslaglocatie. Snelkoppelingen kunnen worden bijgewerkt of verwijderd uit uw items, maar deze wijzigingen zijn niet van invloed op de oorspronkelijke gegevens en de bron.

In dit artikel leert u hoe u een OneLake-snelkoppeling maakt in een KQL-database die verwijst naar interne fabric- of externe bronnen. Dit type snelkoppeling wordt later gebruikt voor query's in KQL-querysets met behulp van de external_table() functie. De naam van snelkoppelingen die zijn gemaakt in een KQL-database, kan niet worden gewijzigd en er kan slechts één snelkoppeling tegelijk worden gemaakt.

Naast het maken van snelkoppelingen vanuit een KQL-database, kunnen snelkoppelingen ook worden gemaakt op basis van andere Fabric-items. Deze snelkoppelingen verwijzen ook naar gegevens die zijn opgeslagen in interne infrastructuur of externe bronnen, maar hebben verschillende beperkingen en zijn anders toegankelijk. Zie OneLake-snelkoppelingen voor meer informatie.

Notitie

Als u query's via OneLake-snelkoppelingen wilt versnellen, raadpleegt u Query's versnellen via OneLake-snelkoppelingen.

Selecteer het tabblad dat overeenkomt met de snelkoppeling die u wilt maken:

OneLake-snelkoppeling

Vereisten

• Een werkruimte met een Capaciteit met Microsoft Fabric
• Een KQL-database met bewerkingsmachtigingen
• Een Lakehouse

Zie Een logische kopie voor toegang tot de gegevens in uw KQL-database in andere Microsoft Fabric-ervaringen.

Snelkoppeling maken

Notitie

In de volgende stroom ziet u hoe u een snelkoppeling maakt die verwijst naar gegevens in een Lakehouse in Fabric. Op dezelfde manier kunt u snelkoppelingen maken die verwijzen naar Data Warehouses of andere KQL-databases.

1. Blader naar een bestaande KQL-database.

2. Selecteer Nieuwe>OneLake-snelkoppeling.

   

Een bron selecteren

1. Selecteer Microsoft OneLake onder Interne bronnen.

   

2. Selecteer de gegevensbron waarmee u verbinding wilt maken en selecteer vervolgens Volgende.

   

3. Vouw Tabellen uit en selecteer een specifieke tabel waarmee u verbinding wilt maken.

   

4. Selecteer Volgende.

Notitie

Als u queryversnelling wilt inschakelen voor een nieuwe snelkoppeling, schakelt u de knop Versnellen in op Aan. Zie Versnelde query's via OneLake-snelkoppelingen voor meer informatie.

5. Selecteer Maken.

Notitie

U kunt per snelkoppeling slechts verbinding maken met één submap of tabel. Als u verbinding wilt maken met meer gegevens, herhaalt u deze stappen en maakt u extra snelkoppelingen.

Azure Data Lake Storage Gen2

Vereisten

• Een werkruimte met een Capaciteit met Microsoft Fabric
• Een KQL-database met bewerkingsmachtigingen
• Een Azure Data Lake Storage Gen2-account .

Snelkoppeling maken

1. Blader naar een bestaande KQL-database.

2. Selecteer Nieuwe>OneLake-snelkoppeling.

   

Een bron selecteren

1. Selecteer onder Externe bronnen Azure Data Lake Storage Gen2.

2. Voer de verbindingsinstellingen in volgens de volgende tabel:

   

   Veld	Beschrijving	Waarde
   URL	De verbindingsreeks voor uw deltacontainer.	https://StorageAccountName.dfs.core.windows.net
   Verbinding	Eerder gedefinieerde verbindingen voor de opgegeven opslaglocatie worden weergegeven in de vervolgkeuzelijst. Als er geen verbindingen bestaan, maakt u een nieuwe verbinding.	Maak een nieuwe verbinding.
   Verbindingsnaam	De naam van de Azure Data Lake Storage Gen2-verbinding.	Een naam voor uw verbinding.
   Verificatietype	Het autorisatiemodel. De ondersteunde modellen zijn: Organisatieaccount, Accountsleutel, Shared Access Signature (SAS), service-principal en werkruimte-id. Zie ADLS-snelkoppelingen voor meer informatie.	Afhankelijk van het autorisatiemodel. Nadat u een verificatietype hebt geselecteerd, vult u de vereiste referenties in.

3. Selecteer Volgende.

4. Blader naar de doellocatie voor de snelkoppeling.

   

   Als u het opslagaccount zojuist hebt gebruikt in de verbindings-URL, worden al uw beschikbare containers weergegeven in de linkernavigatieweergave. Als u een container hebt opgegeven in de verbindings-URL, worden alleen de opgegeven container en de inhoud ervan weergegeven in de navigatieweergave.

   Navigeer door het opslagaccount door een map te selecteren of op de uitbreidingspijl naast een map te klikken.

   In deze weergave kunt u een of meer doellocaties voor snelkoppelingen selecteren. Kies doellocaties door op het selectievakje naast een map in de linkernavigatieweergave te klikken.

5. Selecteer Volgende

   

   Op de controlepagina kunt u al uw selecties controleren. Hier ziet u elke snelkoppeling die wordt gemaakt. In de actiekolom kunt u op het potloodpictogram klikken om de naam van de snelkoppeling te bewerken. U kunt op het prullenbakpictogram klikken om de snelkoppeling te verwijderen.

6. Selecteer Maken.

Amazon S3

Vereisten

• Een werkruimte met een Capaciteit met Microsoft Fabric
• Een KQL-database met bewerkingsmachtigingen
• Een Amazon S3-account. Zie Wat is Amazon S3 voor meer informatie ?

Snelkoppeling maken

1. Blader naar een bestaande KQL-database.

2. Selecteer Nieuwe>OneLake-snelkoppeling.

   

Een bron selecteren

1. Selecteer Amazon S3 onder Externe bronnen.

2. Voer de verbindingsinstellingen in volgens de volgende tabel:

   

   Veld	Beschrijving	Waarde
   URL	De verbindingsreeks voor uw Amazon S3-bucket.	https://BucketName.s3.RegionCode.amazonaws.com
   Verbinding	Eerder gedefinieerde verbindingen voor de opgegeven opslaglocatie worden weergegeven in de vervolgkeuzelijst. Als er geen verbindingen bestaan, maakt u een nieuwe verbinding.	Nieuwe verbinding maken
   Verbindingsnaam	De naam van de Amazon S3-verbinding.	Een naam voor uw verbinding.
   Verificatietype	Het IAM-beleid (Identity and Access Management). Het beleid moet lees- en lijstmachtigingen hebben. Zie IAM-gebruikers voor meer informatie.	Afhankelijk van het bucketbeleid.
   Toegangssleutel-id	De IAM-gebruikerssleutel (Identity and Access Management). Zie Toegangssleutels beheren voor IAM-gebruikers voor meer informatie.	Uw toegangssleutel.
   Geheime toegangssleutel	De geheime sleutel identiteits- en toegangsbeheer (IAM).	Uw geheime sleutel.

Selecteer Volgende.

1. Blader naar de doellocatie voor de snelkoppeling.

   

   Als u het globale eindpunt in de verbindings-URL hebt gebruikt, worden al uw beschikbare buckets weergegeven in de linkernavigatieweergave. Als u een bucketspecifiek eindpunt in de verbindings-URL hebt gebruikt, worden alleen de opgegeven bucket en de inhoud ervan weergegeven in de navigatieweergave.

   Navigeer door het opslagaccount door een map te selecteren of op de uitbreidingspijl naast een map te klikken.

   In deze weergave kunt u een of meer doellocaties voor snelkoppelingen selecteren. Kies doellocaties door op het selectievakje naast een map in de linkernavigatieweergave te klikken.

2. Selecteer Volgende

   

   Op de controlepagina kunt u al uw selecties controleren. Hier ziet u elke snelkoppeling die wordt gemaakt. In de actiekolom kunt u op het potloodpictogram klikken om de naam van de snelkoppeling te bewerken. U kunt op het prullenbakpictogram klikken om de snelkoppeling te verwijderen.

3. Selecteer Maken.

De database wordt automatisch vernieuwd. De snelkoppeling wordt weergegeven onder Snelkoppelingen in het deelvenster Verkenner .

De OneLake-snelkoppeling is gemaakt. U kunt nu een query uitvoeren op deze gegevens.

Querygegevens

Gebruik de external_table() functie om een query uit te voeren op gegevens uit de snelkoppeling OneLake.

1. Selecteer Aan de rechterkant van uw database de optie Gegevens verkennen. Het venster wordt geopend met een paar voorbeeldquery's die u kunt uitvoeren om uw gegevens in eerste instantie te bekijken.
2. Vervang de tijdelijke aanduiding voor de tabelnaam door external_table('de naam van de snelkoppeling').
3. Selecteer Uitvoeren of druk op Shift + Enter om een geselecteerde query uit te voeren.

Toewijzing van gegevenstypen

Toewijzing van Delta Parquet aan Eventhouse-gegevenstypen

Delta primitieve gegevenstypen worden toegewezen aan scalaire eventhouse-gegevenstypen met behulp van de volgende regels. Zie Scalaire gegevenstypen voor meer informatie over Eventhouse-gegevenstypen.

Deltatype	Eventhouse Scalar-gegevenstype
string	string
long	long
integer	int
short	int
byte	real
float	real
double	real
decimal	decimal
boolean	bool
binary	string
date	datetime
timestamp_ntz (zonder tijdzone)	datetime
struct	dynamic
array	dynamic
map	dynamic

Gerelateerde inhoud

• Query's uitvoeren op gegevens in een KQL-queryset
• external_table() Functie
• Query's versnellen via OneLake-snelkoppelingen