Dapatkan pengidentifikasi untuk objek ruang kerja

Artikel
01/23/2025

Artikel ini menjelaskan cara mendapatkan ruang kerja, kluster, dasbor, direktori, model, notebook, dan pengidentifikasi pekerjaan dan URL di Azure Databricks.

Nama instans ruang kerja, URL, dan ID

Nama instans unik, juga dikenal sebagai URL per ruang kerja, ditetapkan untuk setiap penyebaran Azure Databricks. Ini adalah nama domain yang sepenuhnya memenuhi syarat yang digunakan untuk masuk ke penyebaran Azure Databricks Anda dan membuat permintaan API.

ruang kerja Azure Databricks adalah tempat platform Azure Databricks berjalan dan tempat Anda dapat membuat kluster Spark dan menjadwalkan beban kerja. Ruang kerja memiliki ID ruang kerja numerik yang unik.

URL per ruang kerja

URL per ruang kerja ini memiliki format adb-<workspace-id>.<random-number>.azuredatabricks.net. ID ruang kerja muncul segera setelah adb- dan sebelum "titik" (.). Untuk URL https://adb-5555555555555555.19.azuredatabricks.net/per ruang kerja :

Nama instans adalah adb-5555555555555555.19.azuredatabricks.net.
ID ruang kerja 5555555555555555.

Menentukan URL per ruang kerja

Anda dapat menentukan URL per ruang kerja untuk ruang kerja Anda:

Di browser Anda saat Anda masuk:
Di portal Microsoft Azure, dengan memilih sumber daya dan mencatat nilai di bidang URL :
Menggunakan API Azure. Lihat Dapatkan URL untuk setiap ruang kerja menggunakan Azure API.

URL regional lama

Penting

Hindari menggunakan URL regional lama. Ini mungkin tidak berfungsi untuk ruang kerja baru, akan kurang dapat diandalkan, dan akan menunjukkan performa yang lebih rendah daripada URL per ruang kerja.

URL regional warisan terdiri dari wilayah tempat ruang kerja Azure Databricks disebarkan ditambah domain azuredatabricks.net, misalnya, https://westus.azuredatabricks.net/.

Jika Anda masuk ke URL regional lama seperti https://westus.azuredatabricks.net/, nama instans adalah westus.azuredatabricks.net.
ID ruang kerja muncul di URL hanya setelah Anda masuk menggunakan URL regional lama. Itu muncul setelah o=. Di URL https://<databricks-instance>/?o=6280049833385130, ID ruang kerja adalah 6280049833385130.

URL dan ID Kluster

Kluster Azure Databricks menyediakan platform terpadu untuk berbagai kasus penggunaan seperti menjalankan alur ETL produksi, analitik streaming, analitik ad-hoc, dan pembelajaran mesin. Setiap kluster memiliki ID unik yang disebut ID kluster. Ini berlaku untuk semua tujuan dan kelompok pekerjaan. Untuk mendapatkan detail kluster menggunakan REST API, ID kluster sangat penting.

Untuk mendapatkan ID kluster, klik tab Kluster di bar samping lalu pilih nama kluster. ID kluster adalah angka setelah /clusters/ komponen di URL halaman ini

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

Pada tangkapan layar berikut, ID kluster adalah 0831-211914-clean632.

URL Kluster

URL dan ID Dasbor

Dasbor AI/BI adalah presentasi visualisasi dan komentar data. Setiap dasbor memiliki ID unik. Anda dapat menggunakan ID ini untuk membuat tautan langsung yang menyertakan nilai filter dan parameter prasetel, atau mengakses dasbor menggunakan REST API.

Contoh URL dasbor:

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

CONTOH ID dasbor: 01ef9214fcc7112984a50575bf2b460f

URL dan ID Buku Catatan

Buku catatan adalah antarmuka berbasis web ke dokumen yang berisi kode, teks deskriptif, dan visualisasi. Buku catatan adalah salah satu antarmuka untuk berinteraksi dengan Azure Databricks. Setiap buku catatan memiliki ID unik. URL buku catatan memiliki ID buku catatan, maka URL buku catatan unik untuk buku catatan. Ini dapat dibagikan dengan siapa pun di platform Azure Databricks dengan izin untuk melihat dan mengedit buku catatan. Selain itu, setiap perintah buku catatan (sel) memiliki URL yang berbeda.

Untuk menemukan URL atau ID buku catatan, buka buku catatan. Untuk menemukan URL sel, klik konten perintah.

Contoh URL buku catatan:

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

Contoh ID buku catatan: 1940481404050342.

Contoh URL perintah (sel):

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

ID Folder

Folder adalah direktori yang digunakan untuk menyimpan file yang dapat digunakan di ruang kerja Azure Databricks. File-file ini bisa berupa buku catatan, pustaka, atau subfolder. Ada id tertentu yang terkait dengan setiap folder dan setiap sub-folder individual. API Izin mengacu pada id ini sebagai directory_id dan digunakan dalam mengatur dan memperbarui izin untuk folder.

Untuk mengambil directory_id , gunakan Ruang Kerja 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

Ini adalah contoh respons panggilan API:

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

ID Model

Model mengacu pada model terdaftar MLflow, yang memungkinkan Anda mengelola Model MLflow dalam produksi melalui transisi tahap dan pembuatan versi. ID model terdaftar diperlukan untuk mengubah izin pada model secara terprogram melalui API Izin.

Untuk mendapatkan ID model terdaftar, Anda dapat menggunakan Workspace API titik akhir mlflow/databricks/registered-models/get. Misalnya, kode berikut mengembalikan objek model terdaftar dengan propertinya, termasuk ID-nya:

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

Nilai yang dikembalikan memiliki format:

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

URL dan ID Pekerjaan

Pekerjaan adalah cara menjalankan buku catatan atau JAR baik segera ataupun menurut jadwal.

Untuk mendapatkan URL pekerjaan, klik Ikon Alur Kerja Alur Kerja di bilah samping dan klik nama pekerjaan. ID pekerjaan adalah setelah #job/ teks di URL. URL pekerjaan diperlukan untuk memecahkan masalah akar penyebab eksekusi pekerjaan yang gagal.

Dalam tangkapan layar berikut, URL pekerjaan adalah:

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

Dalam contoh ini, ID pekerjaan adalah 1.

URL Pekerjaan

Bagikan melalui