Dapatkan pengidentifikasi untuk objek ruang kerja
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
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 adalahwestus.azuredatabricks.net
. - ID ruang kerja muncul di URL hanya setelah Anda masuk menggunakan URL regional lama. Itu muncul setelah
o=
. Di URLhttps://<databricks-instance>/?o=6280049833385130
, ID ruang kerja adalah6280049833385130
.
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 /clusters/
komponen di URL halaman ini
https://<databricks-instance>/#/setting/clusters/<cluster-id>
Pada tangkapan layar berikut, ID kluster adalah 0831-211914-clean632
.
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
.