ODBC API資料庫應用程式開發完整指南

一、Visual C++資料庫技術總覽

Visual C++提供多元資料存取技術：ODBC API、MFC ODBC、DAO、OLE DB、ADO。各有特色：

• 簡單性：Wizard工具與類庫大幅減少程式碼
• 靈活性：豐富類庫支援客製化介面與功能
• 高速存取：OLE DB/ADO基於COM直連驅動程式，提升效能
• 擴展性：OLE/ActiveX技術實現元件化開發
• 異構資料源：OLE DB支援關聯式與非關聯式資料庫

二、核心技術比較

三、ODBC架構與核心概念

四大元件架構

1. 應用程式：呼叫ODBC函數、提交SQL、處理結果與錯誤
2. 驅動程式管理器：載入/呼叫驅動程式，管理多應用/多驅動，通常為DLL
3. 驅動程式：執行ODBC函數、轉發SQL至資料源、處理網路/檔案系統互動
4. 資料源：資料集與環境（OS、DBMS、網路）的組合，以名稱識別，屏蔽拓撲差異

資料類型與控制代碼

ODBC使用SQL資料類型（資料源端）與C資料類型（應用端）。四種控制代碼管理上下文：

• 環境控制代碼 (HENV)：整個應用程式唯一，管理所有連接與陳述式控制代碼
• 連接控制代碼 (HDBC)：管理特定連接資訊，可多個並存
• 陳述式控制代碼 (HSTMT)：處理SQL陳述式與目錄函數，核心操作單元
• 描述項控制代碼 (HDESC)：中繼資料集合，描述參數與資料行資訊

四、錯誤處理機制

回傳碼

• SQL_SUCCESS：成功
• SQL_SUCCESS_WITH_INFO：成功但有警告，需查診斷記錄
• SQL_ERROR：失敗
• SQL_INVALID_HANDLE：控制代碼無效
• SQL_NO_DATA：無資料（如Fetch結束）

診斷記錄

每個ODBC函數呼叫產生診斷記錄，存於相關控制代碼中，直到下一次使用同一控制代碼。包含標頭記錄（第0筆）與狀態記錄。使用SQLGetDiagRec或SQLGetDiagField取得詳細錯誤資訊（SQLSTATE、原生錯誤碼、訊息文字）。

五、基礎程式碼範例：環境建立與連接

SQLHENV hEnv;
SQLHDBC hDbc;
SQLRETURN ret;

// 1. 分配環境控制代碼
ret = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &hEnv);
ret = SQLSetEnvAttr(hEnv, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);

// 2. 分配連接控制代碼
ret = SQLAllocHandle(SQL_HANDLE_DBC, hEnv, &hDbc);

// 3. 連接資料源 (假設DSN="MyDSN")
ret = SQLConnect(hDbc, (SQLCHAR*)"MyDSN", SQL_NTS, 
                 (SQLCHAR*)"user", SQL_NTS, (SQLCHAR*)"pwd", SQL_NTS);

if (ret == SQL_SUCCESS || ret == SQL_SUCCESS_WITH_INFO) {
    // 連接成功，進行後續操作...
}

總結

ODBC API雖屬底層介面，程式碼量較大，但提供最精細的控制權，適合需要高效能、特殊功能或跨資料庫平台的應用。掌握控制代碼管理、SQL執行流程與錯誤診斷機制，是熟練運用ODBC的關鍵。