Utilisation de la mise en mémoire tampon adaptative

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, lorsque le pilote JDBC Microsoft 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 JDBC Microsoft 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 produit un jeu de résultats très grand : l'application peut exécuter une instruction SELECT qui produit davantage de lignes que l'application ne peut 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 de très grandes colonnes SQLServerResultSet ou de très grandes valeurs de paramètres OUT SQLServerCallableStatement ** :** l'application peut extraire une valeur unique (colonne ou paramètre OUT) trop grande pour être contenue entièrement en mémoire d'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.

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

À partir 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 ; par ailleurs, l'application devait requérir 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 :

• L'application peut affecter la valeur « adaptive » à la propriété de connexion responseBuffering. Pour plus d'informations sur la définition des propriétés de connexion, consultez Définition des propriétés de connexion.
• L'application peut utiliser la méthode setResponseBuffering de l'objet SQLServerDataSource pour définir le mode de mise en mémoire tampon de la réponse pour toutes les connexions créées par le biais de cet objet SQLServerDataSource.
• L'application peut utiliser la méthode setResponseBuffering de la classe SQLServerStatement pour définir le mode de mise en mémoire tampon de la réponse pour un objet statement particulier.

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 dans les rubriques 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 spécifiques 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

Lorsque de grandes valeurs sont lues une fois à l'aide des méthodes get<Type>Stream et que l'accès aux colonnes ResultSet et aux paramètres OUT CallableStatement s'effectue dans l'ordre retourné par le serveur SQL Server, la mise en mémoire tampon adaptative réduit l'utilisation de la mémoire de l'application lors du 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.

Lorsque l'application utilise la mise en mémoire tampon adaptative, les valeurs extraites par les méthodes get<Type>Stream peuvent être extraites une seule fois. Si vous essayez d'appeler toute 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 « Un utilisateur a accédé aux données et elles ne sont pas disponibles pour cette colonne ou ce paramètre ».

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 selectMethod=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, lorsque 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 plus 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 grandes valeurs de texte ou binaires en tant que flux en utilisant les 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.
• Assurez-vous 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 du SQLServerResultSet sont utilisées pour accéder aux colonnes dans l'ordre dans lequel elles sont sélectionnées.
• Assurez-vous 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. De plus, assurez-vous que les méthodes get<Type>Stream du 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, il est préférable d'utiliser selectMethod=cursor plutôt que responseBuffering=adaptive, par exemple :
  • Si votre application traite un jeu de résultats en lecture seule de type avant lentement, par exemple la lecture de chaque ligne après une entrée utilisateur, l'utilisation de selectMethod=cursor à la place de responseBuffering=adaptive peut permettre de 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 permettre de 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 lorsque 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 lorsque 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. Dans la mesure où le jeu de résultats n'est pas déroulable, si l'application accède à une valeur de colonne importante à l'aide de l'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.

Voir aussi

Autres ressources

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