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 / Funciones HFSQL
  • Características del archivo de datos creado
  • Los archivos adicionales creados
  • Gestión de contraseñas
  • Manejo de errores fatales en la creación de un archivo de datos
  • Gestión de conjuntos de caracteres no latinos
  • Replicación: Rango de identificadores
  • Prioridad para definir la ubicación de los archivos de registro
  • Creación de una tabla existente
  • Limitaciones para la integridad referencial
  • OLE DB Oracle: Creación de una tabla que contiene un memo binario
  • OLE DB: Creando un tabla que contiene identificadores automatic
  • Gestión de índices
  • Creando el archivo de datos a partir de su description
  • Fechas y horas con la Conector Nativo SQL Server
  • HCreación y el conector SQLite nativo
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
Crea un archivo de datos vacío (extensión .FIC) con el archivo de índice y el archivo de notas si es necesario.
Esta función también se puede usar para borrar todos los registros de un archivo de datos. En este caso, la Record en la memoria no se cancela. Para inicializarlo, utilice HReset.
Observación: La creación de archivos de datos inexistentes en automatic se puede habilitar en el proyecto description (pestaña "Archivos" del proyecto description, "Crear automáticamente los archivos de datos al abrirlos"). La función HCreación se utiliza automáticamente si el archivo de datos no existe al manipularlo por primera vez.
WINDEVWEBDEV - Código ServidorHFSQL Classic Si el archivo de datos está registrado, puede especificar la ubicación de los archivos de registro.
HFSQL Client/Server Si se han definido restricciones de integridad y si son compatibles, los enlaces se actualizan en el servidor.
// Create the Orders data file (described in the analysis)
HCreation(Orders)
Sintaxis
<Result> = HCreation(<Data file> [, <Password> [, <Path of the JNL file> [, <Path of the JournalOperation file> [, <Option>]]]])
<Result>: booleano
  • True si el archivo de datos fue creado,
  • False si se produce un problema. La función HError permite identificar el error. Si se produce un error fatal, se requiere un proceso específico para continuar el programa y comprobar si se creó el archivo de datos (ver Notas).
<Data file>: Cadena de caracteres
Nombre del archivo de datos a crear.
Conectores Nativos MySQL: el nombre tabla no debe contener ningún carácter acentuado (por ejemplo: "ElanFile"). Este es un problema específico de MySQL (probado en las versiones 3.23.52-max-nt y 3.23.47-max-nt del servidor MySQL).
<Password>: Cadena de caracteres opcional
  • Contraseña asociada al archivo de datos.
    HFSQL ClassicHFSQL Client/Server La contraseña de los archivos HFSQL no distingue entre mayúsculas y minúsculas.
  • Cadena vacía ("") si no se utiliza ninguna contraseña.
<Path of the JNL file>: Cadena de caracteres opcional
Accede a ruta al archivo JNL associated con el archivo de datos registrados. Este parámetro sólo se tiene en cuenta si se registra el archivo de datos. En este caso, el archivo <Nombre de archivo>JNL.fic se creará en la ubicación especificada.
HFSQL Client/Server Este parámetro no debe especificarse. En HFSQL Client/Server, la ruta del archivo JNL es fija y no se puede modificar.
AndroidWidget Android iPhone/iPadPHP Este parámetro no se tiene en cuenta.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
<Path of the JournalOperation file>: Cadena de caracteres opcional
Accede a ruta al archivo de JournalOperation y al archivo de JournalIdentification associated con el archivo registrado. El fichero JournalOperation contiene todas las operaciones realizadas en el fichero con los logs. Este parámetro sólo se tiene en cuenta si se registra el archivo de datos.
HFSQL Client/Server Este parámetro no debe especificarse. En HFSQL Client/Server, la ruta del archivo de operaciones es fija y no se puede modificar.
AndroidWidget Android iPhone/iPadPHP Este parámetro no se tiene en cuenta.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
<Option>: Constante opcional de tipo Integer
Opciones para la creación de el archivo de datos:
hChangeCharsetEl conjunto de caracteres definido con la función ChangeCharset se tendrá en cuenta en el nuevo archivo de datos. El orden, las búsquedas, ... en claves de tipo String (cadenas, caracteres, fecha y hora) se realizarán de acuerdo con este conjunto de caracteres.
hNoLinkGestión de la integridad: Las relaciones no se actualizan en el servidor (creación, modificación o eliminación).
Recordatorio: al crear un archivo de datos, las relaciones se actualizan en el servidor de forma predeterminada.
HFSQL Client/Server Esta constante solo está disponible en modo HFSQL Client/Server.
PHP Este parámetro no se tiene en cuenta.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
AndroidWidget Android Este parámetro no se tiene en cuenta.
Observaciones
WINDEVWEBDEV - Código ServidorUniversal Windows 10 AppiPhone/iPadJavaAjaxHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosHyper File 5.5OLE DBConectores Nativos

Características del archivo de datos creado

Las características del archivo de datos creado son las siguientes:
  • Nombre del archivo de datos:
    Nombre físico definido en la descripción del archivo de datos en el editor de análisis. Este nombre se puede modificar antes de crear el archivo de datos con la función HChangeName.
  • Directorio del archivo de datos:
    Directorio definido en la descripción del archivo de datos en el editor de análisis. Este directorio se puede modificar antes de crear el archivo de datos con las funciones HSubstDir y HChangeDir.
  • Contenido del archivo de datos:
    El archivo de datos creado está vacío, pero no significa que su tamaño sea nulo (el archivo contiene un encabezado que describe su estructura).
  • El orden de los elementos creados en el archivo físico es el orden físico de los elementos creados en el análisis, y no el orden lógico.
If el archivo de datos ya existía: Si el archivo de datos ya existía (mismo nombre, mismo directorio), este archivo de datos es recreado: el archivo de datos no contiene Record. El fichero índice y el fichero memo (si existen) también se recrean.. En este caso, no se verifican las restricciones de integridad.
Atención: La recreación de el archivo de datos es posible sólo si el archivo de datos no es usado por otra aplicación. Si hay que borrar un archivo utilizado actualmente, utilice HDelete durante una exploración. También puede utilizar HDeleteAll para eliminar todos los registros de un archivo de datos.
WINDEVWEBDEV - Código ServidorUniversal Windows 10 AppiPhone/iPadAjaxHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosHyper File 5.5

Los archivos adicionales creados

Al crear un archivo de datos, se pueden crear los siguientes archivos además de el archivo de datos:
  • An archivo de índice (extensión "NDX") si se han definido una o más claves en el archivo description.
  • A archivo de memo (extensión "MMO") si se han definido uno o más elementos de memo en el archivo description.
  • Archivo de registro de A (extensión "JNL"). Este archivo se crea sólo si se ha seleccionado la opción correspondiente durante la creación del archivo description.
    Universal Windows 10 AppAndroidWidget Android iPhone/iPadPHP Este archivo no se crea.
  • Un archivo <ProjectName>.REP. Este archivo contiene la lista de archivos de datos que maneja la aplicación. Este fichero se crea (o rellena) si la gestión de .REP está activada (HSetREP). Para obtener más información, consulte Archivo .REP.
    Universal Windows 10 AppiPhone/iPad Este archivo no se crea.

Gestión de contraseñas

  • La contraseña se puede definir:
    • directamente al crear el archivo de datos con la función HCreación.
    • antes de crear el archivo de datos con la función HPass.
  • Si el archivo de datos existía y estaba protegido por una contraseña, el archivo de datos se vuelve a crear, incluso si la contraseña cambia o ya no existe.
Atención: La contraseña es independiente del cifrado de datos. La encriptación de los datos debe ser configurada durante el archivo description en el editor de análisis (pestaña "Detalles").
PHPConectores Nativos La contraseña no es associated con un archivo de datos sino con una base de datos. Esta contraseña debe especificarse durante la conexión (HConnect).

Manejo de errores fatales en la creación de un archivo de datos

Si se produce un error fatal al crear un archivo de datos, puede ser interesante continuar el programa mientras se comprueba si el archivo de datos fue creado o no.. Para ello, le recomendamos que realice la siguiente excepción: Process:
WHEN EXCEPTION IN
HCreation(PARENT)
DO
Error("HFSQL error: " + HError())
ELSE
Trace("The file is created")
END
WINDEVWEBDEV - Código ServidorUniversal Windows 10 AppiPhone/iPadAjaxHFSQL ClassicHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Gestión de conjuntos de caracteres no latinos

Si se especifica la constante hChangeCharset, el carácter set utilizado en el archivo de datos será el especificado por ChangeCharset. El orden, las búsquedas, ... en claves de tipo String (cadenas, caracteres, fecha y hora) se realizarán de acuerdo con este conjunto de caracteres.
El carácter set utilizado puede ser modificado por HIndex.
Observación: El tamaño de los elementos de cadena especificados en el análisis se expresa en bytes y no en caracteres.. Dependiendo del carácter set utilizado, es posible que tenga que aumentar el tamaño del artículo (si los caracteres utilizados están codificados en 2 bytes, por ejemplo).
WINDEVWEBDEV - Código ServidorAjaxHFSQL ClassicHFSQL Client/ServerHyper File 5.5

Replicación: Rango de identificadores

Los identificadores de automatic para los archivos de las réplicas de los suscriptores utilizan una gama de identificadores que difiere de la utilizada por el archivo de la réplica maestra y por los otros archivos de las réplicas de los suscriptores.
Este rango de identificadores de automatic está escrito en el encabezado de cada archivo de datos (extensión "FIC").
Este rango se inicializa:
Para más detalles, consulte la página web de consecuencias de la implementación de la réplica.
WINDEVWEBDEV - Código ServidorAjaxHFSQL ClassicHyper File 5.5

Prioridad para definir la ubicación de los archivos de registro

La ubicación de los archivos de registro se define según el siguiente orden de prioridad:
  1. Ubicación especificada al crear el archivo de datos de registro (función HCreación).
  2. Ubicación especificada por HChangeLogDir.
  3. Ubicación especificada en el análisis.
  4. Ubicación del archivo de datos registrado.
Si otra aplicación utiliza HDeclareExternal en un archivo de datos registrado, los cambios realizados por esta aplicación se guardan en los archivos de registro especificados en la cabecera del archivo de datos HFSQL registrado.
HFSQL Client/Server La ubicación de los archivos de registro es fija y no se puede modificar.. Para obtener más información, consulte Archivos de registro en modo Cliente/Servidor.
WINDEVWEBDEV - Código ServidorAjaxProcedimientos almacenadosOLE DB

Creación de una tabla existente

Si el tabla ya existe, el HCreación intenta borrar y volver a crear el tabla.
Por ejemplo: Uso de una base de datos Oracle
  • con el proveedor "MSDAORA" de OLE DB: no se puede crear una nueva tabla. Si el tabla ya existe, los registros se borran.
  • con el proveedor de OLE DB "oraOLEDB.Oracle: es posible la creación de una nueva tabla así como la recreación de una tabla existente. Sin embargo, no se puede crear ningún índice o posición de nota.
Al crear un tabla, WINDEV y WEBDEV intentan crear los ítems en el tipo OLE DB correspondientes al tipo HFSQL. Si este tipo no es soportado, WINDEV y WEBDEV prueban sucesivamente todos los tipos de bases de datos OLE "compatibles" hasta que encuentran un tipo soportado por la base de datos OLE DB.
WINDEVWEBDEV - Código ServidorJavaPHPAjaxOLE DBConectores Nativos

Limitaciones para la integridad referencial

Cuando se crea una tabla, las restricciones de integridad referenciales descritas en el análisis no se crean en la base de datos.
OLE DB

OLE DB Oracle: Creación de una tabla que contiene un memo binario

Atención: la creación de un Oracle tabla que contenga memos binarios falla en Oracle 7.x (porque los LOBs no son soportados en esta versión de Oracle).
OLE DB

OLE DB: Creando un tabla que contiene identificadores automatic

El identificador automatic se creará en el tabla sólo si el proveedor OLE DB soporta los identificadores automatic.
WINDEVWEBDEV - Código ServidorJavaPHPConectores Nativos

Gestión de índices

HCreación no devuelve ningún mensaje de error si no se puede añadir un índice. El tabla se crea sin el índice que está causando el problema.. En este caso, se pueden encontrar duplicados en un elemento definido como clave única por WINDEV y WEBDEV si la base de datos externa no soporta las claves únicas.

Creando el archivo de datos a partir de su description

El archivo de datos puede ser creado directamente desde su description en el editor de análisis. Para ello, seleccione "Crear el archivo de datos" y seleccione el directorio donde debe crearse el archivo de datos.
Conectores Nativos

Fechas y horas con la Conector Nativo SQL Server

Cuando se utiliza HCreación, el Conector Nativo de SQLServer crea elementos de FECHA y HORA si la versión del servidor y la versión de la capa cliente corresponden a SQL Server 2008 (o posterior).
Conectores Nativos

HCreación y el conector SQLite nativo

HCreación puede fallar (error "la base de datos tabla está bloqueada") si:
  • el fichero a crear ya existe.
  • una iteración está en curso en otro archivo de la misma base de datos.
Esto es causado por una limitación de la base de datos SQLite.
Componente: wd290hf.dll
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: 03/12/2022

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