How to perform Database Testing using Katalon Studio

Katalon Studio allows users to create custom keywords to address specific needs. With custom keywords, you can connect to databases and perform database testing. This tutorial describes details on how to create custom keywords for database testing in Katalon Studio.

Below is a code sample demonstrating how to

  • establish a database connection
  • execute a query
  • close  the connection

package com.database

import java.sql.DriverManager

import java.sql.ResultSet

import java.sql.Statement

import com.kms.katalon.core.annotation.Keyword

import com.mysql.jdbc.Connection

public class DemoMySql {

   private static Connection connection = null;


    * Open and return a connection to database

    * @param dataFile absolute file path

    * @return an instance of java.sql.Connection


   //Establishing a connection to the DataBase


   def connectDB(String url, String dbname, String port, String username, String password){

   //Load driver class for your specific database type

   String conn = "jdbc:mysql://" + url + ":" + port + "/" + dbname


   //String connectionString = "jdbc:sqlite:" + dataFile

   if(connection != null && !connection.isClosed()){



   connection = DriverManager.getConnection(conn, username, password)

   return connection



    * execute a SQL query on database

    * @param queryString SQL query string

    * @return a reference to returned data collection, an instance of java.sql.ResultSet


   //Executing the constructed Query and Saving results in resultset


   def executeQuery(String queryString) {

   Statement stm = connection.createStatement()

   ResultSet rs = stm.executeQuery(queryString)

   return rs


    //Closing the connection


   def closeDatabaseConnection() {

   if(connection != null && !connection.isClosed()){



   connection = null



    * Execute non-query (usually INSERT/UPDATE/DELETE/COUNT/SUM...) on database

    * @param queryString a SQL statement

    * @return single value result of SQL statement



   def execute(String queryString) {

   Statement stm = connection.createStatement()

   boolean result = stm.execute(queryString)

   return result



Tips: Press “Ctrl + Shift + o“ to automatically import missing libraries in test scripts.

The Custom Keywords file will look like the following:

Katalon Custom Keywords

You can add the sample code above to your keyword file and modify the details as appropriated. Refer to these links for the formats of database connection strings:

Use Defined Keywords in Test Cases for DB Testing

1. Create new custom keywords for database connection (see above).

2. Copy the DB script provided above and paste it into the new keyword editor as illustrated below:Katalon Defined Keywords

thumb_up (6) thumb_down (0)

Generating reliable object selector using Spy Web utility

Katalon Studio Spy Web Utility provides an intelligent object capturing capability and immediate feedback on the uniqueness of selectors. There…

How to use synchronization commands while recording

What is Synchronization? Synchronization is a mechanism which allows multiple threads to work in parallel. In test automation, the application…

Viewing test execution reports in Katalon Analytics

Status Report Duration Report Execution Report Execution Detail View Performance and History This tutorial will show you how to leverage…
Scroll up