取得工作區對象的標識碼

  • 發行項

本文說明如何在 Azure Databricks 中取得工作區、叢集、目錄、模型、筆記本和作業標識碼和 URL。

工作區實例名稱、URL 和標識碼

唯一的實例名稱也稱為個別工作區 URL，會指派給每個 Azure Databricks 部署。 這是用來登入 Azure Databricks 部署並提出 API 要求的完整功能變數名稱。

Azure Databricks 工作區是 Azure Databricks 平台執行的位置，您可以在其中建立 Spark 叢集和排程工作負載。 工作區具有唯一的數值工作區標識符。

每個工作區的 URL

唯一的個別工作區 URL 格式 adb-<workspace-id>.<random-number>.azuredatabricks.net為 。 工作區標識碼會緊接在 adb- 「dot」 （.） 之前出現。 針對個別工作區 URL https://adb-5555555555555555.19.azuredatabricks.net/：

  • 實體名稱稱為 adb-5555555555555555.19.azuredatabricks.net。
  • 工作區識別碼為 5555555555555555。

判斷個別工作區 URL

您可以判斷工作區的個別工作區 URL：

  • 當您登入時，請在瀏覽器中：

    Workspace

  • 在 Azure 入口網站 中，選取資源並注意 URL 欄位中的值：

    Workspace URL

  • 使用 Azure API。 請參閱 使用 Azure API 取得個別工作區 URL。

舊版區域 URL

重要

避免使用舊版區域 URL。 它們可能無法用於新工作區、較不可靠，且效能低於每個工作區 URL。

舊版區域 URL 是由部署 Azure Databricks 工作區加上網域 azuredatabricks.net的區域所組成， https://westus.azuredatabricks.net/例如 。

  • 如果您登入類似 的 https://westus.azuredatabricks.net/舊版區域 URL，則實例名稱為 westus.azuredatabricks.net。
  • 只有在您使用舊版區域 URL 登入之後，工作區標識碼才會出現在 URL 中。 它會出現在 o=之後。 在 URL https://<databricks-instance>/?o=6280049833385130中，工作區識別碼為 6280049833385130。

叢集 URL 和識別碼

Azure Databricks 叢集 為各種使用案例提供統一的平臺，例如執行生產 ETL 管線、串流分析、臨機操作分析和機器學習。 每個叢集都有稱為叢集標識碼的唯一標識符。 這同時適用於所有用途和作業叢集。 若要使用 REST API 取得叢集的詳細數據，叢集標識碼是不可或缺的。

若要取得叢集標識碼，請按下 提要欄位中的 [叢集] 索引 標籤，然後選取叢集名稱。 叢集標識碼是此頁面 URL 中元件之後 /clusters/ 的數位

https://<databricks-instance>/#/setting/clusters/<cluster-id>

在下列螢幕快照中，叢集識別碼為 0831-211914-clean632。

Cluster URL

筆記本 URL 和識別碼

筆記本是檔的網頁型介面，其中包含可執行的程式代碼、視覺效果和敘述文字。 筆記本是與 Azure Databricks 互動的一個介面。 每個筆記本都有唯一標識碼。 筆記本 URL 具有筆記本標識符，因此筆記本 URL 對筆記本而言是唯一的。 它可以與 Azure Databricks 平臺上的任何人共用，並有權檢視和編輯筆記本。 此外，每個筆記本命令 （cell） 都有不同的 URL。

若要尋找筆記本 URL 或識別碼，請開啟筆記本。 若要尋找儲存格 URL，請按下命令的內容。

  • 範例筆記本 URL：

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

  • 範例筆記本標識碼： 1940481404050342。

  • 範例命令 （cell） URL：

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

資料夾識別碼

資料夾是用來儲存可在 Azure Databricks 工作區中使用的檔案的目錄。 這些檔案可以是筆記本、連結庫或子資料夾。 每個資料夾和每個個別子資料夾都有相關聯的特定識別碼。 許可權 API 會將此識別碼稱為directory_id，並用於設定及更新資料夾的許可權。

若要擷取directory_id，請使用工作區 API：

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

這是 API 呼叫回應的範例：

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

Model ID

模型是指 已註冊 MLflow 的模型，可讓您透過階段轉換和版本控制來管理生產中的 MLflow 模型。 需要已註冊的模型標識碼，才能透過 許可權 API 以程式設計方式變更模型的許可權。

若要取得已註冊模型的識別碼，您可以使用 工作區 API 端點 mlflow/databricks/registered-models/get。 例如，下列程式代碼會傳回已註冊的模型物件及其屬性，包括其標識碼：

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

傳回的值的格式如下：

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

作業 URL 和識別碼

作業是立即或以排程方式執行筆記本或 JAR 的方式。

若要取得作業 URL，請按下 Jobs Icon提要字段中的 [工作流程 ]，然後按兩下作業名稱。 作業標識元位於 URL 中的文字 #job/ 之後。 需要作業 URL 才能針對失敗作業執行的根本原因進行疑難解答。

在下列螢幕快照中，作業 URL 為：

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

在這裡範例中，作業識別碼為 1。

Job URL