db2_get_option

(PECL ibm_db2 >= 1.6.0)

db2_get_option — 명령문 자원 또는 연결 자원에 대한 옵션 값을 검색합니다.


설명

db2_get_option(resource $resource, string $option): string|false

명령문 자원 또는 연결 자원에 대해 지정된 옵션 값의 값을 검색합니다.


매개변수

resource
db2_prepare()에서 리턴된 유효한 명령문 자원 또는 db2_connect() 또는 db2_pconnect()에서 리턴된 유효한 연결 자원.
option
유효한 명령문 또는 연결 옵션. 다음 새 옵션은 ibm_db2 버전 1.6.0부터 사용할 수 있습니다. db2_get_option()을 사용하여 실행 중에 설정할 수 있는 유용한 추적 정보를 제공합니다.

메모:

이전 버전의 ibm_db2는 이러한 새 옵션을 지원하지 않습니다.

각 옵션의 값을 설정할 때 일부 서버는 제공된 전체 길이를 처리하지 못하고 값이 잘릴 수 있습니다.

각 옵션에 지정된 데이터가 호스트 시스템으로 전송될 때 올바르게 변환되도록 하려면 문자 A~Z, 0~9, 밑줄(_) 또는 마침표(.)만 사용하십시오.

userid
SQL_ATTR_INFO_USERID - DB2 Connect를 사용할 때 호스트 데이터베이스 서버로 보낸 클라이언트 사용자 ID를 식별하는 데 사용되는 널 종료 문자열에 대한 포인터.

메모: z/OS 및 OS/390용 DB2 서버는 최대 16자 길이를 지원합니다. 이 사용자 ID는 인증 사용자 ID와 혼동되어서는 안 되며 식별 목적으로만 사용되며 권한 부여에는 사용되지 않습니다.

acctstr
SQL_ATTR_INFO_ACCTSTR - DB2 Connect를 사용할 때 호스트 데이터베이스 서버에 전송된 클라이언트 계정 문자열을 식별하는 데 사용되는 null로 끝나는 문자열에 대한 포인터입니다.

메모: z/OS 및 OS/390용 DB2 서버는 최대 200자 길이를 지원합니다.

applname
SQL_ATTR_INFO_APPLNAME - DB2 Connect를 사용할 때 호스트 데이터베이스 서버에 전송된 클라이언트 응용 프로그램 이름을 식별하는 데 사용되는 null로 끝나는 문자열에 대한 포인터입니다.

메모: z/OS 및 OS/390용 DB2 서버는 최대 32자 길이를 지원합니다.

wrkstnname
SQL_ATTR_INFO_WRKSTNNAME - DB2 Connect를 사용할 때 호스트 데이터베이스 서버에 보낸 클라이언트 워크스테이션 이름을 식별하는 데 사용되는 널 종료 문자열에 대한 포인터.

메모: z/OS 및 OS/390용 DB2 서버는 최대 18자 길이를 지원합니다.

다음 표에서는 사용 가능한 리소스 유형과 호환되는 옵션을 지정합니다.

자원-매개변수 매트릭스

Key Value Resource Type
  Connection Statement Result Set
userid SQL_ATTR_INFO_USERID X X -
acctstr SQL_ATTR_INFO_ACCTSTR X X -
applname SQL_ATTR_INFO_APPLNAME X X -
wrkstnname SQL_ATTR_INFO_WRKSTNNAME X X -

반환 값

성공 시 제공된 연결 속성의 현재 설정을 반환하고 실패 시 false를 반환합니다.


Examples

예제 #1 연결 리소스를 통한 매개변수 설정 및 검색

                  
<?php
<?php/* Database Connection Parameters */
$database = 'SAMPLE';
$user     = 'db2inst1';
$password = 'ibmdb2';

/* Obtain Connection Resource */
$conn = db2_connect($database, $user, $password);

echo "Client attributes passed through connection string:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes through connection string */
/* Access the options specified */
$options1 = array('userid' => 'db2inst1');
$conn1 = db2_connect($database, $user, $password, $options1);
$val = db2_get_option($conn1, 'userid');
echo $val . "\n";

$options2 = array('acctstr' => 'account');
$conn2 = db2_connect($database, $user, $password, $options2);
$val = db2_get_option($conn2, 'acctstr');
echo $val . "\n";

$options3 = array('applname' => 'myapp');
$conn3 = db2_connect($database, $user, $password, $options3);
$val = db2_get_option($conn3, 'applname');
echo $val . "\n";

$options4 = array('wrkstnname' => 'workstation');
$conn4 = db2_connect($database, $user, $password, $options4);
$val = db2_get_option($conn4, 'wrkstnname');
echo $val . "\n";

echo "Client attributes passed post-connection:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes after a connection is made */
/* Access the options specified */
$options5 = array('userid' => 'db2inst1');
$conn5 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn5, $options5, 1);
$val = db2_get_option($conn5, 'userid');
echo $val . "\n";

$options6 = array('acctstr' => 'account');
$conn6 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn6, $options6, 1);
$val = db2_get_option($conn6, 'acctstr');
echo $val . "\n";

$options7 = array('applname' => 'myapp');
$conn7 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn7, $options7, 1);
$val = db2_get_option($conn7, 'applname');
echo $val . "\n";

$options8 = array('wrkstnname' => 'workstation');
$conn8 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn8, $options8, 1);
$val = db2_get_option($conn8, 'wrkstnname');
echo $val . "\n";
?>
                  
                

위의 예는 다음을 출력합니다.

Client attributes passed through connection string:
db2inst1
account
myapp
workstation
Client attributes passed post-connection:
db2inst1
account
myapp
workstation
                

기타

  • db2_connect() - 데이터베이스에 대한 연결을 반환합니다.
  • db2_cursor_type() - 명령문 리소스에서 사용하는 커서 유형을 반환합니다.
  • db2_exec() - SQL 문을 직접 실행
  • db2_set_option() - 연결 또는 명령문 리소스에 대한 옵션 설정
  • db2_pconnect() - 데이터베이스에 대한 지속적인 연결을 반환합니다.
  • db2_prepare() - 실행할 SQL 문을 준비합니다.