PHP マニュアル
前のページ |  | 次のページ

# db2_server_info

(no version information, might be only in CVS)

db2_server_info -- DB2 データベースサーバの情報をプロパティに保持するオブジェクトを返す

## 説明

object db2_server_info ( resource connection )

この関数は、IBM DB2、Cloudscape あるいは Apache Derby データベースサーバについての情報を 読み取り専用のプロパティに保持するオブジェクトを返します。 以下の表は、データベースサーバのプロパティの一覧です。

表 1. データベースサーバのプロパティ

プロパティ名 | 返り値の型 | 説明
--- | --- | ---
DBMS_NAME | string | 接続中のデータベースサーバの名前。DB2 サーバの場合は、 `DB2` の後にサーバが稼動している OS の名前が続きます。
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

  Uncommitted read: 変更内容は、他のトランザクションからも すぐに見えるようになります。

CS

  Cursor stability: あるトランザクションで読み込まれた行を、 別のトランザクションから変更してコミットすることができます。

RS

  Read stability: 検索条件あるいは実行中のトランザクションに 一致する行を、トランザクションから追加したり削除したりできます。

RR

  Repeatable read: 実行中のトランザクションに影響を受けるデータは、 他のトランザクションからは見えません。

NC

  No commit: 変更内容は、操作が終了した時点で見えるようになります。 明示的なコミットやロールバックはできません。

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 | データベースサーバがカラムの NOT NULL 定義をサポートしている場合に `TRUE`、サポートしていない場合に `FALSE`。
PROCEDURES | bool | データベースサーバがストアドプロシージャをコールするための CALL 文をサポートしている場合に `TRUE`、サポートしていない場合に `FALSE`。
SPECIAL_CHARS | string | 識別子として使用可能な文字のうち、 a-Z、0-9 およびアンダースコア以外の文字。

SQL_CONFORMANCE

string

データベースサーバの ANSI/ISO SQL-92 仕様への対応レベル。

ENTRY

  SQL-92 エントリレベルに準拠しています。

FIPS127

  FIPS-127-2 transitional に準拠しています。

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_rollback | 上に戻る | db2_set_option