(PECL ibm_db2 >= 1.1.1)
db2_server_info — Retorna um objeto com propriedades que descrevem o servidor de banco de dados DB2
Esta função retorna um objeto com propriedades somente leitura que retornam informações sobre o servidor de banco de dados IBM DB2, Cloudscape ou Apache Derby. A tabela a seguir lista as propriedades do servidor de banco de dados:
Nome da propriedade | Tipo de retorno | Descrição |
---|---|---|
DBMS_NAME | string | O nome do servidor de banco de dados
conectado. Para servidores DB2, esta é uma combinação de
DB2 seguido pelo sistema operacional no qual
o servidor de banco de dados está sendo executado. |
DBMS_VER | string | A versão do servidor de banco de dados, na forma de uma string "MM.mm.uuuu" onde MM é a versão principal, mm é a versão secundária, e uuuu é a atualização. Por exemplo, "08.02.0001" representa a versão principal 8, versão secundária 2, atualização 1. |
DB_CODEPAGE | int | A página de código do banco de dados conectado. |
DB_NAME | string | O nome do banco de dados conectado. |
DFT_ISOLATION | string |
O nível de isolamento de transação padrão suportado pelo servidor:
|
IDENTIFIER_QUOTE_CHAR | string | O caractere usado para delimitar um identificador. |
INST_NAME | string | A instância no servidor de banco de dados que contém o banco de dados. |
ISOLATION_OPTION | array | Um array das opções de isolamento suportadas pelo servidor de banco de dados. As opções de isolamento são descritas na propriedade DFT_ISOLATION. |
KEYWORDS | array | Um array de palavras-chave reservadas pelo servidor de banco de dados. |
LIKE_ESCAPE_CLAUSE | bool | true se o servidor de banco de dados suportar o
uso dos caracteres curinga % e _ . false
se o servidor de banco de dados não suportar
esses caracteres curinga. |
MAX_COL_NAME_LEN | int | Comprimento máximo de um nome de coluna suportado pelo servidor de banco de dados, expresso em bytes. |
MAX_IDENTIFIER_LEN | int | Comprimento máximo de um identificador SQL suportado pelo servidor de banco de dados, expresso em caracteres. |
MAX_INDEX_SIZE | int | Maximum size of columns combined in an index supported by the database server, expressed in bytes. |
MAX_PROC_NAME_LEN | int | Comprimento máximo de um nome de procedimento suportado pelo servidor de banco de dados, expresso em bytes. |
MAX_ROW_SIZE | int | Comprimento máximo de uma linha em uma tabela base suportada pelo servidor de banco de dados, expresso em bytes. |
MAX_SCHEMA_NAME_LEN | int | Comprimento máximo de um nome de esquema suportado pelo servidor de banco de dados, expresso em bytes. |
MAX_STATEMENT_LEN | int | Comprimento máximo de uma instrução SQL suportada pelo servidor de banco de dados, expresso em bytes. |
MAX_TABLE_NAME_LEN | int | Comprimento máximo de um nome de tabela suportado pelo servidor de banco de dados, expresso em bytes. |
NON_NULLABLE_COLUMNS | bool | true se o servidor de banco de dados suportar colunas que podem ser
definidas como NOT NULL, false se o servidor de banco de dados não suportar
colunas definidas como NOT NULL. |
PROCEDURES | bool | true se o servidor de banco de dados suportar o uso da instrução CALL
para chamar procedimentos armazenados, false se o servidor de banco de dados
não suportar a instrução CALL. |
SPECIAL_CHARS | string | Uma string contendo todos os caracteres, exceto a-Z, 0-9 e sublinhado, que podem ser usados em um nome de identificador. |
SQL_CONFORMANCE | string |
O nível de conformidade com a especificação ANSI/ISO SQL-92 oferecido pelo servidor de banco de dados:
|
connection
Especifica uma conexão de cliente DB2 ativa.
Retorna um objeto em uma chamada bem-sucedida, ou false
em caso de falha
Exemplo #1 Um exemplo de db2_server_info()
Para recuperar informações sobre o servidor, deve-se passar um recurso de conexão de banco de dados válido para 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);
}
?>
O exemplo acima produzirá:
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)