Munkaterület-objektumok azonosítóinak lekérése
Ez a cikk bemutatja, hogyan szerezhet be munkaterületet, fürtöt, könyvtárat, modellt, jegyzetfüzetet és feladatazonosítókat és URL-címeket az Azure Databricksben.
Munkaterület-példányok nevei, URL-címei és azonosítói
Minden Egyes Azure Databricks-üzembe helyezéshez egyedi példánynév, más néven munkaterületenkénti URL-cím van hozzárendelve. Ez a teljes tartománynév, amellyel bejelentkezhet az Azure Databricks-üzembe helyezésbe, és API-kéréseket kezdeményezhet.
Az Azure Databricks-munkaterületen fut az Azure Databricks platform, ahol Spark-fürtöket hozhat létre és ütemezhet számítási feladatokat. Egy munkaterület egyedi numerikus munkaterület-azonosítóval rendelkezik.
Munkaterület-alapú URL-cím
A munkaterületenkénti egyedi URL-cím formátuma adb-<workspace-id>.<random-number>.azuredatabricks.net
. A munkaterület azonosítója közvetlenül a "pont" (.) után adb-
és előtt jelenik meg. Munkaterületenkénti URL-cím https://adb-5555555555555555.19.azuredatabricks.net/
esetén:
- A példány neve .
adb-5555555555555555.19.azuredatabricks.net
- A munkaterület azonosítója.
5555555555555555
Munkaterületenkénti URL-cím meghatározása
Meghatározhatja a munkaterület munkaterületenkénti URL-címét:
Bejelentkezéskor a böngészőben:
Az Azure Portalon az erőforrás kiválasztásával és az URL-mező értékének jelölésével:
Az Azure API használata. Lásd: Munkaterületenkénti URL-cím lekérése az Azure API használatával.
Örökölt regionális URL-cím
Fontos
Kerülje az örökölt regionális URL-címek használatát. Előfordulhat, hogy nem működnek új munkaterületeken, kevésbé megbízhatóak, és alacsonyabb teljesítményt mutatnak, mint a munkaterületenkénti URL-címek.
Az örökölt regionális URL-cím az Azure Databricks-munkaterület üzembe helyezésének régiójából és a tartományból azuredatabricks.net
áll, például https://westus.azuredatabricks.net/
.
- Ha egy régi regionális URL-címre jelentkezik be, például
https://westus.azuredatabricks.net/
a példány nevewestus.azuredatabricks.net
. - A munkaterület azonosítója csak akkor jelenik meg az URL-címben, ha egy örökölt regionális URL-cím használatával jelentkezett be. Ekkor megjelenik a
o=
. Az URL-címbenhttps://<databricks-instance>/?o=6280049833385130
a munkaterület azonosítója.6280049833385130
Fürt URL-címe és azonosítója
Az Azure Databricks-fürtök egységes platformot biztosítanak különböző használati esetekhez, például éles ETL-folyamatok futtatásához, streamelemzéshez, alkalmi elemzésekhez és gépi tanuláshoz. Minden fürt rendelkezik egy egyedi azonosítóval, a fürtazonosítóval. Ez mind a teljes célú, mind a feladatfürtökre vonatkozik. Ahhoz, hogy egy fürt adatait lekérje a REST API használatával, a fürtazonosító elengedhetetlen.
A fürtazonosító lekéréséhez kattintson az oldalsáv Fürtök lapjára, majd válasszon egy fürtnevet. A fürt azonosítója a lap URL-címében szereplő összetevő utáni /clusters/
szám.
https://<databricks-instance>/#/setting/clusters/<cluster-id>
Az alábbi képernyőképen a fürtazonosító a következő 0831-211914-clean632
.
Jegyzetfüzet URL-címe és azonosítója
A jegyzetfüzet egy webalapú felület egy futtatható kódot, vizualizációt és elbeszélő szöveget tartalmazó dokumentumhoz. A jegyzetfüzetek az Azure Databricks egyik felületét képezik. Minden jegyzetfüzet egyedi azonosítóval rendelkezik. A jegyzetfüzet URL-címe a jegyzetfüzet azonosítójával rendelkezik, ezért a jegyzetfüzet URL-címe egyedi a jegyzetfüzethez. Az Azure Databricks platformon bárkivel megosztható, aki jogosult a jegyzetfüzet megtekintésére és szerkesztésére. Ezenkívül minden jegyzetfüzetparancsnak (cellának) más URL-címe van.
A jegyzetfüzet URL-címének vagy azonosítóinak megkereséséhez nyisson meg egy jegyzetfüzetet. Cella URL-címének megkereséséhez kattintson a parancs tartalmára.
Példa jegyzetfüzet URL-címe:
https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342`
Példa jegyzetfüzet-azonosító:
1940481404050342
.Példa parancs (cella) URL-címe:
https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342/command/2432220274659491
Mappaazonosító
A mappa egy könyvtár, amely az Azure Databricks-munkaterületen használható fájlok tárolására szolgál. Ezek a fájlok lehetnek jegyzetfüzetek, tárak vagy almappák. Az egyes mappákhoz és az egyes almappákhoz egy adott azonosító tartozik. A Permissions API erre az azonosítóra directory_id hivatkozik, és egy mappa engedélyeinek beállítására és frissítésére szolgál.
A directory_id lekéréséhez használja a Workspace API-t:
curl -n -X GET -H 'Content-Type: application/json' -d '{"path": "/Users/me@example.com/MyFolder"}' \
https://<databricks-instance>/api/2.0/workspace/get-status
Ez egy példa az API-hívás válaszára:
{
"object_type": "DIRECTORY",
"path": "/Users/me@example.com/MyFolder",
"object_id": 123456789012345
}
Modellazonosító
A modell egy regisztrált MLflow-modellre utal, amely lehetővé teszi az éles MLflow-modellek kezelését fázisáttűnések és verziószámozás révén. A regisztrált modellazonosító szükséges a modell engedélyeinek programozott módon történő módosításához az Permissions API-n keresztül.
Regisztrált modell azonosítójának lekéréséhez használhatja a Workspace API-végpontotmlflow/databricks/registered-models/get
. A következő kód például a regisztrált modellobjektumot adja vissza a tulajdonságaival, beleértve annak azonosítóját is:
curl -n -X GET -H 'Content-Type: application/json' -d '{"name": "model_name"}' \
https://<databricks-instance>/api/2.0/mlflow/databricks/registered-models/get
A visszaadott érték formátuma:
{
"registered_model_databricks": {
"name":"model_name",
"id":"ceb0477eba94418e973f170e626f4471"
}
}
Feladat URL-címe és azonosítója
A feladat egy jegyzetfüzet vagy JAR azonnali vagy ütemezett futtatásának módja.
Feladat URL-címének lekéréséhez kattintson a Munkafolyamatok elemre az oldalsávon, és kattintson egy feladat nevére. A feladatazonosító az URL-címben szereplő szöveg #job/
után van. A feladat URL-címe szükséges a sikertelen feladatfuttatások kiváltó okának elhárításához.
A következő képernyőképen a feladat URL-címe a következő:
https://westus.azuredatabricks.net/?o=6280049833385130#job/1
Ebben a példában a feladat azonosítója.1