PHP Conference Nagoya 2025

db2_server_info

(PECL ibm_db2 >= 1.1.1)

db2_server_infoВозвращает объект со свойствами, описывающими сервер базы данных DB2

Описание

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

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top