revOpenDatabase |
Type | function |
Dictionary | LCS |
Library | LiveCode Script |
Syntax | revOpenDatabase("mysql", <hostAddress>, <databaseName>, [<userName>],[<passWord>],[<useSSL>], [<socketAddr>], [<rwTimeout>], [<autoReconnect>])
revOpenDatabase("odbc", <hostAddress>, <databaseName>, [<userName>],[<passWord>],[<cursorType>])
revOpenDatabase("sqlite",<filePath>,[<sqliteOptions>])
revOpenDatabase("postgresql", <hostAddress>, <databaseName>, [<userName>], [<passWord>] [, <sslOption> ...])
revOpenDatabase("oracle", <hostAddress>, <databaseName>, [<userName>],[<passWord>])
|
Synonyms | revdb_connect |
Associations | database library |
Summary | Connects to a MySQL, SQLite, PostgreSQL, ODBC or Oracle database.
|
Introduced | 1.1 |
Changes | LiveCode 6.6
|
OS | mac, windows, linux, ios, android |
Platforms | desktop, server, mobile |
Parameters | Name | Type | Description |
---|
hostAddress | | A string specifying the IP address or domain name of the system hosting
the database followed optionally with a number specifying the port number
you want to connect to, and is used only for MySQL and PostgreSQL databases.
If no port is specified, MySQL database connections use port 3306 and
PostgreSQL database connections use port 5432. For SQLite databases, the
host should be the full path to the database file.
|
databaseName | | A string specifying the the name of the database to connect to. For
SQLite databases, the database name should be left empty.
|
userName | | A string specifying your authorized user name for the database (Some
databases do not require a user name).
|
passWord | | A string specifying the authentication password for the userName (Some
databases do not require a password).
|
useSSL | | (MySQL Only) A boolean specifying whether to use SSL to secure the
socket connection when connecting to a MySQL database. If you use this
feature in a standalone application, remember to select 'SSL Encryption'
from among the available 'script libraries' in the standalone
application settings panel.
|
socketAddr | | (MySQL Only) A string specifying the socket or named pipe the driver
should use to connect with. If empty, the default for the host will be
used.
|
rwTimeout | | (MySQL Only) A number specifying the database read/write timeout in
whole seconds. Defaults to 20 seconds if empty or not a positive
integer. If 0, the connection never times out.
|
autoReconnect | | (MySQL Only) A boolean specifying if the driver should attempt to
automatically reconnect to the database when the connection is lost. A
reconnection attempt will be made the next time a command is executed.
|
cursorType | | (ODBC Only) A string specifying the type of cursor to use. "forward only": This is a cursor that can be scrolled forwards only. All ODBC drivers must support this type of cursor. Forward only cursors are usually faster than scrollable static cursors, but using revMoveToPreviousRecord, revMoveToFirstRecord or revMoveToLastRecord will fail. Forward only is the default cursor type, and is what was used in LiveCode 2.8.1 and earlier.
"emulated static": This cursor has the same behavior as a static cursor, except it allows ODBC to emulate the cursor's behavior if the driver does not support it. ODBC can typically emulate static cursor behavior on Windows systems only.
"static": This is a scrollable static cursor. Using this cursor it is possible to navigate backwards as well as forwards through record sets, and to move straight to the first or last record. Static cursors operate on an "offline" copy of the data, meaning that any changes to the data will not be detected by the cursor. Not all ODBC drivers support static cursors, for example FileMaker 6 does not.
|
sqliteOptions | | A comma-delimited list containing one or more items listed below (Note
order of the items in the options parameter is not important): "extensions": Enable loadable extensions for the connection.
"binary": Places binary data into the database verbatim (without LiveCode encoding).
|
filePath | | (SQLite Only) A string specifying the path to the SQLite database.
|
sslOption | | (PostgreSQL Only) A string of the form "key=value" specifying the SSL
options to use when connecting. The key is the name of the option you
want to set, the value is the value you want the option to take. Any
number of key value pairs can be specified, each in a new parameter. The
set of recognized SSL option and their expected values are as follows:
- "sslmode": A string specifying the SSL connection mode to use.
If no SSL mode is specified, the default will be "prefer" if the
security library can be loaded, "disable" if not. If you use SSL
connections in a standalone application, remember to select
'SSL Encryption' from among the available 'script libraries' in the
standalone application settings panel. There are 6 options:
- "disable": Only try a non-SSL connection.
- "allow": First try a non-SSL connection; if that fails, try an SSL
connection.
- "prefer": First try an SSL connection; if that fails, try a non-SSL
connection.
- "require": Only try an SSL connection. If a root CA file is present,
verify the certificate in the same way as if verify-ca was
specified.
- "verify-ca": Only try an SSL connection, and verify that the server
certificate is issued by a trusted certificate authority (CA).
- "verify-full": Only try an SSL connection, verify that the server
certificate is issued by a trusted CA and that the server host name
matches that in the certificate.
- "sslcompression": A string specifying the any SSL compression to
use. If set to "1" (default), data sent over SSL connections will be
compressed. If set to "0", compression will be disabled. This parameter
is ignored if a connection without SSL is made. Compression uses CPU
time, but can improve throughput if the network is the bottleneck.
Disabling compression can improve response time and throughput if CPU
performance is the limiting factor.
- "sslcert": A string specifying the file name of the client SSL
certificate, replacing the default ~/.postgresql/postgresql.crt. This
parameter is ignored if an SSL connection is not made.
- "sslkey": A string specifying the location for the secret key
used for the client certificate. This parameter is ignored if an SSL
connection is not made.
- sslrootcert": A string specifying the name of a file containing
SSL certificate authority (CA) certificate(s). If the file exists,
the server's certificate will be verified \ to be signed by one of
these authorities. The default is ~/.postgresql/root.crt.
- "sslcrl": A string specifying the file name of the SSL
certificate revocation list (CRL). Certificates listed in this file,
if it exists, will be rejected while attempting \ to authenticate
the server's certificate. The default is ~/.postgresql/root.crl.
|
|
Example | get revOpenDatabase("mysql", "www.example.com", "RatesDB", myUsr, myPass)
get revOpenDatabase("odbc", "BizFile", , "jenkins" ,the dbPassword of me, "emulated static")
local tConID
put revopendatabase("odbc","filedsn=C:\Users\JohnSmith\FileDsnSqlServer.dsn;Uid=<YOUR_USERNAME>;pwd=<YOUR_PASSWORD>",,,) into tConID
put revOpenDatabase("sqlite", "mydb.sqlite" )
put revOpenDatabase("sqlite", "mydb.sqlite", "binary" )
put revOpenDatabase("sqlite", "mydb.sqlite", "extensions" )
put revOpenDatabase("sqlite", "mydb.sqlite", "binary,extensions" )
put revOpenDatabase("sqlite", "file:/Users/johnsmith/Desktop/mydb.sqlite", "uri" )
get revOpenDatabase("mysql", "localhost", "dbName", myUsr, myPass, false, "/var/mysql.sock", 1, true)
get revOpenDatabase("postgresql", "192.168.1.100", "dbName", myUsr, myPass, "sslmode=require", "sslcompression=0")
|
Values | Name | Type | Description |
---|
return | | The revOpenDatabase function returns a database ID which can be used
to refer to the database in other Database library commands and
functions. The database ID is always an integer. If the database is not
successfully opened, the revOpenDatabase function returns an error
message. The error message is never an integer, so you can check whether
the connection was successful by checking whether the return value is an
integer or not.
|
|
Related | Command: revSetDatabaseDriverPath, revExecuteSQL
Function: revLicenseType, revDatabaseID, revDatabaseConnectResult, revDatabaseTableNames, revQueryIsAtStart
Library: Database library
|
Security | disk, network |
Description | Use the revOpenDatabase function to start working with a database.
Note: To use a DSN to identify an ODBC database, use the DSN as the
host, and leave the databaseName parameter empty.
Important: The revOpenDatabase function is part of the Database
library. To ensure that the function works in a standalone
application, you must include this custom library when you create your
standalone. In the Inclusions section of the General screen of the
Standalone Application Settings window, make sure the Database Support
checkbox is checked and the database drivers you are using are
selected in the list of database drivers.
Important: If you are using any of the MySQL or PostgreSQL SSL
connection options in a standalone application, make sure to select
'SSL Encryption' from among the available 'script libraries' in the
standalone application settings panel.
The version of SQLite has been updated to 3.34.0.
The SQLite RTREE and FTS5 modules are now available.
SQLite loadable extensions are now supported. To utilize loadable
extensions, the 'extensions' option must be passed to the
revOpenDatabase() call when creating the database connection.
Binary data can now be placed into SQLite databases verbatim (without
the encoding that used to occur) - this means databases can be made to
contain binary data which is compatible with other applications. To
utilize this functionality, the 'binary' option must be passed to the
revOpenDatabase() call when creating the database connection.
URI filenames are now supported. To utilize this functionality, the 'uri'
option must be passed to the revOpenDatabase() call when creating the database
connection.
URI filenames are useful because they allow appending parameter strings to the filname.
For example, in order to enable shared cache mode, you must open the database with a
filename of the form:
file:<b>pathtodbfile</b>?cache=shared
You can also open a database for read only access:
file:<b>pathtodbfile</b>?mode=ro
The SQLite revOpenDatabase() call no longer requires 5 arguments and
only requires a minimum of 2.
Important: To create and/or connect to a SQLite database on Linux,
you now need to update GCC to version 4.9. To do this on Ubuntu,
use the following commands in a terminal:
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get-update
sudo apt-get install gcc-.4.9 g++-4.9
The version of the PostgreSQL library has been updated to 9.4.5.
|
Tags | database |