array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.db2-server-info.php', 1 => 'db2_server_info', 2 => 'Devuelve un objeto con propiedades que describen el servidor de base de datos DB2', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funciones de IBM DB2', ), 'prev' => array ( 0 => 'function.db2-rollback.php', 1 => 'db2_rollback', ), 'next' => array ( 0 => 'function.db2-set-option.php', 1 => 'db2_set_option', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/ibm_db2/functions/db2-server-info.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_server_info

(PECL ibm_db2 >= 1.1.1)

db2_server_info — Devuelve un objeto con propiedades que describen el servidor de base de datos DB2

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 int 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 bool 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 int Tamaño máximo de un nombre de columna soportado por el servidor de base de datos, expresado en bytes.
MAX_IDENTIFIER_LEN int Tamaño máximo de un identificador SQL soportado por los servidores de base de datos, expresado en caracteres.
MAX_INDEX_SIZE int 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 int Tamaño máximo de un nombre de procedimiento soportado por el servidor de base de datos, expresado en bytes.
MAX_ROW_SIZE int 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 int Tamaño máximo de un nombre de esquema soportado por el servidor de base de datos, expresado en bytes.
MAX_STATEMENT_LEN int Tamaño máximo de una consulta SQL soportada por el servidor de base de datos, expresado en bytes.
MAX_TABLE_NAME_LEN int Tamaño máximo de un nombre de tabla soportado por el servidor de base de datos, expresado en bytes.
NON_NULLABLE_COLUMNS bool 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 bool 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