SQLConnectWS (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Ayuda / WLanguage / Administrar bases de datos / Funciones SQL

Tabla de consulta entre los distintos tipos de bases de datos, sus fuentes y sus bases de datos
Fallo o éxito de la conexión
Conexión a un análisis HFSQL
ODBC y OLE DB: Anidamiento de conexiones
Conexión a una base de datos mediante ODBC
Conectores nativos MySQL, MariaDB y PostgreSQL
Conexión a una base de datos ISAM mediante ACCESS
Utilizar una conexión con autenticación NT
Conector nativo de Oracle: Autenticación externa
Consulta SQL (HExecuteSQLQuery o consultas creadas en el editor de consultas)

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

SQLConnectWS (Función)

Conecta la aplicación actual a una base de datos que será consultada por SQL a través de un proxy de servicio web (SOAP).

Observaciones:

Esta función requiere la configuración de un servicio web para acceder a las bases de datos. Para obtener más información, consulte Acceso a las bases de datos a través de un servicio web.
Esta función no permite acceder a archivos de datos protegidos por contraseña.

Ejemplo

NumConnexion is int

NumConnexion = SQLConnectWS("http://MonServeur/WDSOAPDB_WEB/", ...
	"MS Access 97 Database", "", "", "", "ODBC")
IF NumConnexion <> 0 THEN
	// La connexion s'est bien passée
	 ...
ELSE
	// La connexion a échoué : affichage d'un message explicatif 
	SQLInfo()
	Error("La connexion à la source de données " + NomSource + ...
		" a échoué." + CR + "Code erreur : " + ...
		SQL.Error + CR + SQL.MesError)
END
// Dans tous les cas (connexion OK ou pas)
SQLDisconnect()

Sintaxis

<Result> = SQLConnectWS(<Web service server> , <Source> , <User> , <Password> [, <Database name> [, <Type of database> [, <OLE DB provider> [, <Optional information>]]]])

<Result>: Entero

Identificador de conexión: Este identificador es utilizado por SQLChangeConnection.
0 si se produce un error. Para conocer los detalles del error, utilice SQLInfo.

<Web service server>: Cadena de caracteres

URL de acceso al servidor donde se instaló el servicio web de acceso a las bases de datos externas. Esta URL se especificó en el asistente para la instalación del servicio web. Para obtener más información, consulte Acceso a las bases de datos a través de un servicio web.

<Source>: Cadena de caracteres

Nombre de la fuente de datos (también llamado Nombre de la fuente de datos). Si la fuente de datos contiene varias "Bases de datos", debe especificar el nombre de la "Base de datos" utilizada ( parámetro<Database name> ). Para obtener más información, consulte observaciones.
MySQL y MariaDB: Este parámetro corresponde al nombre o dirección IP del ordenador que contiene la base de datos. Por ejemplo, "Apollon".
La fuente puede ser una base de datos HFSQL Classic o HFSQL Cliente/Servidor.

<User>: Cadena de caracteres

Nombre del usuario. Este nombre es opcional para algunas fuentes de datos. En este caso, utilice una cadena vacía ("") para este parámetro.

<Password>: Cadena de caracteres o cadena secreta

Contraseña correspondiente al usuario especificado. Esta contraseña es opcional para algunas fuentes de datos. En este caso, utilice una cadena vacía ("") para este parámetro..
Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro debe ser "ANSI o Unicode string".
Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas.
Las cadenas secretas no están disponibles para este parámetro en aplicaciones Android y widgets de Android.

<Database name>: Cadena de caracteres opcional

Nombre de la base de datos a utilizar. Para obtener más información, consulte observaciones.
Si se especifica este parámetro, se muestra un cuadro de diálogo específico del controlador durante la conexión. Este cuadro de diálogo puede no aparecer según el controlador utilizado.
Si no se especifica este parámetro, no se muestra ningún cuadro de diálogo.
MySQL y MariaDB: Con Native MariaDB Connector, el nombre de la base de datos es obligatorio.

<Type of database>: Cadena de caracteres opcional

Tipo de base de datos a la que se accede. Los tipos de bases de datos instaladas en el ordenador actual se devuelven mediante SQLListSource. Para obtener más información, consulte las observaciones.

<OLE DB provider>: Cadena de caracteres opcional o constante

Nombre del proveedor OLE DB utilizado. Los más comunes son los siguientes:
"Microsoft.Jet.OLEDB.3.51" Access
"Microsoft.Jet.OLEDB.4.0" Access
"MSDAORA" Oracle (Microsoft)
"MSDASQL" ODBC
"OraOLEDB.Oracle" Oracle
"SQLOLEDB" SQLServer
o una de las siguientes constantes:
hODBC Proveedor OLE DB para ODBC. Permite acceder a una fuente ODBC declarada en las fuentes de datos ODBC de Windows
hOledbAccess97 Proveedor OLE DB para Access 97
hOledbAccess2000 Proveedor OLE DB para Access 2000
hOledbAccess2007 Proveedor OLE DB para Access 2007
hOledbDBase5 Proveedor OLE DB para dBase 5
hOledbExcel97 Proveedor OLE DB para Excel 97
hOledbExcel2000 Proveedor OLE DB para Excel 2000
hOledbExcel2007 Proveedor OLE DB para Excel 2007
hOledbLotus4 Proveedor OLE DB para Lotus 4
hOledbOracle Proveedor OLE DB para Oracle
hOledbSQLServer Proveedor OLE DB para SQL Server

Nota: Para utilizar una conexión OLE DB:
instalar MDAC versión 2.6 o posterior (configuración realizada por WINDEV o WEBDEV al instalar la aplicación)
instalar el proveedor OLE DB que corresponde a la base de datos utilizada.

<Optional information>: Cadena de caracteres opcional (no debe utilizarse con HFSQL ni con ODBC directo)

Se utiliza para especificar la información opcional. Por ejemplo, puede especificar "Trusted_Connection=YES" para utilizar una conexión con autenticación a través del inicio de sesión NT. Si se debe especificar varias informaciones opcionales, deben agruparse en una sola cadena de caracteres y deben estar separadas por el carácter ";".
Las palabras clave reconocidas por OLE DB y los conectores nativos se presentan en Información opcional de conexión.

Observaciones

Tabla de consulta entre los distintos tipos de bases de datos, sus fuentes y sus bases de datos

Tipo de base de datos	Fuente	Nombre de la base de datos

ACCESO	Nombre del archivo Access	"" (cadena vacía)
AS400	Conector Nativo AS/400 (módulo opcional)
DB2	Conector Nativo DB2 (módulo opcional) Fuente definida en el Administrador ODBC	"" (cadena vacía) o Base de datos
HFSQLCS	Acceso HFSQL Client/Server Nombre o dirección del servidor HFSQL C/S	Nombre de la base de datos
ARCHIVO HYPE HFSQL	Nombre de la base de datos	"" (cadena vacía)
INFORMIX	Conector Nativo Informix (módulo opcional)
JDBC	URL para conectarse a la base de datos. Esta URL es específica para cada controlador.	La base de datos debe especificarse en la URL de conexión. Esta URL es específica de cada controlador JDBC.
HIVE	URL para conectarse al servidor Hive.	Base de datos
MySQL	Conector Nativo MySQL (módulo opcional) Nombre de la base de datos	Base de datos
MariaDB	Conector MariaDB nativo (módulo opcional) Nombre de la base de datos	Base de datos
POSTGRESQL	Conector PostgreSQL nativo (módulo opcional) Nombre de la base de datos	Base de datos
ODBC	Fuente definida en el Administrador ODBC	"" (cadena vacía) o Base de datos
OLEDB	Nombre de la fuente	"" (cadena vacía)
ORACLE	Conector Nativo Oracle (módulo opcional) Nombre del alias definido en la configuración de SQL NET Easy y en WDORAINS	"" (cadena vacía)
PROGRESO	Conector Nativo Progress (módulo opcional) Fuente definida en el Administrador ODBC	"" (cadena vacía) o Base de datos
AZURE SQL	Native SQL Azure Connector (módulo opcional suministrado con el Native SQL Server Connector) Nombre del servidor. Si el nombre del servidor tiene el siguiente formato NombreServidor.base de datos.windows.net, las credenciales de inicio de sesión deben tener este formato: login@NombreServidor	Base de datos
SQL SERVER	Conector SQL SERVER nativo (módulo opcional) Nombre del servidor	"" (cadena vacía)
SAP ASE	Conector Nativo SAP ASE (módulo opcional) Nombre del servidor o su alias	"" (cadena vacía)
xBase	Conector xBase nativo (suministrado con el producto)
	Base de datos disponible a través del navegador (disponible sólo en Chrome y Safari) "" (cadena vacía)	"" (cadena vacía)

Bases de datos compatibles: HYPER FILE.

Fallo o éxito de la conexión

Si la conexión se realiza correctamente, se puede utilizar el identificador de conexión para cambiar la conexión (SQLChangeConnection).

Si la conexión falla, las variables SQL.Error y SQL.MesError no se inicializan. Para más detalles sobre el fallo de conexión, utilice SQLInfo.

En cualquier caso (fallo o éxito), la conexión debe cerrarse (SQLDisconnect).

Conexión a un análisis HFSQL

Para la mayoría de las plataformas, el acceso a los datos HFSQL (clásico o cliente/servidor) está disponible en modo nativo. No es necesario acceder a las bases de datos a través de un proxy de servicio web (SOAP). Para acceder a una base de datos HFSQL Cliente/Servidor, basta con utilizar HOpenConnection.

Para conectarse a un análisis HFSQL a través de un proxy de servicio web, utilice la siguiente sintaxis:

SQLConnectWS(<Server of web service>, ...
<"<Drive>:<Full Analysis WDD Path>", "", "<Analysis Password>")

Por ejemplo:

// URL du serveur qui possède le Webservice
sURLServeurWebservice is string = "http://URLServeur"
// WDD de l'analyse sur le serveur. 
// Le chemin est donné par rapport au répertoire des données du Webservice.
sCheminWDDAnalyseSurServeur is string = ".\" + ProjectInfo(piAnalysis) + ".wdd"
// Mot de passe
sMotDePasseWDD is string
// Connexion à la base HFSQL en fonction de ce qui est indiqué dans l'analyse
IF NOT SQLConnectWS(sURLServeurWebservice, sCheminWDDAnalyseSurServeur, "", ...
		sMotDePasseWDD) THEN 
	// Echec de la connexion
	SQLInfo()
	Error(SQL.MesError)
	RETURN
END

// Connexion OK 
// Suite du code avec SQLExec, etc.

Observaciones:

Tras la conexión a un análisis HFSQL, la variable SQL.Connection devuelve -1.
Los archivos de datos HFSQL se buscarán en el servidor en el directorio actual de los programas del servicio web o en el directorio definido en el análisis. No se puede especificar ninguna ruta mediante programación.
Si se ha establecido una contraseña para el análisis, debe especificarse en el tercer parámetro pasado a SQLConnectWS.
Para manipular archivos de datos HFSQL Cliente/Servidor, la conexión definida en el análisis debe contener toda la información necesaria (nombre del servidor o dirección IP, puerto, base de datos, etc.). Esta información no puede especificarse mediante programación.

ODBC y OLE DB: Anidamiento de conexiones

Para ODBC y OLE DB, puede anidar varias llamadas a SQLConnectWS. Tenga en cuenta que esto no es posible con bases de datos HFSQL.

La última conexión abierta es la conexión actual. SQLChangeConnection se utiliza para modificar la conexión actual.

SQLDisconnect desconecta la conexión actual.

Conexión a una base de datos mediante ODBC

Para conectarse a una base de datos mediante ODBC, siga estos pasos:

Configure el origen de datos ODBC en el administrador de ODBC (en el ordenador de desarrollo o en el de implementación). La fuente de datos debe ser una fuente de datos "del sistema".
Utilice SQLConnectWS con el parámetro "ODBC".

Nota: Puede utilizar un proveedor OLE DB sobre ODBC. MDAC debe estar instalado (en el ordenador de desarrollo y en el de implementación). Se debe utilizar la siguiente sintaxis:

<Result> = SQLConnectWS(<Server of web service>, <Source>, <User>, ...
<Password>, <Database Name>, "OLE DB", hODBC)

Nota: La dirección SQL.ODBCHandle proporciona el manejador de conexión ODBC para otras funciones SQL sobre ODBC. Se asigna un valor a esta variable la última vez SQLConnectWS se llama. La dirección SQL.HandleODBC se establece en -1 para las demás conexiones.

Conectores nativos MySQL, MariaDB y PostgreSQL

Para abrir una conexión a una base de datos MySQL, MariaDB o PostgreSQL a través de un Conector Nativo, necesitas pasar los siguientes elementos como parámetros a SQLConnectWS:

el tipo de base de datos utilizada, MySQL, MariaDB o POSTGRESQL.
el nombre de la base de datos. Es el nombre dado por el administrador de la base de datos MySQL/MariaDB/PostgreSQL.

Nota: El nombre de la fuente de datos MySQL o PostgreSQL puede sustituirse por el nombre o la dirección IP del ordenador donde está disponible la base de datos. En cualquier caso, debe especificarse el nombre de la "base de datos".

// Connexion à une base de données MySQL 
NumConnexion = SQLConnectWS("http://URLServeur", "BaseMySQL", ...
			"", "", "", "MySQL")
// ou 
// NumConnexion = SQLConnecte("BaseMySQL", "Utilisateur", ...
// 		"MotDePasse", "MaDataBase", "MySQL")
 
// Connexion à une base de données MySQL distante
NumConnexion = SQLConnectWS("http://URLServeur", "192.168.1.51", ...
		"Utilisateur", "MotDePasse", "test", "MySQL")

Conexión a una base de datos ISAM mediante ACCESS

La siguiente sintaxis se utiliza para conectarse a una base de datos ISAM:

SQLConnectWS(<Server of web service>, <Database Path>, ...
<User>, <Password>, <Database Type>, "ACCESS")


<Database path>	Ruta o nombre completo (según el caso) de la base de datos a la que se accede
<User>	Nombre del usuario. Es opcional para algunas bases de datos.
<Password>	Contraseña del usuario. Es opcional para algunas bases de datos.
<Database type>	Tipo de la base de datos a la que se está conectado (por lo tanto, debe haberse instalado el controlador ISAM correspondiente).

Tipo de base de datos	<Database type>	<Database path>

dBASE III	"dBASE III"	drive:\directory
dBASE IV	"dBASE IV"	drive:\directory
dBASE 5	"dBASE 5.0"	drive:\directory
Paradox 3.x	"Paradox 3.x"	drive:\directory
Paradox 4.x	"Paradox 4.x"	drive:\directory
Paradox 5.x	"Paradox 5.x"	drive:\directory
FoxPro 2.0	"FoxPro 2.0"	drive:\directory
FoxPro 2.5	"FoxPro 2.5"	drive:\directory
FoxPro 2.6	"FoxPro 2.6"	drive:\directory
Excel 3.0	"Excel 3.0"	Unidad:\directorio\archivo.xls
Excel 4.0	"Excel 4.0"	Unidad:\directorio\archivo.xls
Excel 5.0 o Excel 95	"Excel 5.0"	Unidad:\directorio\archivo.xls
Excel 97	"Excel 8.0"	Unidad:\directorio\archivo.xls
Importación de HTML	"Importación HTML"	Unidad:\directorio\nombre de archivo
Exportación HTML	"Exportación HTML"	drive:\directory
Text	"Text"	drive:\directory

Observaciones:

Para que se establezca la conexión solicitada, debe haberse instalado el controlador ISAM correspondiente. El programa de instalación de MS OFFICE 97 propone varios controladores ISAM.
Las bases de datos ACCESS e ISAM sólo son accesibles en modo de 32 bits.
La palabra clave WLanguage WDBinaryMemo, que permite agregar o modificar un memo binario mediante una consulta SQL, no está soportado por el controlador ACCESS.

Utilizar una conexión con autenticación NT

La siguiente sintaxis permite establecer una conexión con autenticación NT:

SQLConnectWS(<Server of web service>, <MaDatabase>, Null, Null, Null, ...
"OLEDB", <OLE DB Provider>, "Trusted_Connection=YES")

Conector nativo de Oracle: Autenticación externa

Para admitir la autenticación externa, deben utilizarse los siguientes parámetros de conexión:

<User> = / (barra oblicua)
<Password> = "" (cadena vacía)

Nota: La autenticación externa utiliza el nombre de usuario y la contraseña de Windows para conectarse a la base de datos. La autenticación externa requiere una configuración del servidor. Consulte la documentación de Oracle para saber cómo autorizar las autenticaciones externas en el servidor.

Consulta SQL (HExecuteSQLQuery o consultas creadas en el editor de consultas)

Cuando se utilizan las sentencias SQL DELETE, INSERT o UPDATE, no se realiza ninguna comprobación de integridad ni de duplicados en una base de datos HFSQL. Esta funcionalidad no está disponible en esta versión.

Solución: Utilice funciones HFSQL (HDelete, HAdd o HModify) en sus archivos de datos. La comprobación de integridad y la comprobación de duplicados se realizarán automáticamente.

Componente: wd310hf.dll

Ver también

Versión mínima requerida

Versión 19

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 24/09/2025

Señalar un error o enviar una sugerencia | Ayuda local