AYUDA EN LÍNEA
 WINDEVWEBDEV 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 / Gestión de HFSQL Client/Server
  • Presentación
  • Lista de palabras clave
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
Presentación
Al definir las conexiones en el editor del modelo de datos o al definir las conexiones mediante programación, tiene la posibilidad de especificar la información de conexión opcional.
En el editor del modelo de datos, esta información se introduce en la descripción de la conexión, pestaña "Avanzado"..
A través de la programación, esta información ampliada se configura:
Esta información se define mediante las siguientes palabras clave.
Atención: Esta página de ayuda sólo presenta la información de conexión opcional disponible para los Conectores Nativos (también llamados Acceso Nativo) y para OLE DB.
Lista de palabras clave
Palabra claveDescripción
ADVERTENCIAS_ANSIEspecifica si el comportamiento de acuerdo con la norma ISO debe ser respetado para varias condiciones de error.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
ANSI_NULLSEspecifica el comportamiento, compatible con ISO, de los operadores Igual a (=) y Diferente de (< >), cuando se utilizan con valores Null..
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a FALSE en el servidor.
  • 1: Fuerza el parámetro a TRUE en el servidor.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
ARITABOTODetiene una consulta cuando se produce un desbordamiento de capacidad o una división por cero durante su ejecución.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave está soportada por los conectores nativos de Sybase y SQL Server (a través de OLE DB y ODBC).
BIBLIOTECA DEL CLIENTE WDEspecifica la DLL de la biblioteca cliente que debe utilizarse para el Conector de progreso nativo.
Ejemplo:
"WD CLIENT LIBRARY= C:\Archivos de programa (x86)\Progress\OpenEdge\bin\pgoe1023.dll"
Si se utiliza esta palabra clave, se ignora el contenido del archivo WDPRGS.INI.
Conectores Nativos Esta palabra clave es soportada por el Native Progress Connector.
BLOQUEO DE MODELOPermite especificar el tipo de bloqueo utilizado en las funciones SQLxxx.
Conectores Nativos SQL Server, Sybase:
  • SQLLock(Table) utiliza TABLOCKX por defecto.
    Ejemplo: MODELOCK = TABLOCKX
    SELECT * FROM MyTable WITH (TABLOCKX)
  • SQLLock(qry) utiliza UPDLOCK por defecto. Ejemplo:
    SELECT * FROM MyTable WITH (UPDLOCK) WHERE MyItm>2 ORDER BY MyItm
Conectores Nativos Oracle:
  • SQLLock( Table) utiliza el modo "EXCLUSIVO" de forma predeterminada. Ejemplo: MODELOCK = EXCLUSIVO
    LOCK TABLE MyTable IN EXCLUSIVE MODE NOWAIT
  • SQLLock(qry) añade "FOR UPDATE" a la consulta (no se puede configurar).
BLOQUEO DE REGISTRO WDPermite especificar si la gestión de los bloqueos está habilitada (o no) en la conexión.
  • Si "WD RECORD LOCK = WITH (NOLOCK)", la gestión de los bloqueos está desactivada en la conexión.. En este caso, Native Connector añade "WITH (NOLOCK)" en todas las consultas SELECT generadas.. Por lo tanto, los registros seleccionados no están bloqueados.
  • Si no se especifica esta opción (caso predeterminado), se habilita la gestión de bloqueos en la conexión.. Todos los registros seleccionados se bloquean automáticamente.
Atención: "WD RECORD LOCK = WITH (NOLOCK)" no se utiliza por defecto. De hecho, esta opción debe utilizarse con sumo cuidado: el valor de los registros leídos puede no corresponderse con el valor real (si este valor ha sido modificado recientemente por otro ordenador, por ejemplo).
CtProgress.ExtendedInfo = ...
	"PORT=2800;" + ...
	"WD RECORD LOCK = WITH (NOLOCK);" + ...
	"WD CLIENT LIBRARY= C:\...\pgoe1022.dll"
Conectores Nativos Esta palabra clave es soportada por el Native Progress Connector.
Conectores Nativos Casos especiales:
  • Sybase: El valor por defecto es "NOHOLDLOCK"..
  • Servidor SQL vía OLE DB: El valor por defecto es "CON (NOLOCK)".
Para todos los demás conectores nativos, el valor por defecto está vacío (incluyendo el conector del servidor SQL vía ODBC).
Catálogo inicialNombre de la base de datos que se utilizará en la fuente de datos.
Certificado SSLNombre (y ruta) del archivo del certificado.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector y el Native PostgreSQL Connector.
CHARSETDefine el conjunto de caracteres durante la llamada a dbsetlname.
Conectores Nativos Esta palabra clave sólo es compatible con el conector Sybase nativo.
Cifrado SSLLista de "cifrados" permitidos durante el cifrado SSL.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector.
clave SSLNombre (y ruta) del archivo clave.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector y el Native PostgreSQL Connector.
CONCAT_NULL_YIELDS_NULLDefine si los resultados de la concatenación se consideran valores nulos o cadenas vacías.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
CriptaConexión encriptada.
Si esta palabra clave se establece en "SÍ", la comunicación entre el cliente de base de datos y el servidor se cifrará.
Ejemplo:
"Encrypt=YES"
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
CRL SSLLista de certificados revocados (CRL = Certificate Revocation List).
Conectores Nativos Esta palabra clave es soportada por el Native PostgreSQL Connector.
CUENTA DE USOPalabra clave específica de las funciones SQLxxx.
Los valores posibles son los siguientes:
  • 0: (valor predeterminado): el resultado de la consulta se navega para el recuento.
  • 1: Utiliza una consulta de consulta (SELECT COUNT FROM...) para contar el número de registros en las consultas realizadas por las funciones SQLxxx.
Conectores Nativos Esta palabra clave está soportada por los conectores nativos de Sybase y SQL Server (a través de OLE DB y ODBC).
EDESe utiliza para especificar si se deben utilizar o no las transacciones distribuidas.
  • Si "DTS = 0", la gestión de las transacciones distribuidas está desactivada.
  • Si "DTS = 1" (valor por defecto), la gestión de las transacciones distribuidas está activada.
Conectores Nativos Esta palabra clave sólo está soportada por el Conector del Oráculo Nativo.
Enchufe UnixConsulte la documentación sobre MySQL (palabra clave = 'mysql_real_connect') para más detalles.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector.
Flag ClientePara más detalles, consulte la documentación sobre MySQL (palabra clave = 'mysql_real_connect').
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector.
FORMATO DE DATOS ANTIGUOSModifica el formato de retorno de los valores de fecha en las funciones SQLxxx para que sea compatible con el formato de los conectores nativos de WINDEV 5.5.
Los valores posibles son los siguientes:
  • 0: (valor por defecto) Formato de fecha soportado por HFSQL.
  • 1: Formato de fechas compatible con los conectores nativos de WINDEV 5.5.
Esta palabra clave está soportada por:
  • Conectores Nativos Servidor SQL (AAAA-MM-DD HH:MM:SS.CCC)
  • Conectores Nativos Sybase (AAAA-MM-DD HH:MM:SS.CCC)
  • Conectores Nativos Oracle (DD-MM-AAAA HH24:MI:MI:SS)
MODO SESIÓN WDEste valor es un número entero, resultado de una combinación (BinarioOr) de los siguientes valores:
  • OCI_SYSDBA=2
  • OCI_SYSOPER=4
  • OCI_PRELIM_AUTH=8
Por ejemplo, para conectarse como SYSDBA, debe utilizar "WD SESSION MODE=2".
Conectores Nativos Esta palabra clave es apoyada por el Conector del Oráculo Nativo.
Modo SSLModo de conexión SSL:
  • permitir: Pruebe una conexión que no sea SSL y luego una conexión SSL en caso de fallo.
  • desactivar: Deshabilite el SSL en la conexión.
  • Preferir (modo Default ): Pruebe una conexión SSL y luego una conexión que no sea SSL en caso de fallo.
  • requerir: Forzar el SSL en la conexión. Si se suministra el archivo de certificado de la autoridad de certificación, compruebe el certificado del servidor.
  • verificar-ca: Forzar el SSL en la conexión y comprobar el certificado del servidor.
  • verificar-lleno: Forzar el SSL en la conexión y comprobar si el nombre del servidor corresponde al certificado.
Conectores Nativos Esta palabra clave es soportada por el Native PostgreSQL Connector.
NLS_FORMATO_DE_FECHASi se especifica esta palabra clave, el Conector Nativo ejecuta la siguiente consulta al abrir la conexión:
ALTER SESSION SET NLS_DATE_FORMAT = format
Este formato no se refiere a la consulta de las columnas de Oracle por WLanguage, sino a las conversiones de fecha realizadas por el propio motor de Oracle.. Por ejemplo, cuando se ejecuta una consulta que contiene TO_CHAR de una fecha.
Conectores Nativos Esta palabra clave sólo está soportada por el Conector del Oráculo Nativo.
Nombre del archivoNombre del archivo UDL utilizado para establecer una conexión a través de OLE DB.
Para crear un archivo UDL:
  1. Cree un archivo de texto con la extensión "UDL".
  2. Haga doble clic en el archivo. Enseguida, se abre la ventana de propiedades de relaciones de datos.
  3. Configure la conexión.
  4. Pruebe la conexión.
  5. Valide (botón "OK"). Ahora se puede utilizar el archivo UDL.
Observación: Este método no está recomendado. De hecho, el acceso OLE DB utiliza la información de conexión para evitar las limitaciones establecidas por algunos proveedores.
OLE DB Esta palabra clave es soportada por OLE DB.
NUMERIC_ROUNDABORTEspecifica el nivel de gravedad del error cuando una operación de redondeo realizada en una expresión desencadena una pérdida de precisión.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
PREFETCHMEMORYTamaño de la memoria en bytes (corresponde al parámetro OCI_ATTR_PREFETCH_MEMORY de OCI_HTYPE_STMT).
El valor por defecto es 10485760 (=10 MB).
Conectores Nativos Esta palabra clave sólo está soportada por el Conector del Oráculo Nativo.
PREFETCHROVNúmero de filas en la captura previa (corresponde al parámetro OCI_ATTR_PREFETCH_ROWS del parámetro OCI_HTYPE_STMT).
Los valores posibles son los siguientes:
  • 0: Desactiva la gestión de prefetch,
  • Valor predeterminado: 1000.
Conectores Nativos Esta palabra clave sólo está soportada por el Conector del Oráculo Nativo.
PROCESOS NO UTILIZADOSNúmero máximo de procesos no utilizados (3 por defecto) almacenados en caché en una conexión WLanguage en SQL Server.
En los conectores SQL Server y Sybase Native, los procesos no utilizados (y sus conexiones) se almacenan en una caché para acelerar la ejecución de una nueva consulta.
Recordatorio: La creación de un proceso y su conexión es una operación larga.
Conectores Nativos Esta palabra clave es apoyada por el Conector de la Base Nativa.
Puerto del servidorPuerto del servidor.
Consulte la documentación sobre MySQL (palabra clave = 'mysql_real_connect') para más detalles.
Conectores Nativos Esta palabra clave es soportada por los Conectores Nativos MySQL y PostgreSQL.
QUOTED_IDENTIFIERObliga a SQL Server a seguir las reglas ISO con respecto a las comillas que delimitan los identificadores y las cadenas literales.. Los identificadores entre comillas dobles pueden ser palabras clave Transact-SQL reservadas o pueden contener caracteres no permitidos en las convenciones de la sintaxis Transact-SQL respecto a los identificadores.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave está soportada por los conectores nativos de Sybase y SQL Server (a través de OLE DB y ODBC).
RELLENO ANSI_PADDINGComprueba el modo de almacenar en la columna los valores cuya longitud es inferior al tamaño definido para la columna y los valores que contienen caracteres de espacio a la derecha para los datos char, varchar, binary y varbinary.
Los valores posibles son los siguientes:
  • 0: Fuerza el parámetro a OFF.
  • 1: Fuerza el parámetro a ON.
  • No especificado: Utiliza la configuración actual del servidor.
Conectores Nativos Esta palabra clave es compatible con los conectores nativos de SQL Server (a través de OLE DB y ODBC).
Soporte Unicode de WDPermite especificar si la gestión del formato Unicode está habilitada (o no) en la conexión.
Si "WD Unicode Support = 0", la gestión del formato Unicode está desactivada en la conexión.. Todos los valores serán convertidos (si es necesario) por el servidor en el juego de caracteres por defecto.. En este caso, se mejora el rendimiento pero no se admiten los elementos Unicode.
Si "WD Unicode Support = 1" (valor por defecto), la gestión del formato Unicode está habilitada en la conexión.. Todos los intercambios con el servidor se realizarán en Unicode. Las posibles conversiones son gestionadas por el conector nativo.
Conectores Nativos Esta palabra clave está soportada por el Servidor SQL Nativo (vía OLE DB u ODBC), Conectores MySQL y PostgreSQL.
SSL CANombre (y ruta) del archivo de la autoridad certificadora.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector y el Native PostgreSQL Connector.
SSL CAPathNombre (y ruta) del directorio que contiene el certificado SSL CA en formato PEM.
Conectores Nativos Esta palabra clave es soportada por el Native MySQL Connector.
Tamaño de caché WDTamaño de la caché para recuperar los registros devueltos por una consulta.
Para Native MySQL Connector y Native PostgreSQL Connector , se utiliza para especificar el tamaño de caché en la información opcional de la conexión.. Si se especifica este parámetro, se ignora el ajuste definido por CtCacheSize.
Para Conector Nativo SQL Server (a través de OLE DB y ODBC) , define la cantidad de registros que un cursor del servidor debe leer a la vez. Por defecto, este valor se establece en 100.
Los valores posibles son los siguientes:
  • -2: Valor por defecto del conector nativo o biblioteca cliente (100 en la mayoría de los casos).
  • -1: Todos los registros se almacenan en la caché.
Esta palabra clave está soportada por:
  • Conectores Nativos Sybase nativo, Servidor SQL (vía OLE DB y ODBC) y Conectores PostgreSQL.
  • OLE DB OLE DB.
Tiempo de espera de comandos WDDefine el tiempo máximo de espera (en segundos) para ejecutar un comando (tiempo de espera del comando).
Los valores posibles son los siguientes:
  • -1: Valor por defecto de la Biblioteca cliente (30 segundos en la mayoría de los casos).
  • 0: No timeout. En este caso, hay una espera interminable (precaución: la aplicación puede estar bloqueada).
  • superior a 0: Valor de tiempo de espera en segundos.
Esta palabra clave está soportada por:
  • Conectores Nativos Sybase nativo, Servidor SQL (vía OLE DB u ODBC) y Conectores PostgreSQL.
  • OLE DB OLE DB.
Tiempo de espera de la conexión WDDefine el tiempo máximo de espera (en segundos) para establecer la conexión (tiempo de espera de la conexión).
Los valores posibles son los siguientes:
  • -1: Valor por defecto de la Biblioteca cliente (30 segundos en la mayoría de los casos).
  • 0: Sin tiempo de espera (espera infinita).
  • superior a 0: Valor de tiempo de espera en segundos.
Esta palabra clave está soportada por:
  • Conectores Nativos Sybase nativo, Servidor SQL (vía OLE DB u ODBC) y Conectores PostgreSQL.
  • OLE DB OLE DB.
TRANS_NO_NUEVA_SESIÓNGestión de nuevas sesiones al iniciar una transacción.
Si esta palabra clave se establece en 1, no se creará ninguna nueva sesión al iniciar una transacción.. Esta opción le permite utilizar las tablas temporales creadas por sesión.
Esta opción también puede afectar el uso de transacciones anidadas.
Conectores Nativos Esta palabra clave es soportada por el conector nativo de SQL Server vía OLE DB.
Trusted_ConnectionInicie sesión con la autenticación NT.
Si esta palabra clave se establece en "SÍ", el usuario de Windows que ejecuta el proceso para iniciar la conexión se utilizará para iniciar sesión en la base de datos.
Ejemplo:
"Trusted_Connection=YES"
Conectores Nativos Esta palabra clave es soportada por Native SQL Server Connector.
Ubicación del cursor de WDEn la mayoría de los casos, el cursor por defecto es el más rápido. Corresponde al "conjunto de resultados por defecto" de la documentación de SQL Server.
Usted tiene la capacidad de especificar cursores específicos:
  • "WD Cursor Location = CLIENT" permite solicitar el uso de un cursor de cliente para todas las operaciones de navegación realizadas en esta conexión.
  • "WD Cursor Location = SERVER" permite solicitar el uso de un cursor de servidor para todas las operaciones de navegación realizadas en esta conexión.. El tipo de cursor del servidor utilizado es FAST_FORWARD. Consulte la documentación sobre SQL Server para obtener más detalles.
Este tipo de cursor se puede utilizar para:
  • Limite los recursos reservados en el servidor durante las operaciones de navegación.
  • Limitar el número de conexiones abiertas por el Conector Nativo para manejar las múltiples navegaciones en paralelo.
Atención:
  • En la mayoría de los casos, las navegaciones realizadas con los cursores del servidor son más lentas que las realizadas en el modo predeterminado.
  • Los cursores del servidor pueden no ser compatibles con algunos tipos de consultas.
  • Las actuaciones se ven afectadas por el tamaño de la caché.
Observación: Los cursores del servidor se utilizan automáticamente cuando una conexión está en transacción.
Esta palabra clave está soportada por:
  • Conectores Nativos Conector SQL Server nativo (mediante OLE DB u ODBC).
  • OLE DB OLE DB.
VERSIÓN CLIENTE WDEspecifica el número de versión de la biblioteca cliente que se va a utilizar.
Esta palabra clave está soportada por:
  • Conectores Nativos Conectores SQL Server nativos mediante OLE DB: Los valores posibles son los siguientes:
    • 2000: Utiliza la biblioteca cliente SQLOLEDB (suministrada con SQL Server 2005).
    • 2005: Utiliza la biblioteca cliente SQLnCli (suministrada con SQL Server 2005).
    • 2008: Utiliza la biblioteca cliente SQLnCli10 (suministrada con SQL Server 2008).
    • 2012: Fuerza el uso de la biblioteca cliente SQLnCli12 (suministrada con SQL Server 2012).
    • 2017: Fuerza el uso de la librería cliente msoledbsql.
    • 2019: Fuerza el uso de la librería cliente msoledbsql en la versión 19.
  • Conectores Nativos Conectores SQL Server nativos mediante ODBC: Los valores posibles son los siguientes:
    • 2000: Utiliza la biblioteca cliente SQLOLEDB (suministrada con SQL Server 2005).
    • 2005: Utiliza la biblioteca cliente SQLnCli (suministrada con SQL Server 2005).
    • 2008: Utiliza la biblioteca cliente SQLnCli10 (suministrada con SQL Server 2008).
    • 2012: Fuerza el uso de la biblioteca cliente SQLnCli12 (suministrada con SQL Server 2012).
    • msodbcsql11: Fuerza el uso de la librería cliente msodbcsql en la versión 11.
    • msodbcsql13: Fuerza el uso de la librería cliente msodbcsql en la versión 13.
    • msodbcsql17: Fuerza el uso de la librería cliente msodbcsql en la versión 17.
    • msodbcsql18: Fuerza el uso de la librería cliente msodbcsql en la versión 18.
  • Conectores Nativos Oracle: Los valores posibles son los siguientes:
    • 7: Fuerza el uso de la librería cliente de Oracle 7 (ociw32.dll).
    • 8: Utiliza la biblioteca cliente de Oracle 8 (y posteriores) (oci.dll).
WD Lock TimeoutDefine el tiempo máximo de espera (en segundos) para implementar un bloqueo (lock timeout).
Los valores posibles son los siguientes:
  • -2: Respuesta inmediata (utiliza NOWAIT en Oracle).
  • -1: Valor por defecto (30 segundos en la mayoría de los casos).
  • 0: Sin tiempo de espera (espera infinita).
  • superior a 0: Valor de tiempo de espera en segundos.
Conectores Nativos Esta palabra clave está soportada por el Servidor SQL nativo (a través de la base de datos OLE o ODBC) y los conectores del Oráculo (sólo el valor -2).
Conectores Nativos La información opcional es ahora soportada por el Native AS/400 Connector (para más detalles, vea la documentación sobre el Native AS/400 Connector):
  • PEA
  • AUTODAY
  • ACUERDOS DE ESCONDITE
  • CACHETIMEOUT
  • CLAVE DE TIEMPO DE CACHÉ
  • CCSID
  • LOCALCP
  • CODEPAGEFILE
  • TIEMPO DE ESPERA DE LA CONEXIÓN
  • TIEMPO DE ESPERA DEL COMANDO
  • TIPO DE FECHA
  • CALENDARIO
  • DRVOPTIMISTA
  • EIM_LOOKUP_INFO
  • EXTRAIDX
  • FIELDDNAMES_MUST_MATCH
  • FORCELIBLE
  • HFMAXKEY
  • IGNORE_VACIO_EXTINFO
  • IMPORT_DFT
  • IMPORT_SELOMIT
  • LITERALCASE
  • ESPACIOS DE LIDERAZGO
  • SÓLO NOMBRES DE CAMPOS CORTOS
  • NOMBRE
  • SQLNAMING
  • SSL
  • SSL_INTF
  • FICHERO_SSL_CAFILE
  • SSL_CAPATH
  • EN SENTIDO ESTRICTO
  • SQLFULLPRECISION
  • SQLHPOS
  • TCP_VERSION
  • TCPIP_FATAL
  • TIMEOUTNOTIF
  • ARCHIVO_DE_USUARIO
  • FICHERO_DE_USUARIO_CERT_PKEY
  • USER_CERT_PASSPHRASE
Versión mínima requerida
  • Versión 16
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 07/06/2024

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