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

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 neve westus.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ímben https://<databricks-instance>/?o=6280049833385130a 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