db2_server_info
(PECL ibm_db2 >= 1.1.1)
db2_server_info — DB2 데이터베이스 서버를 설명하는 속성이 있는 객체를 반환합니다.
설명
db2_server_info(resource $connection
): object
이 함수는 IBM DB2, Cloudscape 또는 Apache Derby 데이터베이스 서버에 대한 정보를 반환하는 읽기 전용 속성이 있는 개체를 반환합니다. 다음 표에는 데이터베이스 서버 속성이 나열되어 있습니다.
데이터베이스 서버 속성
Property name | Return type | 설명 |
---|---|---|
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 | 서버에서 지원하는 기본 트랜잭션 격리 수준:
|
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 이고, 데이터베이스 서버가 NOT NULL로 정의된 열을 지원하지 않는 경우 false 입니다. |
PROCEDURES | bool | 데이터베이스 서버가 저장 프로시저를 호출하기 위해 CALL 문 사용을 지원하는 경우 true 이고, 데이터베이스 서버가 CALL 문을 지원하지 않는 경우 false 입니다. |
SPECIAL_CHARS | string | 식별자 이름에 사용할 수 있는 a-Z, 0-9 및 밑줄을 제외한 모든 문자를 포함하는 문자열입니다. |
SQL_CONFORMANCE | string | 데이터베이스 서버에서 제공하는 ANSI/ISO SQL-92 사양에 대한 준수 수준:
|
매개변수
connection
- 활성 DB2 클라이언트 연결을 지정합니다.
반환 값
호출이 성공하면 개체를 반환합니다. 실패 시 false
를 반환합니다.
Examples
예제 #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 데이터베이스 클라이언트를 설명하는 속성이 있는 개체를 반환합니다.