Cara Membuat Connection String JDBC untuk SQL Server

Apa Itu Connection String JDBC?

Connection string JDBC adalah URL yang menentukan host database, port, dan parameter lain yang diperlukan untuk terhubung ke database SQL Server. String ini berisi semua informasi yang dibutuhkan driver JDBC untuk membuat koneksi.

Struktur Dasar Connection String JDBC untuk SQL Server

Format umum connection string JDBC untuk SQL Server terlihat seperti ini:

jdbc:sqlserver://[serverName[\instanceName][:portNumber]];[property=value[;property=value]]

• jdbc:sqlserver:// - Protokol yang digunakan untuk koneksi JDBC.
• serverName - Nama atau alamat IP server yang menjalankan instance SQL Server.
• instanceName (opsional) - Instance SQL Server tertentu.
• portNumber (opsional) - Port yang dituju. Default-nya 1433.
• property=value - Properti tambahan untuk mengonfigurasi koneksi (seperti nama database, detail autentikasi, dll.).

Jika Anda bekerja dengan PostgreSQL, coba PostgreSQL JDBC URL Builder kami untuk menyusun connection string dengan mudah.

Contoh: Connection String JDBC Minimal

String connectionUrl = "jdbc:sqlserver://localhost:1433;";

Ini adalah bentuk connection string paling sederhana, di mana:

• Server database berjalan secara lokal.
• Port yang dipakai adalah port default SQL Server, yaitu 1433.

Contoh: Connection String JDBC Lengkap

Untuk pengaturan yang lebih detail, bayangkan skenario di mana Anda ingin terhubung ke named instance di server remote dengan kredensial dan database tertentu:

String connectionUrl = "jdbc:sqlserver://192.168.1.100\\SQLExpress:1433;"
                     + "databaseName=MyDatabase;"
                     + "user=myUsername;"
                     + "password=myPassword;";

Berikut arti setiap bagiannya:

• 192.168.1.100\\SQLExpress:1433 - Terhubung ke instance SQLExpress di server 192.168.1.100 menggunakan port 1433.
• databaseName=MyDatabase - Terhubung ke database bernama MyDatabase.
• user=myUsername dan password=myPassword - Ini adalah kredensial yang digunakan untuk autentikasi.

Contoh dengan Integrated Windows Authentication

Jika SQL Server Anda dikonfigurasi untuk menggunakan Windows Authentication, Anda bisa memakai parameter integratedSecurity:

String connectionUrl = "jdbc:sqlserver://localhost:1433;"
                     + "databaseName=MyDatabase;"
                     + "integratedSecurity=true;";

Parameter ini memberi tahu driver untuk menggunakan kredensial Windows milik pengguna yang sedang login untuk autentikasi.

Terhubung dengan Driver JDBC

Untuk menggunakan connection string di aplikasi Java, Anda perlu memuat driver JDBC SQL Server dan membuat koneksi. Berikut contoh lengkap program Java yang terhubung ke SQL Server menggunakan JDBC:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;

public class SQLServerConnection {
    public static void main(String[] args) {
        String connectionUrl = "jdbc:sqlserver://localhost:1433;"
                             + "databaseName=MyDatabase;"
                             + "user=myUsername;"
                             + "password=myPassword;";

        try {
            // Load the SQL Server JDBC driver
            Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");

            // Establish the connection
            Connection con = DriverManager.getConnection(connectionUrl);

            // Create and execute a basic SQL query
            String SQL = "SELECT * FROM Customers";
            Statement stmt = con.createStatement();
            ResultSet rs = stmt.executeQuery(SQL);

            // Iterate through the result set and print the data
            while (rs.next()) {
                System.out.println(rs.getString("CustomerID") + " - " + rs.getString("CustomerName"));
            }

            // Close the resources
            rs.close();
            stmt.close();
            con.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Output yang Diharapkan:

Dengan asumsi ada tabel Customers di database Anda, menjalankan kode di atas akan menampilkan ID dan nama pelanggan seperti ini:

1 - John Doe
2 - Jane Smith
3 - Alice Johnson

Parameter Connection String yang Umum

Mengatasi Masalah Koneksi

URL Koneksi Tidak Valid

Jika Anda menemui error seperti:

com.microsoft.sqlserver.jdbc.SQLServerException: The connection string contains a badly formed name or value.

Pastikan connection string mengikuti format yang benar dan tidak ada titik koma (;) atau tanda sama dengan (=) yang salah tempat.

Port Tidak Listening

Jika Anda mendapat error yang menunjukkan koneksi ditolak, pastikan bahwa:

• Instance SQL Server sedang berjalan.
• Port yang ditentukan terbuka dan listening.

Anda bisa mengecek port yang digunakan SQL Server dengan menjalankan query ini di SQL Server:

SELECT DISTINCT local_net_address, local_tcp_port 
FROM sys.dm_exec_connections
WHERE local_net_address IS NOT NULL;

Driver Tidak Ditemukan

Jika Anda melihat error seperti:

java.lang.ClassNotFoundException: com.microsoft.sqlserver.jdbc.SQLServerDriver

Pastikan Anda sudah menambahkan driver JDBC SQL Server ke classpath proyek Anda. Anda bisa mengunduh driver tersebut dari situs web Microsoft.

Kesimpulan

Menyiapkan koneksi JDBC ke SQL Server itu mudah setelah Anda memahami struktur connection string-nya. Tutorial ini telah membahas hal-hal penting, termasuk connection string dasar dan lanjutan, cara mengintegrasikan connection string ke aplikasi Java, serta beberapa tips troubleshooting yang umum.