Utilisation des types de données spatiales

Télécharger le pilote JDBC

Les types de données spatiales (Geometry et Geography) sont pris en charge à partir de la préversion 6.5.0 de JDBC Driver. Les types de données spatiales ne sont actuellement pas pris en charge avec les procédures stockées, les paramètres de type table (TVP), BulkCopy et Always Encrypted. Cette page présente divers cas d’usage des types de données Geometry et Geography avec le pilote JDBC. Pour plus d’informations, consultez la vue d’ensemble des types de données spatiales.

Création d’un objet de géométrie / géographie

Il existe deux façons de créer un objet Geometry/Geography : convertir un texte bien connu (WKT) ou un format SQL Server interne (CLR).

Créer à partir de WKT

String geoWKT = "LINESTRING(1 0, 0 1, -1 0)";
Geometry geomWKT = Geometry.STGeomFromText(geoWKT, 0);
Geography geogWKT = Geography.STGeomFromText(geoWKT, 4326);

Ce code crée un objet Geometry de type LINESTRING avec l’identifiant du système de référence spatiale (SRID) 0, ainsi qu’un objet Geography avec le SRID 4326.

Créer à partir d’un CLR

byte[] geomCLR = Hex.decodeHex("00000000010403000000000000000000F03F00000000000000000000000000000000000000000000F03F000000000000F0BF000000000000000001000000010000000001000000FFFFFFFF0000000002".toCharArray());
byte[] geogCLR = Hex.decodeHex("E61000000104030000000000000000000000000000000000F03F000000000000F03F00000000000000000000000000000000000000000000F0BF01000000010000000001000000FFFFFFFF0000000002".toCharArray());

Geometry geomWKT = Geometry.deserialize(geomCLR);
Geography geogWKT = Geography.deserialize(geogCLR);

Ce code créera des objets Geometry et Geography équivalents à ceux créés à partir du WKT précédemment.

Utilisation d’un objet Geometry/Geography

En supposant que l’utilisateur dispose d’une table sur SQL Server comme ci-dessous :

CREATE TABLE sampleTable (c1 geometry)  

Un exemple de script pour insérer une valeur de géométrie serait :

String geoWKT = "LINESTRING(1 0, 0 1, -1 0)";
Geometry geomWKT = Geometry.STGeomFromText(geoWKT, 0);
SQLServerPreparedStatement pstmt = (SQLServerPreparedStatement) connection.prepareStatement("insert into sampleTable values (?)");
pstmt.setGeometry(1, geomWKT);  
pstmt.execute();

La même opération peut être effectuée pour la contrepartie Geography, à l’aide d’une colonne Geography et de la méthode setGeography().

Pour lire une colonne Geometry/Geography :

try(SQLServerResultSet rs = (SQLServerResultSet)stmt.executeQuery("select * from geomTable")) {
    while(rs.next()){
        rs.getGeometry(1);
    }
}

La même opération peut être effectuée pour la contrepartie Geography, à l’aide d’une colonne Geography et de la méthode getGeography().

API récemment introduites

Ces méthodes sont les nouvelles API publiques introduites dans cet ajout, dans les classes SQLServerPreparedStatement, SQLServerResultSet, Geometry et Geography.

SQLServerPreparedStatement

SQLServerResultSet

Géométrie

Geography

Limitations des types de données spatiales

1. Les sous-types de données spatiales CircularString, CompoundCurve, CurvePolygon et FullGlobe ne sont pris en charge qu’à partir de SQL Server 2012 et ultérieur.

2. Always Encrypted ne peut pas être utilisé avec des types de données spatiales.

3. Les procédures stockées, les TVP et les opérations BulkCopy ne sont actuellement pas pris en charge pour les types de données spatiaux.

Contenu connexe

• Exemple de types de données spatiales