Konfigurasikan API JDBC untuk pengujian stres database - Performance Testing

Saat perlu melakukan uji kinerja operasi database seperti query, insert, update, atau delete, gunakan API JDBC di Performance Testing (PTS) untuk mengirim pernyataan SQL langsung ke database Anda dalam beban simulasi. Topik ini menjelaskan cara menyiapkan koneksi database, kredensial, dan konfigurasi SQL untuk skenario pengujian JDBC.

PTS mendukung tipe database berikut: MySQL, PostgreSQL, MariaDB, dan SQL Server.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Akses ke Konsol PTS
Titik akhir, port, dan nama database untuk instans database target Anda
Akun database dengan izin yang diperlukan oleh pernyataan SQL Anda

Buat skenario pengujian JDBC

Login ke Konsol PTS.
Pada panel navigasi sebelah kiri, pilih Performance Test > Create Scenario, lalu klik PTS.
Hapus API HTTP default dan tambahkan API JDBC.

Konfigurasikan parameter permintaan dasar. Untuk deskripsi parameter, lihat tabel parameter di bawah ini.

JDBC basic request configuration

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi	Contoh
API Name	Nama yang mengidentifikasi definisi layanan API tersebut. Panjang maksimum: 20 karakter.	`API-1`
Database Type	Jenis database yang akan dihubungkan. Nilai yang valid: MySQL, PostgreSQL, MariaDB, dan SQL Server.	MySQL
Database URL	String koneksi database dalam format `<host>:<port>/<database_name>`. Lihat format Database URL di bawah ini.	`rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb`
Username	Username untuk otentikasi database.	`test_user`
Password	Password untuk otentikasi database.	`your_password`
SQL	Pernyataan SQL yang akan dijalankan. Harus dimulai dengan `SELECT`, `UPDATE`, `INSERT`, atau `DELETE` (tidak peka huruf besar/kecil). Lihat panduan pernyataan SQL di bawah ini.	`select * from test_users;`
Timeout Duration	Waktu maksimum, dalam milidetik, yang ditunggu PTS untuk respons dari server database.	`5000`
limit	Jumlah maksimum baris yang dibaca dari set hasil. Hanya berlaku untuk pernyataan `SELECT`. Nilai maksimum: 1.000.000.	`1000`

Format Database URL

Database URL menggabungkan alamat host, nomor port, dan nama database menjadi satu string koneksi. Gunakan format sesuai tipe database Anda:

Tipe database	Port default	Contoh URL
MySQL	3306	`rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb`
PostgreSQL	5432	`pgm-bp1xxxxxxx.pg.rds.aliyuncs.com:5432/mydb`
MariaDB	3306	`rm-bp1xxxxxxx.mariadb.rds.aliyuncs.com:3306/mydb`
SQL Server	1433	`rm-bp1xxxxxxx.sqlserver.rds.aliyuncs.com:1433/mydb`

Ganti placeholder dengan nilai aktual Anda:

Placeholder	Deskripsi	Contoh
`<host>`	Titik akhir atau alamat IP instans database Anda	`rm-bp1xxxxxxx.mysql.rds.aliyuncs.com`
`<port>`	Nomor port (gunakan port default atau port kustom jika dikonfigurasi)	`3306`
`<database_name>`	Nama database target	`mydb`

Catatan: Nomor port yang ditampilkan di atas merupakan nilai default. Jika database Anda menggunakan port kustom, gantilah nomor port tersebut sesuai kebutuhan.

Panduan pernyataan SQL

Bidang SQL menerima pernyataan yang dimulai dengan salah satu kata kunci berikut (tidak peka huruf besar/kecil):

Kata kunci	Operasi	Contoh
`SELECT`	Query data	`select * from test_users where status = 'active';`
`INSERT`	Tambahkan catatan	`insert into test_users (name, email) values ('test', 'test@example.com');`
`UPDATE`	Modifikasi catatan	`update test_users set email = 'new@example.com' where id = 1;`
`DELETE`	Hapus catatan	`delete from test_users where id = 1;`

Pertimbangan uji beban

Tetapkan parameter limit untuk pernyataan SELECT. Set hasil yang besar selama uji beban mengonsumsi memori dan dapat mengganggu metrik kinerja. Tetapkan limit ke nilai yang sesuai dengan skenario pengujian Anda.
Gunakan pernyataan SQL yang realistis. Tulis pernyataan yang mencerminkan query produksi aktual, termasuk klausa WHERE dan join, agar memperoleh data kinerja yang bermakna.
Monitor nilai timeout. Jika pernyataan SQL Anda melibatkan tabel besar atau join berat, tingkatkan Timeout Duration untuk menghindari kegagalan palsu selama uji beban.