使用 SQLAPI++ 統一訪問 MySQL、Oracle、SQL Server 等多種數據庫的 C++ 實戰

SQLAPI++：C++ 跨數據庫訪問中間件實戰指南

SQLAPI++ 是一個高性能 C++ 庫，封裝原生數據庫 API（非 ODBC/OLEDB 中間層），支持 Oracle、SQL Server、DB2、Sybase、Informix、InterBase、SQLBase、MySQL、PostgreSQL 等主流數據庫。本文展示核心 API 用法、編譯環境與實戰代碼模板。

核心優勢

• 零中間層：直接調用目標 DBMS 客戶端庫，性能接近原生開發
• 統一接口：同一套代碼通過連接字符串切換數據庫，遷移成本極低
• 部署輕量：無需配置 ODBC DSN 或 OLEDB Provider，僅需目標數據庫客戶端庫
• 跨平台編譯器支持：MSVC、Borland C++ Builder、GCC (G++)

官方資源

• 官網：www.sqlapi.com（提供評估版下載）
• 評估版限制：連接成功後彈出 MessageBox，生產環境需購買授權
• 作者提供 BCB 破解版（www.szsmart.net），僅供學習研究

完整代碼範例（以 Oracle 為例，切換 MySQL 僅需修改連接參數）

#include <stdio.h>      // printf
#include <SQLAPI.h>    // SQLAPI++ 主頭文件

int main(int argc, char* argv[]) {
    SAConnection con;           // 連接對象
    SACommand cmd(&con,        // 命令對象，綁定連接
        "SELECT fid, fvarchar20 FROM test_tbl");  // 測試查詢 SQL

    try {
        // === 1. 建立連接 ===
        // 參數：數據源名、用戶、密碼、客戶端類型
        // MySQL 使用 SA_MySQL_Client，Oracle 使用 SA_Oracle_Client
        con.Connect("test", "tester", "tester", SA_Oracle_Client);

        // === 2. 執行查詢 ===
        cmd.Execute();

        // === 3. 遍歷結果集 ===
        while (cmd.FetchNext()) {
            printf("Row fetched: fid=%ld, fvarchar20='%s'\n",
                cmd.Field("fid").asLong(),
                (const char*)cmd.Field("fvarchar20").asString());
        }

        // === 4. 提交事務 ===
        con.Commit();
        printf("Rows selected!\n");
    }
    catch (SAException &x) {
        // === 5. 異常處理：回滾事務 ===
        try {
            con.Rollback();
        }
        catch (SAException &) {
            // 忽略回滾異常
        }
        // 輸出錯誤信息
        printf("Error: %s\n", (const char*)x.ErrText());
    }

    return 0;
}

關鍵類與方法速查

切換目標數據庫只需修改兩處

1. 連接調用：SA_MySQL_Client / SA_Oracle_Client / SA_SQLServer_Client 等
2. 連接參數：DSN/主機:端口/服務名、用戶、密碼

SQL 方言差異（如分頁、自增列、日期函數）仍需業務層適配，SQLAPI++ 不自動翻譯 SQL 語法。

編譯鏈接要點

• 包含目錄：SQLAPI/include
• 庫目錄：SQLAPI/lib（按編譯器/架構區分子目錄）
• 鏈接庫：sqlapi.lib (MSVC) / libsqlapi.a (GCC)
• 運行時需目標數據庫客戶端 DLL/SO 在 PATH/LD_LIBRARY_PATH 中