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 서버에서 지원하는 기본 트랜잭션 격리 수준:
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 데이터베이스 서버가 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 사양에 대한 준수 수준:
ENTRY
엔트리 레벨 SQL-92 규정 준수.
FIPS127
FIPS-127-2 과도기 준수.
FULL
전체 수준 SQL-92 준수.
INTERMEDIATE
중급 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 데이터베이스 클라이언트를 설명하는 속성이 있는 개체를 반환합니다.