Ketahanan koneksi di driver ODBC

Untuk memastikan bahwa aplikasi tetap terhubung, driver ODBC dapat memulihkan koneksi diam.

Penting

Fitur ketahanan koneksi didukung pada Microsoft Azure SQL Database, database Fabric SQL, dan versi server SQL Server 2014 (dan yang lebih baru).

Fitur ini tersedia di Windows yang dimulai dengan Microsoft ODBC Driver 11 untuk SQL Server. Ini tersedia di Linux mulai versi 17.2 dari Microsoft ODBC Driver 17 untuk SQL Server.

Untuk informasi selengkapnya tentang ketahanan koneksi diam, lihat Artikel Teknis - Ketahanan Koneksi Menganggur.

Untuk mengontrol perilaku koneksi ulang, Driver ODBC untuk SQL Server memiliki dua opsi:

Jumlah percobaan ulang koneksi.

Jumlah percobaan ulang koneksi menentukan jumlah upaya untuk menyambung ulang jika terjadi kegagalan koneksi. Nilai yang valid berkisar antara 0 hingga 255. Nol (0) berarti jangan mencoba menyambungkan kembali. Nilai bawaannya adalah satu kali percobaan penyambungan ulang.

Anda dapat mengubah jumlah percobaan ulang koneksi saat Anda:
- Tentukan atau ubah sumber data yang menggunakan Driver ODBC untuk SQL Server dengan kontrol Jumlah Percobaan Ulang Koneksi.
- Gunakan kata kunci string koneksi ConnectRetryCount.
  
  Untuk mendapatkan jumlah percobaan ulang koneksi, gunakan atribut koneksi SQL_COPT_SS_CONNECT_RETRY_COUNT (hanya baca). Jika aplikasi tersambung ke server yang tidak mendukung ketahanan koneksi, SQL_COPT_SS_CONNECT_RETRY_COUNT mengembalikan 0.
Interval percobaan ulang koneksi.

Interval coba lagi sambungkan menentukan jumlah detik antara setiap upaya coba lagi koneksi. Nilai yang valid adalah 1-60. Total waktu untuk terhubung kembali tidak dapat melebihi batas waktu koneksi (SQL_ATTR_QUERY_TIMEOUT di SQLSetStmtAttr). Nilai default-nya adalah 10 detik.

Anda dapat mengubah interval percobaan ulang koneksi ketika Anda:
- Tentukan atau ubah sumber data yang menggunakan Driver ODBC untuk SQL Server dengan kontrol Connect Retry Interval.
- ConnectRetryInterval Gunakan kata kunci string koneksi.
  
  Untuk mendapatkan durasi interval percobaan ulang koneksi, gunakan atribut koneksi SQL_COPT_SS_CONNECT_RETRY_INTERVAL (hanya baca).

Jika aplikasi membuat koneksi dengan SQL_DRIVER_COMPLETE_REQUIRED dan kemudian mencoba menjalankan pernyataan melalui koneksi yang rusak, driver ODBC tidak akan menampilkan kotak dialog lagi. Selain itu, selama pemulihan sedang berlangsung,

Selama pemulihan, setiap panggilan ke SQLGetConnectAttr(SQL_COPT_SS_CONNECTION_DEAD), harus mengembalikan SQL_CD_FALSE.
Jika pemulihan gagal, panggilan apa pun ke SQLGetConnectAttr(SQL_COPT_SS_CONNECTION_DEAD), harus mengembalikan SQL_CD_TRUE.

Kode status berikut dikembalikan oleh fungsi apa pun yang menjalankan perintah di server:

Status	Pesan
`IMC01`	`The connection is broken and recovery is not possible. The client driver attempted to recover the connection one or more times and all attempts failed. Increase the value of ConnectRetryCount to increase the number of recovery attempts.`
`IMC02`	`The server did not acknowledge a recovery attempt, connection recovery is not possible.`
`IMC03`	`The server did not preserve the exact client TDS version requested during a recovery attempt, connection recovery is not possible.`
`IMC04`	`The server did not preserve the exact server major version requested during a recovery attempt, connection recovery is not possible.`
`IMC05`	`The connection is broken and recovery is not possible. The connection is marked by the server as unrecoverable. No attempt was made to restore the connection.`
`IMC06`	`The connection is broken and recovery is not possible. The connection is marked by the client driver as unrecoverable. No attempt was made to restore the connection.`

Contoh

Sampel berikut berisi dua fungsi. func1 menunjukkan bagaimana Anda dapat menyambung ke nama sumber data (DSN) yang menggunakan ODBC Driver for SQL Server di Windows. DSN menggunakan Autentikasi SQL Server, dan menentukan ID pengguna. func1 kemudian mengambil jumlah percobaan ulang koneksi dengan SQL_COPT_SS_CONNECT_RETRY_COUNT.

func2 menggunakan SQLDriverConnect, ConnectRetryCount kata kunci string koneksi, dan atribut koneksi untuk mengambil pengaturan percobaan ulang koneksi dan interval percobaan ulang.

// Connection_resiliency.cpp
// compile with: odbc32.lib
#include <windows.h>
#include <stdio.h>
#include <sqlext.h>
#include <msodbcsql.h>

void func1() {
    SQLHENV henv;
    SQLHDBC hdbc;
    SQLHSTMT hstmt;
    SQLRETURN retcode;
    SQLSMALLINT i = 21;

    // Allocate environment handle
    retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);

    // Set the ODBC version environment attribute
    if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
        retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);

        // Allocate connection handle
        if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
            retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);

            // Set login timeout to 5 seconds
            if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
                SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);

                // Connect to data source
                retcode = SQLConnect(hdbc, (SQLCHAR*)"MyDSN", SQL_NTS, (SQLCHAR*)"userID", SQL_NTS, (SQLCHAR*)"password_for_userID", SQL_NTS);
                retcode = SQLGetConnectAttr(hdbc, SQL_COPT_SS_CONNECT_RETRY_COUNT, &i, SQL_IS_INTEGER, NULL);

                // Allocate statement handle
                if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
                    retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);

                    // Process data
                    if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
                        SQLFreeHandle(SQL_HANDLE_STMT, hstmt);
                    }

                    SQLDisconnect(hdbc);
                }

                SQLFreeHandle(SQL_HANDLE_DBC, hdbc);
            }
        }
        SQLFreeHandle(SQL_HANDLE_ENV, henv);
    }
}

void func2() {
    SQLHENV henv;
    SQLHDBC hdbc1;
    SQLHSTMT hstmt;
    SQLRETURN retcode;
    SQLSMALLINT i = 21;

#define MAXBUFLEN 255

    SQLCHAR ConnStrIn[MAXBUFLEN] = "DRIVER={ODBC Driver 18 for SQL Server};SERVER=server_that_supports_connection_resiliency;Encrypt=yes;UID=userID;PWD=<password>;ConnectRetryCount=2";
    SQLCHAR ConnStrOut[MAXBUFLEN];

    SQLSMALLINT cbConnStrOut = 0;

    // Allocate environment handle
    retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);

    // Set the ODBC version environment attribute
    if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {

        retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3_80, SQL_IS_INTEGER);

        // Allocate connection handle
        if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
            retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);

            // Set login timeout to 5 seconds
            if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
                // SQLSetConnectAttr(hdbc1, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);

                retcode = SQLDriverConnect(hdbc1, NULL, ConnStrIn, SQL_NTS, NULL, 0, NULL, SQL_DRIVER_NOPROMPT);
            }
            retcode = SQLGetConnectAttr(hdbc1, SQL_COPT_SS_CONNECT_RETRY_COUNT, &i, SQL_IS_INTEGER, NULL);
            retcode = SQLGetConnectAttr(hdbc1, SQL_COPT_SS_CONNECT_RETRY_INTERVAL, &i, SQL_IS_INTEGER, NULL);
        }
    }
}

int main() {
    func1();
    func2();
}

Microsoft ODBC Driver untuk SQL Server

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-10-10

Ketahanan koneksi di driver ODBC

Contoh

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: