Získání identifikátorů pro objekty pracovního prostoru

Tento článek vysvětluje, jak získat pracovní prostor, klasický výpočetní objekt, řídicí panel, adresář, model, poznámkový blok a identifikátory úloh a adresy URL v Azure Databricks.

Názvy instancí pracovního prostoru, adresy URL a ID

Každému nasazení Azure Databricks se přiřadí jedinečný název instance, označovaný také jako adresa URL pro jednotlivé pracovní prostory. Jedná se o plně kvalifikovaný název domény používaný k přihlášení k nasazení Azure Databricks a k provádění požadavků rozhraní API.

V pracovním prostoru azure Databricks je místo, kde běží platforma Azure Databricks a kde můžete vytvářet clustery Spark a plánovat úlohy. Pracovní prostor má jedinečné číselné ID pracovního prostoru.

Adresa URL pro jednotlivé pracovní prostory

Jedinečná adresa URL pracovního prostoru má formát adb-<workspace-id>.<random-number>.azuredatabricks.net. ID pracovního prostoru se zobrazí hned za adb- a před tečkou (.). Pro adresu URL https://adb-5555555555555555.19.azuredatabricks.net/pracovního prostoru:

  • Adresa URL pracovního prostoru je https://adb-5555555555555555.19.azuredatabricks.net/
  • Název instance je adb-5555555555555555.19.azuredatabricks.net.
  • ID pracovního prostoru je 5555555555555555.

Určení adresy URL pro jednotlivé pracovní prostory

Můžete určit adresu URL pracovního prostoru pro jednotlivé pracovní prostory:

Starší regionální adresa URL

Důležité

Vyhněte se starším oblastním adresám URL. Oni:

  • S novými pracovními prostory nemusí fungovat.
  • Jsou méně spolehlivé a pomalejší než adresy URL pro jednotlivé pracovní prostory.
  • Může přerušit funkce, které vyžadují ID pracovního prostoru.

Starší oblastní adresa URL se skládá z oblasti, ve které je nasazený pracovní prostor Azure Databricks, a azuredatabricks.netdomény , například https://westus.azuredatabricks.net/.

  • Pokud se přihlásíte ke starší regionální adrese URL, například https://westus.azuredatabricks.net/, název instance je westus.azuredatabricks.net.
  • ID pracovního prostoru se zobrazí v adrese URL až po přihlášení pomocí starší místní adresy URL. Zobrazí se za o=. V adrese URL https://<databricks-instance>/?o=6280049833385130je 6280049833385130ID pracovního prostoru .

Adresa URL a ID výpočetního prostředku

Výpočetní prostředky Azure Databricks poskytují jednotnou platformu pro různé případy použití, jako je spouštění produkčních kanálů ETL, analýzy streamování, ad hoc analýzy a strojového učení. Každý klasický výpočetní prostředek má jedinečné ID označované jako ID clusteru. To platí pro clustery pro všechny účely i úlohy, ale ne pro bezserverové výpočetní prostředky. K získání podrobností o clusteru pomocí rozhraní REST API potřebujete ID clusteru.

Pokud chcete získat ID clusteru, klikněte na výpočetní ikonuCompute na bočním panelu a vyberte název clusteru. ID clusteru je číslo za komponentou /clusters/ v adrese URL této stránky.

https://<databricks-instance>/compute/clusters/<cluster-id>

Na následujícím snímku obrazovky je 0130-201722-abcdefghID clusteru .

Adresa URL clusteru

Adresa URL a ID řídicího panelu

Řídicí panel AI/BI je prezentace vizualizací dat a komentářů. Každý řídicí panel má jedinečné ID. Pomocí tohoto ID můžete vytvořit přímé odkazy, které obsahují přednastavené hodnoty filtru a parametrů, nebo získat přístup k řídicímu panelu pomocí rozhraní REST API.

  • Příklad adresy URL řídicího panelu:

    https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
  • Příklad ID řídicího panelu: 01ef9214fcc7112984a50575bf2b460f

Adresa URL a ID poznámkového bloku

Poznámkový blok je webové rozhraní pro dokument, který obsahuje spustitelný kód, vizualizace a text vyprávění. Poznámkové bloky jsou jedním rozhraním pro interakci s Azure Databricks. Každý poznámkový blok má jedinečné ID. Adresa URL poznámkového bloku má ID poznámkového bloku, proto je adresa URL poznámkového bloku jedinečná pro poznámkový blok. Můžete ho sdílet s kýmkoli na platformě Azure Databricks s oprávněním k zobrazení a úpravám poznámkového bloku. Každý příkaz poznámkového bloku (buňka) má navíc jinou adresu URL.

Pokud chcete najít adresu URL nebo ID poznámkového bloku, otevřete poznámkový blok. Pokud chcete najít adresu URL buňky, klikněte na obsah příkazu.

  • Příklad adresy URL poznámkového bloku:

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342`

  • Příklad ID poznámkového bloku: 1940481404050342.

  • Příklad adresy URL příkazu (buňky):

    https://adb-62800498333851.30.azuredatabricks.net/?o=6280049833385130#notebook/1940481404050342/command/2432220274659491

ID složky

Složka je adresář sloužící k ukládání souborů, které se dají použít v pracovním prostoru Azure Databricks. Tyto soubory můžou být poznámkové bloky, knihovny nebo podsložky. Ke každé složce a každé jednotlivé podsložce je přidružené konkrétní ID. Rozhraní API pro oprávnění odkazuje na toto ID jako directory_id a používá se v nastavení a aktualizaci oprávnění pro složku.

K načtení directory_id použijte rozhraní API pracovního prostoru:

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

Toto je příklad odpovědi na volání rozhraní API:

{
  "object_type": "DIRECTORY",
  "path": "/Users/me@example.com/MyFolder",
  "object_id": 123456789012345
}

ID modelu

Model odkazuje na zaregistrovaný model MLflow, který umožňuje spravovat modely MLflow v produkčním prostředí prostřednictvím přechodů fází a správy verzí. Zaregistrované ID modelu se vyžaduje pro změnu oprávnění v modelu prostřednictvím kódu programu prostřednictvím rozhraní API pro oprávnění.

K získání ID registrovaného modelu můžete použít koncového bodu rozhraní API mlflow/databricks/registered-models/get . Například následující kód vrátí zaregistrovaný objekt modelu s jeho vlastnostmi, včetně ID:

curl -n -X GET -H 'Content-Type: application/json' -d '{"name": "model_name"}' \
https://<databricks-instance>/api/2.0/mlflow/databricks/registered-models/get

Vrácená hodnota má formát:

{
  "registered_model_databricks": {
    "name": "model_name",
    "id": "ceb0477eba94418e973f170e626f4471"
  }
}

Adresa URL a ID úlohy

Úloha je způsob, jak spustit poznámkový blok nebo SOUBOR JAR okamžitě nebo podle plánu.

Pokud chcete získat adresu URL úlohy, klikněte na Úlohy ikona kanály na bočním panelu a klikněte na název úlohy. ID úlohy se zobrazí za /jobs/ adresou URL. Pomocí adresy URL úlohy přejděte k úloze a její historii spuštění. Pokud chcete vytvořit odkaz přímo na konkrétní spuštění, například pokud chcete sdílet lístek podpory, použijte místo toho adresu URL spuštění. Viz Adresa URL a ID spuštění úlohy.

Na následujícím snímku obrazovky je adresa URL úlohy:

https://adb-westus.18.azuredatabricks.net/jobs/5?o=1248852073749208

V tomto příkladu je 5ID úlohy .

Adresa URL úlohy

Adresa URL a ID spuštění úlohy

Jedna úloha může mít mnoho spuštění. Každé spuštění má vlastní jedinečné ID spuštění a vlastní adresu URL, která se liší od ID úlohy a adresy URL úlohy. Když sdílíte odkaz na konkrétní spuštění, například v lístku podpory, použijte místo adresy URL úlohy adresu URL spuštění, aby příjemce otevřel správné spuštění.

Adresa URL spuštění má formát:

https://<databricks-instance>/jobs/<job-id>/runs/<run-id>

Id spuštění nebo adresu URL najdete v uživatelském rozhraní pracovního prostoru:

  • Na kartě Spuštění úlohy kliknutím na odkaz ve sloupci Čas zahájení otevřete stránku s podrobnostmi o spuštění úlohy . ID spuštění se zobrazí na panelu Adresa prohlížeče za /runs/. Zkopírujte adresu ke sdílení spuštění.
  • Na stránce podrobností o spuštění úlohy obsahuje adresa URL na panelu Adresa ID úlohy i ID spuštění ve formuláři /jobs/<job-id>/runs/<run-id>.

Programové získání ID spuštění nebo adresy URL:

Note

Pro spuštění aktivovaná jinou úlohou, například úkol, který používá typ úlohy Spustit úlohu , parent_run_id určuje pole nadřazené spuštění. Viz Přidat oznámení k úloze.

  • Last updated on