Abrufen von Bezeichnern für Arbeitsbereichsobjekte

In diesem Artikel wird erläutert, wie Sie Arbeitsbereichs-, klassische Compute-, Dashboard-, Verzeichnis-, Modell-, Notizbuch- und Auftragsbezeichner und -URLs in Azure Databricks abrufen.

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/:

• Die Arbeitsbereichs-URL lautet https://adb-5555555555555555.19.azuredatabricks.net/
• Der Name der Instanz lautet adb-5555555555555555.19.azuredatabricks.net.
• Die Arbeitsbereichs-ID lautet 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

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.

Berechnen der Ressourcen-URL und -ID

Azure Databricks-Computeressourcen bieten eine einheitliche Plattform für verschiedene Anwendungsfälle wie das Ausführen von ETL-Pipelines für die Produktion, Streaming analytics, Ad-hoc-Analysen und maschinelles Lernen. Jede klassische Computeressource verfügt über eine eindeutige ID, die als Cluster-ID bezeichnet wird. Dies gilt sowohl für allzweck- als auch für Auftragscluster, aber nicht für serverlose Berechnung. Sie benötigen die Cluster-ID, um die Details eines Clusters mithilfe der REST-API abzurufen.

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

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

Im folgenden Screenshot ist die Cluster-ID 0130-201722-abcdefgh.

Dashboard-URL und -ID

Ein AI/BI-Dashboard ist eine Darstellung von Datenvisualisierungen und Kommentaren. Jedes Dashboard verfügt über eine eindeutige ID. Sie können diese ID verwenden, um direkte Links zu erstellen, die vordefinierte Filter- und Parameterwerte enthalten, oder über die REST-API auf das Dashboard zugreifen.

• Beispiel-Dashboard-URL:

  https://adb-62800498333851.30.azuredatabricks.net/sql/dashboardsv3/01ef9214fcc7112984a50575bf2b460f
  

• Beispiel-Dashboard-ID: 01ef9214fcc7112984a50575bf2b460f

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 auf der Randleiste auf und Pipelines ", und klicken Sie auf einen Auftragsnamen. Die Auftrags-ID wird hinter /jobs/ der URL angezeigt. Verwenden Sie die Auftrags-URL, um zu einem Auftrag und dem Ausführungsverlauf zu navigieren. Um direkt mit einer bestimmten Ausführung zu verknüpfen, z. B. zum Freigeben in einem Supportticket, verwenden Sie stattdessen die Ausführungs-URL. Siehe Auftragsausführungs-URL und ID.

Im folgenden Screenshot ist die Auftrags-URL:

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

In diesem Beispiel ist die Auftrags-ID 5.

Auftragsausführungs-URL und ID

Ein einzelner Auftrag kann viele Läufe aufweisen. Jede Ausführung verfügt über eine eigene eindeutige Ausführungs-ID und eine eigene URL, die sich von der Auftrags-ID und Auftrags-URL unterscheidet. Wenn Sie einen Link zu einer bestimmten Ausführung freigeben, z. B. in einem Supportticket, verwenden Sie die Ausführungs-URL anstelle der Auftrags-URL, damit der Empfänger die richtige Ausführung öffnet.

Die Ausführungs-URL weist das Format auf:

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

So suchen Sie die Ausführungs-ID oder URL in der Arbeitsbereichs-UI:

• Klicken Sie auf der Registerkarte "Ausführen " für einen Auftrag auf den Link in der Spalte "Startzeit ", um die Seite " Auftragsausführungsdetails " zu öffnen. Die Ausführungs-ID wird in der Adressleiste des Browsers nach /runs/. Kopieren Sie die Adresse, um die Ausführung freizugeben.
• Auf der Seite " Auftragsausführungsdetails " enthält die URL in der Adressleiste sowohl die Auftrags-ID als auch die Ausführungs-ID im Formular /jobs/<job-id>/runs/<run-id>.

So rufen Sie die Ausführungs-ID oder URL programmgesteuert ab:

• Auftrags-API: Rufen Sie den Endpunkt zum Abrufen eines einzelnen Auftrags auf . Die Antwort enthält run_id und run_page_url, was die direkte UI-Verknüpfung mit der Ausführung ist.
• Systemtabellen: Die system.lakeflow.job_run_timeline Tabelle enthält beide job_id und run_id Spalten. Weitere Informationen finden Sie unter Auftragssystemtabellenreferenz.