AYUDA EN LÍNEA
 WINDEV, WEBDEV Y WINDEV MOBILE
Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Sintaxis 1: Utilizar una cadena de caracteres para el proveedor OLE DB
  • Sintaxis 1: Pseudo-conexión a una base de datos HFSQL Classic
  • Diferencias entre HOpenConnection y HDescribeConnection
  • Uso del conector xBase nativo con conjuntos de caracteres no latinos
  • Conector Nativo MySQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Describe una nueva conexión a una base de datos externa. Esta conexión se llama. Se pueden definir parámetros específicos como el modo de gestión de los cursores (si la base de datos a la que se accede lo permite).
Para asociar esta conexión a una tabla o un archivo de datos, utilice HChangeConnection.
Para abrir la conexión, utilice HOpenConnection. Si los parámetros de la conexión descrita con HDescribeConnection son incorrectos, la función HOpenConnection devolverá un error.
Con HDescribeConnection , una descripción de Oracle tabla importada en el análisis puede ser utilizada directamente por los archivos de datos HFSQL Classic. Simplemente describa una conexión temporal a una base de datos HFSQL Classic y asóciela al archivo description desde en el análisis. Vea los Ejemplos para más detalles.
Esta función se conserva por motivos de compatibilidad con versiones anteriores. Le recomendamos que utilice una Conexión Variable y sus propiedades para describir una conexión.
Ejemplo
HFSQL Client/ServerConectores Nativos
HDescribeConnection("MyConnection", "", "", ...
"Server_SQLServer", "dbo", hNativeAccessSQLServer, hOReadWrite, "")
Sintaxis

Describir una conexión a través de la programación Ocultar los detalles

<Result> = HDescribeConnection(<Connection> , <User> [, <Password>] , <Data source> , <Database> , <OLE DB provider or Native Connector> [, <Access> [, <Extended information>]])
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
Para establecer esta conexión, utilice HOpenConnection (esta función devolverá un error si los parámetros de conexión son incorrectos).
Para asignar esta conexión a un archivo de datos, utilice HChangeConnection.
<Connection>: Cadena de caracteres
Nombre de la nueva conexión a definir.
Si este nombre ya es utilizado por una conexión existente, la conexión anterior se sustituye por la nueva. La conexión anterior (así como los archivos de datos que la utilizaban) se cierran automáticamente.
<User>: Cadena de caracteres
Nombre de usuario utilizado para la base de datos. Este parámetro es devuelto por la CtUserName Property.
<Password>: Cadena de caracteres opcional
Contraseña de conexión (si existe). Si no se requiere una contraseña, utilice una cadena vacía ("") o la palabra clave NULL.
<Data source>: Cadena de caracteres
Ruta completa de la fuente de datos. La conexión se creará y abrirá para esta fuente de datos. Este parámetro es devuelto por la CtDatabase Property.
Conectores Nativos XML: Este parámetro corresponde al nombre del archivo XML.
HFSQL Client/Server Este parámetro corresponde al nombre del servidor. Se puede especificar el número de puerto utilizado por el servidor HFSQL. De forma predeterminada, se utiliza el puerto 4900. Si el número de puerto del servidor HFSQL es diferente, utilice la siguiente notación:
<Nombre de equipo>: <Número de puerto>
Ejemplo: "NombreEquipo:4901".
Para un uso a través de Internet, se deben gestionar los puertos con Firewall. Para obtener más información, consulte Administrar puertos.
Tienes la capacidad de especificar una Address IPv6 escribiendo la Address IPv6 entre corchetes. En este caso, el número de puerto debe especificarse después del corchete de cierre.. Por ejemplo: [0154:2145:2155::5554]:4900.
AndroidWidget Android Para una aplicación Android:
  • Conexión a una base de datos HFSQL Client/Server:
    • La base de datos se encuentra en el ordenador de desarrollo y se maneja desde un emulador Android: usar la IP Address 10.0.2.2 con el puerto del servidor. Ejemplo: "10.0.2.2:4900"
    • La base de datos se encuentra en la red del ordenador de desarrollo y se maneja desde un emulador Android: usar el nombre completo del servidor con el dominio. Ejemplo: "Server@domain.com:4900" (con el simulador WINDEV Mobile, el nombre el equipo sin dominio puede ser suficiente).
  • Conexión a una base de datos SQLite:
    Ruta completa del archivo que contiene la base de datos SQLite en el dispositivo Android.
    Ejemplo : /sdcard/bdd/MiBaseDeDatos.db
    Si el parámetro corresponde a una cadena vacía (""), el archivo que contiene los datos de la base de datos se creará en el directorio "databases" de la aplicación y tendrá el mismo nombre que la aplicación seguido de la extensión ".db".
<Database>: Cadena de caracteres
Nombre de la base de datos que se utilizará en la fuente de datos, cadena vacía ("") si no se debe especificar ningún nombre.. Este parámetro se puede utilizar si la fuente de datos permite especificar la base de datos que se debe utilizar..
Por ejemplo, en SQL Server, la base de datos "Maestra" es la base de datos Default pero se pueden manejar otras bases de datos ("dbo" por ejemplo).
Para especificar que el acceso se realiza sobre un fichero que se encuentra en la base de datos "dbo" (que no es la base de datos Default), debe corresponder a "dbo".
Este parámetro es devuelto por la CtInitialCatalog Property.
<OLE DB provider or Native Connector>: Cadena de caracteres o constante
  • Nombre del proveedor OLE DB utilizado. Para obtener fácilmente la cadena a utilizar, seleccione la opción "Conexión" en el editor de análisis (ver Notas).

    o
  • una de las siguientes constantes:
    hAccessHF7Pseudo-conexión a una base de datos HFSQL Classic
    hAccessHFClientServerConector Nativo a una base de datos HFSQL Client/Server.
    hNativeAccessAS400Conector Nativo AS/400 (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessDB2Conector Nativo DB2 (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessInformixConector Nativo Informix (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessMariaDBConector Nativo MariaDB (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessMySQLConector Nativo MySQL (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessOracleConector Nativo Oracle (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessOracleLiteConector Nativo Oracle (módulo opcional de WINDEV Mobile)
    hNativeAccessPostgreSQLConector Nativo PostgreSQL (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessProgressConector Nativo Progress (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessSQLAzureNative SQL Azure Connector (módulo opcional de WINDEV/WEBDEV, proporcionado con Conector Nativo SQL Server)
    hNativeAccessSQLiteConector SQLite nativo (proporcionado con WINDEV/WEBDEV)
    hNativeAccessSQLServerConector Nativo SQL Server (módulo opcional de WINDEV/WEBDEV).
    El antiguo Conector Nativo es usado por Default. Para utilizar el nuevo Conector Nativo SQL Server, utilice el H.SQLServerMode Variable.
    hNativeAccessSQLServerMobileNative SQL Server Mobile Connector (módulo opcional de WINDEV Mobile)
    hNativeAccessSybaseConector Nativo Sybase (módulo opcional de WINDEV/WEBDEV)
    hNativeAccessXBaseConector nativo xBase (incluido con WINDEV/WEBDEV)
    hNativeAccessXMLConector XML nativo (incluido con WINDEV/WEBDEV)
    hODBCProveedor OLE DB para ODBC (permite acceder a una fuente de datos ODBC declarada en las fuentes de datos ODBC de Windows)
    hOledbAccess97Proveedor OLE DB para Access 97
    hOledbAccess2000Proveedor OLE DB para Access 2000
    hOledbDBase5Proveedor OLE DB para dBase 5
    hOledbExcel97Proveedor OLE DB para Excel 97
    hOledbExcel2000Proveedor OLE DB para Excel 2000
    hOledbLotus4Proveedor OLE DB para Lotus 4
    hOledbOracleProveedor OLE DB para Oracle
    hOledbSQLServerProveedor OLE DB para SQL Server

    AndroidWidget Android Las constantes disponibles son las siguientes:
    hNativeAccessSQLiteConector SQLite nativo de una aplicación Android.



<Access>: Constante opcional
Configura el tipo de acceso a la base de datos.
hOReadSe puede acceder a la base de datos en modo de solo lectura. Solo se pueden leer registros. No se pueden agregar o eliminar.
hOReadWrite
(valor predeterminado)		Se puede acceder a la base de datos en lectura/escritura. Se pueden leer y escribir nuevos registros.

Este parámetro es devuelto por la CtAccess Property.
<Extended information>: Cadena de caracteres opcional
Información opcional insertada en la cadena de conexión a la base de datos. Si se reconocen palabras clave específicas, la información correspondiente se extrae de la cadena de conexión. El resto de la cadena de conexión se envía a la base de datos. A continuación, los parámetros extraídos son procesados por el Conector Nativo o por el conector OLE DB utilizado..
Estas palabras clave deben indicarse de la siguiente manera: "<Palabra clave> = <Valor>;".
Por ejemplo, puede especificar "Trusted_Connection=YES" para utilizar una conexión con autenticación a través del inicio de sesión NT..
Conectores Nativos Las palabras clave reconocidas por OLE DB y el Conectores Nativos se presentan en el Información opcional de conexión Page.
Ejemplo de cadena a utilizar:
"WD Cache Size = 10000; Server Port=3306;"
HFSQL Client/Server Las palabras clave reconocidas para el acceso mediante HFSQL Client/Server son las siguientes:
COMPRESSIONHabilita o deshabilita la compresión de los datos intercambiados entre el Cliente y el Servidor.. Esta palabra clave puede corresponder a:
  • TRUE para activar la compresión de datos.
  • FALSE para no comprimir datos.
DB_EXISTVerifica la existencia de la base de datos. Si la base de datos especificada no existe, la función HDescribeConnection devuelve False.
ENCRYPTIONPermite el cifrado de los datos intercambiados entre el Cliente y el Servidor. Esta palabra clave puede tomar varios valores:
  • RÁPIDO
  • RC5_16 para utilizar el cifrado RC5 de 16 rondas.
  • AES128 para utilizar el cifrado AES de 128 bits con el modo de funcionamiento OFB.
  • AES192 para utilizar el cifrado AES de 192 bits con el modo de funcionamiento OFB.
  • AES256 para utilizar el cifrado AES de 256 bits con el modo de funcionamiento OFB.

Este parámetro es devuelto por la CtExtendedInfo Property.
Observaciones
HFSQL Client/ServerConectores Nativos

Sintaxis 1: Utilizar una cadena de caracteres para el proveedor OLE DB

Para encontrar fácilmente la cadena de caracteres que se debe utilizar para definir el proveedor OLE DB, le recomendamos seguir los siguientes pasos:
  1. En la editor de análisis, abra la ventana de conexión de la description: en la pestaña "Análisis", en el grupo "Conexiones", haga clic en "Conexiones".
  2. Seleccione el proveedor que se utilizará ("Conexión mediante").
  3. Enseguida, se muestra la cadena de caracteres que corresponde al proveedor. Esta cadena de caracteres se puede utilizar para definir el proveedor OLE DB utilizado en el parámetro <Proveedor OLE DB>.
Conectores Nativos

Sintaxis 1: Pseudo-conexión a una base de datos HFSQL Classic

Los archivos de datos OLE DB o nativos se describen en el editor de análisis. Para manipular estas descripciones a través de la programación con una base de datos HFSQL, simplemente especifique la constante hAccessHF7 como nombre del proveedor.
A continuación, esta conexión puede asignarse a los archivos de datos afectados por HChangeConnection.
Los archivos de datos en formato HFSQL correspondientes a la description de la BD OLE o los archivos nativos se crearán (si es necesario) en el directorio definido por . Por Default, estos archivos de datos están vacíos cuando se crean.

Diferencias entre HOpenConnection y HDescribeConnection

Método 1: Para abrir una conexión al inicio de la aplicación y cerrarla al final, utilice HOpenConnection. Para utilizar esta conexión cuando se manejan archivos o tablas de datos, basta con cambiar esta conexión con HChangeConnection.
HOpenConnection(MyConnection, params)       // open the connection
HChangeConnection(AFile, MyConnection)
Método 2: Para describir una conexión a través de la programación y abrirla automáticamente al abrir el archivo de datos, debe:
  • describir la conexión con la función HDescribeConnection.
  • asociar esta conexión con el archivo de datos deseado description utilizando HChangeConnection. La conexión sólo se abrirá la primera vez que se acceda a el archivo de datos.
Esta solución puede ser useful cuando una aplicación maneja tanto archivos de datos HFSQL como archivos de datos Oracle. Por ejemplo, si la aplicación utiliza un único archivo Oracle, en un Process específico, la conexión a la base de datos Oracle sólo se realizará si es necesario.
Si se elige la primera solución para el mismo tipo de aplicación, la conexión (que puede llevar bastante tiempo) se establecerá cada vez que se inicie la aplicación.
Ejemplo:
HDescribeConnection(MyConnection, params)
HChangeConnection(AFile, MyConnection)
...
HReadFirst(AFile) // Open the connection
...
HClose(AFile) // Close the connection
Conectores Nativos

Uso del conector xBase nativo con conjuntos de caracteres no latinos

Para utilizar el conector xBase nativo con juegos de caracteres no latinos, Conector Nativo debe realizar una conversión estándar OEM/ANSI.. Para ello, debe especificarse la siguiente cadena en la información ampliada:
OEMTOANSI=VENTANAS;
Ejemplo:
  1. En el código de inicialización del proyecto, añada el código utilizado para modificar el carácter set:
    ChangeCharset(charsetChinese)
  2. Cree una conexión xBase:
    HDescribeConnection("CntxBase", "", "", fExeDir(), "", hNativeAccessXBase, hOReadWrite, ...
    "OEMTOANSI=WINDOWS;")
    HChangeConnection("*", "CntxBase")
Conectores Nativos

Conector Nativo MySQL

Para get las últimas características de MySQL (por ejemplo, el nuevo modo de acceso Default), es necesario actualizar la biblioteca cliente de MySQL (archivo LibMySQL.DLL).. Para obtener más información, consulte Conector Nativo MySQL.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290hf.dll
Ver también
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 30/08/2023

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