User's Guide and Reference

ShapeToSQL

ShapeToSQL constructs a db2gse.ST_Geometry value given it's well-known binary representation. The SRID value of 0 is automatically used.

Syntax

db2gse.ST_ShapeToSQL(ShapeGeometry blob(1M))

Return type

db2gse.ST_Geometry

Examples

The following C code fragment contains ODBC functions embedded with DB2 Spatial Extender SQL functions that insert data into the LOTS table. The LOTS table was created with two columns: the lot_id, which uniquely identifies each lot, and the and the lot multipolygon column, which contains the geometry of each lot.

CREATE TABLE lots (lot_id  integer,
                   lot     db2gse.ST_MultiPolygon);

The ShapeToSQL function converts shapes into DB2 Spatial Extender geometry. The entire INSERT statement is copied into shp_sql. The INSERT statement contains parameter markers to accept the LOT_id and the lot data, dynamically.

/* Create the SQL insert statement to populate the lot id and the
   lot multipolygon. The question marks are parameter markers that 
   indicate the lot_id and lot values that will be retrieved at
   run time. */
 
strcpy (shp_sql,"insert into lots (lot_id, lot) values(?, 
db2gse.ShapeToSQL(cast(? as blob(1m))))");
 
/* Allocate memory for the SQL statement handle and associate the 
   statement handle with the connection handle. */
 
rc = SQLAllocStmt (handle, &hstmt);
 
/* Prepare the SQL statement for execution. */
 
rc = SQLPrepare (hstmt, (unsigned char *)shp_sql, SQL_NTS);
 
/* Bind the integer key value to the first parameter. */
 
pcbvalue1 = 0; 
 
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_SLONG,
     SQL_INTEGER, 0, 0, &lot_id, 0, &pcbvalue1);
 
/* Bind the shape to the second parameter. */
 
pcbvalue2 = blob_len;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT, SQL_C_BINARY,
     SQL_BLOB, blob_len, 0, shape_blob, blob_len, &pcbvalue2);
 
/* Execute the insert statement. */
 
rc = SQLExecute (hstmt);


[ Top of Page | Previous Page | Next Page ]