Abrufen von Bezeichnern für Arbeitsbereichsobjekte

Artikel
03/01/2024

In diesem Artikel wird erläutert, wie Sie Arbeitsbereichs-, Cluster-, Verzeichnis-, Modell-, Notebook- und Auftragsbezeichner und URLs in Azure Databricks erhalten.

Instanznamen, URLs und IDs von Arbeitsbereichen

Jeder Azure Databricks-Bereitstellung wird ein eindeutiger Instanzname zugewiesen, auch arbeitsbereichsspezifische URL genannt, zugewiesen. Dies ist der vollqualifizierte Domänenname, der verwendet wird, um sich bei Ihrer Azure Databricks-Bereitstellung anzumelden und API-Anforderungen zu stellen.

Im Azure Databricks-Arbeitsbereich wird die Azure Databricks-Plattform ausgeführt, und Sie können Spark-Cluster erstellen und Workloads planen. Ein Arbeitsbereich verfügt über eine eindeutige numerische Arbeitsbereichs-ID.

Arbeitsbereichsspezifische URL

Diese eindeutige arbeitsbereichsspezifische URL hat das Format adb-<workspace-id>.<random-number>.azuredatabricks.net. Die Arbeitsbereichs-ID wird unmittelbar nach adb- und vor dem Punkt (.) angezeigt. Für die arbeitsbereichspezifische URL https://adb-5555555555555555.19.azuredatabricks.net/:

Der Instanzenname ist adb-5555555555555555.19.azuredatabricks.net.
Die Arbeitsbereich-ID ist 5555555555555555.

Arbeitsbereichspezifische URL ermitteln

Sie können die arbeitsbereichsspezifische URL für Ihren Arbeitsbereich ermitteln:

In Ihrem Browser, wenn Sie angemeldet sind:
Wählen Sie im Azure-Portal die Ressource aus, und notieren Sie sich den Wert im Feld URL:
Mit der Azure API. Siehe Abrufen einer Arbeitsbereichs-URL mithilfe der Azure-API.

Regionale Legacy-URL

Wichtig

Vermeiden Sie die Verwendung von älteren regionalen URLs. Sie funktioniert möglicherweise nicht für neue Arbeitsbereiche, ist weniger zuverlässig und weist eine geringere Leistung als arbeitsbereichsspezifische URLs auf.

Die regionale Legacy-URL besteht aus der Region, in der Azure Databricks-Arbeitsbereich bereitgestellt wird, sowie der Domäne azuredatabricks.net, z. B. https://westus.azuredatabricks.net/.

Wenn Sie sich bei einer regionalen Legacy-URL wie https://westus.azuredatabricks.net/ anmelden, ist der Instanzname westus.azuredatabricks.net.
Die Arbeitsbereichs-ID wird erst in der URL angezeigt, nachdem Sie sich mit einer regionalen Legacy-URL angemeldet haben. Er wird nach o= angezeigt. In der URL https://<databricks-instance>/?o=6280049833385130 ist die Arbeitsbereichs-ID 6280049833385130.

Cluster-URL und -ID

Ein Azure Databricks-Cluster bietet eine einheitliche Plattform für verschiedene Anwendungsfälle wie das Ausführen von ETL-Produktionspipelines, Streaminganalysen, Ad-hoc-Analysen und maschinellem Lernen. Jedes Cluster verfügt über eine eindeutige ID, die als Cluster-ID bezeichnet wird. Dies gilt sowohl für Allzweck- als auch für Auftragscluster. Um die Details eines Clusters mithilfe der REST-API zu erhalten, ist die Cluster-ID von entscheidender Bedeutung.

Um die Cluster-ID zu erhalten, klicken Sie in der Randleiste auf die Registerkarte Cluster, und wählen Sie dann einen Clusternamen aus. Die Cluster-ID ist die Nummer nach der Komponente /clusters/ in der URL dieser Seite.

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

Im folgenden Screenshot ist die Cluster-ID 0831-211914-clean632.

Cluster URL

Notebook-URL und -ID

Ein Notebook ist eine webbasierte Oberfläche für ein Dokument, das ausführbaren Code, Visualisierungen und beschreibenden Text enthält. Notebooks sind eine Schnittstelle für die Interaktion mit Azure Databricks. Jedes Notebook hat eine eindeutige ID. Die Notebook-URL enthält die Notebook-ID, daher ist die Notebook-URL für ein Notebook eindeutig. Sie kann für alle Benutzer auf der Azure Databricks-Plattform mit der Berechtigung zum Anzeigen und Bearbeiten des Notebooks freigegeben werden. Darüber hinaus verfügt jeder Notebookbefehl (Zelle) über eine andere URL.

Öffnen Sie ein Notebook, um nach einer Notebook-URL oder -ID zu suchen. Klicken Sie auf den Inhalt des Befehls, um eine Zellen-URL zu suchen.

Beispielnotebook-URL:

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

Beispielnotebook-ID: 1940481404050342.

Beispielbefehls-URL (Zelle):

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

Ordner-ID

Ein Ordner ist ein Verzeichnis, das zum Speichern von Dateien verwendet wird, die im Azure Databricks-Arbeitsbereich verwendet werden können. Diese Dateien können Notizbücher, Bibliotheken oder Unterordner sein. Jedem Ordner und jedem einzelnen Unterordner ist eine bestimmte ID zugeordnet. Die Berechtigungs-API bezieht sich auf diese ID als directory_id und wird in der Einstellung und Aktualisierung von Berechtigungen für einen Ordner verwendet.

Verwenden Sie die Arbeitsbereichs-API, um directory_id abzurufen:

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

Dies ist ein Beispiel für die API-Aufrufantwort:

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

Modell-ID

Ein Modell bezieht sich auf ein bei MLflow registriertes Modell, mit dem Sie MLflow-Modelle in der Produktion über Phasenübergänge und Versionswechsel verwalten können. Die registrierte Modell-ID ist erforderlich, um die Berechtigungen für das Modell programmgesteuert über die Berechtigungs-API zu ändern.

Um die ID eines registrierten Modells abzurufen, können Sie den Endpunkt Arbeitsbereichs-API verwendenmlflow/databricks/registered-models/get. Der folgende Code gibt z. B. das registrierte Modellobjekt mit seinen Eigenschaften zurück, einschließlich seiner 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

Der zurückgegebene Wert hat das Format:

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

Auftrags-URL und -ID

Ein Auftrag ist eine Möglichkeit, ein Notebook oder JAR entweder sofort oder nach Zeitplan auszuführen.

Um eine Auftrags-URL zu erhalten, klicken Sie in der Seitenleiste auf das Workflows und dann auf einen Auftragsnamen. Die Auftrags-ID befindet sich hinter dem Text #job/ in der URL. Die Auftrags-URL ist erforderlich, um die Grundursache für fehlerhafte Auftragsausführungen zu beheben.

Im folgenden Screenshot ist die Auftrags-URL:

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

In diesem Beispiel ist die Auftrags-ID 1.

Job URL