PHP8 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 | 字符串 | 您所到的数据库服务器的名称 连接。对于 DB2 服务器,这是后跟操作系统的组合 数据库服务器正在运行。DB2 |
DBMS_VER | 字符串 | 数据库服务器的版本,采用字符串形式 “MM.mm.uuuu”其中是主要版本,是次要版本, 并且是更新。例如,“08.02.0001” 表示主要版本 8、次要版本 2、更新 1。MMmmuuuu |
DB_CODEPAGE | 国际 | 连接到的数据库的代码页。 |
DB_NAME | 字符串 | 连接到的数据库的名称。 |
DFT_ISOLATION | 字符串 | 支持的默认事务隔离级别 服务器:
|
IDENTIFIER_QUOTE_CHAR | 字符串 | 用于分隔标识符的字符。 |
INST_NAME | 字符串 | 数据库服务器上包含 数据库。 |
ISOLATION_OPTION | 数组 | 支持的隔离选项数组 数据库服务器。隔离选项在 DFT_ISOLATION属性。 |
关键字 | 数组 | 数据库保留的关键字数组 服务器。 |
LIKE_ESCAPE_CLAUSE | 布尔 | 如果 数据库服务器支持 和 通配符的使用 字符。如果数据库服务器不这样做,则为 false 支持这些通配符。% _ |
MAX_COL_NAME_LEN | 国际 | 数据库支持的列名的最大长度 服务器,以字节表示。 |
MAX_IDENTIFIER_LEN | 国际 | 数据库支持的 SQL 标识符的最大长度 服务器,以字符表示。 |
MAX_INDEX_SIZE | 国际 | 索引中组合的列的最大大小 数据库服务器,以字节表示。 |
MAX_PROC_NAME_LEN | 国际 | 数据库支持的过程名称的最大长度 服务器,以字节表示。 |
MAX_ROW_SIZE | 国际 | 基表中一行的最大长度,由 数据库服务器,以字节表示。 |
MAX_SCHEMA_NAME_LEN | 国际 | 数据库支持的架构名称的最大长度 服务器,以字节表示。 |
MAX_STATEMENT_LEN | 国际 | 数据库支持的 SQL 语句的最大长度 服务器,以字节表示。 |
MAX_TABLE_NAME_LEN | 国际 | 数据库支持的表名的最大长度 服务器,以字节表示。 |
Non_Nullable_Columns | 布尔 | 如果 数据库服务器支持的列可以 定义为 NOT NULL,如果数据库服务器不支持,则为 false 定义为 NOT NULL 的列。 |
程序 | 布尔 | 如果数据库服务器支持使用 CALL 语句调用存储过程,如果数据库为 false 服务器不支持 CALL 语句。 |
SPECIAL_CHARS | 字符串 | 包含除 a-Z、0-9 和下划线,可用于标识符名称。 |
SQL_CONFORMANCE | 字符串 | 符合 ANSI/ISO SQL-92 规范的级别 由数据库服务器提供:
|
参数
connection
指定活动的 DB2 客户机连接。
返回值
在成功的调用中返回一个对象, 或者在失败时返回 false
示例
示例 #1 A db2_server_info() example
若要检索有关服务器的信息,必须传递有效的 数据库连接资源设置为 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 数据库客户机的属性