(PECL ibm_db2 >= 1.1.1)
db2_server_info — Devuelve un objeto con propiedades que describen el servidor de base de datos DB2
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:
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:
|
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:
|
connection
Especifica la conexión cliente DB2 activa.
Devuelve un objeto si la llamada es exitosa, o false
en caso de error
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 resultado del ejemplo sería:
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)