Nonstop Database, HiRDB Version 9 UAP Development Guide

[Contents][Index][Back][Next]

14.4 ODBC functions provided by HiRDB

HiRDB provides ODBC functions, and you can access HiRDB on a server from a UAP that utilizes these ODBC functions. The following table shows the ODBC functions provided by HiRDB.

Table 14-3 ODBC functions provided by HiRDB

Classification ODBC functions ODBC2.0 driver ODBC 3.5 driver
Provided? Expansion level Provided? Expansion level
Connection to data source SQLAllocEnv Y Core -- --
SQLAllocHandle -- -- Y Core
SQLAllocConnect Y Core -- --
SQLConnect Y Core Y Core
SQLDriverConnect Y 1 Y Core
SQLBrowseConnect Y 2 Y 1
Driver and data source information acquisition SQLDataSources Y#1 2 Y#1 Core
SQLDrivers -- -- Y#1 Core
SQLGetInfo Y 1 Y Core
SQLGetFunctions -- -- Y Core
SQLGetTypeInfo Y 1 Y Core
Driver option setting and acquisition SQLSetConnectOption Y 1 -- --
SQLGetConnectOption Y 1 -- --
SQLSetStmtOption Y 1 -- --
SQLGetStmtOption Y 1 -- --
SQLSetConnectAttr -- -- Y Core
SQLGetConnectAttr -- -- Y Core
SQLSetEnvAttr -- -- Y Core
SQLGetEnvAttr -- -- Y Core
SQLSetStmtAttr -- 1 Y Core
SQLGetStmtAttr -- 1 Y Core
Descriptor value setup SQLGetDescField -- -- Y Core
SQLGetDescRec -- -- Y Core
SQLSetDescField -- -- Y Core
SQLSetDescRec -- -- Y Core
SQLCopyDesc -- -- Y Core
SQL request creation SQLAllocStmt Y Core -- --
SQLPrepare Y Core Y Core
SQLBindParameter Y 11 Y Core
SQLSetParam#2 Y 1 -- --
SQLGetCursorName Y Core Y Core
SQLSetCursorName Y Core Y Core
SQLDescribeParam Y 2 -- --
SQLNumParam Y 2 -- --
SQLDescribeParams -- -- Y 2
SQLNumParams -- -- Y Core
SQLParamOptions N 2 -- --
SQLSetScrollOptions N#3 2 N 2
SQL execution SQLExecute Y Core Y Core
SQLExecDirect Y Core Y Core
SQLNativeSql Y 2 Y Core
SQLParamData Y 1 Y Core
SQLPutData Y 1 Y Core
Execution result and execution result information acquisition SQLRowCount Y Core Y Core
SQLNumResultCols Y Core Y Core
SQLDescribeCol Y Core Y Core
SQLColAttributes Y Core -- --
SQLColAttribute -- -- Y Core
SQLBindCol Y Core Y Core
SQLFetch Y Core Y Core
SQLFetchScroll -- -- Y#4 Core
SQLExtendedFetch N#3 2 Y Core
SQLGetData Y 1 Y Core
SQLSetPos N#3 2 Y#4 1
SQLBulkOperations -- -- N 1
SQLMoreResults#5 Y 2 Y 1
SQLError Y Core -- --
SQLGetDiagField -- -- Y Core
SQLGetDiagRec -- -- Y Core
Data source system information acquisition SQLColumnPrivileges Y 2 Y 2
SQLColumns Y 1 Y Core
SQLForeignKeys Y#6 2 Y#6 2
SQLPrimaryKeys Y#6 2 Y#6 1
SQLProcedureColumns Y 2 Y 1
SQLProcedure Y 2 Y 1
SQLSpecialColumns Y#6 1 Y#6 Core
SQLStatistics Y 1 Y Core
SQLTablePrivileges Y 2 Y 2
SQLTables Y 1 Y Core
SQL execution termination SQLFreestmt Y Core Y Core
SQLCloseCursor -- -- Y Core
SQLCancel Y Core Y Core
SQLTransact Y Core Y Core
SQLEndTran -- -- Y Core
Disconnection SQLDisconnect Y Core Y Core
SQLFreeConnect Y Core -- --
SQLFreeEnv Y Core -- --
SQLFreeHandle -- -- Y Core

Legend:
Y: The applicable ODBC function is provided.
N: The applicable ODBC function is not provided.
--: Not applicable
1: Level 1
2: Level 2
Core: Core level

#1
This function is provided by the drive manager.

#2
Although the SQLSetParam function was included in SQLBindParameter beginning with ODBC 2.0, this function is provided to maintain compatibility with applications that do not support ODBC 2.0.

#3
Because this function is installed in the ODBC2.0 cursor library, the range of functions specified by the cursor library can be used. To use SQLExtendedFetch, set up a cursor library. For details on setting up a cursor library, see 14.8 Setting cursor libraries.

#4
To use these ODBC functions, you must use the cursor library provided by Microsoft.

#5
The statement handle used to execute an SQL statement is used to call SQLMoreResults. If the executed SQL statement uses HiRDB's results-set return facility and a result set is available, the function returns SQL_SUCCESS and the next result set becomes available. If the next result set is not available, the function returns SQL_NO_DATA.
For details about the results-set return facility, see the manual HiRDB Version 9 SQL Reference.

#6
Only the call is supported. The result set created by this function always contains no rows.