Mengautentikasi dengan token akses pribadi Azure Databricks (warisan)

Azure Databricks token akses pribadi (PATs) memungkinkan Anda mengautentikasi ke sumber daya dan API di tingkat ruang kerja. Anda dapat menyimpannya dalam variabel lingkungan atau profil Azure Databricks konfigurasi. Setiap PAT hanya berlaku untuk satu ruang kerja, dan pengguna dapat membuat hingga 600 PATs per ruang kerja. Azure Databricks secara otomatis mencabut PAT yang belum digunakan selama 90 hari.

Penting

Jika memungkinkan, Databricks merekomendasikan penggunaan OAuth alih-alih PATs untuk autentikasi akun pengguna karena OAuth memberikan keamanan yang lebih kuat. Untuk mempelajari cara mengautentikasi dengan akun pengguna Databricks menggunakan OAuth, lihat Otorisasi akses pengguna ke Azure Databricks dengan OAuth.

Anda tidak dapat menggunakan token akses pribadi untuk mengotomatiskan fungsionalitas Azure Databricks account-level. Sebagai gantinya, gunakan token Microsoft Entra ID admin akun Azure Databricks. Azure Databricks admin akun dapat menjadi pengguna atau perwakilan layanan. Untuk informasi selengkapnya, lihat:

Membuat token akses pribadi untuk pengguna ruang kerja

Untuk membuat token akses pribadi untuk pengguna ruang kerja Azure Databricks Anda, lakukan hal berikut:

Di ruang kerja Azure Databricks Anda, klik nama pengguna Anda di bilah atas dan pilih Settings.
Klik Pengembang.
Di samping Token akses, klik Kelola.
Klik Buat token baru.
Masukkan nama yang membantu Anda mengidentifikasi token ini nanti.
Atur masa pakai token dalam hari. Lihat Mengatur masa pakai maksimum token akses pribadi baru.
Pilih jenis cakupan dan tambahkan cakupan API. Pilih BI Tools untuk alat yang tersambung ke gudang Databricks SQL seperti Tableau atau Power BI, atau pilih PI lain untuk memilih cakupan secara manual. Lihat Token akses pribadi dengan cakupan spesifik.
Untuk mengaktifkan auto-scoping token ini, aktifkan token Auto-scope. Auto-scoping secara otomatis mempersempit cakupan token ke API yang digunakan, menerapkan cakupan all-apis untuk sementara selama periode observasi. Opsi ini hanya muncul ketika admin telah mengaktifkan pratinjau auto-scoping untuk workspace Anda, dan auto-scoping hanya berlaku untuk token dengan masa hidup lebih dari 30 hari. Lihat penentuan cakupan otomatis untuk token akses pribadi.
Klik Hasilkan.
Salin token yang ditampilkan ke lokasi aman, lalu klik Selesai. Simpan token dengan aman dan jangan bagikan. Jika Anda kehilangannya, Anda harus membuat token baru.

Jika Anda tidak dapat membuat atau menggunakan token, administrator ruang kerja Anda mungkin telah menonaktifkan token atau tidak memberi Anda izin. Lihat administrator ruang kerja Anda atau berikut ini:

Token akses pribadi terlingkup

Token akses pribadi terlingkup membatasi izin token untuk operasi API tertentu. Alih-alih memberikan akses ruang kerja penuh, Anda menetapkan satu atau beberapa cakupan API, seperti sql, , unity-catalogatau scim, yang membatasi operasi REST API yang dapat dipanggil token.

Peringatan

Token dengan authentication cakupan dapat membuat token baru dengan cakupan apa pun. Berikan cakupan ini hanya untuk token yang perlu mengelola token lain.

Untuk membuat token cakupan di UI ruang kerja, pilih jenis cakupan dan tambahkan cakupan API saat Anda membuat token baru. Pilih BI Tools untuk alat yang tersambung ke gudang Databricks SQL seperti Tableau atau Power BI, atau pilih PI lain untuk memilih cakupan secara manual.

Untuk daftar lengkap cakupan dan operasi API terkait, lihat Cakupan API.

Penentuan cakupan otomatis untuk token akses pribadi

Cakupan otomatis secara otomatis mempersempit izin token hanya ke API yang digunakannya secara aktif. Azure Databricks mengamati penggunaan API token selama periode 30 hari, lalu menerapkan scope yang disimpulkan. Auto-scoping berjalan sekali per token. Selama periode observasi, token tetap memiliki akses penuh ke workspace (scope all-apis ). Azure Databricks mengirim email pengingat 7 hari sebelum penegakan dan email penegakan saat cakupan yang diinferensikan diterapkan.

Kontrol cakupan otomatis

Pratinjau ruang kerja (dikendalikan admin): Seorang admin mengaktifkan atau menonaktifkan pratinjau cakupan otomatis untuk seluruh ruang kerja dari konsol akun atau halaman Pratinjau ruang kerja. Lihat Kelola Pratinjau Azure Databricks.
Pengaturan per token (autoscope_enabled): Saat pratinjau diaktifkan, setiap token ikut serta atau tidak secara individual saat dibuat.

Auto-scoping hanya berlaku untuk token dengan masa hidup lebih dari 30 hari. Ini termasuk token baru yang dibuat dengan auto-scoping yang diaktifkan dan token jangka panjang yang sudah ada. Untuk token yang memenuhi syarat yang sudah ada, periode observasi 30 hari dimulai ketika admin mengaktifkan pratinjau. Azure Databricks menerapkan cakupan yang disimpulkan pada akhir periode tersebut dan mengirim email pengingat 7 hari sebelum diberlakukan, dengan jadwal yang sama seperti token auto-scoped yang baru dibuat.

Keluar dari auto-scoping

Satu token, sebelum penerapan: Atur token ke lingkup tertentu di UI workspace (Pengaturan>Developer>Access Tokens>Manage, lalu klik Update token) atau dengan Token API (lihat Update the scopes of a personal access token). Mengatur scope tertentu menghentikan auto-scoping secara permanen untuk token tersebut. Menyetel token kembali ke cakupan all-apis (scopes array kosong) adalah no-op dan tidak menghentikan auto-scoping. Untuk mempertahankan token dengan akses penuh all-apis yang tidak pernah auto-scope, buat token baru dengan auto-scoping dinonaktifkan.
Seluruh ruang kerja: Minta admin untuk mematikan pratinjau auto-scoping di halaman Pratinjau . Lihat Kelola Pratinjau Azure Databricks.

Setelah penegakan selesai, auto-scoping tidak berjalan lagi untuk token tersebut, sehingga Anda dapat mengatur cakupannya secara bebas, termasuk kembali ke all-apis.

Catatan

Opt-out UI workspace hanya berlaku untuk token yang Anda miliki. Untuk menonaktifkan token prinsipal layanan, atur cakupannya dengan permintaan PATCH /api/2.0/token/{token_id_sha256} sebagai gantinya.

Untuk meninjau status auto-scoping dan cakupan yang disimpulkan untuk token Anda, lihat Tinjau status auto-scoping dan cakupan yang disimpulkan untuk token.

Membuat token akses pribadi untuk perwakilan layanan

Perwakilan layanan dapat membuat token akses pribadi untuk dirinya sendiri.

Jalankan perintah berikut untuk menghasilkan token akses:
```
databricks tokens create \
  --lifetime-seconds <lifetime-seconds> \
  -p <profile-name>
```
Ganti nilai berikut:
- <lifetime-seconds>: Masa pakai token dalam detik, seperti 86400 selama 1 hari. Diatur ke maksimum ruang kerja (biasanya 730 hari).
- <profile-name>: Profil konfigurasi dengan informasi autentikasi. Secara default menjadi DEFAULT.
Salin token_value dari respons, yang merupakan token akses untuk perwakilan layanan Anda. Simpan token dengan aman dan jangan bagikan. Jika Anda kehilangannya, Anda harus membuat token baru.

Melakukan autentikasi token akses pribadi

Untuk mengonfigurasi autentikasi token akses pribadi Azure Databricks, atur variabel lingkungan terkait berikut, bidang .databrickscfg, bidang Terraform, atau bidang Config:

Host Azure Databricks, ditentukan sebagai URL Azure Databricks per-workspace target, misalnya https://adb-1234567890123456.7.azuredatabricks.net.
Token akses pribadi Azure Databricks untuk akun pengguna Azure Databricks.

Untuk melakukan Azure Databricks autentikasi token akses pribadi, integrasikan hal berikut dalam kode Anda, berdasarkan alat atau SDK yang berpartisipasi:

Lingkungan

Untuk menggunakan variabel lingkungan untuk jenis autentikasi Azure Databricks tertentu dengan alat atau SDK, maka lihat Otorisasi akses ke sumber daya Azure Databricks atau dokumentasi alat atau SDK. Lihat juga Variabel dan bidang lingkungan untuk autentikasi terpadu dan prioritas metode Autentikasi.

Atur variabel lingkungan berikut:

DATABRICKS_HOST, atur ke URL Azure Databricks per-workspace, misalnya https://adb-1234567890123456.7.azuredatabricks.net.
DATABRICKS_TOKEN, diatur menjadi string token.

Profil

Buat atau identifikasi profil Azure Databricks configuration dengan bidang berikut dalam file .databrickscfg Anda. Jika Anda membuat profil, ganti placeholder dengan nilai sesuai. Untuk menggunakan profil dengan alat atau SDK, lihat Mengotorisasi akses ke sumber daya Azure Databricks atau dokumentasi alat atau SDK tersebut. Lihat juga Variabel dan bidang lingkungan untuk autentikasi terpadu dan prioritas metode Autentikasi.

Atur nilai berikut dalam file .databrickscfg Anda. Dalam hal ini, host adalah URL Azure Databricks per-workspace, misalnya https://adb-1234567890123456.7.azuredatabricks.net:

[<some-unique-configuration-profile-name>]
host  = <workspace-url>
token = <token>

Alih-alih mengatur nilai secara manual, Anda dapat menggunakan Databricks CLI untuk mengatur nilai-nilai ini sebagai gantinya:

Catatan

Prosedur berikut menggunakan Databricks CLI untuk membuat profil konfigurasi Azure Databricks dengan nama DEFAULT. Jika Anda sudah memiliki profil konfigurasi DEFAULT, prosedur ini akan menimpa profil konfigurasi Anda yang ada DEFAULT.

Untuk memeriksa apakah Anda sudah memiliki DEFAULT profil konfigurasi, dan untuk melihat pengaturan profil ini jika ada, gunakan Databricks CLI untuk menjalankan perintah databricks auth env --profile DEFAULT.

Untuk membuat profil konfigurasi dengan nama selain DEFAULT, ganti DEFAULT bagian --profile DEFAULT dalam perintah berikut databricks configure dengan nama yang berbeda untuk profil konfigurasi.

Gunakan Databricks CLI untuk membuat profil konfigurasi Azure Databricks bernama DEFAULT yang menggunakan autentikasi token akses pribadi Azure Databricks. Untuk melakukannya, jalankan perintah berikut:
```
databricks configure --profile DEFAULT
```
Untuk perintah Databricks Host, masukkan URL Azure Databricks per-workspace Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net.
Untuk prompt Token Akses Personal, masukkan token akses pribadi Azure Databricks untuk ruang kerja Anda.

antarmuka baris perintah (CLI)

Untuk Databricks CLI, jalankan databricks configure perintah . Pada perintah, masukkan pengaturan berikut:

Host Azure Databricks, ditentukan sebagai URL Azure Databricks per-workspace target, misalnya https://adb-1234567890123456.7.azuredatabricks.net.
Token akses pribadi Azure Databricks untuk akun pengguna Azure Databricks.

Untuk informasi selengkapnya, lihat Autentikasi token akses pribadi (warisan).

Sambungkan

Catatan

Azure Databricks autentikasi token akses pribadi didukung pada versi Databricks Connect berikut:

Untuk Python, Databricks Connect untuk Databricks Runtime 13.3 LTS dan versi yang lebih baru.
Untuk Scala, Databricks Connect untuk Databricks Runtime 13.3 LTS dan versi yang lebih baru.

Untuk Databricks Connect, gunakan Databricks CLI untuk mengatur nilai dalam file .databrickscfg Anda, untuk operasi tingkat Azure Databricks workspace seperti yang ditentukan di bagian Profile.

Prosedur berikut membuat profil konfigurasi Azure Databricks bernama DEFAULT, yang menimpa profil DEFAULT yang ada. Untuk memeriksa apakah DEFAULT profil ada, jalankan databricks auth env --profile DEFAULT. Jika ada, gunakan nama profil yang berbeda.

Jalankan perintah berikut untuk membuat profil konfigurasi Azure Databricks bernama DEFAULT yang menggunakan autentikasi token akses pribadi.
```
databricks configure \
  --configure-cluster \
  --profile DEFAULT
```
Untuk perintah Databricks Host, masukkan URL Azure Databricks per-workspace Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net.
Untuk perintah Token Akses Pribadi, masukkan token akses pribadi untuk ruang kerja Anda.
Dalam daftar kluster yang tersedia, pilih target Azure Databricks kluster di ruang kerja Anda. Anda dapat mengetik bagian mana pun dari nama tampilan kluster untuk memfilter daftar kluster yang tersedia.

Gunakan REST API Azure Databricks untuk mengeluarkan token akses pribadi

Azure Databricks menyediakan titik akhir REST /api/2.0/token/create untuk menerbitkan PAT. Lihat Membuat token pengguna untuk detail API.

Dalam contoh berikut, atur nilai-nilai ini:

<databricks-instance>: URL ruang kerja Databricks Anda. Contohnya,dbc-abcd1234-5678.cloud.databricks.com.
<your-existing-access-token>: PAT (string) valid yang ada yang memiliki izin untuk membuat token baru.
<lifetime-seconds>: Masa pakai token dalam hitung detik.
<scopes>: Daftar scope yang akan ditetapkan ke token, atau array kosong ([]) untuk memberikan akses penuh ke ruang kerja (scope all-apis). Lihat Token akses pribadi dengan cakupan spesifik.

curl -X POST https://<databricks-instance>/api/2.0/token/create \
-H "Authorization: Bearer <your-existing-access-token>" \
-H "Content-Type: application/json" \
-d '{
  "lifetime_seconds": <lifetime-seconds>,
  "scopes": [
    "sql",
    "authentication"
  ],
  "autoscope_enabled": true
}'

Jika berhasil, ini menghasilkan payload respons yang mirip dengan:

{
  "token_value": "<your-newly-issued-pat>",
  "token_info": {
    "token_id": "<token-id>",
    "creation_time": <creation-timestamp>,
    "expiry_time": <expiry-timestamp>,
    "comment": "<comment>",
    "scopes": ["authentication", "sql"],
    "last_accessed_time": 0
  }
}

Berikan token baru dari respons di header Otorisasi panggilan selanjutnya ke API REST Databricks. Contohnya:

# This example uses a simple GET. For POST or other REST verbs, you may need to provide additional parameters.
curl -X GET "https://<databricks-instance>/api/2.0/<path-to-endpoint>" \
     -H "Authorization: Bearer <your-new-pat>"

import requests

headers = {
    'Authorization': 'Bearer <your-new-pat>'
}
# This example is for an HTTP GET operation.
response = requests.get('https://<databricks-instance>/api/2.0/<path-to-endpoint>', headers=headers)

Memperbarui cakupan token akses pribadi

Jika token tercakup kehilangan cakupan yang diperlukan untuk panggilan API, permintaan gagal dengan kesalahan yang menunjukkan cakupan yang hilang. Untuk memperbarui cakupan token, gunakan titik akhir REST /api/2.0/token/<token_id>. Token panggilan harus memiliki authentication cakupan, yang mengizinkan pengelolaan token lain. update_mask Gunakan bidang untuk menentukan bidang token mana yang akan diperbarui.

curl -X PATCH https://<databricks-instance>/api/2.0/token/<token_id> \
-H "Authorization: Bearer <your-existing-access-token>" \
-H "Content-Type: application/json" \
-d '{
  "token": {
    "scopes": ["sql", "unity-catalog"]
  },
  "update_mask": "scopes"
}'

Untuk memberikan token akses penuh workspace (scope all-apis), atur scopes ke sebuah array kosong ("scopes": []). String all-apis literal bukanlah nilai lingkup yang diterima.

Catatan

Azure Databricks merekomendasikan menetapkan lingkup tertentu daripada memberikan akses all-apis. Lihat penentuan cakupan otomatis untuk token akses pribadi.

Perubahan cakupan dapat memakan waktu hingga sepuluh menit untuk disebarluaskan.

Untuk melihat semua cakupan yang tersedia, gunakan GET /api/2.0/token-scopes.

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-10-08

Mengautentikasi dengan token akses pribadi Azure Databricks (warisan)

Membuat token akses pribadi untuk pengguna ruang kerja

Token akses pribadi terlingkup

Penentuan cakupan otomatis untuk token akses pribadi

Kontrol cakupan otomatis

Keluar dari auto-scoping

Membuat token akses pribadi untuk perwakilan layanan

Melakukan autentikasi token akses pribadi

Lingkungan

Profil

antarmuka baris perintah (CLI)

Sambungkan

Gunakan REST API Azure Databricks untuk mengeluarkan token akses pribadi

Memperbarui cakupan token akses pribadi

Saran dan Komentar

Sumber Daya Tambahan: