 |
Qore Programming Language Reference Manual
0.9.4.2
|
179 constructor(
string driver, *
string user, *
string pass, *
string db, *
string encoding, *
string host, *softint port, *hash<auto> options, *
Qore::Thread::Queue queue,
auto arg);
279 *hash<auto>
describe(
string sql, ...);
310 auto exec(
string sql, ...);
743 auto select(
string sql, ...);
914 nothing
setPort(softint port = 0);
981 auto vexec(
string sql, *softlist<auto> vargs);
1015 auto vselect(
string sql, *softlist<auto> vargs);
1041 *hash<auto>
vselectRow(
string sql, *softlist<auto> vargs);
1073 auto vselectRows(
string sql, *softlist<auto> vargs);
1080 const DSDB2 =
"db2";
*string getHostName()
Returns the hostname parameter as a string or NOTHING if none is set.
const DBI_CAP_STORED_PROCEDURES
Indicates that the DBI driver supports stored procedure execution.
Definition: QC_Datasource.dox.h:1135
*hash< auto > selectRow(string sql,...)
Executes an SQL select statement on the server and returns the first row as a hash (the column values...
nothing setAutoCommit(bool ac=True)
Turns autocommit on or off for this object.
const DBI_CAP_HAS_RESULTSET_OUTPUT
Indicates that the DBI driver supports result set output binding with a SQLStatement output variable.
Definition: QC_Datasource.dox.h:1125
The Serializable class can be used to mark a class as being serializable.
Definition: QC_Serializable.dox.h:96
const DBI_CAP_HAS_OPTION_SUPPORT
Indicates that the DBI driver supports the new driver option API.
Definition: QC_Datasource.dox.h:1121
*string getPassword()
Returns the password parameter as a string or NOTHING if none is set.
hash< auto > getOptionHash()
returns the valid options for the driver associated with the Datasource with descriptions and current...
*string getDBEncoding()
Retrieves the database-specific charset set encoding for the current connection.
const DBI_CAP_CHARSET_SUPPORT
Indicates that the DBI driver supports proper character encoding conversions.
Definition: QC_Datasource.dox.h:1109
destructor()
Closes the datasource if it's open (if any operations are in progress, will block until the operation...
auto execRaw(string sql)
Grabs the transaction lock (if autocommit is disabled) and executes an SQL command on the server and ...
list< auto > getCapabilityList()
Returns a list of strings giving the capabilities of the current DBI driver.
const DSSQLite3
for the "sqlite3" driver
Definition: QC_Datasource.dox.h:1093
*string getDBName()
Returns the database name parameter as a string or NOTHING if none is set.
const DBI_CAP_EVENTS
Indicates that the DBI driver supports the event API.
Definition: QC_Datasource.dox.h:1111
const DBI_CAP_HAS_SELECT_ROW
Indicates that the DBI driver supports a native selectRow() method implementation.
Definition: QC_Datasource.dox.h:1127
string getOSCharset()
Returns the Qore character encoding name for the current connection as a string or "(unknown)" if non...
constructor()
The constructor does not perform any action; this class is just used to mark a class as serializable ...
const DBI_CAP_SERVER_TIME_ZONE
Indicates that the DBI driver supports automatically converting date/time values to the server's pres...
Definition: QC_Datasource.dox.h:1133
const True
logical True
Definition: qc_qore.dox.h:98
const DBI_CAP_TRANSACTION_MANAGEMENT
Indicates that the DBI driver supports transaction management.
Definition: QC_Datasource.dox.h:1139
*hash< auto > vselectRow(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the first row as a hash (column names and value...
const DBI_CAP_HAS_ARRAY_BIND
Indicates that the DBI driver supports binding arrays by value for bulk DML operations.
Definition: QC_Datasource.dox.h:1113
const DSMSSQL
another constant for the "freetds" driver
Definition: QC_Datasource.dox.h:1085
copy()
Creates a new Datasource object with the same driver as the original and copies of all the connection...
Queue objects provide a blocking, thread-safe message-passing object to Qore programs
Definition: QC_Queue.dox.h:17
const DSPGSQL
for the "pgsql" driver
Definition: QC_Datasource.dox.h:1091
auto select(string sql,...)
Executes an SQL select statement on the server and returns the result as a hash (column names) of lis...
*string getDBCharset()
Retrieves the database-specific charset set encoding for the current connection.
bool inTransaction()
Returns True if a transaction is currently in progress, False if not.
bool currentThreadInTransaction()
Returns True if the current thread is in a transaction (i.e. holds the transaction lock),...
const DSMySQL
for the "mysql" driver
Definition: QC_Datasource.dox.h:1087
nothing beginTransaction()
Manually grabs the transaction lock.
const DBI_CAP_HAS_NUMBER_SUPPORT
Indicates that the DBI driver supports arbitrary-precision numeric support for binding and retrieving...
Definition: QC_Datasource.dox.h:1119
nothing setTransactionLockTimeout(timeout timeout_ms=0)
Sets the transaction lock timeout value in milliseconds; set to 0 for no timeout.
This class defines an abstract interface for database access, inherited by both the Datasource and Da...
Definition: QC_AbstractDatasource.dox.h:10
This class provides the Qore interface to databases.
Definition: QC_Datasource.dox.h:105
hash< auto > getConfigHash()
Returns a datasource hash describing the configuration of the current object.
nothing setUserName(string user)
Sets the username parameter for the time a connection to the server is established.
auto vexec(string sql, *softlist< auto > vargs)
Grabs the transaction lock (if autocommit is disabled) and executes SQL code on the DB connection,...
nothing setEventQueue(Qore::Thread::Queue queue, auto arg)
Sets a queue object for DBI events on the datasource.
nothing reset()
Closes and reopens the Datasource.
nothing setDBEncoding(string encoding)
Sets the database-specific character encoding name for the next connection to the server.
auto getOption(string opt)
Returns the current value for the given option.
nothing open()
Opens a connection to the datasouce, using the connection parameters already set; an exception is thr...
nothing close()
Closes the connection to the database; if any actions are in progress on the database,...
const DSFreeTDS
for the "freetds" driver
Definition: QC_Datasource.dox.h:1083
const DBI_CAP_HAS_STATEMENT
Indicates that the DBI driver supports the prepared statement interface (the SQLStatement class)
Definition: QC_Datasource.dox.h:1129
const DBI_CAP_AUTORECONNECT
Indicates that the DBI driver supports automatically/transparently reconnecting to the server if the ...
Definition: QC_Datasource.dox.h:1103
auto getClientVersion()
Retrieves the driver-specific client library version information; this method may not be implemented ...
string getConfigString()
Returns a string giving the configuration of the current object in a format that can be parsed by par...
bool getAutoCommit()
Returns the autocommit status for the object.
nothing commit()
Commits the current transaction and releases the transaction lock.
int getCapabilities()
Returns an integer bitfield of DBI driver capabilities.
const DBI_CAP_HAS_EXECRAW
Indicates that the DBI driver supports the Datasource::execRaw() and DatasourcePool::execRaw() method...
Definition: QC_Datasource.dox.h:1117
auto selectRows(string sql,...)
Executes an SQL select statement on the server and returns the result as a list (rows) of hashes (the...
auto getServerVersion()
Returns the driver-specific server version data for the current connection.
const DBI_CAP_LOB_SUPPORT
Indicates that the DBI driver supports LOB columns (BLOBs and CLOBs, for example)
Definition: QC_Datasource.dox.h:1131
nothing setDBCharset(string encoding)
Sets the database-specific character encoding name for the next connection to the server.
const DBI_CAP_TIME_ZONE_SUPPORT
Indicates that the DBI driver supports time zones in times.
Definition: QC_Datasource.dox.h:1137
const DBI_CAP_HAS_DESCRIBE
Indicates that the DBI driver supports the describe method.
Definition: QC_Datasource.dox.h:1115
nothing setPort(softint port=0)
Sets the port number to use for the connection.
*int getPort()
Gets the port number that will be used for the next connection to the server.
AbstractSQLStatement getSQLStatement()
Returns an AbstractSQLStatement object based on the current database connection object.
int transactionTid()
Returns the TID of the thread holding the transaction lock or -1 if it's not currently held.
const DSOracle
for the "oracle" driver
Definition: QC_Datasource.dox.h:1089
auto vselect(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the results in a hash (column names) of lists (...
auto exec(string sql,...)
Grabs the transaction lock (if autocommit is disabled) and executes an SQL command on the server and ...
nothing rollback()
Rolls the current transaction back and releases the transaction lock.
*string getOSEncoding()
Returns the Qore character encoding name for the current connection as a string or NOTHING if none is...
nothing setHostName(string host)
Sets the hostname to use for the next connection to the server.
This class defines an abstract interface for the SQLStatement class.
Definition: QC_AbstractSQLStatement.dox.h:11
auto vselectRows(string sql, *softlist< auto > vargs)
Executes a select statement on the server and returns the results in a list (rows) of hashes (column ...
nothing clearEventQueue()
Clears the queue object for DBI events on the datasource.
nothing setDBName(string db)
Sets the database name parameter for the time a connection to the server is established.
nothing setPassword(string pass)
Sets the password parameter for the time a connection to the server is established.
int getTransactionLockTimeout()
Retrieves the transaction lock timeout value as an integer in milliseconds.
setOption(string opt, auto val)
sets an option for the datasource
*hash< auto > describe(string sql,...)
Executes an SQL select statement on the server and returns a description of the result set as a hash.
*string getUserName()
Returns the username parameter as a string or NOTHING if none is set.
const DSDB2
for the "db2" driver
Definition: QC_Datasource.dox.h:1081
main Qore-language namespace
Definition: Pseudo_QC_All.dox.h:3
const DBI_CAP_BIND_BY_VALUE
Indicates that the DBI driver supports directly binding qore values into queries using the %v placeho...
Definition: QC_Datasource.dox.h:1107
const DBI_CAP_BIND_BY_PLACEHOLDER
Indicates that the DBI driver supports binding placeholder buffers when executing SQL to retrieve dat...
Definition: QC_Datasource.dox.h:1105
const DSSybase
for the "sybase" driver
Definition: QC_Datasource.dox.h:1095
string getDriverName()
Returns the name of the driver used for the object.