Dapatkan pengidentifikasi untuk objek ruang kerja

Artikel ini menjelaskan cara mendapatkan ruang kerja, komputasi klasik, dasbor, direktori, model, buku catatan, 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 :

• URL ruang kerja adalahhttps://adb-5555555555555555.19.azuredatabricks.net/
• Nama instansnya adalah adb-5555555555555555.19.azuredatabricks.net.
• ID ruang kerja adalah 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 URL regional lama. Mereka:

• Ada kemungkinan tidak berfungsi dengan ruang kerja baru.
• Kurang andal dan lebih lambat daripada URL per ruang kerja.
• Dapat memutus fitur yang memerlukan ID 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 sumber daya komputasi

Sumber daya komputasi Azure Databricks menyediakan platform terpadu untuk berbagai kasus penggunaan seperti menjalankan alur ETL produksi, analitik streaming, analitik ad-hoc, dan pembelajaran mesin. Setiap sumber daya komputasi klasik memiliki ID unik yang disebut ID kluster. Ini berlaku untuk kluster semua tujuan dan pekerjaan, tetapi tidak komputasi tanpa server. Anda memerlukan ID kluster untuk mendapatkan detail kluster menggunakan REST API.

Untuk mendapatkan ID kluster, klik Komputasi pada bilah samping lalu pilih nama kluster. ID kluster adalah angka setelah /clusters/ komponen di URL halaman ini.

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

Pada tangkapan layar berikut, ID kluster adalah 0130-201722-abcdefgh.

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 Pekerjaan & Alur di bar samping dan klik nama pekerjaan. ID pekerjaan muncul setelah /jobs/ di URL. Gunakan URL pekerjaan untuk menavigasi ke pekerjaan dan riwayat eksekusinya. Untuk menautkan langsung ke eksekusi tertentu, misalnya untuk berbagi dalam tiket dukungan, gunakan URL eksekusi sebagai gantinya. Lihat URL dan ID eksekusi pekerjaan.

Dalam tangkapan layar berikut, URL pekerjaan adalah:

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

Dalam contoh ini, ID pekerjaan adalah 5.

URL dan ID eksekusi pekerjaan

Satu pekerjaan dapat memiliki banyak eksekusi. Setiap eksekusi memiliki ID eksekusi unik dan URL-nya sendiri, yang berbeda dari ID pekerjaan dan URL pekerjaan. Saat Anda berbagi tautan ke eksekusi tertentu, misalnya, dalam tiket dukungan, gunakan URL eksekusi daripada URL pekerjaan sehingga penerima membuka eksekusi yang benar.

URL eksekusi memiliki format:

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

Untuk menemukan ID eksekusi atau URL di UI ruang kerja:

• Pada tab Jalankan untuk pekerjaan, klik tautan di kolom Waktu mulai untuk membuka halaman Detail eksekusi pekerjaan . ID eksekusi muncul di bilah alamat browser setelah /runs/. Salin alamat untuk berbagi eksekusi.
• Pada halaman Detail eksekusi pekerjaan , URL di bilah alamat berisi ID pekerjaan dan ID eksekusi dalam formulir /jobs/<job-id>/runs/<run-id>.

Untuk mendapatkan ID eksekusi atau URL secara terprogram:

• API Pekerjaan: Panggil Dapatkan titik akhir eksekusi pekerjaan tunggal . Respons mencakup run_id dan run_page_url, yang merupakan tautan UI langsung ke eksekusi.
• Tabel sistem: Tabel system.lakeflow.job_run_timeline menyertakan kolom job_id dan run_id . Lihat Referensi tabel sistem pekerjaan.

Nota

Untuk eksekusi yang dipicu oleh pekerjaan lain, misalnya tugas yang menggunakan jenis tugas Jalankan Pekerjaan , parent_run_id bidang mengidentifikasi eksekusi induk. Lihat Menambahkan pemberitahuan pada pekerjaan.