cubrid_connect_with_url
설명
url 인자로 전달된 접속 정보를 이용하여 데이터베이스로 연결을 시도한다. PHP에서 HA 기능을 사용하는 경우, 이 함수의 url 인자에 active 서버의 연결 정보 및 장애 발생 시 failover할 standby 서버의 연결 정보를 명시해야 한다. 서버 연결에 성공하면 연결 핸들 ID를 반환하고, 실패하면 에러 코드를 반환한다.
구문
int cubrid_connect_with_url (char *url [, char *db_user, char *db_password ])
<url> ::=
cci:cubrid:<host>:<db_name>:<db_user>:<db_password>:[?<properties>]
<properties> ::= <property> [&<property>]
<property> ::= althosts=<alternative_hosts> [&rctime=<time>]
<alternative_hosts> ::= <standby_broker1_host>:<port> [,<standby_broker2_host>:<port>]
<host> := HOSTNAME | IP_ADDR
<time> := SECOND
- url : (IN) 서버 연결 정보 문자 스트링
- host : 마스터 데이터베이스의 호스트 이름 또는 IP 주소
- db_name : 데이터베이스 이름
- db_user : 데이터베이스 사용자 이름
- db_password : 데이터베이스 사용자 비밀번호
- althosts=standby_broker1_host, standby_broker2_host, ... : active 서버에 연결할 수 없는 경우, 그 다음으로 연결을 시도(failover)할 standby 서버의 브로커 정보를 나타낸다. failover할 브로커를 여러 개 지정할 수 있고, alhosts에 나열한 순서대로 연결을 시도한다.
- rctime : 장애가 발생했던 active 브로커에 연결을 시도하는 주기이다. 장애 발생 후 althosts에 명시한 브로커로 접속하여(failover) 트랜잭션을 종료한 후, rctime만큼 시간이 경과할 때마다 마스터 데이터베이스의 active 브로커에 연결을 시도한다. 디폴트 값은 600초이다.
- db_user : (IN) 데이터베이스 사용자 이름
- db_passwd : (IN) 데이터베이스 사용자 비밀번호
리턴 값
- 성공 : 연결 핸들 ID (int)
- 실패 : 에러 코드