OneLake-snelkoppelingen maken in een KQL-database

Met OneLake-snelkoppelingen in een KQL-database kunt u query's uitvoeren op gegevens in interne Fabric items en externe opslag zonder de gegevens te verplaatsen. In een KQL-database wordt elke snelkoppeling weergegeven onder Snelkoppelingen en wordt een query uitgevoerd als een externe tabel in een KQL-queryset met behulp van de external_table() functie.

In dit artikel leert u hoe u een OneLake-snelkoppeling maakt in een KQL-database die verwijst naar interne Fabric- of externe bronnen. U kunt de naam van snelkoppelingen die zijn gemaakt in een KQL-database niet wijzigen en u kunt slechts één snelkoppeling tegelijk maken.

Zie OneLake-snelkoppelingen voor algemene informatie over snelkoppelingen, bronspecifieke instructies en bredere beperkingen.

Notitie

Zie Queryversnelling via OneLake-snelkoppelingen om de queryprestaties te verbeteren ten opzichte van ondersteunde snelkoppelingen.

Vereisten

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

Snelkoppeling maken

  1. Blader naar een bestaande KQL-database.

  2. Selecteer +>Nieuwe>OneLake-snelkoppeling.

    Schermopname van het tabblad Start met de vervolgkeuzelijst van de knop Nieuw. De optie met de titel OneLake-snelkoppeling is gemarkeerd.

Een bron selecteren

KQL-databases ondersteunen snelkoppelingen naar interne OneLake-resources, zoals KQL-databases, lakehouses en magazijnen, en naar externe resources, zoals Azure Data Lake Storage, Amazon S3 en Google Cloud Storage. Zie Typen sneltoetsen voor een volledige lijst met ondersteunde snelkoppelingen en bronspecifieke configuratierichtlijnen.

  1. Kies in het venster Nieuwe snelkoppeling het brontype waarmee u verbinding wilt maken.
  2. Voltooi de vereiste verbindingsgegevens voor de bron en selecteer vervolgens de map of tabel die u wilt weergeven in de KQL-database.
  3. Optioneel: Als u queryversnelling wilt inschakelen voor de nieuwe snelkoppeling, stelt u Versnellen in op Aan.
  4. Klik op Creëren.

Zie voor ondersteunde scenario's en beperkingen Queryversnelling voor OneLake-snelkoppelingen - overzicht.

Schermopname van het venster Nieuwe snelkoppeling met de details van de snelkoppeling. De wisselknop Accelerate is gemarkeerd.

Notitie

  1. U kunt per snelkoppeling slechts verbinding maken met één submap of tabel. Als u verbinding wilt maken met meer gegevens, maakt u extra snelkoppelingen.
  2. U kunt geen snelkoppeling maken voor een tabel met een sterretje (*) in een kolomnaam. Wijzig de naam van de kolommen voordat u de snelkoppeling maakt.

Nadat u de snelkoppeling hebt gemaakt, wordt de database automatisch vernieuwd. De snelkoppeling verschijnt onder Snelkoppelingen in het deelvenster Verkenner. U kunt nu een query uitvoeren op de gegevens.

Schermafbeelding van het Explorer-deelvenster met de nieuwe snelkoppeling.

Snelkoppelingen organiseren met mappen

Een submap maken of naar een bestaande map gaan:

  1. In het Verkenner-deelvenster kunt u het volgende doen:
    • Klik met de rechtermuisknop op de snelkoppeling en selecteer Verplaatsen naar map>+ Nieuwe map.
      Schermopname van het snelmenu met de optie voor het maken van een nieuwe map voor de snelkoppeling.
    • Of selecteer het beletselteken (...) naast de specifieke snelkoppeling en selecteer Verplaatsen naar map>+ Nieuwe map of kies een bestaande map.
      Schermopname van het snelmenu met de optie om de snelkoppeling naar een bestaande map te verplaatsen of een nieuwe te maken.
  2. Als u een map wilt maken, voert u een naam in voor de map en selecteert u Maken. De snelkoppeling wordt verplaatst naar de nieuwe map.
    Schermopname van de nieuwe map die wordt gemaakt.
  3. Als u meer dan één snelkoppeling wilt verplaatsen, voert u een andere mapnaam in of selecteert u het vervolgkeuzemenu en vinkt u de selectievakjes aan naast de snelkoppelingen die u naar dezelfde map wilt verplaatsen.
    Schermopname van het snelmenu met de optie om meerdere sneltoetsen naar dezelfde map te verplaatsen.
  4. U kunt ook snelkoppelingen naar een bestaande map verplaatsen. Hiervoor selecteert u Verplaatsen naar map en selecteert u vervolgens de map waarnaar u de snelkoppeling wilt verplaatsen of sleept u de snelkoppeling naar de map en zet u deze neer.

Notitie

  • Als u een submap verwijdert, worden de snelkoppelingen in de map niet verwijderd, maar teruggezet naar de bovenliggende map.
  • Een submap wordt automatisch verwijderd wanneer er geen snelkoppelingen in de map zijn.
  • Mappen kunnen per assettype worden gemaakt en de naam moet uniek zijn per assettype. U kunt bijvoorbeeld een tabelmap en een snelkoppelingsmap met dezelfde naam hebben, maar u kunt geen twee sneltoetsenmappen met dezelfde naam hebben.

Gegevens opvragen

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

  1. Selecteer Aan de rechterkant van de database de optie Uw 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('<shortcut-name>').
  3. Selecteer Uitvoeren of druk op Shift + Enter om een geselecteerde query uit te voeren.

Schermopname van het venster Uw gegevens verkennen met de resultaten van een voorbeeldquery.

Koppeling van gegevenstypen

Toewijzing van Delta Parquet aan Eventhouse-gegevenstype

Delta-primitieve gegevenstypen komen overeen met de scalaire gegevenstypen van Eventhouse, zoals weergegeven in de volgende tabel. Zie Scalaire gegevenstypen voor meer informatie.

Deltatype Eventhouse scalair 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

Automatische schemasynchronisatie

Tabelschema’s van een snelkoppelingstabel worden automatisch gesynchroniseerd, zodat kolomtoevoegingen, verwijderingen, naamswijzigingen en typewijzigingen in de brontabel zonder handmatige updates in de snelkoppeling worden doorgevoerd. Dit gedrag staat standaard aan. Om het uit te schakelen, voer je 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)

Voor meer informatie over schema-synchronisatiegedrag, zie Automatische schema-synchronisatie.

Gerelateerde inhoud

  • Last updated on