OneLake-pikakuvakkeiden luominen KQL-tietokannassa

OneLake-pikanäppäimet KQL-tietokannassa mahdollistavat datan kyselyn sisäisistä Fabric-kohteista ja ulkoisesta tallennustilasta ilman, että dataa tarvitsee siirtää. KQL-tietokannassa jokainen pikakuvake näkyy pikakuvakkeiden kohdalla ja haetaan ulkoisena tauluna KQL-kyselyjoukossa käyttämällä funktiotaexternal_table().

Tässä artikkelissa kerrotaan, miten voit luoda OneLake-pikakuvakkeen KQL-tietokantaan, joka osoittaa sisäiseen Fabriciin tai ulkoisiin lähteisiin. Et voi nimetä KQL-tietokannassa luotuja pikakuvakkeita, ja voit luoda vain yhden pikakuvakkeen kerrallaan.

Yleistä tietoa pikakuvaketyypeistä, lähdekohtaisista ohjeista ja laajemmista rajoituksista löytyy OneLake-pikakuvakkeista.

Muistiinpano

Kyselysuorituskyvyn parantamiseksi tuettuihin pikanäppäimiin nähden, katso Kyselykiihdytys OneLake-pikanäppäimissä.

Edellytykset

Jos haluat käyttää KQL-tietokannan tietoja muissa Microsoft Fabric -käyttökokemuksissa, katso Yksi looginen kopio.

Pikakuvakkeen luominen

  1. Selaa olemassa olevaan KQL-tietokantaan.

  2. Valitse +>New>OneLake -pikakuvake.

    Näyttökuva Aloitus-välilehdestä, jossa näkyy Uusi-painikkeen avattava valikko. OneLake-pikakuvake -niminen vaihtoehto näkyy korostettuna.

Valitse lähde

KQL-tietokannat tukevat oikoteitä sisäisiin OneLake-resursseihin, kuten KQL-tietokantoihin, järvivarastoihin ja varastoihin, sekä ulkoisiin resursseihin, kuten Azure Data Lake Storage, Amazon S3 ja Google Cloud Storage. Täydellisen listan tuetuista pikakuvaketyypeistä ja lähdekohtaisista konfiguraatioohjeista löydät kohdasta Pikakuvakeiden tyypit.

  1. Uusi-pikakuvakke-ikkunassa valitse lähdetyyppi, johon haluat yhdistää.
  2. Täytä tarvittavat yhteystiedot lähteelle ja valitse sitten kansio tai taulukko, jonka haluat paljastaa KQL-tietokannassa.
  3. Valinnainen: Uuden pikakuvakkeen kyselykiihdytyksen aktivoimiseksi aseta AccelerateOn-tilaan.
  4. Valitse Luo.

Tuetut skenaariot ja rajoitukset löytyvät kohdasta Kyselykiihdytys OneLake-pikakuvakkeille – yleiskatsaus.

Kuvakaappaus New pikakuvakkeen ikkunasta, jossa näkyy pikakuvakeiden tiedot. Kiihdytyskytkin on korostettu.

Muistiinpano

  1. Voit muodostaa yhteyden vain yhteen alikansioon tai taulukkoon pikakuvaketta kohden. Yhdistääksesi enemmän dataan, luo lisäpikanäppäimiä.
  2. Et voi luoda pikakuvaketta taulukolle, jossa on tähti (*) missään sarakkeen nimessä. Nimeä sarakkeet uudelleen ennen pikakuvakkeen luomista.

Kun luot pikakuvakkeen, tietokanta päivittyy automaattisesti. Pikakuvake näkyy Resurssienhallintaruudun Pikakuvakkeet-kohdassa. Nyt voit kysyä tietoja.

Näyttökuva resurssienhallintaruudusta, jossa näkyy uusi pikakuvake.

Järjestä pikakuvakkeet kansioiden avulla

Alikansion luominen tai siirtäminen olemassa olevaan kansioon:

  1. Explorer-ruudussa joko:
    • Napsauta oikealla pikakuvaketta ja valitse Siirrä kansioon>+ Uusi kansio.
      Kuvakaappaus ponnahdusvalikosta, jossa näkyy mahdollisuus luoda uusi kansio pikakuvakkeelle.
    • Tai valitse ellipsi (...) pikanäppäimen vierestä ja valitse Siirrä kansioon>+ Uusi kansio tai valitse olemassa oleva kansio.
      Kuvakaappaus ponnahdusvalikosta, jossa on mahdollisuus siirtää pikakuvake olemassa olevaan kansioon tai luoda uusi.
  2. Luodaksesi kansion, syötä kansiolle nimi ja valitse Luo. Pikakuvake siirretään uuteen kansioon.
    Kuvakaappaus uudesta kansiosta, jota luodaan.
  3. Jos haluat siirtää useampaa pikakuvaketta, syötä toinen kansion nimi tai valitse pudotusvalikko ja rastita pikakuvakkeiden vieressä olevat ruudut, jotka haluat siirtää samaan kansioon.
    Kuvakaappaus ponnahdusvalikosta, jossa on mahdollisuus siirtää useita pikanäppäimiä samaan kansioon.
  4. Voit myös siirtää pikakuvakkeita olemassa olevaan kansioon. Voit tehdä niin, valitse Siirrä kansioon ja valitse sitten kansio, johon haluat siirtää pikakuvakkeen, tai vedä ja pudota pikakuvake kansioon.

Muistiinpano

  • Jos poistat alikansion, kansion pikakuvakkeet eivät poisteta, vaan ne siirretään takaisin vanhemmaan kansioon.
  • Alikansio poistetaan automaattisesti, jos kansiossa ei ole pikakuvakkeita.
  • Kansioita voidaan luoda asset-tyypin mukaan, ja nimen on oltava yksilöllinen kunkin asset-tyypin mukaan. Esimerkiksi voit käyttää taulukkokansiota ja pikakuvakkeiden kansiota samalla nimellä, mutta et voi olla kahta pikakuvakekansiota samalla nimellä.

Tietojen kyseleminen

Voit tehdä kyselyn tietoja OneLake-pikakuvakkeesta käyttämällä -funktiotaexternal_table().

  1. Valitse tietokantasi oikealta puolelta Tutki tietosi. Ikkuna avautuu ja sisältää muutamia esimerkkikyselyitä, jotka voit suorittaa, jotta voit tarkastella tietojasi ensimmäisen kerran.
  2. Korvaa taulun nimen paikkamerkki .external_table('<shortcut-name>')
  3. Suorita valittu kysely valitsemalla Suorita tai painamalla Vaihto + Enter.

Näyttökuva Tutki tietojasi -ikkunasta, joka näyttää esimerkkikyselyn tulokset.

Tietotyyppien kartoittaminen

Delta Parquetin ja Eventhousen tietotyyppien kartoitus

Delta-primitiiviset tietotyypit vastaavat Eventhouse-skalaaridatatyyppejä, kuten seuraavassa taulukossa on esitetty. Lisätietoja löytyy kohdasta Skalaaritietotyypit.

Delta-tyyppi Eventhouse-skalaaridatatyyppi
string string
long long
integer int
short int
byte real
float real
double real
decimal decimal
boolean bool
binary string
date datetime
timestamp_ntz (ilman aikavyöhykettä) datetime
struct dynamic
array dynamic
map dynamic

Automaattinen skeeman synkronointi

Pikakuvaketaulun taulukon skeemat synkronoituvat automaattisesti, joten sarakkeiden lisäykset, poistot, uudelleennimeämiset ja tyypin muutokset lähdetaulukossa näkyvät pikakuvakkeessa ilman manuaalisia päivityksiä. Tämä käytös on oletuksena päällä. Poistaaksesi sen käytöstä, suorita seuraava komento lähdetietokannassa:

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

Lisätietoja skeeman synkronointikäyttäytymisestä löytyy kohdasta Automaattinen skeema-synkronointi.

Liittyvä sisältö

  • Last updated on