ODBC 函式摘要
下表列出依工作類型分組的 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 |
關閉連線。 釋放環境、連接、語句或描述元句柄。 |