AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
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
Realiza varios cálculos estadísticos en las claves de un archivo de datos. Esta función es equivalente a la función HAccelerateSpeed. Estas estadísticas se utilizan al implementar 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 luego utiliza estas estadísticas para definir los elementos más discriminantes que se utilizarán para optimizar las iteraciones en los archivos de datos.
Las estadísticas se utilizan para get información sobre el contenido del archivo de datos cuando se calculan. Por lo tanto, cuanto más modificaciones se realizan en el archivo después de este cálculo, menos estas estadísticas representan el contenido de True del archivo de datos. Cuanto más Record s el archivo de datos contiene, menos la modificación de un solo Record impacta las estadísticas generales.
Atención: <Fuente>.StatCalculate impide escribir en el archivo de datos durante el cálculo de las estadísticas (se realiza una iteración para cada clave en el archivo de datos).
HFSQL Client/Server Las estadísticas pueden ser calculadas en la tarea de Background sin bloquear el archivo de datos en modo de escritura.
Observación: Para que el cálculo estadístico sea eficiente, este cálculo debe realizarse en todos los archivos de datos (para una consulta de varios archivos, por ejemplo).
Ejemplo
// Statistics on the CustName key of the Customer data file
Customer.StatCalculate(CustName)
Sintaxis
<Result> = <Source>.StatCalculate([<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.
<Source>: Tipo de fuente especificada
Nombre del archivo de datos utilizado.
Atención: Este archivo de datos no debe ser bloqueado por una aplicación.
<Key item>: Cadena de caracteres opcional
Nombre del elemento clave utilizado para calcular las estadísticas. Si no se especifica este nombre o si es igual a "*", las estadísticas se calcularán para todos los elementos clave que se encuentran en el archivo de datos.
<Option>: Constante de tipo Integer
Opción para el cálculo de las estadísticas.
  • Si no se especifica este parámetro, el cálculo de las estadísticas bloquea a el archivo de datos en modo de escritura.
  • Si este parámetro corresponde a la constante hBackgroundTask, las estadísticas se calculan en la tarea Background, sin bloquear el archivo de datos.
Importante: Este parámetro se tiene en cuenta para los ficheros HFSQL Client/Server. En los otros casos, el archivo de datos se bloquea automáticamente mientras se calculan las estadísticas.
Observaciones
  • <Fuente>.StatCalculate no cierra el archivo de datos.
  • Las estadísticas también pueden ser actualizadas por <Fuente>.Index. Las funciones <Fuente>.Index y <Fuente>.StatCalculate son las dos únicas funciones que permiten actualizar las estadísticas del archivo de datos.
  • En los ficheros de datos HFSQL Classic o Cliente/Servidor, el cálculo estadístico sólo puede realizarse sobre las partidas clave.
  • La sintaxis <Fuente>.StatCalculate(<Archivo de datos>) equivale a <Fuente>.StatCalculate(<Archivo de datos>, "*")
  • Para utilizar la función <Fuente>.StatCalculate con los archivos de datos de un clúster HFSQL, el parámetro <Opción> debe corresponder a la constante hBackgroundTask para no bloquear el clúster.
Componente: wd300hf.dll
Versión mínima requerida
  • Versión 25
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 17/06/2024

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