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 |
關閉連線。 釋放環境、連接、語句或描述元控制碼。 |