AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Gestión de estadísticas
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Recopila estadísticas sobre las claves de los archivos de datos.
Esta función es equivalente a la función HAccelerateSpeed.
Estas estadísticas se utilizan al aplicar un filtro, crear una consulta o crear una vista en el archivo de datos. El motor HFSQL analiza la condición de selección y, a continuación, utiliza estas estadísticas para definir los campos más discriminantes que se utilizarán para optimizar las iteraciones en los archivos de datos.
Al calcular las estadísticas, estas permiten obtener información sobre el contenido del archivo de datos. Es importante tener en cuenta que entre más modificaciones se realicen en el archivo de datos después del cálculo, menos precisas serán las estadísticas con respecto al contenido del archivo de datos. Cuantos más registros contenga el archivo de datos, menor será el impacto de la modificación de un solo registro en las estadísticas globales.
Nota: La función HStatCalculate impide las operaciones de escritura en el archivo de datos mientras se calculan las estadísticas (el archivo de datos se lee por cada clave).
HFSQL Client/Server Las estadísticas pueden calcularse en segundo plano, sin bloquear el archivo de datos.
New in SaaS
HFSQL Client/Server Las estadísticas de un archivo de datos HFSQL Client/Server pueden calcularse de forma asíncrona utilizando la función HStatCalculateAsynchronous.
Nota: Esta funcionalidad solo está disponible a partir de WINDEV Suite SaaS 2025 - Update 2.
Para obtener más información, consulte Utilizar las novedades exclusivas de WINDEV Suite SaaS 2025.
Nota: Para obtener resultados óptimos, este cálculo debe incluir todos los archivos de datos (por ejemplo, consulta a varios archivos de datos).
Ejemplo
// Statistics on the CustName key of the Customer data file
HStatCalculate(Customer, CustomerName)
Sintaxis
<Result> = HStatCalculate([<Data file> [, <Key item> [, <Option>]]])
<Result>: Booleano
  • True si se realizó el cálculo,
  • False si se produce un problema (archivo de datos bloqueado por una aplicación, por ejemplo). La función HError permite identificar el error.
<Data file>: Cadena de caracteres opcional
Nombre del archivo de datos utilizado. Si no se especifica este nombre, la función HStatCalculate utilizará el último archivo de datos utilizado por la última función HFSQL (que empieza por "H").
Si este parámetro es igual a "*" (sin especificar ningún campo), el cálculo se realizará en todos los archivos de datos descritos en el análisis actual (incluidos los archivos de datos descritos con las funciones HDeclare, HDeclareExternal y HDescribeFile).
Atención: Este archivo de datos no debe estar bloqueado por una aplicación.
<Key item>: Cadena de caracteres opcional
Nombre del campo clave utilizado para calcular las estadísticas. Si no se especifica este nombre o se establece en "*", las estadísticas se calcularán para todos los campos clave del archivo de datos.
<Option>: Constante de tipo Integer
Opción para calcular las estadísticas.
  • Si no se especifica este parámetro, el cálculo de las estadísticas bloquea el archivo de datos.
  • Si este parámetro corresponde a la constante hBackgroundTask, las estadísticas se calculan en segundo plano, sin bloquear el archivo de datos.
Importante: Este parámetro solo se tiene en cuenta para archivos de datos HFSQL Client/Server. En todos los demás casos, el archivo de datos se bloquea automáticamente mientras se calculan las estadísticas.
Observaciones
  • La función HStatCalculate no cierra el archivo de datos.
  • Las estadísticas también pueden actualizarse utilizando la función HIndex. Las funciones HIndex y HStatCalculate son las dos únicas funciones que permiten actualizar las estadísticas del archivo de datos.
  • En los archivos de datos HFSQL Classic o Client/Server, solo se pueden utilizar los campos clave para calcular las estadísticas.
  • La sintaxis HStatCalculate(<Data file>) equivale a HStatCalculate(<Data file>, "*")
  • Para utilizar la función HStatCalculate con los archivos de datos de un clúster HFSQL, el parámetro <Option> debe corresponder a la constante hBackgroundTask para no bloquear el clúster.
Componente: wd300hf.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: 24/06/2025

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