Difference between revisions of "RDO CONNECT()"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
(14 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
− | { | + | ==Purpose== |
− | + | Connect to a data source | |
+ | |||
+ | |||
+ | ==Syntax== | ||
+ | RDO_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>]) | ||
+ | |||
+ | MYSQL_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>]) | ||
+ | |||
+ | |||
+ | ==See Also== | ||
+ | [[RDO_AFFECTED_ROWS()]], [[RDO_CLOSE()]], [[RDO_DATA_SEEK()]], [[RDO_ERRNO()]], [[RDO_ERROR()]], [[RDO_EXEC()]], [[RDO_FETCH_ARRAY()]], [[RDO_FETCH_ASSOC()]], [[RDO_FETCH_FIELD()]], [[RDO_FETCH_LENGTHS()]], [[RDO_FETCH_OBJECT()]], [[RDO_FETCH_ROW()]], [[RDO_FIELD_FLAGS()]], [[RDO_FIELD_LEN()]], [[RDO_FIELD_NAME()]], [[RDO_FIELD_SEEK()]], [[RDO_FIELD_TABLE()]], [[RDO_FIELD_TYPE()]], [[RDO_FREE_OBJECT()]], [[RDO_FREE_RESULT()]], [[RDO_GET_CLIENT_INFO()]], [[RDO_GET_HOST_INFO()]], [[RDO_INFO()]], [[RDO_LIST_DBS()]], [[RDO_NUM_FIELDS()]], [[RDO_NUM_ROWS()]], [[RDO_PING()]], [[RDO_QUERY()]], [[RDO_REAL_ESCAPE_STRING()]], [[RDO_RESULT()]], [[RDO_SELECT_DB()]], [[RDO_STAT()]], [[RDO_THREAD_ID()]], [[RDO_UNBUFFERED_QUERY()]] | ||
+ | |||
+ | |||
+ | ==Description== | ||
+ | The RDO_CONNECT() function is used to connect to a data source. The numeric value returned should be saved to a variable to be used by other functions to reference the connection. Connection references start from 0 and correspond to the [[SELECT()|cursor/workarea]] -1. If RDO_CONNECT() returns -1, the connection failed. | ||
+ | |||
+ | |||
+ | {| class="wikitable" | ||
+ | !Keywords||Description | ||
+ | |- | ||
+ | |<expC1>||Servertype: "recital", "oracle", "db2", "mysql" or "postgres" | ||
+ | |- | ||
+ | |<expC2>||Hostname: IP address or character name | ||
+ | |- | ||
+ | |<expC3>||Username: account used to access the data source | ||
+ | |- | ||
+ | |<expC4>||Password: password for account above | ||
+ | |- | ||
+ | |<expC5>||Database: database to connect to | ||
+ | |- | ||
+ | |} | ||
+ | |||
+ | |||
+ | ==Example== | ||
+ | <code lang="recital"> | ||
+ | conn = rdo_connect("mysql","localhost", "user", "pass", "test") | ||
+ | if conn > -1 | ||
+ | rdo_exec("create table mytable (phrase char(20))", conn) | ||
+ | rdo_exec("insert into mytable values ('Hello world')") | ||
+ | echo rdo_affected_rows() | ||
+ | rdo_close(conn) | ||
+ | endif | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ==Products== | ||
+ | Recital, Recital Server | ||
+ | [[Category:Documentation]] | ||
+ | [[Category:Functions]] | ||
+ | [[Category:SQL]] | ||
+ | [[Category:Remote Data Connectivity]] | ||
+ | [[Category:Remote Data Connectivity Functions]] |
Latest revision as of 11:57, 22 June 2010
Purpose
Connect to a data source
Syntax
RDO_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])
MYSQL_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])
See Also
RDO_AFFECTED_ROWS(), RDO_CLOSE(), RDO_DATA_SEEK(), RDO_ERRNO(), RDO_ERROR(), RDO_EXEC(), RDO_FETCH_ARRAY(), RDO_FETCH_ASSOC(), RDO_FETCH_FIELD(), RDO_FETCH_LENGTHS(), RDO_FETCH_OBJECT(), RDO_FETCH_ROW(), RDO_FIELD_FLAGS(), RDO_FIELD_LEN(), RDO_FIELD_NAME(), RDO_FIELD_SEEK(), RDO_FIELD_TABLE(), RDO_FIELD_TYPE(), RDO_FREE_OBJECT(), RDO_FREE_RESULT(), RDO_GET_CLIENT_INFO(), RDO_GET_HOST_INFO(), RDO_INFO(), RDO_LIST_DBS(), RDO_NUM_FIELDS(), RDO_NUM_ROWS(), RDO_PING(), RDO_QUERY(), RDO_REAL_ESCAPE_STRING(), RDO_RESULT(), RDO_SELECT_DB(), RDO_STAT(), RDO_THREAD_ID(), RDO_UNBUFFERED_QUERY()
Description
The RDO_CONNECT() function is used to connect to a data source. The numeric value returned should be saved to a variable to be used by other functions to reference the connection. Connection references start from 0 and correspond to the cursor/workarea -1. If RDO_CONNECT() returns -1, the connection failed.
Keywords | Description |
---|---|
<expC1> | Servertype: "recital", "oracle", "db2", "mysql" or "postgres" |
<expC2> | Hostname: IP address or character name |
<expC3> | Username: account used to access the data source |
<expC4> | Password: password for account above |
<expC5> | Database: database to connect to |
Example
conn = rdo_connect("mysql","localhost", "user", "pass", "test") if conn > -1 rdo_exec("create table mytable (phrase char(20))", conn) rdo_exec("insert into mytable values ('Hello world')") echo rdo_affected_rows() rdo_close(conn) endif
Products
Recital, Recital Server