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

描述

参数

返回值

示例

参见

改进此页面

用户贡献笔记