Partager via


Utilisation de la mise en mémoire tampon adaptative

Télécharger le pilote JDBC

La mise en mémoire tampon adaptative est conçue pour récupérer tout type de données de valeur importante sans la charge mémoire associée aux curseurs côté serveur. Les applications peuvent utiliser la fonctionnalité de mise en mémoire tampon adaptative avec toutes les versions de SQL Server qui sont prises en charge par le pilote.

Normalement, quand le Pilote Microsoft JDBC pour SQL Server exécute une requête, il extrait tous les résultats du serveur dans la mémoire d’application. Bien que cette approche réduise la consommation des ressources sur l’ordinateur SQL Server, elle peut lever une exception OutOfMemoryError dans l’application JDBC pour les requêtes qui produisent des résultats très grands.

Pour permettre aux applications de gérer des résultats très volumineux, le Pilote Microsoft JDBC pour SQL Server fournit la mise en mémoire tampon adaptative. Avec la mise en mémoire tampon adaptative, le pilote récupère les résultats de l’exécution des instructions à partir du serveur SQL Server chaque fois que l’application en a besoin, et non en une seule fois. Le pilote ignore également les résultats dès que l'application ne peut plus y accéder. Voici quelques exemples de situations où la mise en mémoire tampon adaptative peut être utile :

  • La requête génère un jeu de résultats très volumineux : l'application peut exécuter une instruction SELECT qui produit plus de lignes que l'application ne peut en stocker en mémoire. Dans les versions précédentes, l’application devait utiliser un curseur côté serveur pour éviter une erreur OutOfMemoryError. La mise en mémoire tampon adaptative permet d'effectuer un passage en lecture seule avant uniquement d'un jeu de résultats arbitrairement volumineux sans nécessiter de curseur côté serveur.

  • La requête produit des valeurs très élevées pour les colonnes SQLServerResultSet ou les paramètres OUT SQLServerCallableStatement : l’application peut récupérer une seule valeur (colonne ou paramètre OUT) qui est trop grande pour la mémoire de l’application. La mise en mémoire tampon adaptative permet à l'application cliente d'extraire une telle valeur en tant que flux, en utilisant les méthodes getAsciiStream, getBinaryStream ou getCharacterStream. L’application récupère la valeur à partir du serveur SQL Server à mesure qu’elle lit le flux.

Notes

Avec la mise en mémoire tampon adaptative, le pilote JDBC ne met en mémoire tampon que la quantité de données requise. Le pilote ne fournit aucune méthode publique pour contrôler ou limiter la taille de la mémoire tampon.

Définition de la mise en mémoire tampon adaptative

À compter de la version 2.0 du pilote JDBC, le comportement par défaut du pilote est « adaptive ». En d'autres termes, pour pouvoir obtenir le comportement de mise en mémoire tampon adaptative, votre application n'a pas besoin de requérir explicitement le mode de mise en mémoire tampon adaptative. Toutefois, dans la version 1.2, le mode de mise en mémoire tampon était « full » par défaut, et l’application devait demander explicitement le mode de mise en mémoire tampon adaptative.

Il existe trois manières pour une application de demander que l'exécution d'instructions utilise la mise en mémoire tampon adaptative :

Lors de l’utilisation du pilote JDBC version 1.2, les applications devaient effectuer une conversion de type (transtypage) de l’objet statement vers une classe SQLServerStatement pour pouvoir utiliser la méthode setResponseBuffering. Les exemples de code Exemple de lecture de données volumineuses et Exemple de lecture de données volumineuses avec des procédures stockées illustrent cet ancien mode d’utilisation.

Toutefois, avec le pilote JDBC version 2.0, les applications peuvent utiliser les méthodes isWrapperFor et unwrap pour accéder aux fonctionnalités propres aux fournisseurs sans hypothèse relative à la hiérarchie de la classe d’implémentation. Pour obtenir un exemple de code, consultez la rubrique Exemple de mise à jour de données volumineuses.

Récupération de données volumineuses avec la mise en mémoire tampon adaptative

Quand des valeurs élevées sont lues une fois en utilisant les méthodes get<Type>Stream et que les colonnes ResultSet et les paramètres CallableStatement OUT sont accessibles dans l’ordre retourné par le serveur SQL, la mise en mémoire tampon adaptative réduit l’utilisation de la mémoire de l’application pendant le traitement des résultats. Lors de l'utilisation de la mise en mémoire tampon adaptative :

  • Les méthodes get<Type>Stream définies dans les classes SQLServerResultSet et SQLServerCallableStatement retournent des flux à lecture unique par défaut, bien que les flux puissent être réinitialisés s’ils sont marqués par l’application. Si l’application souhaite effectuer un reset du flux, elle doit d’abord appeler la méthode mark sur ce flux.

  • Les méthodes get<Type>Stream définies dans les classes SQLServerClob et SQLServerBlob retournent des flux qui peuvent toujours être repositionnés à la position de départ du flux sans appeler la méthode mark.

Quand l’application utilise la mise en mémoire tampon adaptative, les valeurs récupérées par les méthodes get<Type>Stream peuvent être récupérées une seule fois. Si vous essayez d’appeler une méthode get<Type> sur la même colonne ou le même paramètre après avoir appelé la méthode get<Type>Stream du même objet, une exception est levée avec le message « Les données ont été consultées et ne sont pas disponibles pour cette colonne ou ce paramètre ».

Notes

Un appel à ResultSet.close() au milieu du traitement d’un objet ResultSet oblige Microsoft JDBC Driver pour SQL Server à lire et ignorer tous les paquets restants. Cela peut prendre beaucoup de temps si la requête a retourné un jeu de données volumineux, surtout si la connexion réseau est lente.

Consignes pour l'utilisation de la mise en mémoire tampon adaptative

Les développeurs doivent respecter les recommandations importantes suivantes afin de réduire l'utilisation de la mémoire par l'application :

  • Évitez d’utiliser la propriété de chaîne de connexion electMethod=cursor pour permettre à l’application de traiter un jeu de résultats très volumineux. La fonctionnalité de mise en mémoire tampon adaptative permet aux applications de traiter de très grands jeux de résultats avant uniquement en lecture seule sans utiliser de curseur côté serveur. Notez que, quand vous définissez selectMethod=cursor, tous les jeux de résultats en lecture seule de type avant produits par cette connexion sont affectés. En d’autres termes, si votre application traite régulièrement des jeux de résultats de petite taille avec peu de lignes, la création, la lecture et la fermeture d’un curseur côté serveur pour chaque jeu de résultats utilisera davantage de ressources à la fois côté client et côté serveur que dans le cas où selectMethod n’a pas la valeur cursor.

  • Lisez les valeurs de texte ou binaires volumineuses en tant que flux à l’aide des méthodes getAsciiStream, getBinaryStream ou getCharacterStream à la place des méthodes getBlob ou getClob,. À partir de la version 1.2, la classe SQLServerCallableStatement fournit de nouvelles méthodes get<Type>Stream à cet effet.

  • Vérifiez que les colonnes avec des valeurs potentiellement grandes sont placées en dernier dans la liste de colonnes dans une instruction SELECT et que les méthodes get<Type>Stream de SQLServerResultSet sont utilisées pour accéder aux colonnes dans l’ordre dans lequel elles sont sélectionnées.

  • Vérifiez que les paramètres OUT avec des valeurs potentiellement grandes sont déclarés en dernier dans la liste de paramètres dans le SQL utilisé pour créer le SQLServerCallableStatement. Vérifiez aussi que les méthodes get<Type>Stream de SQLServerCallableStatement sont utilisées pour accéder aux paramètres OUT dans l’ordre dans lequel ils sont déclarés.

  • Évitez d'exécuter simultanément plusieurs instructions sur la même connexion. L'exécution d'une autre instruction avant le traitement des résultats de l'instruction précédente peut provoquer la mise en mémoire tampon des résultats non traités dans la mémoire d'application.

  • Dans certains cas, l’utilisation de selectMethod=cursor au lieu de responseBuffering=adaptive serait plus avantageuse, par exemple :

    • Si votre application traite avant uniquement, en lecture seule jeu de résultats lentement, par exemple la lecture de chaque ligne après une entrée utilisateur, à l’aide de selectMethod = cursor au lieu de responseBuffering = adaptive peut aider à réduire l’utilisation des ressources par SQL Server.

    • Si votre application traite plusieurs jeux de résultats en lecture seule de type avant simultanément sur la même connexion, l’utilisation de selectMethod=cursor à la place de responseBuffering=adaptive peut aider à réduire la mémoire requise par le pilote lors du traitement de ces jeux de résultats.

    Dans les deux cas, vous devez tenir compte de la surcharge liée à la création, la lecture et la fermeture des curseurs côté serveur.

En outre, la liste suivante fournit quelques recommandations pour les jeux de résultats de type avant uniquement pouvant être mis à jour et déroulables :

  • Pour les jeux de résultats déroulables, lors de l’extraction d’un bloc de lignes, le pilote lit toujours en mémoire le nombre de lignes indiqué par la méthode getFetchSize de l’objet SQLServerResultSet, même quand la mise en mémoire tampon adaptative est activée. Si le défilement provoque une erreur OutOfMemoryError, vous pouvez réduire le nombre de lignes extraites en appelant la méthode setFetchSize de l’objet SQLServerResultSet pour affecter un nombre inférieur de lignes à la taille de l’extraction, voire une seule ligne, si nécessaire. Si cela n’empêche pas l’erreur OutOfMemoryError, évitez d’inclure des colonnes très volumineuses dans les jeux de résultats déroulables.

  • Pour les jeux de résultats de type avant uniquement pouvant être mis à jour, lors de l’extraction d’un bloc de lignes, le pilote lit normalement en mémoire le nombre de lignes indiqué par la méthode getFetchSize de l’objet SQLServerResultSet, même quand la mise en mémoire tampon adaptative est activée sur la connexion. Si l’appel de la méthode next de l’objet SQLServerResultSet provoque une erreur OutOfMemoryError, vous pouvez réduire le nombre de lignes extraites en appelant la méthode setFetchSize de l’objet SQLServerResultSet pour affecter un nombre inférieur de lignes à la taille de l’extraction, voire une seule ligne, si nécessaire. Vous pouvez également forcer le pilote à ne mettre aucune ligne en mémoire en appelant la méthode setResponseBuffering de l’objet SQLServerStatement avec le paramètre « adaptive » avant d’exécuter l’instruction. Comme le jeu de résultats n’a pas d’option de défilement, si l’application accède à une grande valeur de colonne en utilisant une des méthodes get<Type>Stream, le pilote ignore la valeur dès que l’application la lit, comme il le fait pour les jeux de résultats en lecture seule de type avant uniquement.

Voir aussi

Amélioration des performances et de la fiabilité avec le pilote JDBC