Megosztás a következőn keresztül:

Csatlakozás a Microsoft OneLake-hez

  • Cikk

A Microsoft OneLake nyílt hozzáférést biztosít az összes Fabric-elemhez a meglévő Azure Data Lake Storage (ADLS) Gen2 API-k és SDK-k használatával. A OneLake-ben tárolt adatokat bármely, az ADLS Gen2-vel kompatibilis API-val, SDK-val vagy eszközzel elérheti, csak egy OneLake URI használatával. Adatokat tölthet fel egy tóházba az Azure Storage Exploreren keresztül, vagy elolvashat egy deltatáblát az Azure Databricks parancsikonja alapján.

Mivel a OneLake szolgáltatásként szoftver (SaaS), bizonyos műveleteket, például az engedélyek kezelését vagy az elemek frissítését az ADLS Gen2 API-k helyett a Fabric-szolgáltatásokon keresztül kell elvégezni. Az API-k módosításainak teljes listáját a OneLake API paritásában találja.

URI szintaxis

Mivel a OneLake a teljes Microsoft Fabric-bérlőben létezik, a munkaterület, az elem és az elérési út alapján bármit hivatkozhat a bérlőben:

https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>

Feljegyzés

Mivel több elemtípusban is újra felhasználhatja az elemneveket, meg kell adnia az elemtípust a bővítményben. Például .lakehouse egy tóházhoz és .datawarehouse egy raktárhoz.

A OneLake támogatja a globálisan egyedi azonosítókkal (GUID-kkel) rendelkező munkaterületek és elemek hivatkozását is. A OneLake GUID-ket és GRAFIKUS GUID-ket rendel hozzá, még akkor sem, ha a munkaterület vagy az elem neve megváltozik. A munkaterülethez vagy elemhez társított GUID-azonosítót a Háló portál URL-címében találja. A munkaterülethez és az elemhez is grafikus GUID-ket kell használnia, és nincs szükség az elem típusára.

https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>

Amikor ADLS Gen2 helyett oneLake-en keresztül használható eszközt vezet be, használja a következő leképezést:

  • A fiók neve mindig onelake.
  • A tároló neve a munkaterület neve.
  • Az adatútvonal az elemnél kezdődik. Például: /mylakehouse.lakehouse/Files/

A OneLake az Azure Blob Fájlrendszer illesztőprogramot (ABFS) is támogatja az ADLS Gen2 és az Azure Blob Storage kompatibilitásának további biztosításához. Az ABFS-illesztő saját sémaazonosítót abfs és egy másik URI-formátumot használ az ADLS Gen2-fiókok fájljainak és könyvtárainak kezelésére. Ha ezt az URI-formátumot a OneLake-en szeretné használni, cserélje le a munkaterületet a fájlrendszerre, és adja meg az elem és az elem típusát.

abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>

Az abfs-illesztő URI-ja nem engedélyezi a munkaterület nevében lévő speciális karaktereket, például szóközöket. Ezekben az esetekben hivatkozhat olyan munkaterületekre és elemekre, amelyek globálisan egyedi azonosítókkal (GUID-kkel) vannak elosztva a jelen szakaszban leírtak szerint.

Engedélyezés

A OneLake API-kat a Microsoft Entra ID használatával hitelesítheti egy engedélyezési fejlécen keresztül. Ha egy eszköz támogatja az Azure-fiókba való bejelentkezést a jogkivonat-átengedés engedélyezéséhez, bármelyik előfizetést kiválaszthatja. A OneLake csak a felhasználói jogkivonatot igényli, és nem érdekli az Azure-előfizetése.

Ha közvetlenül DFS API-kon keresztül hívja meg a OneLake-t, a Microsoft Entra-fiókjához tartozó tulajdonosi jogkivonattal hitelesíthet. A szervezet tulajdonosi jogkivonatainak lekérésével és kezelésével kapcsolatos további információkért tekintse meg a Microsoft Authentication Libraryt.

A OneLake közvetlen API-hívások használatával történő gyors, alkalmi teszteléséhez íme egy egyszerű példa a PowerShell használatával az Azure-fiókba való bejelentkezéshez, egy tárterület-hatókörű jogkivonat lekéréséhez és a vágólapra másolásához máshol való egyszerű használat érdekében. A hozzáférési jogkivonatok PowerShell használatával történő lekéréséről további információt a Get-AzAccessToken című témakörben talál.

Feljegyzés

A OneLake csak a Storage célközönség jogkivonatait támogatja. Az alábbi példában a célközönséget a ResourceTypeName paraméteren keresztül állítjuk be.

Connect-AzAccount
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard

Adattárolási hely

Ha a globális végpontot ('https://onelake.dfs.fabric.microsoft.com) használja a munkaterület régiójától eltérő régió adatainak lekérdezésére, előfordulhat, hogy az adatok elhagyhatják a régiót a végpontfeloldási folyamat során. Ha aggódik az adattárolás miatt, a munkaterület megfelelő regionális végpontjának használatával biztosíthatja, hogy az adatok az aktuális régión belül maradnak, és ne lépik át a regionális határokat. A megfelelő regionális végpontot a munkaterülethez csatolt kapacitás régiójának ellenőrzésével derítheti fel.

A OneLake regionális végpontjai mind ugyanazt a formátumot követik: https://<region>-onelake.dfs.fabric.microsoft.com. Például egy, az USA nyugati régiójában lévő kapacitáshoz csatolt munkaterület a regionális végponton https://westus-onelake.dfs.fabric.microsoft.comkeresztül érhető el.

Gyakori problémák

Ha az ADLS Gen2-vel kompatibilis eszköz vagy csomag nem működik a OneLake-en keresztül, a leggyakoribb probléma az URL-érvényesítés. Mivel a OneLake az ADLS Gen2-nél () eltérő végpontot használdfs.fabric.microsoft.com,dfs.core.windows.net egyes eszközök nem ismerik fel a OneLake-végpontot, és nem blokkolják azt. Egyes eszközök lehetővé teszik egyéni végpontok (például a PowerShell) használatát. Ellenkező esetben gyakran egyszerű megoldás a OneLake végpontjának hozzáadása támogatott végpontként. Ha url-érvényesítési problémát talál, vagy bármilyen más probléma merül fel a OneLake-hez való csatlakozással kapcsolatban, tudassa velünk.

Példák

Fájl létrehozása

Kérelem HELYEZ https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Fejlécek Authorization: Bearer <userAADToken>
Válasz ResponseCode: 201 Created
Fejlécek:
x-ms-version : 2021-06-08
x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67b
x-ms-content-crc64 : OAJ6r0dQWP0=
x-ms-request-server-encrypted : true
ETag : 0x8DA58EE365
Törzs:

Kapcsolódó tartalom