Este componente nos crea una conexión a un servidor de Base de Datos SQL (MySQl, MariaDB, SQLLite, SQLServer, Firebird, Interbase o PostgreSQL) mediante ODBC utilizando ADO.
WITH OBJECT wAdoConnect():New()
:cHost := "192.168.1.1"
:cUser := "user"
:cPass := "1234"
:nEngine := xc_MariaDB
:cDriver := "MariaDB ODBC 3.1 Driver"
:Connect()
END WITH
En caso de producirse algún error durante una tarea con el wAdoConnect, podemos consultar el error producido con;
Hay que tener en cuenta que wAdoConnect utiliza OLE para conectarse a ODBC, por lo que debemos tener configurado Apache para que pueda encontrar OLE.
Para eso debemos añadir al fichero httpd.conf, que encontraremos en \Apache24\conf las siguientes líneas;
# Para tener una variable que apunte a la carpeta cgi-bin Define CGIROOT "c:/Apache24/cgi-bin" # Para que funcione el OLE dentro de Apache SetEnv ProgramFiles "C:\Program Files" SetEnv "ProgramFiles(x86)" "C:\Program Files (x86)" SetEnv ProgramFilesW6432 "C:\Program Files" SetEnv CommonProgramFiles "C:\Program Files\Common Files" SetEnv "CommonProgramFiles(x86)" "C:\Program Files (x86)\Common Files" SetEnv CommonProgramFilesW6432 "C:\Program Files\Common Files"
Yo tengo por costumbre ponerlas debajo de 'ServerRoot “${SRVROOT}”'.
Si hemos ejecutado Néfele Wizard en la máquina, existirán esas líneas ya que las crea al detectar Apache.
| Nombre | Init | Descripción | Versión |
|---|---|---|---|
| lAbortOnErrors | .F. | Cancela la ejecución en caso de algún error | 0.3.5 |
| lDisplayErrors | .F. | Nos envía a Néfele Console el error que se ha producido | 0.3.5 |
| cLastError | Código del error | 0.3.5 | |
| cMsgError | Mensaje del Error | 0.3.5 | |
| cHost | Servidor al que vamos a conectarnos (en SQLite no tiene uso) | 0.3.5 | |
| cUser | Usuario para la conexión | 0.3.5 | |
| cPassword | Contraseña del Usuario | 0.3.5 | |
| cDriver | Driver ODBC que se utilizara para la conexión | 0.3.5 | |
| cClientDLL | Librería DLL que se utilizara en Firebird, hay que incluir el Path completo | 0.3.5 | |
| nPort | Puerto de conexión | 0.3.5 | |
| nEngine | xc_MariaDB | Tipo de Base de datos | 0.3.5 |
| cConnect | Si no utilizamos nEngine tendremos que indicarle la cadena de conexión | 0.3.5 | |
| nTimeOut | 20 | Segundos de timeout en la conexión | 0.3.5 |
| aFileds | Cabeceras de la ultima consulta SQL | 0.3.5 | |
| nRecCount | Número de registros recuperados en la ultima consulta SQL | 0.3.5 |
| Método | Descripción | Versión |
|---|---|---|
| Connect( cConnect ) | Establece la conexión con el Servidor de Base de Datos, si hemos defino las propiedades de conexión no es necesario pasarle cConnect | 0.3 |
| Disconnect() | Cierra la conexión con el Servidor de Base de Datos. | 0.3 |
| Execute( cSelect ) | Ejecuta una cadena SQL, nos retorna .T. si se ha podido ejecutar. | 0.3 |
| BuildSQLSt | Nos permite construir una select con una plantilla. | 0.3 |
| QueryArray( cSelect, @aHeader ) | Devuelve un Array de registros (aunque se un solo registro devolverá un array bidimensional) | 0.3 |
| QueryArrayHash( cSelect, @aHeader ) | Devuelve un Array de Hash (aunque sea un solo registro devolverá un array bidimensional) | 0.3 |
| QueryValue( cSelect, xDefault ) | Devuelve solo un valor, en caso de Nil devolverá xDefault. | 0.3 |
| QueryRecordSet( cSelect, @aHeader ) | Devuelve un RecordSet. | 0.3 |
| QueryRow( cSelect, @aHeader ) | Devuelve un array con los valores un registro. | 0.3 |
| QueryRowHash( cSelect, @aHeader ) | Devuelve un Hash con los valores de un registro. | 0.3 |