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 문을 준비합니다.