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

Článek
10/31/2024

Tento článek vysvětluje, jak získat pracovní prostor, cluster, ří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.

Pracovní prostor 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:

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:

V prohlížeči, když jste přihlášení:
Na webu Azure Portal vyberte prostředek a označte hodnotu v poli adresa URL :
Pomocí rozhraní Azure API. Viz Získání adresy URL pro jednotlivé pracovní prostory pomocí rozhraní Azure API.

Starší regionální adresa URL

Důležité

Nepoužívejte starší regionální adresy URL. Nemusí fungovat pro nové pracovní prostory, jsou méně spolehlivé a vykazují nižší výkon než adresy URL pro jednotlivé pracovní prostory.

Starší oblastní adresa URL se skládá z oblasti, ve které je nasazený pracovní prostor Azure Databricks, a také z domény azuredatabricks.net, 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 clusteru

Cluster Azure Databricks poskytuje 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ý cluster má jedinečné ID označované jako ID clusteru. To platí pro clustery pro všechny účely i úlohy. K získání podrobností o clusteru pomocí rozhraní REST API je důležité ID clusteru.

Pokud chcete získat ID clusteru, klikněte na kartu Clustery 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>/#/setting/clusters/<cluster-id>

Na následujícím snímku obrazovky je 0831-211914-clean632ID 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ý bod mlflow/databricks/registered-models/getrozhraní API pracovního prostoru . 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.

Adresu URL úlohy získáte kliknutím na Pracovní postupy na bočním panelu a kliknutím na název úlohy. ID úlohy je za textem #job/ v adrese URL. Adresa URL úlohy je nutná k řešení původní příčiny neúspěšných spuštění úloh.

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

https://westus.azuredatabricks.net/?o=6280049833385130#job/1

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

Adresa URL úlohy

Sdílet prostřednictvím