OneLake parancsikonok

A OneLake Microsoft parancsikonjai egyesíthetik az adatokat tartományok, felhők és fiókok között azáltal, hogy a OneLake-t a teljes vállalat egyetlen virtuális adattóvá teszik. Fabric szolgáltatások és elemzési motorok egységes névtéren keresztül csatlakozhatnak meglévő adatforrásaihoz, például Azure, Amazon Web Serviceshez (AWS) és OneLake-hez. A OneLake kezeli az összes engedélyt és hitelesítő adatot, így nem kell külön konfigurálnia az egyes Fabric számítási feladatokat az egyes adatforrásokhoz való csatlakozáshoz. Emellett billentyűparancsokkal kiküszöbölheti az adatok élpéldányait, és csökkentheti az adatmásolatokkal és az előkészítéssel járó folyamatkésést.

Mik a billentyűparancsok?

A parancsikonok olyan objektumok a OneLake-ben, amelyek más tárolási helyekre mutatnak. A hely lehet a OneLake-en belüli vagy kívüli. Az a hely, amelyre a parancsikon mutat, a parancsikon célútvonala. A parancsikon elérési útja a hely, ahol a parancsikon megjelenik.

A parancsikonok mappákként jelennek meg a OneLake-ben, és a OneLake-hez hozzáféréssel rendelkező számítási feladatok vagy szolgáltatások használhatják őket. A billentyűparancsok szimbolikus hivatkozásokként viselkednek. Ezek a céltól független objektumok. Ha töröl egy parancsikont, a cél nem változik. Ha áthelyez, átnevez vagy töröl egy célelérési utat, a parancsikon megszakadhat.

Diagram, amely azt mutatja be, hogy egy parancsikon hogyan köti össze a más helyeken tárolt fájlokat és mappákat.

Hol hozhatok létre gyorshivatkozásokat?

A lakehouse-okban és Kusto Lekérdezésnyelv (KQL) adatbázisokban parancsikonokat hozhat létre.

A Fabric portálon interaktív módon hozhat létre billentyűparancsokat, a REST API pedig programozott módon hozhat létre billentyűparancsokat.

Lakehouse

Ha parancsikonokat hoz létre egy tóházban, ismernie kell az elem mappastruktúráját. A Lakehouses két legfelső szintű mappával rendelkezik: a Táblák mappával és a Fájlok mappával. A táblák mappa strukturált adatkészletekhez készült. A fájlok mappa strukturálatlan vagy félig strukturált adatokhoz készült.

A Táblák mappában csak a legfelső szinten hozhat létre billentyűparancsokat. A OneLake nem támogatja a táblák mappa alkönyvtáraiban található billentyűparancsokat. A táblák szakasz billentyűparancsai általában a OneLake belső forrásaira mutatnak, vagy más, a Delta táblaformátumnak megfelelő adategységekre mutatnak. Ha a parancsikon célja delta parquet formátumú adatokat tartalmaz, a lakehouse automatikusan szinkronizálja a metaadatokat, és táblaként felismeri a mappát. A táblák szakasz billentyűparancsai egyetlen táblára vagy sémára hivatkozhatnak, amely több tábla szülőmappája.

Megjegyzés

A Delta formátum nem támogatja a névben szóköz karaktereket tartalmazó táblákat. A OneLake nem tekinti Delta-táblának a lakehouse-ban azokat a parancsikonokat, amelyek nevében szóköz van.

A fájlok mappájában nincsenek korlátozások arra vonatkozóan, hogy hol hozhat létre billentyűparancsokat. A mappahierarchia bármely szintjén létrehozhat billentyűparancsokat. A táblafelderítés nem történik meg a fájlok mappájában. Az itt található billentyűparancsok bármelyik belső OneLake- és külső tárolórendszerre mutathatnak, bármilyen formátumú adatokkal.

A Fájlok nézetet és a Táblák nézetet egymás mellett ábrázoló diagram.

KQL-adatbázis

Amikor létrehoz egy parancsikont egy KQL-adatbázisban, az az adatbázis Parancsikonok mappájában jelenik meg. A KQL-adatbázis külső táblákhoz hasonlóan kezeli a parancsikonokat. A parancsikon lekérdezéséhez használja a external_table Kusto lekérdezésnyelv függvényét.

A KQL-adatbázisban található billentyűparancsok képernyőképe.

Hol érhetem el a billentyűparancsokat?

A OneLake-ben adatokat elérő Fabric vagy nem Fabric szolgáltatások parancsikonokat használhatnak. A parancsikonok transzparensek minden olyan szolgáltatás számára, amely a OneLake API-val fér hozzá az adatokhoz. A parancsikonok csak egy másik mappaként jelennek meg a tóban. Az Apache Spark, az SQL, a Valós idejű intelligencia és az Analysis Services mind használhat billentyűparancsokat az adatok lekérdezéséhez.

Apache Spark

Az Apache Spark-jegyzetfüzetek és az Apache Spark-feladatok a OneLake-ben létrehozott billentyűparancsokat használhatják. Relatív fájlelérési utak használatával közvetlenül a parancsikonokból olvashatja be az adatokat. Emellett ha létrehoz egy parancsikont a lakehouse Táblák szakaszában, és az Delta formátumban van, akkor az Apache Spark SQL szintaxisával felügyelt táblázatként is elolvashatja.

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

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

SQL

A lakehouse táblázatos részében, a lakehouse SQL-analitikai végpontján keresztül olvashat billentyűparancsokat. Az SQL Analytics-végpontot a lakehouse módválasztóján vagy SQL Server Management Studio (SSMS) keresztül érheti el.

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

Valós idejű intelligencia

A KQL-adatbázisok billentyűparancsai külső táblákként vannak felismerve. A parancsikon lekérdezéséhez használja a external_table Kusto lekérdezésnyelv függvényét.

external_table('MyShortcut')
| take 100

Analysis Services

A lakehouse táblák szakaszában hivatkozásokat tartalmazó szemantikai modelleket hozhat létre. Amikor a szemantikai modell Direct Lake módban fut, az Analysis Services közvetlenül a parancsikonból tud adatokat olvasni.

A Fabric kört nem érintő szolgáltatások

Az Fabric kívüli alkalmazások és szolgáltatások a OneLake API-n keresztül is elérhetik a billentyűparancsokat. A OneLake támogatja az ADLS Gen2 és a Blob Storage API-k egy részét. A OneLake API-val kapcsolatos további információkért lásd: OneLake hozzáférés API-kkal.

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

Billentyűparancsok típusai

A OneLake parancsikonjai több fájlrendszerbeli adatforrást is támogatnak. Ezek a források közé tartoznak a belső OneLake-helyek és a külső vagy nem Microsoft források.

A Fabric helyszíni adatátjáró (OPDG) használatával parancsikonokat is létrehozhat helyszíni vagy hálózati korlátozásokkal rendelkező helyekre.

OneLake belső parancsikonok

Belső OneLake-parancsikonok használatával hivatkozhat a meglévő Fabric elemeken belüli adatokra, többek között a következőkre:

  • KQL-adatbázisok
  • Tóparti házak
  • Azure Databricks tükrözött katalógusai
  • Tükrözött adatbázisok
  • Szemantikai modellek
  • SQL-adatbázisok
  • Raktárak

A belső parancsikon létrehozására vonatkozó utasításokért lásd: Belső OneLake-parancsikon létrehozása.

A parancsikon egy mappa helyére mutathat ugyanazon az elemen belül, az ugyanazon munkaterületen belüli elemekre, vagy akár a különböző munkaterületeken lévő elemekre is. Amikor különböző elemek között hoz létre parancsikont, az elemtípusoknak nem szükséges egyezniük. Például létrehozhat egy parancsikont a lakehouse-ban, amely egy adattárházban található adatokra mutat.

Amikor egy felhasználó egy parancsikonon keresztül fér hozzá egy másik OneLake-helyről származó adatokhoz, a OneLake a hívó felhasználó identitásával engedélyezi az adatokhoz való hozzáférést. A felhasználónak engedéllyel kell rendelkeznie a célhelyen az adatok olvasásához.

Fontos

Ha a felhasználók Power BI szemantikai modelleken keresztül férnek hozzá a parancsikonokhoz SQL vagy T-SQL motoron keresztül a DirectLake használatával Delegált identitás módban, a hívó felhasználó identitása nem kerül továbbításra a parancsikon célpontja felé. Ehelyett a rendszer átadja a hívóelem tulajdonosának identitását, amely delegálja a hívó felhasználó hozzáférését. A korlátozás megoldásához használjon Power BI szemantikai modelleket a DirectLake-ben a OneLake módban vagy T-SQL-t felhasználói azonosító módban.

Külső OneLake-hivatkozások

Ha részletes útmutatást szeretne egy adott parancsikontípus létrehozásához, válasszon ki egy cikket a támogatott külső források listájából:

Gyorsítótár

A gyorsítótárazás csökkentheti a felhők közötti adathozzáféréssel kapcsolatos kimenő adatforgalom költségeit. Amikor a OneLake külső parancsikonon keresztül olvassa a fájlokat, a szolgáltatás a fájlokat a Fabric munkaterület gyorsítótárában tárolja. A OneLake a távoli tárolószolgáltató helyett a gyorsítótárból érkező későbbi olvasási kérelmekre válaszol. A gyorsítótárazott fájlok megőrzési idejét 1–28 nap között állíthatja be. Minden alkalommal, amikor hozzáfér a fájlhoz, a megőrzési idő visszaállítódik. Ha a távoli tárolónak a fájlnak a gyorsítótár verziójánál újabb verziója van, akkor a OneLake kiszolgálja a távoli tárolószolgáltatótól érkező kérést, és frissíti a fájlt a gyorsítótárban. Ha a kijelölt megőrzési időszakon belül nem fér hozzá egy fájlhoz, az törlődik a gyorsítótárból. Az 1 GB-nál nagyobb fájlok nem gyorsítótárazhatók.

Megjegyzés

A helyi gyorsítótárazás jelenleg a Google Cloud Storage (GCS), az S3, az S3 kompatibilis és a helyszíni adatátjáró billentyűparancsait támogatja.

Az Amazon S3 helyszíni billentyűparancsaihoz is támogatott a gyorsítótárazás, amelyek Microsoft Entra szolgáltatási főhitelesítői hitelesítést használnak.

A parancsikonok gyorsítótárazásának engedélyezéséhez nyissa meg a Munkaterület beállításai panelt. Válassza a OneLake lapot. Állítsa be a gyorsítótár beállítását Be értékre, és válassza ki a megőrzési időtartamot.

A gyorsítótárat bármikor törölheti. Ugyanabból a beállítások oldaláról válassza a Gyorsítótár alaphelyzetbe állítása gombot. Ez a művelet eltávolítja az összes fájlt a munkaterület helyi gyorsítótárából.

Képernyőkép a munkaterület beállításai panelről, amelyen a OneLake lap van kijelölve.

Hogyan használják a billentyűparancsok a felhőkapcsolatokat?

Az ADLS és az S3 parancsikonok a felhőkapcsolatok használatával delegálják az engedélyezést. Amikor új ADLS- vagy S3-parancsikont hoz létre, vagy új kapcsolatot hoz létre, vagy kiválaszt egy meglévő kapcsolatot az adatforráshoz. Az parancsikonhoz való kapcsolat beállítása hozzárendelési művelet. A kötési műveletet csak a kapcsolat engedélyével rendelkező felhasználók hajthatják végre. Ha nincs engedélye a kapcsolatra, nem hozhat létre új parancsikonokat a kapcsolat használatával.

A felhőkapcsolatok megtekintésével és frissítésével kapcsolatos további információkért lásd: Kapcsolatok kezelése billentyűparancsokkal.

Billentyűparancsok biztonsága

A billentyűparancsok kezeléséhez és használatához bizonyos engedélyek szükségesek. A OneLake parancsikon-biztonsága ismerteti a parancsikonok létrehozásához és rajtuk keresztüli adatokhoz való hozzáféréshez szükséges engedélyeket.

Hogyan kezelik a billentyűparancsok a törléseket?

A billentyűparancsok nem támogatják a kaszkádolt törléseket. Ha töröl egy parancsikont, csak a parancsikonobjektumot törli. A parancsikon célobjektum adatai változatlanok maradnak. Ha azonban töröl egy fájlt vagy mappát egy parancsikonon belül, és rendelkezik a parancsikon célhelyének a törlési művelet végrehajtásához szükséges engedélyekkel, akkor a célfájlt vagy mappát is törli.

Például, vegyünk egy tavi házat a következő elérési úttal: MyLakehouse\Files\MyShortcut\Foo\Bar. A MyShortcut parancsikon a Foo\Bar könyvtárakat tartalmazó ADLS Gen2-fiókra mutat.

Ha törli MyLakehouse\Files\MyShortcut, törli a MyShortcut parancsikont a lakehouse-ból, de az ADLS Gen2 fiók Foo\Bar fájljai és könyvtárai nem változnak.

Ha törli a MyLakehouse\Files\MyShortcut\Foo\Bar fájlt, és van írási engedélye az ADLS Gen2-fiókban, akkor a Bar könyvtár törlésre kerül az ADLS Gen2-fiókból.

Munkaterület-származás nézet

Ha több Fabric elem között hoz létre parancsikonokat egy munkaterületen belül, a munkaterület vonalas nézetén keresztül vizualizálhatja a parancsikonkapcsolatokat. Válassza a Munkaterület-kezelő jobb felső sarkában található Vonalas nézet gombot ( ).

Képernyőkép a vonalas nézet képernyőről a billentyűparancs-kapcsolat megjelenítéséhez.

Megjegyzés

A származás nézet hatóköre egyetlen munkaterületre terjed ki. A kijelölt munkaterületen kívüli helyekre mutató billentyűparancsok nem jelennek meg.

Korlátozások és szempontok

  • Minden Fabric elem legfeljebb 100 000 billentyűparancsot támogat. Ebben az összefüggésben az "elem" kifejezés alkalmazásokra, lakehouse-okra, adattárházakra, jelentésekre és egyebekre vonatkozik.
  • Egyetlen OneLake-elérési út legfeljebb 10 parancsikont támogat.
  • A parancsikonokra vezető közvetlen billentyűparancsok maximális száma 5.
  • A OneLake parancsikonnevei, szülőútvonalai és célútvonalai nem tartalmazhatnak "%" vagy "+" karaktereket.
  • A billentyűparancsok nem támogatják a nem latin karaktereket.
  • Az adattárházak és szemantikai modellek parancsikonjainak származási vonala jelenleg nem érhető el.
  • A Fabric parancsikon szinte azonnal szinkronizálódik a forrással, de a propagálási idő az adatforrás teljesítménye, a gyorsítótárazott nézetek vagy a hálózati kapcsolat problémái miatt változhat.
  • Akár egy percig is eltarthat, amíg a Table API felismeri az új parancsikonokat.

Kapcsolódó tartalom

  • Last updated on