Manajemen rahasia

Rahasia di Azure Databricks menyimpan nilai sensitif, seperti kata sandi, kunci API, atau hashing salt, sehingga notebook, pekerjaan, dan fungsi dapat menggunakannya tanpa nilai tersebut muncul dalam kode. Anda dapat mengelola secret di dua tempat:

  • Secret scopes workspace: Koleksi rahasia bernama dalam satu workspace. Izin berlaku untuk seluruh cakupan. Lihat cakupan rahasia Workspace.
  • Rahasia di Unity Catalog: Objek securable (catalog.schema.secret) yang tersedia di setiap workspace yang terhubung ke metastore. Anda bisa memberikan akses ke setiap secret. Lihat Rahasia di Katalog Unity.

Rahasia Unity Catalog dapat dikelola oleh Azure Databricks atau menggunakan Azure Key Vault sebagai backend. Lihat rahasia Azure Key Vault di Unity Catalog.

Pilih tempat menyimpan sebuah secret

Tabel berikut membandingkan di mana setiap opsi menyimpan nilai rahasia, workspace mana yang dapat menggunakannya, dan bagaimana Anda mengontrol akses.

  Cakupan rahasia workspace Azure Databricks-managed secret di Unity Catalog Rahasia yang didukung Azure Key Vault di Unity Catalog (Beta)
Di mana nilai disimpan Azure Databricks, di workspace, atau Azure Key Vault Anda dengan scope yang didukung Key Vault Azure Databricks, di Unity Catalog Azure Key Vault (Azure Databricks hanya menyimpan nama rahasia di Unity Catalog)
Enkripsi dengan kunci Anda sendiri Ya, dengan kunci yang dikelola pelanggan untuk layanan terkelola Ya, dengan kunci yang dikelola pelanggan pada katalog
Tersedia dalam Satu ruang kerja Setiap workspace yang terhubung ke metastore Setiap workspace yang terhubung ke metastore
Kontrol akses Izin cakupan rahasia (tanpa kontrol akses tingkat rahasia) Hak istimewa Unity Catalog pada rahasia, skema, atau katalog Izin Unity Catalog pada secret, skema, atau katalog
Putar Perbarui nilai di Azure Databricks, atau di Key Vault untuk cakupan yang didukung Key Vault Perbarui nilai di Azure Databricks Putar di Azure Key Vault. Tidak ada perubahan di Azure Databricks.

Di mana Anda dapat menggunakan secret

Cakupan secret workspace dan secret Unity Catalog didukung di berbagai tempat. Sebelum memilih satu, periksa apakah itu berfungsi di tempat kode Anda berjalan.

Permukaan Cakupan secret workspace Rahasia di Unity Catalog
dbutils.secrets dalam notebook dan job Yes. Lihat Baca rahasia. Ya, pada lingkungan serverless versi 4 ke atas atau Databricks Runtime 17.3 LTS ke atas. Lihat Baca rahasia.
API REST dan CLI Databricks Yes. Nilai yang dikembalikan oleh API tidak disamarkan. Yes. Nilai yang dikembalikan oleh API tidak disamarkan.
Pengembangan jarak jauh, seperti Databricks Connect Ya, dengan klien Databricks Connect dbutils.secrets. Lihat Databricks Utilities dengan Databricks Connect untuk Python. No
Unity Catalog Python dan UDF Scala No Yes. Penelepon hanya perlu EXECUTE. Lihat Gunakan rahasia dalam UDF.
Gudang SQL Ya, dengan fungsi rahasia Hanya melalui UDF Python atau Scala Unity Catalog yang mendeklarasikan rahasia ini
Properti konfigurasi spark dan variabel lingkungan pada komputasi Yes. Lihat Menggunakan rahasia dalam properti konfigurasi Spark atau variabel lingkungan. No
Variabel lingkungan endpoint penyajian model Yes. Lihat Menambahkan variabel lingkungan berbasis rahasia. No
Repositori paket bawaan Ya, dalam cakupan databricks-package-management. Lihat Konfigurasikan repositori paket default. No

Sumber daya tambahan

Resource Description
Rahasia dalam Katalog Unity Buat secret Unity Catalog, berikan akses, dan baca secret tersebut di notebook, job, dan UDF.
Praktik terbaik untuk rahasia Unity Catalog Atur rahasia berdasarkan lingkungan, aplikasi, atau tim, dan biarkan beban kerja menggunakan rahasia tanpa membacanya.