PHP8 db2_server_info

2024-04-08 10:14 更新

（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	字符串	支持的默认事务隔离级别服务器：出生未提交读取：所有人都可以立即看到更改并发事务。 CS系列游标稳定性：一个事务读取的行可以更改，并且由第二个并发事务提交。 RS （英语）读取稳定性：事务可以添加或删除与搜索条件或挂起的交易。 RR型可重复读取：受待处理事务影响的数据不是可用于其他事务。数控无提交：任何更改在成功结束时都可见操作。不允许显式提交和回滚。
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 规范的级别由数据库服务器提供：进入入门级 SQL-92 合规性。 FIPS127 FIPS-127-2 过渡合规性。满完全符合 SQL-92 标准。中间中级 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 数据库客户机的属性

以上内容是否对您有帮助：

← PHP8 db2_rollback

PHP8 db2_set_option →

写笔记

我要补充