All Products
Search
Document Center

ApsaraDB RDS:Hubungkan ke instans SQL Server

Last Updated:Jun 21, 2026

Setelah konfigurasi awal selesai, Anda dapat menghubungkan ke instans SQL Server menggunakan metode seperti Data Management (DMS) atau SQL Server Management Studio (SSMS). Topik ini menjelaskan langkah-langkah untuk masing-masing metode.

Prasyarat

  • Anda telah membuat instans ApsaraDB RDS for SQL Server. Untuk informasi selengkapnya, lihat Buat instans ApsaraDB RDS for SQL Server.

  • Anda telah membuat database dan akun. Untuk informasi selengkapnya, lihat Buat database dan akun.

  • Anda telah mengonfigurasi daftar putih alamat IP untuk mengizinkan klien Anda, seperti instans Elastic Compute Service (ECS) atau perangkat on-premises, mengakses instans ApsaraDB RDS for SQL Server. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih alamat IP.

    Catatan
    • Jika Anda menggunakan instans Elastic Compute Service (ECS) untuk menghubungkan ke instans ApsaraDB RDS for SQL Server melalui jaringan internal, instans ECS dan instans RDS harus berada di wilayah yang sama dan virtual private cloud (VPC) yang sama. Tambahkan alamat IP pribadi instans ECS ke daftar putih alamat IP.

    • Jika Anda menggunakan perangkat on-premises untuk menghubungkan ke instans ApsaraDB RDS for SQL Server, tambahkan alamat IP publik perangkat tersebut ke daftar putih alamat IP.

Prosedur

Anda dapat menghubungkan ke database SQL Server menggunakan Alibaba Cloud Data Management Service (DMS), klien, atau aplikasi Java.

Metode 1: Gunakan DMS

Data Management Service (DMS) adalah platform manajemen data terpadu yang mendukung seluruh siklus hidup data. Platform ini menyediakan fitur seperti manajemen aset data global, tata kelola data, desain dan pengembangan database, integrasi data, pengembangan data, dan konsumsi data. DMS membantu perusahaan membuka nilai data mereka secara efisien dan aman serta mempercepat transformasi digital mereka.

Anda dapat menggunakan DMS untuk login dengan cepat dan mudah ke instans ApsaraDB for SQL Server guna mengelola dan menggunakan data. Metode ini menghilangkan kebutuhan untuk mengonfigurasi daftar putih alamat IP atau memilih jenis koneksi untuk instans.

  1. Buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS dan klik ID instans tersebut.

  2. Klik Log On to Database untuk membuka halaman login DMS.

  3. Pada kotak dialog Log on to Database Instance, masukkan informasi login dan klik Log In.

    • Pilih Access Mode. Tutorial ini menggunakan Account + password login sebagai contoh.

    • Masukkan Database Account dan Database Password. Tutorial ini menggunakan akun istimewa testuser dan kata sandi kustom.

    • Pilih Control Mode. Tutorial ini menggunakan Flexible Management sebagai contoh.

      Catatan
      • Flexible Management tidak dikenai biaya. Stable Change dan Security Collaboration dikenai biaya.

      • Dibandingkan dengan mode kontrol Flexible Management, mode Stable Change dan Security Collaboration menawarkan fitur manajemen database yang lebih canggih. Jika Anda mencoba ApsaraDB for SQL Server, kami merekomendasikan memilih mode Flexible Management.

  4. Setelah login, database yang baru dibuat akan muncul di bawah Instances Connected pada panel navigasi kiri halaman DMS. Tutorial ini menggunakan database dbtest sebagai contoh. Anda juga dapat mengklik ganda database lain untuk beralih ke database tersebut.

    Catatan

    Jika instans sudah ada tetapi database target tidak ditemukan dalam daftar instans yang terhubung di DMS, penyebabnya mungkin salah satu dari berikut:

    • Akun login tidak memiliki izin untuk mengakses database target: Buka halaman Accounts pada halaman detail instans ApsaraDB RDS, temukan akun target, lalu klik Change Permissions pada kolom Actions untuk memberikan izin yang diperlukan.

    • Direktori tidak ditampilkan karena metadata belum disinkronkan: Arahkan pointer ke instans yang berisi database target dan klik ikon image di sebelah kanan nama instans. Hal ini akan memperbarui daftar sehingga menampilkan database target.

  5. Setelah login ke database di DMS, gunakan tab SQL Console untuk membuat database dan tabel, serta melakukan kueri dan memodifikasi data.

Metode 2: Gunakan SSMS

Microsoft SQL Server Management Studio (SSMS) adalah tool antarmuka pengguna grafis (GUI) untuk mengelola dan mengadministrasi SQL Server. Anda dapat menggunakannya untuk menghubungkan ke berbagai database SQL Server, seperti instans ApsaraDB for SQL Server, instans SQL Server on-premises, atau instans SQL Server yang dihosting di cloud lain.

Tutorial ini menunjukkan cara menghubungkan ke instans ApsaraDB for SQL Server menggunakan Microsoft SQL Server Management Studio 19.0 (SSMS).

Catatan
  • Kami menyarankan Anda mengunduh versi terbaru SSMS untuk memastikan kompatibilitas dengan semua versi SQL Server.

  • Untuk menghubungkan menggunakan klien, Anda harus terlebih dahulu mengonfigurasi daftar putih alamat IP dan mendapatkan titik akhir instans.

  1. Buka klien Microsoft SQL Server Management Studio (SSMS) 19.0 lokal Anda.

  2. Pilih Connection > Database Engine.

  3. Pada kotak dialog Connect to Server, masukkan informasi login.

    Parameter

    Nilai

    Deskripsi

    Server name

    rm-2ze****.rds.aliyuncs.com,1433

    Titik akhir dan nomor port instans ApsaraDB RDS. Masukkan Public Address dan Outside the network port yang Anda peroleh saat mengajukan titik akhir publik. Pisahkan titik akhir dan nomor port dengan koma (,).

    Authentication

    SQL Server Authentication

    Metode autentikasi untuk SQL Server.

    Username

    testuser

    Username untuk akun instans ApsaraDB RDS.

    Password

    Test_pw123

    Password untuk akun instans ApsaraDB RDS.

  4. Klik Connection.

    Setelah koneksi berhasil, SSMS akan menampilkan informasi koneksi di sebelah kiri.

Metode 3: Gunakan aplikasi Java

Bagian ini menjelaskan cara menggunakan JDBC untuk menghubungkan ke instans ApsaraDB for SQL Server dari aplikasi Java.

Catatan

Sebelum menghubungkan, tambahkan alamat IP lingkungan tempat aplikasi berjalan, seperti alamat IP instans ECS atau perangkat on-premises, ke daftar putih alamat IP instans ApsaraDB for SQL Server. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih alamat IP.

  1. Tambahkan driver JDBC Microsoft ke proyek Maven Anda untuk mengakses database SQL Server.

    Metode 1: Tambahkan dependensi secara manual ke file pom.xml proyek Maven Anda

    Catatan
    • Kami menyarankan Anda memilih versi dependensi yang sesuai dengan versi Java Anda. Misalnya, file mssql-jdbc-12.2.0.jre8.jar dalam paket 12.2.0 ditujukan untuk Java 8 atau yang lebih baru.

    • Untuk melihat versi dependensi sebelumnya, lihat tutorial resmi.

    <dependency>
      <groupId>com.microsoft.sqlserver</groupId>
      <artifactId>mssql-jdbc</artifactId>
      <version>12.2.0.jre8</version> <!-- Periksa nomor versi terbaru -->
    </dependency>

    Setelah menambahkan dependensi, klik image. Dependensi dalam file pom.xml akan diunduh secara otomatis.

    Metode 2: Unduh driver JDBC secara manual dan tambahkan ke classpath proyek Maven Anda

    1. Unduh driver yang sesuai dengan versi Java Anda dari Microsoft JDBC Driver for SQL Server.

      Microsoft JDBC Driver for SQL Server adalah driver JDBC tipe 4 yang menyediakan konektivitas database melalui antarmuka pemrograman aplikasi (API) JDBC standar yang tersedia di platform Java. Driver ini memungkinkan Anda mengakses SQL Server dari aplikasi Java apa pun, server aplikasi, atau applet yang mendukung Java.
    2. Setelah mengunduh dan mengekstrak paket, simpan file JAR secara manual, seperti sqljdbc4.jar atau sqljdbc.jar, ke proyek Anda.

      Langkah-langkah berikut menunjukkan cara menambahkan driver di IntelliJ IDEA:

      • Di IntelliJ IDEA, pilih File > Project Structure dari bilah menu.

      • Pada kotak dialog Project Structure, pilih Project Settings > Modules di panel kiri, buka tab Dependencies, klik ikon tambah (+), lalu pilih JARs or Directories.

      • Pada kotak dialog pemilih file yang muncul, cari dan pilih file JAR yang telah diunduh, seperti mssql-jdbc-12.2.0.jre8.jar, lalu klik OK.

  2. Tulis kode contoh untuk menghubungkan ke database SQL Server dari Java:

    Ganti titik akhir, nama database, username, password, dan pernyataan SQL dalam kode contoh dengan nilai aktual Anda. Untuk informasi selengkapnya, lihat Lihat atau modifikasi titik akhir dan nomor port.

    import java.sql.Connection;
    import java.sql.DriverManager;
    import java.sql.SQLException;
    import java.sql.Statement;
    import java.sql.ResultSet;
    
    public class testMSSQLJDBC {
    
        public static void main(String[] args) {
            // Masukkan titik akhir database. Gunakan titik akhir internal jika aplikasi Anda berjalan di instans ECS, atau titik akhir publik jika berjalan di lingkungan on-premises atau lainnya.
            String url = "jdbc:sqlserver://rm-2vc367d081200******.mssql.cn-chengdu.rds.aliyuncs.com:1433;"
                    + "database=YourDatabaseName;"
                    + "encrypt=true;"
                    + "trustServerCertificate=true;"
                    + "loginTimeout=30;";
            // Tentukan username dan password jika Anda tidak menggunakan Windows Authentication.
            String username = "usernametest";
            String password = "Passwordtest!";
    
            // Buat objek koneksi.
            Connection connection = null;
    
            try {
                // Muat driver JDBC.
                Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
                // Hubungkan ke database SQL Server.
                connection = DriverManager.getConnection(url, username, password);
                System.out.println("Koneksi berhasil!");
    
                // Buat objek Statement untuk menjalankan pernyataan SQL.
                Statement statement = connection.createStatement();
                // Jalankan kueri SQL. Ganti nama tabel dan kolom sesuai kebutuhan.
                String sql = "SELECT TOP 10 * FROM YourTableName";
                ResultSet resultSet = statement.executeQuery(sql);
    
                // Proses set hasil.
                while (resultSet.next()) {
                    System.out.println("Kolom 1: " + resultSet.getString("YourColumnName1"));
                    System.out.println("Kolom 2: " + resultSet.getString("YourColumnName2"));
                }
    
                // Tutup set hasil.
                resultSet.close();
                // Tutup objek Statement.
                statement.close();
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            } catch (SQLException e) {
                e.printStackTrace();
            } finally {
                // Tutup koneksi.
                if (connection != null) {
                    try {
                        connection.close();
                    } catch (SQLException e) {
                        e.printStackTrace();
                    }
                }
            }
        }
    }
  3. Uji koneksi.

    Simpan kode sebagai file SqlServerConnection.java, lalu kompilasi dan jalankan dari command line atau di IDE. Jika konfigurasi benar, program akan mencetak output berikut, yang menunjukkan koneksi berhasil ke database SQL Server.

    Koneksi berhasil!

FAQ

Saya ingin menghubungkan ke instans RDS menggunakan titik akhir publik, tetapi alamat IP publik saya tidak stabil dan terus berubah. Apa saran Anda?

Kami menyarankan Anda menambahkan blok CIDR yang lebih besar ke daftar putih alamat IP untuk memenuhi kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih alamat IP dan Bagaimana cara menentukan alamat IP publik server atau client eksternal untuk SQL Server?.

Penting

0.0.0.0/0 menunjukkan bahwa alamat IP apa pun dapat mengakses instans RDS. Jika Anda menambahkan 0.0.0.0/0 ke daftar putih alamat IP untuk pengujian, segera ubah entri ini setelah pengujian selesai.

Saya menggunakan Function Compute dan ingin mengambil data dari RDS. Bagaimana caranya?

Anda dapat menginstal dependensi pihak ketiga untuk fungsi Anda dan menggunakan modul bawaan untuk mengambil data dari RDS. Untuk informasi selengkapnya, lihat Instal dependensi pihak ketiga untuk fungsi.

Saya telah login ke instans RDS di DMS, tetapi DMS menunjukkan bahwa tidak ada database yang ditemukan. Mengapa?

Jika database target tidak ada dalam daftar Instances Connected, periksa masalah berikut:

  • Akun login tidak memiliki izin untuk mengakses database target: Buka halaman Accounts pada halaman detail instans RDS. Temukan akun target dan klik Change Permissions pada kolom Actions untuk memberikan izin. Untuk informasi selengkapnya, lihat Modifikasi izin akun.

  • Direktori tidak ditampilkan karena metadata belum disinkronkan: Arahkan pointer ke instans tempat database target berada dan klik ikon image di sebelah kanan nama instans. Hal ini akan memperbarui daftar database dan menampilkan database target.

Saya tidak dapat menghubungkan ke instans RDS saya dari komputer on-premises menggunakan SSMS. Mengapa?

Untuk menghubungkan ke instans ApsaraDB RDS for SQL Server dari klien SSMS on-premises, pastikan persyaratan berikut terpenuhi:

  • Untuk mengakses instans RDS dari perangkat on-premises, Anda harus mengajukan titik akhir publik dan menggunakannya untuk menghubungkan ke instans. Anda tidak dikenai biaya untuk mengajukan titik akhir publik atau untuk traffic publik yang dihasilkan setelahnya. Untuk informasi selengkapnya, lihat Ajukan titik akhir publik.

    Di panel navigasi kiri halaman detail instans, klik Database Connection untuk melihat titik akhir internal, titik akhir publik, dan nomor port instans (1433 secara default). Titik akhir publik terlihat mirip dengan rm-<instance_id>.mssql.<region>.rds.aliyuncs.com. Sebelum menghubungkan, klik Set Whitelist di sebelah titik akhir publik untuk menambahkan alamat IP server aplikasi atau perangkat on-premises Anda ke daftar putih alamat IP. Saat menggunakan SQL Server Management Studio untuk menghubungkan, masukkan nama server dalam format <public_endpoint>,1433.

  • Tambahkan alamat IP publik perangkat on-premises Anda ke daftar putih alamat IP instans. Untuk informasi selengkapnya, lihat Tambahkan daftar putih alamat IP untuk instans RDS.

    Untuk melakukannya, buka halaman manajemen instans dan klik Whitelist and Security Group di panel navigasi kiri. Pada tab Whitelist Settings, klik Add Whitelist Group.

Saya gagal login ke instans RDS dari klien DMS, meskipun password dan informasi lainnya benar. Apa yang harus saya lakukan?

Kami menyarankan Anda login ke instans RDS dari konsol web DMS seperti yang dijelaskan dalam Metode 1, daripada menggunakan klien DMS. Jika terjadi error login, lihat FAQ tentang login ke database menggunakan DMS untuk solusi.