PHP: db2_server_info

Descripción

db2_server_info(resource $connection): stdClass|false

Esta función devuelve un objeto con propiedades de solo lectura que proporcionan información sobre el servidor de base de datos IBM DB2, Cloudscape o Apache Derby. La tabla siguiente lista las propiedades del servidor de base de datos:

**Propiedades del servidor de base de datos**
Nombre de la propiedad	Tipo de retorno	Descripción
DBMS_NAME	string	El nombre del servidor de base de datos al que se está conectado. Para servidores DB2, es una combinación de `DB2` seguido del sistema operativo en el que funciona el servidor de base de datos.
DBMS_VER	string	La versión del servidor de base de datos, en formato de string `"MM.mm.uuuu"` donde `MM` es la versión mayor, `mm` es la versión menor y `uuuu` es la actualización. Por ejemplo, `"08.02.0001"` representa la versión mayor 8, la versión menor 2, la actualización 1.
DB_CODEPAGE	entero	La página de código de la base de datos a la que se está conectado.
DB_NAME	string	El nombre de la base de datos a la que se está conectado.
DFT_ISOLATION	string	El nivel predeterminado de aislamiento de transacción soportado por el servidor: UR Lectura no confirmada (`Uncommitted read`): los cambios son inmediatamente visibles para todas las transacciones concurrentes. CS Estabilidad del cursor (`Cursor stability`): una fila leída por una transacción puede ser modificada y confirmada por una segunda transacción concurrente. RS Estabilidad de lectura (`Read stability`): una transacción puede agregar o eliminar filas que coincidan con una condición de búsqueda o una transacción pendiente. RR Lectura repetible (`Repeatable read`): los datos afectados por las transacciones pendientes no están disponibles para otras transacciones. NC Sin confirmación (`No commit`): todo cambio es visible al final de una operación exitosa. Las confirmaciones explícitas y los retrocesos no están permitidos.
IDENTIFIER_QUOTE_CHAR	string	El carácter utilizado para delimitar un identificador.
INST_NAME	string	La instancia en el servidor de base de datos que contiene la base de datos.
ISOLATION_OPTION	array	Un array de opciones de aislamiento soportadas por el servidor de base de datos. Las opciones de aislamiento se describen en la propiedad DFT_ISOLATION.
KEYWORDS	array	Un array de palabras clave reservadas por el servidor de base de datos.
LIKE_ESCAPE_CLAUSE	booleano	`true` si el servidor de base de datos soporta el uso de los caracteres comodín `%` y `_`. `false` si el servidor de base de datos no soporta estos caracteres comodín.
MAX_COL_NAME_LEN	entero	Tamaño máximo de un nombre de columna soportado por el servidor de base de datos, expresado en bytes.
MAX_IDENTIFIER_LEN	entero	Tamaño máximo de un identificador SQL soportado por los servidores de base de datos, expresado en caracteres.
MAX_INDEX_SIZE	entero	Tamaño máximo de las columnas combinadas en un índice soportado por el servidor de base de datos, expresado en bytes.
MAX_PROC_NAME_LEN	entero	Tamaño máximo de un nombre de procedimiento soportado por el servidor de base de datos, expresado en bytes.
MAX_ROW_SIZE	entero	Tamaño máximo de una fila en la tabla de base soportada por el servidor de base de datos, expresado en bytes.
MAX_SCHEMA_NAME_LEN	entero	Tamaño máximo de un nombre de esquema soportado por el servidor de base de datos, expresado en bytes.
MAX_STATEMENT_LEN	entero	Tamaño máximo de una consulta SQL soportada por el servidor de base de datos, expresado en bytes.
MAX_TABLE_NAME_LEN	entero	Tamaño máximo de un nombre de tabla soportado por el servidor de base de datos, expresado en bytes.
NON_NULLABLE_COLUMNS	booleano	`true` si el servidor de base de datos soporta las columnas que pueden ser definidas como NOT NULL, `false` si el servidor de base de datos no soporta las columnas definidas como NOT NULL.
PROCEDURES	booleano	`true` si el servidor de base de datos soporta el uso de la consulta CALL para llamar a los procedimientos almacenados, `false` si el servidor de base de datos no soporta la consulta CALL.
SPECIAL_CHARS	string	Un string que contiene todos los caracteres distintos de las letras (mayúsculas y minúsculas), los dígitos y el carácter de subrayado que pueden ser utilizados como nombre de identificador.
SQL_CONFORMANCE	string	El nivel de conformidad con la especificación ANSI/ISO SQL-92 ofrecido por el servidor de base de datos: ENTRY Nivel de conformidad SQL-92. FIPS127 Conformidad tradicional FIPS-127-2. FULL Nivel completo de conformidad SQL-92. INTERMEDIATE Nivel intermedio de conformidad SQL-92.

Parámetros

connection: Especifica la conexión cliente DB2 activa.

Valores devueltos

Devuelve un objeto si la llamada es exitosa, o false si ocurre un error

Ejemplos

Ejemplo #1 Ejemplo con db2_server_info()

Para recuperar información sobre el servidor, se debe pasar un recurso de conexión de base de datos válido a la función db2_server_info().

<?php

$conn = db2_connect('sample', 'db2inst1', 'ibmdb2');

$server = db2_server_info( $conn );

if ($server) {
    echo "DBMS_NAME: ";                 var_dump( $server->DBMS_NAME );
    echo "DBMS_VER: ";                  var_dump( $server->DBMS_VER );
    echo "DB_CODEPAGE: ";               var_dump( $server->DB_CODEPAGE );
    echo "DB_NAME: ";                   var_dump( $server->DB_NAME );
    echo "INST_NAME: ";                 var_dump( $server->INST_NAME );
    echo "SPECIAL_CHARS: ";             var_dump( $server->SPECIAL_CHARS );
    echo "KEYWORDS: ";                  var_dump( sizeof($server->KEYWORDS) );
    echo "DFT_ISOLATION: ";             var_dump( $server->DFT_ISOLATION );
    echo "ISOLATION_OPTION: ";
    $il = '';
    foreach( $server->ISOLATION_OPTION as $opt )
    {
       $il .= $opt." ";
    }
    var_dump( $il );
    echo "SQL_CONFORMANCE: ";           var_dump( $server->SQL_CONFORMANCE );
    echo "PROCEDURES: ";                var_dump( $server->PROCEDURES );
    echo "IDENTIFIER_QUOTE_CHAR: ";     var_dump( $server->IDENTIFIER_QUOTE_CHAR );
    echo "LIKE_ESCAPE_CLAUSE: ";        var_dump( $server->LIKE_ESCAPE_CLAUSE );
    echo "MAX_COL_NAME_LEN: ";          var_dump( $server->MAX_COL_NAME_LEN );
    echo "MAX_ROW_SIZE: ";              var_dump( $server->MAX_ROW_SIZE );
    echo "MAX_IDENTIFIER_LEN: ";        var_dump( $server->MAX_IDENTIFIER_LEN );
    echo "MAX_INDEX_SIZE: ";            var_dump( $server->MAX_INDEX_SIZE );
    echo "MAX_PROC_NAME_LEN: ";         var_dump( $server->MAX_PROC_NAME_LEN );
    echo "MAX_SCHEMA_NAME_LEN: ";       var_dump( $server->MAX_SCHEMA_NAME_LEN );
    echo "MAX_STATEMENT_LEN: ";         var_dump( $server->MAX_STATEMENT_LEN );
    echo "MAX_TABLE_NAME_LEN: ";        var_dump( $server->MAX_TABLE_NAME_LEN );
    echo "NON_NULLABLE_COLUMNS: ";      var_dump( $server->NON_NULLABLE_COLUMNS );

    db2_close($conn);
}
?>

El ejemplo anterior mostrará:

DBMS_NAME: string(9) "DB2/LINUX"
DBMS_VER: string(10) "08.02.0000"
DB_CODEPAGE: int(1208)
DB_NAME: string(6) "SAMPLE"
INST_NAME: string(8) "db2inst1"
SPECIAL_CHARS: string(2) "@#"
KEYWORDS: int(179)
DFT_ISOLATION: string(2) "CS"
ISOLATION_OPTION: string(12) "UR CS RS RR "
SQL_CONFORMANCE: string(7) "FIPS127"
PROCEDURES: bool(true)
IDENTIFIER_QUOTE_CHAR: string(1) """
LIKE_ESCAPE_CLAUSE: bool(true)
MAX_COL_NAME_LEN: int(30)
MAX_ROW_SIZE: int(32677)
MAX_IDENTIFIER_LEN: int(18)
MAX_INDEX_SIZE: int(1024)
MAX_PROC_NAME_LEN: int(128)
MAX_SCHEMA_NAME_LEN: int(30)
MAX_STATEMENT_LEN: int(2097152)
MAX_TABLE_NAME_LEN: int(128)
NON_NULLABLE_COLUMNS: bool(true)

Ver también

db2_client_info() - Devuelve un objeto con propiedades que describen el cliente de base de datos DB2

db2_server_info

Descripción

Parámetros

Valores devueltos

Ejemplos

Ver también

Found A Problem?

User Contributed Notes