Munkaterület-objektumok azonosítóinak lekérése
Ez a cikk bemutatja, hogyan szerezheti meg a munkaterület, fürt, irányítópult, könyvtár, modell, jegyzetfüzet és feladat azonosítóit és URL-jeit az Azure Databricks rendszerben.
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ület az a hely, ahol az Azure Databricks platform fut, és ahol Spark-fürtöket hozhat létre, valamint számítási feladatokat ütemezhet. 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 APIhaszná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, valamint a tartomány azuredatabricks.net
( például https://westus.azuredatabricks.net/
) áll.
- 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. A klaszter részleteinek lekéréséhez a REST API-n keresztül elengedhetetlen a klaszterazonosító.
A fürtazonosító lekéréséhez kattintson a fürtök fülre az oldalsávon, 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
.
Irányítópult URL-címe és azonosítója
Az AI/BI-irányítópult adatvizualizációk és kommentárok bemutatója. Minden irányítópult egyedi azonosítóval rendelkezik. Ezzel az azonosítóval olyan közvetlen hivatkozásokat hozhat létre, amelyek előre beállított szűrő- és paraméterértékeket tartalmaznak, vagy elérheti az irányítópultot a REST API használatával.
Példa irányítópult URL-címe:
https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
Példa irányítópult-azonosítóra:
01ef9214fcc7112984a50575bf2b460f
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.
Egy regisztrált modell azonosítójának lekéréséhez használhatja a Workspace API végpontot mlflow/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 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