Csatlakozás a Microsoft OneLake-hez
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
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$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 CreatedFejlécek: x-ms-version : 2021-06-08x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67bx-ms-content-crc64 : OAJ6r0dQWP0=x-ms-request-server-encrypted : trueETag : 0x8DA58EE365Törzs: |