Menambahkan sumber daya Lakebase ke aplikasi Databricks

Tambahkan database Lakebase sebagai sumber daya Databricks Apps untuk mempertahankan data di seluruh penyebaran. Sumber daya yang didukung PostgreSQL ini memungkinkan aplikasi Anda membuat dan mengelola skema dan tabel yang mempertahankan status.

Jenis sumber daya database Lakebase berikut ini tersedia:

• Penskalaan Otomatis Lakebase: Mengatur sumber daya sebagai proyek yang berisi cabang dan database.
• Lakebase Provisioned: Mengatur sumber daya sebagai instans database.

Kedua jenis menggunakan model koneksi PostgreSQL yang sama dan menyediakan variabel lingkungan yang sama ke aplikasi Anda.

Menambahkan sumber daya database

Sebelum Anda menambahkan database Lakebase sebagai sumber daya, tinjau prasyarat sumber daya aplikasi.

Nota

Anda tidak dapat membuat database yang Disediakan baru setelah 12 Maret 2026, tetapi Anda dapat menambahkan database yang sudah ada sebagai sumber daya aplikasi. Lihat Autoscaling secara default.

1. Di bagian Sumber daya aplikasi saat Anda membuat atau mengedit aplikasi, klik + Tambahkan Database sumber daya>.
2. Pilih database. Untuk Autoscaling Lakebase, pilih proyek, cabang, dan database. Untuk Lakebase Provisioned, pilih instans database dan database dalam instans tersebut.
3. Pilih tingkat izin yang sesuai untuk aplikasi Anda. Saat ini, satu-satunya izin yang tersedia adalah Dapat menyambungkan dan membuat.
4. (Opsional) Tentukan kunci sumber daya kustom, yaitu cara Anda mereferensikan database dalam konfigurasi aplikasi Anda. Kunci defaultnya adalah postgres untuk Lakebase Autoscaling dan database untuk Lakebase Provisioned.

Anda harus memiliki CAN MANAGE izin pada proyek Lakebase untuk menambahkannya sebagai sumber daya aplikasi.

Saat Anda menambahkan sumber daya database:

• Azure Databricks membuat peran PostgreSQL dalam database yang dipilih. Nama peran cocok dengan ID klien prinsipal layanan. Jika peran sudah ada, Azure Databricks menggunakannya kembali.
• Azure Databricks memberikan hak istimewa kepada perwakilan layanan CONNECT dan CREATE pada database yang dipilih. Hak istimewa ini memungkinkan aplikasi membuat skema dan tabel dalam database.
• Untuk penskalaan otomatis di Lakebase, pengguna yang menambahkan sumber daya harus memiliki CAN MANAGE izin pada proyek.

Variabel lingkungan

Saat Anda menyebarkan aplikasi dengan sumber daya database, Azure Databricks mengatur variabel lingkungan berikut untuk sumber daya database pertama.

Jika aplikasi Anda menggunakan beberapa database PostgreSQL, variabel ini hanya mencerminkan yang pertama. Gunakan valueFrom dengan kunci sumber daya untuk mengambil detail koneksi untuk database. Lihat Menggunakan variabel lingkungan untuk mengakses sumber daya.

Variabel	Deskripsi
PGAPPNAME	Nama aplikasi
PGDATABASE	Nama dari database
PGHOST	Nama host server PostgreSQL
PGPORT	Port untuk server PostgreSQL
PGSSLMODE	Mode SSL untuk koneksi
PGUSER	ID klien dan nama peran perwakilan layanan

Menghapus sumber daya database

Jika Anda menghapus sumber daya database dari aplikasi, aplikasi mencoba menetapkan ulang semua objek yang dimiliki oleh perwakilan layanan kepada pengguna yang menghapus sumber daya.

Logika yang digunakan aplikasi terutama bergantung pada apakah Anda memiliki peran dalam database:

Izin Anda	Peran dalam database?	Hasil
CAN MANAGE	Ya	Azure Databricks menetapkan ulang semua objek yang dimiliki oleh perwakilan layanan kepada Anda dan menghapus peran perwakilan layanan.
CAN MANAGE	Tidak.	Azure Databricks membuat peran untuk Anda, menetapkan ulang semua objek yang dimiliki oleh peran perwakilan layanan kepada Anda, dan menghapus peran perwakilan layanan.
Tidak CAN MANAGE	Tidak tersedia	Azure Databricks menghapus sumber daya, tetapi tidak menghapus peran atau menetapkan ulang kepemilikan. Peringatan muncul di UI, dan Anda harus secara manual membersihkan peran dan objek yang Anda miliki nanti.

Catatan

Pertimbangkan hal berikut saat Anda menambahkan database sebagai sumber daya aplikasi:

• Jika Anda mencabut CONNECT dan CREATE dari satu database dan memberikannya pada database lain dalam pembaruan yang sama, Azure Databricks memperbarui hak istimewa tetapi tidak membuat ulang peran perwakilan layanan.
• Database mempertahankan status. Skema atau tabel apa pun yang dibuat oleh aplikasi tetap ada bahkan setelah Anda menyebarkan ulang atau menghentikan aplikasi.