下表列出依工作類型分組的 ODBC 函式,並包含一致性指定和每個函式用途的簡短描述。 如需一致性指定的詳細資訊,請參閱 ODBC 和標準 CLI。 如需每個函式語法和語意的詳細資訊,請參閱 ODBC API 參考。
應用程式可以呼叫 SQLGetInfo 函式,以取得驅動程式的一致性資訊。 若要取得驅動程式中特定函式支援的相關信息,應用程式可以呼叫 SQLGetFunctions。
| Task | 函式名稱 | 一致性 | 目的 |
|---|---|---|---|
| 連線到資料來源 | SQLAllocHandle | ISO 92 | 取得環境、連接、語句或描述元句柄。 |
| SQLConnect | ISO 92 | 依數據來源名稱、使用者標識碼和密碼連接到特定驅動程式。 | |
| SQLDriverConnect | ODBC | 連接字串 或要求驅動程式管理員和驅動程式向使用者顯示連接對話框,以連線到特定驅動程式。 | |
| SQLBrowseConnect | ODBC | 傳回連接屬性和有效屬性值的後續層級。 針對每個連接屬性指定值時,會連接到數據源。 | |
| 取得驅動程式和數據源的相關信息 | SQLDataSources SQLDrivers |
ISO 92 ODBC |
傳回可用數據源的清單。 傳回已安裝驅動程式及其屬性的清單。 |
| SQLGetInfo | ISO 92 | 傳回特定驅動程式和數據源的相關信息。 | |
| SQLGetFunctions | ISO 92 | 傳回支持的驅動程式函式。 | |
| SQLGetTypeInfo | ISO 92 | 傳回支援的資料類型的相關資訊。 | |
| 設定和擷取驅動程序屬性 | SQLSetConnectAttr SQLGetConnectAttr |
ISO 92 ISO 92 |
設定連接屬性。 傳回連接屬性的值。 |
| SQLSetEnvAttr | ISO 92 | 設定環境屬性。 | |
| SQLGetEnvAttr | ISO 92 | 傳回環境屬性的值。 | |
| SQLSetStmtAttr | ISO 92 | 設定語句屬性。 | |
| SQLGetStmtAttr | ISO 92 | 傳回語句屬性的值。 | |
| 設定和擷取描述元欄位 | SQLGetDescField SQLGetDescRec |
ISO 92 ISO 92 |
傳回單一描述元欄位的值。 傳回多個描述元欄位的值。 |
| SQLSetDescField | ISO 92 | 設定單一描述元欄位。 | |
| SQLSetDescRec | ISO 92 | 設定多個描述元欄位。 | |
| SQLCopyDesc | ISO 92 | 將描述元資訊從一個描述元句柄複製到另一個描述項句柄。 | |
| 準備 SQL 要求 | SQLPrepare | ISO 92 | 準備 SQL 語句以供稍後執行。 |
| SQLBindParameter | ODBC | 指派 SQL 語句中參數的記憶體。 | |
| SQLGetCursorName | ISO 92 | 傳回與語句句柄相關聯的數據指標名稱。 | |
| SQLSetCursorName | ISO 92 | 指定數據指標名稱。 | |
| SQLSetScrollOptions | ODBC | 設定控制數據指標行為的選項。 | |
| 提交要求 | SQLExecute SQLExecDirect |
ISO 92 ISO 92 |
執行已備妥的陳述式。 執行陳述式。 |
| SQLNativeSql | ODBC | 傳回由驅動程序翻譯的 SQL 語句文字。 | |
| SQLDescribeParam | ODBC | 傳回語句中特定參數的描述。 | |
| SQLNumParams | ISO 92 | 傳回語句中的參數數目。 | |
| SQLParamData | ISO 92 | 與 SQLPutData 搭配使用,在運行時間提供參數數據。 ( 適用於長資料值。) | |
| SQLPutData | ISO 92 | 傳送參數的部分或所有數據值。 ( 適用於長資料值。) | |
| 擷取結果和結果的相關信息 | SQLRowCount SQLNumResultCols |
ISO 92 ISO 92 |
傳回受插入、更新或刪除要求影響的數據列數目。 傳回結果集中的資料行數目。 |
| SQLDescribeCol | ISO 92 | 描述結果集中的數據行。 | |
| SQLColAttribute | ISO 92 | 描述結果集中數據行的屬性。 | |
| SQLBindCol | ISO 92 | 指派結果數據行的記憶體,並指定數據類型。 | |
| SQLFetch | ISO 92 | 傳回多個結果數據列。 | |
| SQLFetchScroll | ISO 92 | 傳回可捲動的結果數據列。 | |
| SQLGetData | ISO 92 | 傳回結果集一個數據列的一部分或全部一個數據行。 ( 適用於長資料值。) | |
| SQLSetPos | ODBC | 將數據指標放在擷取的數據區塊內,並允許應用程式重新整理數據列集中的數據,或更新或刪除結果集中的數據。 | |
| SQLBulkOperations | ODBC | 執行大量插入和大量書籤作業,包括依書籤進行更新、刪除和擷取。 | |
| SQLMoreResults | ODBC | 判斷是否有更多可用的結果集,如果是,則會初始化下一個結果集的處理。 | |
| SQLGetDiagField | ISO 92 | 傳回其他診斷資訊(診斷數據結構的單一欄位)。 | |
| SQLGetDiagRec | ISO 92 | 傳回其他診斷資訊(診斷數據結構的多個字段)。 | |
| 取得資料來源系統資料表的相關資訊(目錄函式) | SQLColumnPrivileges SQLColumns |
ODBC 開啟群組 |
傳回一或多個數據表的數據行和相關聯許可權清單。 傳回指定數據表中的數據行名稱清單。 |
| SQLForeignKeys | ODBC | 如果指定數據表存在,則傳回組成外鍵的數據行名稱清單。 | |
| SQLPrimaryKeys | ODBC | 傳回組成數據表主鍵的數據行名稱清單。 | |
| SQLProcedureColumns | ODBC | 傳回輸入和輸出參數的清單,以及組成指定程序結果集的數據行。 | |
| SQLProcedures | ODBC | 傳回儲存在特定數據來源中的程式名稱清單。 | |
| SQLSpecialColumns | 開啟群組 | 傳回可唯一識別指定數據表中數據列之最佳數據行集的相關信息,或交易更新數據列中任何值時自動更新的數據行。 | |
| SQLStatistics | ISO 92 | 傳回單一數據表和與數據表相關聯之索引清單的統計數據。 | |
| SQLTablePrivileges | ODBC | 傳回數據表清單,以及與每個數據表相關聯的許可權。 | |
| SQLTables | 開啟群組 | 傳回儲存在特定數據源中的數據表名稱清單。 | |
| 終止語句 | SQLFreeStmt | ISO 92 | 結束語句處理、捨棄暫止的結果,以及選擇性地釋放與語句句柄相關聯的所有資源。 |
| SQLCloseCursor | ISO 92 | 關閉語句句柄上已開啟的數據指標。 | |
| SQLCancel | ISO 92 | 取消語句上的處理。 | |
| SQLCancelHandle | ODBC | 取消語句或連接上的處理。 | |
| SQLEndTran | ISO 92 | 認可或回復交易。 | |
| 終止連線 | SQLDisconnect SQLFreeHandle |
ISO 92 ISO 92 |
關閉連線。 釋放環境、連接、語句或描述元句柄。 |