Share via

Munkaterület-objektumok azonosítóinak lekérése

  • Cikk

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:

Ö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 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. 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.

Fürt URL-címe

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 Munkafolyamatok ikona 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

Feladat URL-címe