Resumen de las funciones de CLI de DB2

La Tabla 29 resume la finalidad de cada función de CLI de DB2 soportada por DB2 Everyplace y las diferencias entre las funciones de CLI de DB2 soportadas por DB2 Everyplace y las funciones de CLI de DB2 estándar.

Tabla 29. lista de funciones de CLI de DB2

Nombre de la función Finalidad Resumen de las diferencias
SQLAllocConnect Obtiene un descriptor de contexto de conexión.
SQLAllocEnv Obtiene un descriptor de entorno.
SQLAllocHandle Obtiene un descriptor de contexto.
SQLAllocStmt Asigna un descriptor de sentencia.
SQLBindCol Asigna almacenamiento para una columna resultante y especifica el tipo de datos. El tipo de datos destino sólo puede ser un tipo de datos soportado. No se da soporte al localizador de LOB.
SQLBindParameter Asigna almacenamiento para un parámetro de una sentencia de SQL. No da soporte al enlace con matrices de variables de aplicación o localizadores de LOB. No da soporte a SQLPutData(), por lo que la aplicación debe colocar el valor del parámetro en ParameterValuePtr antes de invocar SQLExecute(). El tipo de parámetro sólo puede ser INPUT, pues no se da soporte a los procedimientos almacenados.
SQLColumns Devuelve la lista de nombres de columna en las tablas especificadas. No se tienen en cuenta los parámetros CatalogName, NameLength1, SchemaName, NameLength2. Las columnas 2, 12 y 15 del conjunto de resultados devuelto son siempre NULL. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLConnect Conecta a un controlador específico mediante un nombre de fuente de datos, un ID de usuario y una contraseña.
SQLDescribeCol Describe una columna del conjunto resultante. La información sobre columnas está limitada por los tipos soportados de datos de columnas.
SQLDisconnect Cierra la conexión.
SQLEndTran Solicita un COMMIT o un ROLLBACK para todas las operaciones de todas las sentencias asociadas a una conexión. El atributo de conexión SQL_ATTR_AUTOCOMMIT debe establecerse en SQL_AUTOCOMMIT_OFF antes de invocar SQLEndTran().
SQLError Devuelve información adicional sobre errores o de estado.
SQLExecDirect Ejecuta una sentencia. No se da soporte a los códigos de retorno SQL_STILL_EXECUTING ni SQL_NEED_DATA. No se da soporte a las llamadas de CLI asíncronas.
SQLExecute Ejecuta una sentencia preparada. Se deben enlazar todos los parámetros antes de invocar SQLExecute(). No se da soporte a la ejecución asíncrona de las llamadas de SQL.
SQLFetch Devuelve una fila resultante. El resultado se obtiene fila a fila, no por conjuntos de filas. No se da soporte a los descriptores de sentencias. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLFetchScroll Devuelve un conjunto de filas resultante. El resultado se obtiene por conjuntos de filas. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLForeignKeys Devuelve información sobre claves foráneas para la tabla especificada. PKCatalogName, NameLength1, PKSchemaName, NameLength2, FKCatalogName, NameLength4, FKSchemaName y NameLength5 se ignoran. Las columnas 1, 2, 5, 6, 12 y 13 del conjunto resultante devuelto son siempre una serie de longitud cero. Las columnas 10, 11 y 14 del conjunto resultante devuelto son siempre cero. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLFreeConnect Libera el descriptor de contexto de conexión.
SQLFreeEnv Libera el descriptor de entorno.
SQLFreeHandle Libera recursos de descriptor de contexto.
SQLFreeStmt Finaliza el proceso de la sentencia, desecha los resultados pendientes y, opcionalmente, libera todos los recursos asociados al descriptor de la sentencia. Sólo se da soporte a las opciones SQL_DROP y SQL_RESET_PARAMS.
SQLGetConnectAttr Devuelve el valor actual de un atributo de conexión. DB2 Everyplace da soporte a un subconjunto de atributos de conexión soportados por DB2. DB2 Everyplace también da soporte a algunos atributos de conexión no soportados por DB2.
SQLGetCursorName Devuelve el nombre de cursor que está asociado a un descriptor de sentencia. El nombre de cursor generado internamente siempre comienza por CUR.
SQLGetData Devuelve parte o la totalidad de una columna de una fila de un conjunto resultante. El tipo de datos destino sólo puede ser un tipo de datos soportado. No se da soporte al localizador de LOB. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLGetDiagRec Obtiene varios campos de datos de diagnóstico. Sólo se da soporte a los registros de diagnóstico asociados a un descriptor de contexto de una sentencia o conexión. Sólo se da soporte a registros de diagnóstico individuales.
SQLGetInfo Devuelve información acerca de una fuente de datos y un controlador específicos. DB2 Everyplace da soporte a un subconjunto de los tipos de información soportados por DB2.
SQLGetStmtAttr Devuelve el valor actual de un atributo de una sentencia. DB2 Everyplace da soporte a un subconjunto de atributos de sentencia soportados por DB2. DB2 Everyplace también da soporte a algunos atributos de sentencia no soportados por DB2.
SQLNumParams Devuelve el número de marcadores de parámetro de una sentencia de SQL. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLNumResultCols Devuelve el número de columnas del conjunto resultante.
SQLPrepare Prepara una sentencia de SQL para una ejecución posterior.
SQLPrimaryKeys Devuelve una lista de nombres de columna que abarcan la clave primaria de una tabla. No se tienen en cuenta los parámetros CatalogName, NameLength1, SchemaName, NameLength2. Las columnas 1, 2 y 6 del conjunto resultante devuelto son siempre una serie de longitud cero. No se da soporte al código de retorno SQL_STILL_EXECUTING.
SQLRowCount Devuelve el número de filas afectadas por una petición de inserción, actualización o supresión.
SQLSetConnectAttr Establece opciones relacionadas con una conexión. DB2 Everyplace da soporte a un subconjunto de atributos de conexión soportados por DB2. DB2 Everyplace también da soporte a algunos atributos de conexión no soportados por DB2.
SQLSetStmtAttr Establece opciones relacionadas con una sentencia. DB2 Everyplace da soporte a un subconjunto de atributos de sentencia soportados por DB2. DB2 Everyplace también da soporte a algunos atributos de sentencia no soportados por DB2.
SQLTables Devuelve la lista de nombres de tabla almacenados en una fuente de datos específica. No se tienen en cuenta los parámetros CatalogName, NameLength1, SchemaName, NameLength2, TableType, NameLength4. DB2 Everyplace sólo da soporte al tipo "TABLE." No se da soporte al código de retorno SQL_STILL_EXECUTING.

Consulta relacionada