VSqlDatabase
Última actualización
Última actualización
Este clase representa la conexión con una base de datos externa.
Dispone de funciones para conexión y obtención de información, además de la ejecución de sentencias SQL.
Requiere importarla previamente a su uso:
importClass ( "VSqlDatabase" );
Constructor
De conexión
De estado
De sentencias SQL
De tablas
De campos
De índice primario
Tipos de campo
Invalid = Desconocido
Bool = Booleano
Int = Entero
UInt = Entero sin signo
LongLong = LongLong
ULongLong = LongLong sin signo
Double = Double
Char = Char
Map = Map
List = List
String = String
StringList = StringList
ByteArray = ByteArray
Date = Fecha
Time = Hora
DateTime = Tiempo
Pixmap = Mapa de píxeles
Image = Imagen
Bitmap = Mapa de bits
BitArray = BitArray
Tipos de tabla
0x01 = Todas las tablas visibles por el usuario
0x02 = Todas las tablas internas usadas por la base de datos
0x04 = Todas las vistas visibles para el usuario
0xff = Todas las anteriores
Construye un conector para acceder a una base de datos externa.
Requiere importarla previamente a su uso:
importClass ( "VSqlDatabase" );
Cierra la conexión con la base de datos actual. Debemos abrirla de nuevo para continuar trabajando con la base de datos.
Configura la conexión con la base de datos externa según los parámetros especificados.
Parámetros:
szPluginDriver: cadena entre comillas o comas simples con el identificador del plugin de driver usado.
szNombreDSN: nombre o DSN de la base de datos.
szOpcionesConexion: opciones de conexión de la base de datos (Opcional)
szServidor: servidor de la base de datos a la que nos vamos a conectar (Opcional)
nPuerto: puerto usado por la base de datos (Opcional)
Nota:
Si hemos configurado en el DSN el resto de parámetros requeridos para la conexión, no es necesario cumplimentar los parámetros opcionales. En Linux y Mac, el driver en el DSN para ODBC debe ser la senda la propia librería del driver.
No todos los plugins de drivers están disponibles, dependerán del sistema operativo. La función drivers() nos devolverá los plugins disponibles para el ejecutable de entre los siguientes:
"QODBC" Open Database Connectivity (ODBC) 2.0 - Microsoft SQL Server y otros drivers ODBC compatibles
"QODBC3" Open Database Connectivity (ODBC) 3.0 - Microsoft SQL Server y otros drivers ODBC compatibles
"QDB2" IBM DB2 (versión 7.1 y superiores)
"QIBASE" Borland InterBase y Firebird
"QMYSQL" MySQL 5.X
"QMYSQL3" MySQL 3.X
"QOCI" Oracle Call Interface Driver (versiones 9 y superiores)
"QPSQL" PostgreSQL (versiones 7.3 y superiores)
"QPSQL7" PostgreSQL (versiones 6 y 7)
"QSQLITE" SQLite versión 3
"QSQLITE2" SQLite versión 2
En general, el acceso a bases de datos SQLite es el mejor soportado en todas las plataformas, Oracle vía OCI, PosgreSQL y MySQL a través de ODBC o con driver nativo están bastante soportados en Windows y Linux. En cuanto al resto de drivers y sistemas operativos, depende de la calidad de los drivers existentes en cada sistema operativo.
Ejemplos de DSN para ODBC:
Para Windows:
nombreDSN
DSN=nombreDSN
Para Linux y Mac:
Driver={/usr/local/lib/libmyodbc5a.so};Server=www.dominio.com;Port=3306;Database=nombreBaseDatos;Uid=nombreUsuario;Pwd=contraseña;
Opciones de conexión:
ODBC
SQL_ATTR_ACCESS_MODE
SQL_ATTR_LOGIN_TIMEOUT
SQL_ATTR_CONNECTION_TIMEOUT
SQL_ATTR_CURRENT_CATALOG
SQL_ATTR_METADATA_ID
SQL_ATTR_PACKET_SIZE
SQL_ATTR_TRACEFILE
SQL_ATTR_TRACE
SQL_ATTR_CONNECTION_POOLING
SQL_ATTR_ODBC_VERSION
MySQL
CLIENT_COMPRESS
CLIENT_FOUND_ROWS
CLIENT_IGNORE_SPACE
CLIENT_SSL
CLIENT_ODBC
CLIENT_NO_SCHEMA
CLIENT_INTERACTIVE
UNIX_SOCKET
MYSQL_OPT_RECONNECT
MYSQL_OPT_CONNECT_TIMEOUT
MYSQL_OPT_READ_TIMEOUT
MYSQL_OPT_WRITE_TIMEOUT
PostgreSQL
connect_timeout
options
tty
requiressl
service
DB2
SQL_ATTR_ACCESS_MODE
SQL_ATTR_LOGIN_TIMEOUT
OCI
OCI_ATTR_PREFETCH_ROWS
OCI_ATTR_PREFETCH_MEMORY
SQLite
QSQLITE_BUSY_TIMEOUT
QSQLITE_OPEN_READONLY
QSQLITE_OPEN_URI
QSQLITE_ENABLE_SHARED_CACHE
Interbase
ISC_DPB_LC_CTYPE
ISC_DPB_SQL_ROLE_NAME
Ej. de uso:
CLIENT_SSL=1;CLIENT_IGNORE_SPACE=1;
Devuelve en un array la lista de plugins de driver disponibles para el ejecutable.
Abre la base de datos externa.
Parámetros:
szUsuario: nombre del usuario (Opcional)
szContraseña: contraseña del usuario (Opcional)
Nota: si hemos configurado en el DSN el resto de parámetros requeridos para la conexión, no es necesario cumplimentar los parámetros opcionales.
Devuelve true si la sentencia SQL continúa en ejecución, false si no es así.
Devuelve true si sólo es posible navegar hacia adelante por los resultados, false si no es así.
Devuelve true si la conexión con la base de datos ya está establecida, false si no es así.
Ejecuta la sentencia SQL contra la base de datos. Retorna true si ha podido ejecutar la sentencia de forma correcta y false si ha habido algún error.
Parámetros:
szSQL: sentencia SQL
bForwardOnly: determina que se sólo se avanzará en los resultados
Devuelve el valor de la columna cuyo index pasamos como parámetro.
Parámetros:
nNumCol: index de la columna
Devuelve el valor de la columna cuyo nombre pasamos como parámetro.
Parámetros:
szNombreCol: nombre de la columna
Devuelve el número de columnas obtenidas en la sentencia SQL.
Devuelve el nombre de la columna cuyo index pasamos como parámetro.
Parámetros:
nNumCol: index de la columna
Devuelve el último mensaje de error generado.
Avanza hasta el final de la lista resultante.
Vuelve al principio de la lista resultante.
Avanza al siguiente registro.
Retorna el número de filas afectadas por la sentencia SQL que hemos ejecutado, si la base de datos externa lo admite, lo que no sucede para todos los casos.
Nota: en el caso de una SELECT debemos usar el retorno de la función nextRegister() para saber si debemos seguir recorriendo la lista resultante ya que generalmente no se retorna número de registros afectados.
Devuelve un array con los nombres de las tablas que tiene la base de datos en función del tipo que indicamos como parámetro.
Parámetros:
nTipo: ver enum de tipos de tabla
Devuelve el número de campos que tiene la tabla cuyo nombre pasamos como parámetro.
Parámetros:
szTabla: nombre de la tabla
Devuelve true si el campo tiene valor automático (auto-incremento)
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Devuelve la longitud del campo.
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Nota: en función del driver utilizado, la información que devuelve puede resultar distinta. Por ejemplo, un campo de tipo VARCHAR en MySQL se muestra con la longitud definida en la base de datos a través del driver ODBC, el tamaño de la cadena, pero a través del driver nativo la longitud retorna el número de bytes que ocupa. Por ejemplo: si es latin1 será del mismo tamaño, pero si es utf-8 será del triple, ya que este formato permite cadenas de hasta 3 bytes por carácter.
Devuelve el nombre del campo.
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Devuelve la precisión del campo cuando es de tipo numérico.
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Devuelve el tipo de campo.
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Ver enum para los tipos de campo.
Nota: en función del driver utilizado, la información puede mostrarse distinta. Por ejemplo, un campo de tipo VARCHAR en MySQL se muestra como VSqlDatabase.String a través del driver ODBC, pero a través del driver nativo se muestra como VSqlDatabase.ByteArray cuando el cotejamiento está establecido como UTF-8Bin, por ejemplo.
Retorna el número de campos que componen el índice primario de la tabla que pasamos como parámetro.
Parámetros:
szTabla: nombre de la tabla
Devuelve el campo de la parte del índice primario de la tabla cuyo nombre pasamos como parámetro.
Parámetros:
szTabla: nombre de la tabla
nIndex: posición de la parte del índice
Devuelve el nombre del índice primario de la tabla cuyo nombre pasamos como parámetro.
Parámetros:
szTabla: nombre de la tabla