PHP: db2_server_info

Описание

db2_server_info(resource $connection): stdClass|false

Функция возвращает объект со свойствами только для чтения, которые возвращают информацию о сервере баз данных IBM DB2, Cloudscape или Apache Derby. В следующей таблице перечислены свойства сервера базы данных:

**Свойства сервера базы данных**
Название свойства	Тип возвращаемого значения	Описание
DBMS_NAME	string	Имя сервера базы данных, к которому вы подключены. Для серверов DB2 это комбинация `DB2`, за которой следует операционная система, в которой работает сервер базы данных.
DBMS_VER	string	Версия сервера базы данных в виде строки "MM.mm.uuuu", где `MM` - это мажорная версия, `mm` - это минорная версия, а `uuuu` - это патч-версия. Например, "08.02.0001" означает мажорную версию 8, минорную версию 2 и патч-версию 1.
DB_CODEPAGE	int	Кодовая страница базы данных, к которой вы подключены.
DB_NAME	string	Имя базы данных, к которой вы подключены.
DFT_ISOLATION	string	Уровень изоляции транзакции по умолчанию, поддерживаемый сервером: UR Незавершённое чтение: изменения сразу видны всем параллельным транзакциям. CS Стабильность курсора: строка, прочитанная одной транзакцией, может быть изменена и зафиксирована второй параллельной транзакцией. RS Стабильность чтения: транзакция может добавлять или удалять строки, соответствующие условию поиска или ожидающей транзакции. RR Повторяющееся чтение: данные, на которые влияет ожидающая транзакция, недоступны для других транзакций. NC Без фиксации: любые изменения видны в конце успешной операции. Явные коммиты и откаты недопустимы.
IDENTIFIER_QUOTE_CHAR	string	Символ, используемый для обозначения идентификатора.
INST_NAME	string	Экземпляр на сервере базы данных, содержащий базу данных.
ISOLATION_OPTION	array	Массив параметров изоляции, поддерживаемых сервером базы данных. Параметры изоляции описаны в свойстве DFT_ISOLATION.
KEYWORDS	array	Массив ключевых слов, зарезервированных сервером базы данных.
LIKE_ESCAPE_CLAUSE	bool	`true`, если сервер базы данных поддерживает использование подстановочных знаков `%` и `_`. `false`, если сервер базы данных не поддерживает эти подстановочные знаки.
MAX_COL_NAME_LEN	int	Максимальная длина имени столбца, поддерживаемая сервером базы данных, выраженная в байтах.
MAX_IDENTIFIER_LEN	int	Максимальная длина SQL-идентификатора, поддерживаемая сервером базы данных, выраженная в символах.
MAX_INDEX_SIZE	int	Максимальный размер столбцов, объединённых в индекс, поддерживаемый сервером базы данных, выраженный в байтах.
MAX_PROC_NAME_LEN	int	Максимальная длина имени процедуры, поддерживаемая сервером базы данных, выраженная в байтах.
MAX_ROW_SIZE	int	Максимальная длина строки в таблице базы данных, поддерживаемая сервером базы данных, выраженная в байтах.
MAX_SCHEMA_NAME_LEN	int	Максимальная длина имени схемы, поддерживаемая сервером базы данных, выраженная в байтах.
MAX_STATEMENT_LEN	int	Максимальная длина SQL-оператора, поддерживаемая сервером базы данных, выраженная в байтах.
MAX_TABLE_NAME_LEN	int	Максимальная длина имени таблицы, поддерживаемая сервером базы данных, выраженная в байтах.
NON_NULLABLE_COLUMNS	bool	`true`, если сервер базы данных поддерживает столбцы, которые можно определить как NOT NULL, `false`, если сервер базы данных не поддерживает столбцы, определённые как NOT NULL.
PROCEDURES	bool	`true`, если сервер базы данных поддерживает использование оператора CALL для вызова хранимых процедур, `false`, если сервер базы данных не поддерживает оператор CALL.
SPECIAL_CHARS	string	Строка, содержащая все символы, кроме a-Z, 0-9 и подчёркивания, которые можно использовать в имени идентификатора.
SQL_CONFORMANCE	string	Уровень соответствия спецификации ANSI/ISO SQL-92, предлагаемый сервером базы данных: ENTRY Соответствие начальному уровню SQL-92. FIPS127 Переходное соответствие FIPS-127-2. FULL Полное соответствие стандарту SQL-92. INTERMEDIATE Соответствие среднему уровню SQL-92.

Список параметров

connection: Задаёт активное соединение клиента DB2.

Возвращаемые значения

Возвращает объект в случае успешного вызова функции или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования db2_server_info()

Чтобы получить информацию о сервере, вы должны передать действительный ресурс подключения к базе данных в 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);
}
?>

Результат выполнения приведённого примера:

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)

Смотрите также

db2_client_info() - Возвращает объект со свойствами, описывающими клиента DB2

db2_server_info

Описание

Список параметров

Возвращаемые значения

Примеры

Смотрите также

User Contributed Notes