Difference between revisions of "Remote Data Connectivity"

From Recital Documentation Wiki
Jump to: navigation, search
(Sending SQL Queries and Statements)
(Sending SQL Queries and Statements)
Line 61: Line 61:
  
 
* [[RDO_REAL_ESCAPE_STRING()|rdo_real_escape_string()]] - escape special characters in a string for use in an SQL statement
 
* [[RDO_REAL_ESCAPE_STRING()|rdo_real_escape_string()]] - escape special characters in a string for use in an SQL statement
 +
 +
<pre>
 +
string = rdo_real_escape_string(query as string [, connection as numeric])
 +
</pre>
 +
 
* [[RDO_AFFECTED_ROWS()|rdo_affected_rows()]] - return the number of rows affected by the last operation
 
* [[RDO_AFFECTED_ROWS()|rdo_affected_rows()]] - return the number of rows affected by the last operation
 +
 +
<pre>
 +
numeric = rdo_affected_rows()
 +
</pre>
 +
 
* [[RDO_INFO()|rdo_info()]] - return information about the last query
 
* [[RDO_INFO()|rdo_info()]] - return information about the last query
 +
 +
<pre>
 +
string = rdo_info()
 +
</pre>
  
 
====Processing Result Sets====
 
====Processing Result Sets====

Revision as of 14:37, 28 July 2010

Remote Data Connectivity

Overview of Remote Data Connectivity Functions

Overview of Recital Data Objects (RDO)

The RDO functions can be used for data access for both remote third-party/Recital and local Recital data sources. The functions allow a connection to be made to the data, SQL queries to be sent and the results to be loaded into a result set object for further processing.

Each MySQL compatible RDO function also has a MySQL-named equivalent for ease of use, e.g. rdo_connect() and mysql_connect() are synonyms.

Connecting to a Data Source

numeric = rdo_connect(servertype as character, hostname_or_ip as character, account as character, 
  password as character [, database as character])
numeric = rdo_select_db(database as character [, connection as numeric])

Disconnecting from a Data Source

numeric = rdo_close(connection as numeric)

Sending SQL Queries and Statements

numeric = rdo_exec(statement as string [, connection as numeric])
  • rdo_query() - return a result set object for a SELECT query
object = rdo_query(query as string [, connection as numeric])
object = rdo_unbuffered_query(query as string [, connection as numeric])
string = rdo_real_escape_string(query as string [, connection as numeric])
numeric = rdo_affected_rows()
  • rdo_info() - return information about the last query
string = rdo_info()

Processing Result Sets

Getting Error Information

  • rdo_errno() - return the number of the last error
  • rdo_error() - return the error description of the last Recital error

Getting Environment Information

Examples

Using Recital Client/Server

Using Recital with MySQL

Using Recital with PostgreSQL

Using Recital with Oracle

Using Recital with DB2