Opret OneLake-genveje i en KQL-database

OneLake-genveje i en KQL-database lader dig forespørge data i interne Fabric-elementer og ekstern lagring uden at flytte dataene. I en KQL-database vises hver genvej under Genveje og forespørges som en ekstern tabel i et KQL-forespørgselssæt ved at bruge external_table() funktionen.

I denne artikel lærer du, hvordan du opretter en OneLake-genvej i en KQL-database, der peger på interne Fabric- eller eksterne kilder. Du kan ikke omdøbe genveje, der er oprettet i en KQL-database, og du kan kun oprette én genvej ad gangen.

For generel information om genvejstyper, kildespecifikke instruktioner og bredere begrænsninger, se OneLake-genveje.

Bemærk

For at forbedre forespørgselsydelsen over understøttede genveje, se Forespørgselsacceleration over OneLake-genveje.

Forudsætninger

Hvis du vil have adgang til dataene i din KQL-database i andre Microsoft Fabric-oplevelser, skal du se Én logisk kopi.

Opret en genvej

  1. Gå til en eksisterende KQL-database.

  2. Vælg +>New>OneLake genvej.

    Skærmbillede af fanen Hjem, der viser rullelisten for knappen Ny. Indstillingen med navnet OneLake-genvej er fremhævet.

Vælg en kilde

KQL-databaser understøtter genveje til interne OneLake-ressourcer, såsom KQL-databaser, lakehouses og lagre, samt til eksterne ressourcer som Azure Data Lake Storage, Amazon S3 og Google Cloud Storage. For en komplet liste over understøttede genvejstyper og kildespecifikke konfigurationsvejledninger, se Typer af genveje.

  1. I genvejsvinduet Ny vælger du den kildetype, du vil forbinde til.
  2. Udfyld de nødvendige forbindelsesdetaljer for kilden, og vælg derefter den mappe eller tabel, du vil vise i KQL-databasen.
  3. Valgfrit: For at aktivere forespørgselsacceleration på den nye genvej, sæt Accelerérér til Tændt.
  4. Vælg Opret.

For understøttede scenarier og begrænsninger, se Forespørgselsacceleration for OneLake-genveje - oversigt.

Skærmbillede af det nye genvejsvindue, der viser genvejsdetaljerne. Acceler-knappen er markeret.

Bemærk

  1. Du kan kun oprette forbindelse til én undermappe eller tabel pr. genvej. For at forbinde til mere data, lav flere genveje.
  2. Du kan ikke oprette en genvej over en tabel, der har en stjerne (*) i et hvilket som helst kolonnenavn. Omdøb kolonnerne, før du opretter genvejen.

Efter du har oprettet genvejen, opdateres databasen automatisk. Genvejen vises under Genveje i ruden Stifinder . Du kan nu forespørge dataene.

Skærmbillede af ruden Stifinder, der viser den nye genvej.

Organiser genveje med mapper

For at oprette en undermappe eller flytte til en eksisterende mappe:

  1. I udforskerpanelet er enten:
    • Højreklik på genvejen og vælg Flyt til mappe>+Ny mappe.
      Skærmbillede af pop-up-menuen, der viser muligheden for at oprette en ny mappe til genvejen.
    • Eller vælg ellipsen (...) ved siden af den specifikke genvej og vælg Flyt til mappe>+ Ny mappe eller vælg en eksisterende mappe.
      Skærmbillede af pop-up-menuen, der viser muligheden for at flytte genvejen til en eksisterende mappe eller oprette en ny.
  2. For at oprette en mappe skal du indtaste et navn på mappen og vælge Opret den. Genvejen flyttes til den nye mappe.
    Skærmbillede af den nye mappe, der bliver oprettet.
  3. For at flytte mere end én genvej, skal du enten indtaste et andet mappenavn eller vælge dropdown-menuen og sætte kryds ved de felter, du vil flytte til den samme mappe.
    Skærmbillede af pop-up-menuen, der viser muligheden for at flytte flere genveje til den samme mappe.
  4. Du kan også flytte genveje til en eksisterende mappe. For at gøre det skal du vælge Flyt til mappe og derefter vælge den mappe, du vil flytte genvejen til, eller trække og slippe genvejen ind i mappen.

Bemærk

  • Hvis du sletter en undermappe, bliver genvejene i mappen ikke slettet, men flyttes tilbage til forældremappen.
  • En undermappe slettes automatisk, når der ikke er genveje i mappen.
  • Mapper kan oprettes pr. assettype, og navnet skal være unikt per assettype. For eksempel kan du have en tabelmappe og en genvejsmappe med samme navn, men du kan ikke have to genvejsmapper med samme navn.

Forespørg om data

Hvis du vil forespørge om data fra OneLake-genvejen, skal du bruge funktionen external_table().

  1. På højre side af din database vælger du Udforsk dine data. Vinduet åbnes med et par eksempelforespørgsler, som du kan køre for at få et indledende kig på dine data.
  2. Erstat pladsholderen for tabelnavnet med external_table('<shortcut-name>').
  3. Vælg Kør , eller tryk på Skift + Enter for at køre en valgt forespørgsel.

Skærmbillede af vinduet Udforsk dine data, der viser resultaterne af en eksempelforespørgsel.

Datatypetilknytning

Delta Parquet til Eventhouse datatype-mapping

Delta-primitive datatyper kortlægges til Eventhouse-skalardatatyper som vist i følgende tabel. For mere information, se Scalar data types.

Delta-type Eventhouse-skalar datatype
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (uden tidszone) datetime
struct dynamic
array dynamic
map dynamic

Automatisk skema-synkronisering

Tabelskemaer for en genvejstabel-tabel synkroniseres automatisk, så kolonnetilføjelser, sletninger, omdøbninger og typeændringer i kildetabellen afspejles i genvejen uden at det kræver manuelle opdateringer. Denne adfærd er slået til som standard. For at deaktivere det, kør følgende kommando i kildedatabasen:

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

For mere information om skemasynkroniseringsadfærd, se Automatisk skemasynkronisering.

Relateret indhold

  • Last updated on