PolarDB:Multi-tenancy

Istilah

Penyewa: Dalam multi-tenancy, penyewa adalah entitas logis yang mewakili unit alokasi data dan sumber daya. Penyewa berada di tingkat yang lebih tinggi daripada kluster dan di tingkat yang lebih rendah daripada pengguna atau basis data. Beberapa akun atau basis data dapat sesuai dengan satu penyewa. Penyewa dibagi menjadi dua kategori:

• Penyewa sistem adalah entitas administratif khusus. Secara umum, hanya satu penyewa sistem yang dibuat. Penyewa sistem dapat menggunakan sumber daya dari penyewa biasa. Ketika pengguna dari penyewa sistem terhubung ke basis data dan memiliki izin untuk mengakses kluster, pengguna tersebut dapat mengakses kluster semua penyewa.

• Penyewa biasa: Sumber daya mereka sepenuhnya terisolasi dari sumber daya penyewa lainnya. Penyewa biasa harus dibuat oleh penyewa sistem.

Konfigurasi Sumber Daya: Anda dapat mengalokasikan sumber daya seperti CPU dan memori untuk setiap penyewa. Akun istimewa dapat menetapkan batasan sumber daya bagi setiap penyewa sesuai dengan kebutuhan bisnis.

Fitur konfigurasi sumber daya penyewa dirancang untuk membatasi jumlah sumber daya yang digunakan oleh satu atau beberapa proses. Di PolarDB for PostgreSQL, satu sesi setara dengan satu proses. Dalam satu sesi, hanya satu pengguna yang dapat masuk ke satu basis data. Proses, pengguna, dan basis data merupakan elemen dasar dari penyewa. Setiap proses, pengguna, dan basis data dapat dipetakan ke penyewa tertentu. Sebuah proses hanya dapat dimiliki oleh satu penyewa, sehingga mencegah statistik ganda dalam penggunaan sumber daya. Proses anak dari kueri paralel termasuk dalam penyewa yang memulai kueri tersebut. Dengan demikian, sumber daya dapat dibatasi dalam tiga dimensi berdasarkan atribut proses:

• Proses: Proses koneksi (proses sesi) yang dimulai oleh pengguna. Proses-proses ini mencakup proses kueri paralel, tetapi tidak mencakup proses pembantu sistem.

• Pengguna: Semua proses koneksi (proses sesi) yang dimulai oleh pengguna. Mereka mencakup proses kueri paralel, tetapi tidak mencakup proses pembantu sistem.

• Basis Data: Semua proses koneksi (proses sesi) ke satu basis data yang dimulai oleh pengguna. Mereka mencakup proses kueri paralel, tetapi tidak mencakup proses pembantu sistem.

Prasyarat

Kluster PolarDB for PostgreSQL Anda menjalankan mesin berikut:

PostgreSQL 14 (versi revisi 14.12.24.0 atau lebih baru)

SELECT version();

Parameter

SELECT pg_reload_conf();

SELECT pg_reload_conf();

SELECT pg_reload_conf();

SELECT pg_reload_conf();

SELECT pg_reload_conf();

Penggunaan

Untuk menggunakan multi-tenancy, Anda harus membuat ekstensi polar_resource_manager di basis data tempat Anda menentukan parameter polar_resource_manager.database_name.

CREATE EXTENSION polar_resource_manager;

Buat konfigurasi sumber daya

Anda dapat membuat konfigurasi sumber daya dengan menggunakan fungsi polar_create_resource_config.

SELECT polar_resource_manager.polar_create_resource_config('resource_config_name');

Parameter resource_config_name harus memenuhi persyaratan untuk nama basis data: Panjangnya bisa hingga 64 karakter. Jika tidak, mereka secara otomatis dipotong.

Hapus konfigurasi sumber daya

Anda dapat membuat konfigurasi sumber daya menggunakan fungsi polar_drop_resource_config.

SELECT polar_resource_manager.polar_drop_resource_config('resource_config_name');

Ubah konfigurasi sumber daya

Anda dapat mengubah konfigurasi sumber daya dengan menggunakan fungsi polar_alter_resource_config.

SELECT polar_resource_manager.polar_alter_resource_config('resource_config_name', 'config_name', value);

Nilai valid untuk parameter config_name:

• cpu_rate_limit: Batas CPU, dalam satuan inti CPU.

• mem_limit: Batas memori, dalam byte.

Buat penyewa

Anda dapat membuat penyewa dengan menggunakan fungsi polar_create_tenant.

SELECT polar_resource_manager.polar_create_tenant('tenant_name', 'resource_config_name');

• Parameter tenant_name harus memenuhi persyaratan untuk nama basis data: Panjangnya bisa hingga 64 karakter. Jika tidak, mereka secara otomatis dipotong.

• Nilai resource_config_name harus merupakan konfigurasi sumber daya yang ada. Jika tidak, penyewa tidak dapat dibuat.

Hapus penyewa

Anda dapat membuat tenant menggunakan fungsi polar_drop_tenant. Setelah tenant dihapus, konfigurasi sumber dayanya tetap ada.

SELECT polar_resource_manager.polar_drop_tenant('tenant_name');

Ubah penyewa

Anda dapat membuat tenant menggunakan fungsi polar_alter_tenant.

SELECT polar_resource_manager.polar_alter_tenant('tenant_name', 'config_name', 'value');

Nilai valid untuk parameter config_name:

• name: Nama penyewa.

• resource_config: Konfigurasi sumber daya.

Tetapkan basis data ke penyewa

Anda dapat menetapkan basis data ke penyewa dengan menggunakan fungsi polar_tenant_add_database. Basis data hanya dapat ditetapkan ke satu penyewa. Anda tidak dapat menetapkan basis data ke beberapa penyewa.

SELECT polar_resource_manager.polar_tenant_add_database('tenant_name', 'database_name');

Lihat basis data dan penyewanya

Anda dapat melihat basis data dan penyewanya dengan menggunakan fungsi polar_tenants_dbs.

SELECT dbsname, tenantname FROM polar_resource_manager.polar_tenants_dbs;

Tetapkan pengguna ke penyewa

Anda dapat menetapkan pengguna ke penyewa dengan menggunakan fungsi polar_tenant_add_user. Pengguna hanya dapat ditetapkan ke satu penyewa. Anda tidak dapat menetapkan pengguna ke beberapa penyewa.

SELECT polar_resource_manager.polar_tenant_add_user('tenant_name', 'user_name');

Lihat pengguna dan penyewanya

Anda dapat melihat pengguna dan penyewanya dengan menggunakan fungsi polar_tenants_users.

SELECT username, tenantname FROM polar_resource_manager.polar_tenants_users;

Tetapkan proses ke penyewa

Anda dapat menetapkan proses ke penyewa dengan menggunakan fungsi polar_tenant_add_process. Proses hanya dapat ditetapkan ke satu penyewa. Jika Anda menetapkan proses ke beberapa penyewa, hanya penetapan terakhir yang valid.

SELECT polar_resource_manager.polar_tenant_add_process('tenant_name', pid);

Lihat sumber daya penyewa

Anda dapat melihat sumber daya penyewa dengan menggunakan tampilan polar_all_resource_configs_detail.

SELECT * FROM polar_resource_manager.polar_all_resource_configs_detail;

Tabel berikut menjelaskan kolom dari tampilan.

Manajemen sumber daya CPU

Setelah Anda menambahkan proses, pengguna, dan basis data ke penyewa, Anda dapat menetapkan batas CPU dalam konfigurasi sumber daya. Jika proses anak latar belakang dapat dialokasikan, mereka ditetapkan ke penyewa yang memulai kueri paralel, sehingga proses anak latar belakang dan proses sesi keduanya tunduk pada batas sumber daya penyewa. Ketika kueri paralel selesai, proses anak latar belakang dihapus dari penyewa. Mekanisme ini secara dinamis memberlakukan dan menghapus batas sumber daya pada penyewa.

Batas penggunaan CPU

Anda dapat menetapkan batas penggunaan CPU maksimum untuk penyewa. Jika batas tersebut terlampaui, kluster akan menurunkan konsumsi CPU agar tetap berada dalam batas yang ditentukan.

Anda dapat menetapkan nilai cpu_rate_limit (bertipe data float) menggunakan fungsi polar_resource_manager.polar_alter_resource_config.

Manajemen sumber daya memori

Memori merupakan sumber daya kaku yang tidak dapat dibatasi secara dinamis seperti CPU. Jika batas penggunaan memori terlampaui, sistem akan menghentikan proses untuk melepaskan sumber daya memori. Mekanisme ini serupa dengan cara sistem operasi menangani masalah OOM, tetapi batasan ini diterapkan pada tingkat penyewa, bukan seluruh basis data.

Batas penggunaan memori

Anda dapat menetapkan nilai mem_limit (bertipe data float) menggunakan fungsi polar_resource_manager.polar_alter_resource_config. Karena nilai ini menentukan penggunaan memori maksimum, jumlah nilai mem_limit dapat melebihi spesifikasi kluster. Dua kebijakan berikut dapat diterapkan:

• Manajemen Ambang Batas Aktif: Ketika ambang batas eviksi aktif (total_mem_request_rate, default 80%) terlampaui dan penggunaan memori penyewa melebihi batas yang ditentukan, sesi akan dihentikan untuk melepaskan sumber daya memori. Kesalahan kelebihan memori akan dikembalikan. Sistem akan terus menerapkan mekanisme ini hingga penggunaan memori berada di bawah ambang batas eviksi aktif.

• Manajemen Ambang Batas Paksa: Jika ambang batas eviksi paksa (total_mem_limit_rate, default 95%) terlampaui, sistem akan menjelajahi semua proses, melepaskan sumber daya sesi, dan mengembalikan kesalahan kelebihan memori. Ini bertujuan untuk mencegah kesalahan OOM di kluster.

Selama eviksi, sesi pengguna dihentikan dan sumber daya yang digunakan oleh proses dilepaskan. Sistem menghentikan sesi dengan mengirimkan sinyal SIGUSR2 ke proses sesi serta mengembalikan kesalahan OOM tertentu. Jika penggunaan memori proses latar belakang dari kueri paralel melebihi batas memori, proses pengguna yang terkait akan dihentikan. Saat ini, hanya proses pengguna yang dapat dihentikan. Proses latar belakang sistem milik penyewa sistem (Pro) dan tidak dapat dihentikan untuk melepaskan sumber daya memori.