Devuelve un objeto cuyas propiedades describen cliente de una base de datos DB2

Descripción

db2_client_info ( resource $connection ) : object

Esta función devuelve un objeto, con propiedades de sólo lectura, con información sobre el cliente de base de datos DB2. La siguiente tabla lista las propiedades del cliente DB2:

**DB2 client properties**
Nombre de la propiedad	Tipo devuelto	Descripción
APPL_CODEPAGE	int	Código de página de la aplicación.
CONN_CODEPAGE	int	Código de página de la conexión activa.
DATA_SOURCE_NAME	string	Nombre fuente de datos (DSN) usado para crear la conexión actual a la base de datos.
DRIVER_NAME	string	Nombre de la biblioteca que implementa la especificación de la Interfaz a nivel de Llamada (CLI) de DB2.
DRIVER_ODBC_VER	string	Versión de ODBC que soporta el cliente DB2. Devuelve un string del tipo "MM.mm" donde `MM` es la versión principal y `mm` la secundaria. El cliente DB2 siempre devuelve "03.51".
DRIVER_VER	string	Versión del driver, en forma de string "MM.mm.uuuu" donde `MM` es la versión principal, `mm` es la versión secundaria, y `uuuu` la actualización. Por ejemplo, "08.02.0001" representa la versión principal 8, versión secundaria 2, actualización 1.
ODBC_SQL_CONFORMANCE	string	Nivel de gramática SQL ODBC soportado por el cliente. MINIMUM Soporta la gramática mínima ODBC SQL. CORE Soporta la gramática de tipo core de ODBC SQL. EXTENDED Soporta la gramática extendida de ODBC SQL.
ODBC_VER	string	Versión de ODBC que soporta el gestor de drivers de ODBC. Devuelve un strong del tipo "MM.mm.rrrr" donde `MM` es la versión principal, `mm` es la versión secundaria, y `rrrr` es la edición. El cliente DB2 siempre devuelve "03.01.0000".

Parámetros

connection: Especifica una conexión de cliente DB2 activa.

Valores devueltos

Devuelve un objeto en caso de éxito. Devuelve FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de db2_client_info()

Para consultar información del cliente, se debe proporcionar un recurso de conexión a base de datos válido a db2_client_info().


<?php
$conn = db2_connect( 'SAMPLE', 'db2inst1', 'ibmdb2' );
$client = db2_client_info( $conn );

if ($client) {
    echo "DRIVER_NAME: ";           var_dump( $client->DRIVER_NAME );
    echo "DRIVER_VER: ";            var_dump( $client->DRIVER_VER );
    echo "DATA_SOURCE_NAME: ";      var_dump( $client->DATA_SOURCE_NAME );
    echo "DRIVER_ODBC_VER: ";       var_dump( $client->DRIVER_ODBC_VER );
    echo "ODBC_VER: ";              var_dump( $client->ODBC_VER );
    echo "ODBC_SQL_CONFORMANCE: ";  var_dump( $client->ODBC_SQL_CONFORMANCE );
    echo "APPL_CODEPAGE: ";         var_dump( $client->APPL_CODEPAGE );
    echo "CONN_CODEPAGE: ";         var_dump( $client->CONN_CODEPAGE );
}
else {
    echo "Error al consultar información del cliente.
     Es posible que la conexión a base de datos sea inválida.";
}
db2_close($conn);

?>

El resultado del ejemplo sería:

DRIVER_NAME: string(8) "libdb2.a"
DRIVER_VER: string(10) "08.02.0001"
DATA_SOURCE_NAME: string(6) "SAMPLE"
DRIVER_ODBC_VER: string(5) "03.51"
ODBC_VER: string(10) "03.01.0000"
ODBC_SQL_CONFORMANCE: string(8) "EXTENDED"
APPL_CODEPAGE: int(819)
CONN_CODEPAGE: int(819)

Ver también

db2_server_info() - Returns an object with properties that describe the DB2 database server