|
|
|
|
- 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
- Archivo UDL
- Conector Nativo MySQL
HDescribeConnection( Función)
No disponible con este tipo de conexión
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.
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>]] , <Additional options>)
<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).
<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.
<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". <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:
| | hAccessHF7 | Pseudo-conexión a una base de datos HFSQL Classic | hAccessHFClientServer | Conector Nativo a una base de datos HFSQL Client/Server. | hNativeAccessAS400 | Conector Nativo AS/400 (módulo opcional de WINDEV/WEBDEV) | hNativeAccessDB2 | Conector Nativo DB2 (módulo opcional de WINDEV/WEBDEV) | hNativeAccessInformix | Conector Nativo Informix (módulo opcional de WINDEV/WEBDEV) | hNativeAccessMariaDB | Conector Nativo MariaDB (módulo opcional de WINDEV/WEBDEV) | hNativeAccessMySQL | Conector Nativo MySQL (módulo opcional de WINDEV/WEBDEV) | hNativeAccessOracle | Conector Nativo Oracle (módulo opcional de WINDEV/WEBDEV) | hNativeAccessOracleLite | Conector Nativo Oracle (módulo opcional de WINDEV Mobile) | hNativeAccessPostgreSQL | Conector Nativo PostgreSQL (módulo opcional de WINDEV/WEBDEV) | hNativeAccessProgress | Conector Nativo Progress (módulo opcional de WINDEV/WEBDEV) | hNativeAccessSQLAzure | Native SQL Azure Connector (módulo opcional de WINDEV/WEBDEV, proporcionado con Conector Nativo SQL Server) | hNativeAccessSQLite | Conector SQLite nativo (proporcionado con WINDEV/WEBDEV) | hNativeAccessSQLServer | Conector 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. | hNativeAccessSQLServerMobile | Native SQL Server Mobile Connector (módulo opcional de WINDEV Mobile) | hNativeAccessSybase | Conector Nativo Sybase (módulo opcional de WINDEV/WEBDEV) | hNativeAccessXBase | Conector nativo xBase (incluido con WINDEV/WEBDEV) | hNativeAccessXML | Conector XML nativo (incluido con WINDEV/WEBDEV) | hODBC | Proveedor OLE DB para ODBC (permite acceder a una fuente de datos ODBC declarada en las fuentes de datos ODBC de Windows) | hOledbAccess97 | Proveedor OLE DB para Access 97 | hOledbAccess2000 | Proveedor OLE DB para Access 2000 | hOledbDBase5 | Proveedor OLE DB para dBase 5 | hOledbExcel97 | Proveedor OLE DB para Excel 97 | hOledbExcel2000 | Proveedor OLE DB para Excel 2000 | hOledbLotus4 | Proveedor OLE DB para Lotus 4 | hOledbOracle | Proveedor OLE DB para Oracle | hOledbSQLServer | Proveedor OLE DB para SQL Server |
Las constantes disponibles son las siguientes:
| | hNativeAccessSQLite | Conector SQLite nativo de una aplicación Android. | Atención: Para utilizar una conexión OLE DB, es necesario: - instalar MDAC versión 2.6 o posterior (instalación realizada con WINDEV/WEBDEV, al crear la versión cliente)
- instalar el proveedor OLE DB que corresponde a la base de datos utilizada.
Este parámetro es devuelto por la CtOLEDBProvider Property. Las constantes disponibles son las siguientes:
| | hAccessHF7 | Pseudo-conexión a una base de datos HFSQL Mobile | hAccessHFClientServer | Conexión a una base de datos HFSQL Client/Server | hAccessJDBCMySQL | Acceso a una base de datos MySQL mediante JDBC | hAccessJDBCSQLite | Acceso a una base de datos SQLite mediante JDBC | hAccessJDBCSQLServer | Acceso a una base de datos SQL Server mediante JDBC |
<Access>: Constante opcional Configura el tipo de acceso a la base de datos.
| | hORead | Se 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..
Este parámetro es devuelto por la CtExtendedInfo Property.
<Additional options>: Constante Si no se especifica este parámetro, el motor HFSQL define automáticamente los parámetros que se deben utilizar en función de la base de datos a la que se accede y del proveedor OLE DB utilizado.Para forzar algunos parámetros, se pueden combinar las siguientes constantes: - Ubicación de los cursores
| | hClientCursor | Cursor utilizado por MDAC. Por lo general, ofrece más funcionalidades que un cursor servidor. Un cursor cliente obligatoriamente es un cursor estático. | hServerCursor | Cursor utilizado por la base de datos. Este cursor puede aplicar fácilmente las modificaciones realizadas por otros usuarios a los datos. |
- Tipo de cursor
| | hDynamicCursor | Cursor que ofrece una gran cantidad de funcionalidades pero que consume mucha memoria. Este cursor permite realizar varios movimientos. Permite acceder a todas las modificaciones, adiciones y eliminaciones realizadas por los demás usuarios. | hForwardOnlyCursor | Cursor rápido que consume poca memoria. El desplazamiento se realiza del primer al último registro. Los datos modificados por otros usuarios no son visibles. | hOpenKeysetCursor | Cursor que utiliza un conjunto de registros fijo. Solo se almacenan las claves que corresponden al registro, no los registros (consume menos memoria). No se puede acceder a los registros eliminados. Las modificaciones realizadas por otros usuarios son Visible (pero los registros añadidos no lo son). | hStaticCursor | Hace una copia de los registros de la consulta en la memoria (alto consumo de memoria). Todos los tipos de desplazamiento están permitidos. |
- Modo de bloqueo
| | hOptimisticCursor | El registro se bloquea durante la actualización | hPessimisticCursor | El registro se bloquea tan pronto como entra en modo de edición para ser modificado. | hReadOnlyCursor | El conjunto de registros utilizado no podrá modificarse. |
Atención: no todos los proveedores OLE DB soportan todos los tipos de cursores. 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
Clasificación Lógica de negocio / UI: Lógica de negocio
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|