DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés HFSQL
  • Récupération des enregistrements
  • Gestion de la propriété CxTailleCache
  • Option hRequêteSansCorrection
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
CxTailleCache (Propriété)
En anglais : CtCacheSize
OLE DBConnecteurs Natifs (Accès Natifs)Disponible uniquement avec ces types de connexion
La propriété CxTailleCache permet de connaître et de modifier le nombre maximum d'enregistrements pouvant être contenus dans le cache du Connecteur Natif MySQL.
Remarque : La taille du cache spécifiée avec la propriété CxTailleCache est ignorée si cette taille a été précisée directement dans les informations optionnelles des fonctions HDécritConnexion ou HOuvreConnexion.
Gestion du cache : fonctionnement
A chaque accès à une base de données externe, les enregistrements récupérés sont stockés dans le cache du Connecteur Natif utilisé avant d'être transmis au poste client.
Le cache d'un Connecteur Natif ne peut contenir qu'un nombre limité d'enregistrements. Si le nombre d'enregistrements à récupérer est supérieur au nombre maximum d'enregistrements défini pour le cache, les enregistrements sont récupérés par groupes d'enregistrements.
Le nombre maximum d'enregistrements pouvant être contenus dans le cache correspond à la taille du cache.
Par exemple, si la taille du cache du Connecteur Natif utilisé est égale à 10, lors de l'exécution d'une requête sélectionnant 24 enregistrements, le cache se remplira 3 fois de suite :
  • 10 enregistrements.
  • 10 enregistrements.
  • 4 enregistrements.
Exemple
// Modifier la taille du cache du Connecteur Natif MySQL utilisé par la connexion MaConnexion
MaConnexion.CxTailleCache = 450
Syntaxe

Connaître la taille du cache du Connecteur Natif MySQL Masquer les détails

<Taille du cache> = <Nom de la connexion>.CxTailleCache
<Taille du cache> : Entier
Taille du cache du Connecteur Natif MySQL.
Si ce paramètre correspond à :
  • -2 : la taille du cache est la taille par défaut (100 pour le Connecteur Natif MySQL).
  • -1 : la taille du cache est illimitée.
  • 0 : le cache ne stocke aucun enregistrement. Aucun enregistrement n'est récupéré.
<Nom de la connexion> : Chaîne de caractères
Nom de la connexion manipulée. Ce nom a été défini sous l'éditeur d'analyses ou avec les fonctions HDécritConnexion ou HOuvreConnexion.

Modifier la taille du cache du Connecteur Natif MySQL Masquer les détails

<Nom de la connexion>.CxTailleCache = <Taille du cache>
<Nom de la connexion> : Chaîne de caractères
Nom de la connexion manipulée. Ce nom a été défini sous l'éditeur d'analyses ou avec les fonctions HDécritConnexion ou HOuvreConnexion.
<Taille du cache> : Entier
Nouvelle taille du cache du Connecteur Natif MySQL.
Si ce paramètre correspond à :
  • -2 : la taille du cache sera la taille par défaut (100 pour le Connecteur Natif MySQL).
  • -1 : la taille du cache sera illimitée.
  • 0 : le cache ne stockera aucun enregistrement. Aucun enregistrement ne sera récupéré.
Remarques

Récupération des enregistrements

La vitesse de récupération de l'ensemble des enregistrements est proportionnelle à la taille du cache : plus la taille du cache est importante, plus la vitesse de récupération est élevée.
Cependant, plus la taille du cache est petite, plus la lecture du premier enregistrement sera rapide.
Attention : La mémoire occupée par le cache est proportionnelle à la taille du cache.

Gestion de la propriété CxTailleCache

La propriété CxTailleCache est gérée uniquement par le Connecteur Natif MySQL.
Les autres Connecteurs Natifs ne gèrent pas la propriété CxTailleCache. Dans ce cas, l'utilisation de cette propriété sera ignorée et aucune erreur ne sera générée.

Option hRequêteSansCorrection

Si la requête est exécutée sans vérification du code SQL (utilisation de la constante hRequêteSansCorrection), la taille du cache sera illimitée et ne pourra pas être modifiée grâce à la propriété CxTailleCache.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale