Utilisation des types de données avancés

Télécharger le pilote JDBC

Le Pilote Microsoft JDBC pour SQL Server utilise les types de données avancés JDBC pour convertir les types de données SQL Server en un format compréhensible par le langage de programmation Java.

Notes

Le tableau suivant liste les mappages par défaut entre les types de données avancés SQL Server, JDBC et du langage de programmation Java.

¹ Le Pilote Microsoft JDBC pour SQL Server prend en charge l'envoi et la récupération d'UDT CLR sous forme de données binaires, et non la manipulation des métadonnées CLR.

Les sections suivantes proposent des exemples d'utilisation du pilote JDBC et des types de données avancés.

Types de données BLOB, CLOB et NCLOB

Le pilote JDBC implémente toutes les méthodes des interfaces java.sql.Blob, java.sql.Clob et java.sql.NClob.

Types de données de grande valeur

Dans les versions antérieures de SQL Server, l'utilisation de types de données de grande valeur nécessitait un traitement spécial. Les types de données à valeur élevée sont ceux qui dépassent la taille de ligne maximale de 8 Ko. SQL Server introduit un spécificateur max pour les types de données varchar, nvarchar et varbinary, qui permet le stockage de valeurs pouvant atteindre 2^31 octets. Les colonnes de table et les variables Transact-SQL peuvent spécifier les types de données varchar(max), nvarchar(max) ou varbinary(max).

Les principaux scénarios de travail sur des types de données de grande valeur impliquent l'extraction d'une base de données ou l'ajout à une base de données. Les sections suivantes décrivent les différentes approches de réalisation de ces tâches.

Récupération de types de données de grande valeur à partir d'une base de données

Pour récupérer un type de données à valeur élevée non binaire, par exemple varchar(max) , dans une base de données, une approche consiste à lire ces données sous forme de flux de caractères. L'exemple suivant utilise la méthode executeQuery de la classe SQLServerStatement pour extraire des données de la base de données et les retourner dans un jeu de résultats. Ensuite, la méthode getCharacterStream de la classe SQLServerResultSet est appelée pour lire les données de grande valeur dans le jeu de résultats.

ResultSet rs = stmt.executeQuery("SELECT TOP 1 * FROM Test1");  
rs.next();  
Reader reader = rs.getCharacterStream(2);  

Pour récupérer un type de données à valeur élevée binaire, par exemple varbinary(max) , dans une base de données, plusieurs approches sont possibles. La plus efficace consiste à lire les données en tant que flux de données binaire, comme suit :

ResultSet rs = stmt.executeQuery("SELECT photo FROM mypics");  
rs.next();  
InputStream is = rs.getBinaryStream(2);  

Vous pouvez également utiliser la méthode getBytes pour lire les données sous forme de tableau d'octets, comme dans l’exemple suivant :

ResultSet rs = stmt.executeQuery("SELECT photo FROM mypics");  
rs.next();  
byte [] b = rs.getBytes(2);  

Ajout de types de données de grande valeur à une base de données

Le téléchargement de données de grande valeur avec le pilote JDBC fonctionne correctement dans les cas de correspondance avec la taille de la mémoire ; dans les cas de dépassement de la taille de la mémoire, la transmission de flux de données en continu constitue l'option principale. Cependant, la méthode la plus efficace consiste à télécharger des données de grande valeur via les interfaces de flux.

L'utilisation d'une chaîne ou d'octets est également une option, comme suit :

PreparedStatement pstmt = con.prepareStatement("INSERT INTO test1 (c1_id, c2_vcmax) VALUES (?, ?)");  
pstmt.setInt(1, 1);  
pstmt.setString(2, htmlStr);  
pstmt.executeUpdate();  

Si vous disposez d'une bibliothèque d'images sur le serveur et que vous devez charger des fichiers image binaires entiers dans une colonne varbinary(max) , la méthode la plus efficace impliquant le pilote JDBC consiste à utiliser directement les flux, comme dans l’exemple suivant :

try (PreparedStatement pstmt = con.prepareStatement("INSERT INTO test1 (Col1, Col2) VALUES(?,?)")) { 
  File inputFile = new File("CLOBFile20mb.jpg");  
  try (FileInputStream inStream = new FileInputStream(inputFile)) {
    int id = 1;  
    pstmt.setInt(1,id);  
    pstmt.setBinaryStream(2, inStream);  
    pstmt.executeUpdate();
  }
}

Modification de types de données de grande valeur dans une base de données

Dans la plupart des cas, la méthode recommandée pour mettre à jour ou modifier des valeurs élevées dans la base de données est de passer des paramètres à travers les classes SQLServerPreparedStatement et SQLServerCallableStatement en utilisant des commandes Transact-SQL comme UPDATE, WRITE et SUBSTRING.

Si vous devez remplacer l'instance d'un mot dans un fichier texte volumineux, comme un fichier HTML archivé, vous pouvez utiliser un objet Clob, comme dans l’exemple suivant :

String SQL = "SELECT * FROM test1;";  
try (Statement stmt = con.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE)
     ResultSet rs = stmt.executeQuery(SQL)) {
  rs.next();

  Clob clob = rs.getClob(2);  
  long pos = clob.position("dog", 1);  
  clob.setString(pos, "cat");  
  rs.updateClob(2, clob);  
  rs.updateRow();  
}

De plus, vous pouvez effectuer tout le travail sur le serveur et simplement transmettre les paramètres à une instruction UPDATE préparée.

Pour plus d'informations sur les types de données de grande valeur, consultez « Utilisation de types de données de grande valeur » dans la documentation en ligne de SQL Server.

Type de données XML

SQL Server propose un type de données xml qui vous permet de stocker des documents et des fragments XML dans une base de données SQL Server. Le type de données xml est intégré dans SQL Server et s’apparente à certains égards à d’autres types intégrés, comme int et varchar. Comme d’autres types intégrés, vous pouvez utiliser le type de données xml comme type de colonne pour créer une table, comme type de variable, type de paramètre ou type de retour de fonction, ou dans les fonctions Transact-SQL CAST et CONVERT.

Dans le pilote JDBC, le type de données xml peut être mappé en tant que chaîne, tableau d’octets, flux, objet CLOB, objet BLOB ou objet SQLXML. La chaîne est la valeur par défaut. À partir de la version 2.0 du pilote JDBC, l'API JDBC 4.0 est prise en charge, ce qui permet l'introduction de l'interface SQLXML. L’interface SQLXML définit des méthodes d’interaction et de manipulation des données XML. Le type de données SQLXML correspond au type de données SQL Server xml. Pour savoir comment lire et écrire des données XML dans la base de données relationnelle avec le type de données Java SQLXML, consultez Prise en charge des données XML.

L’implémentation du type de données xml dans le pilote JDBC permet la prise en charge des éléments suivants :

• Accès à XML en tant que chaîne standard Java UTF-16 pour les scénarios de programmation les plus courants

• Entrée de XML en UTF-8 ou codé sur 8 bits

• Accès à XML en tant que tableau d'octets avec un BOM de début lors de l'encodage en UTF-16 pour l'échange avec d'autres processeurs XML et fichiers de disque

Avec SQL Server, il est nécessaire d’ajouter une marque d'ordre d'octet au début des fichiers XML encodés en UTF-16. L'application doit le fournir quand les valeurs de paramètre XML sont fournies en tant que tableaux d'octets. SQL Server retourne toujours les valeurs XML sous forme de chaînes UTF-16 sans marque d'ordre d'octet ou déclaration d’encodage incorporée. Lorsque des valeurs XML sont récupérées en tant que byte[], BinaryStream ou Blob, une marque d'ordre d'octet (BOM, Byte-Order Mark) UTF-16 est ajoutée au début de la valeur.

Pour plus d’informations sur le type de données xml, voir « Type de données xml » dans la Documentation en ligne de SQL Server.

Type de données défini par l'utilisateur

L’introduction des types définis par l’utilisateur (UDT) dans SQL Server 2005 (9.x) étend le système de type SQL en permettant de stocker des objets et des structures de données personnalisées dans une base de données SQL Server. Les UDT peuvent contenir plusieurs types de données et avoir des comportements, ce qui les différencie des types de données d'alias traditionnels qui ne comportent qu'un seul type de données système SQL Server. Les types UDT sont définis à l'aide d'un des langages pris en charge par le CLR (Common Language Runtime) Microsoft .NET produisant un code vérifiable. Cela inclut Microsoft Visual C# et Visual Basic .NET. Les données sont exposées en tant que champs et propriétés d'une classe ou structure basée sur le .NET Framework ; par ailleurs, les comportements sont définis par les méthodes de la classe ou de la structure.

Dans SQL Server, un type UDT peut être utilisé comme définition de colonne d’une table, comme variable dans un lot Transact-SQL ou comme argument d’une fonction ou d’une procédure stockée Transact-SQL.

Pour plus d’informations sur les types de données définis par l’utilisateur, voir « Utiliser et modifier des instances de types définis par l’utilisateur » dans la Documentation en ligne de SQL Server.

Type de données Sql_variant

Pour plus d’informations sur le type de données sql_variant, consultez Utilisation du type de données Sql_variant.

Types de données spatiales

Pour plus d’informations sur le type de données spatiales, consultez Utilisation du type de données spatiales.

Voir aussi

Présentation des types de données du pilote JDBC