DBZ-752 Geometry documentation

debezium · Jun 26, 2018 · 7d69cd4 · 7d69cd4
1 parent 70b1207
commit 7d69cd4
Show file tree

Hide file tree

Showing 2 changed files with 41 additions and 4 deletions.
diff --git a/docs/connectors/mysql.asciidoc b/docs/connectors/mysql.asciidoc
@@ -1161,6 +1161,31 @@ As of version 0.5.1, the MySQL connector also has limited support for some of th
 
 |=======================
 
+As of version 0.7.2, the MySQL connector has full support for all of the following https://dev.mysql.com/doc/refman/5.7/en/spatial-datatypes.html[spatial data types]:
+
+[cols="20%a,15%a,30%a,35%a",width=150,options="header,footer",role="table table-bordered table-striped"]
+|=======================
+|Spatial Data Type
+|Literal type (schema type)
+|Semantic type (schema name)
+|Notes
+|`GEOMETRY` +
+`LINESTRING` +
+`POLYGON` +
+`MULTIPOINT` +
+`MULTILINESTRING` +
+`MULTIPOLYGON` +
+`GEOMETRYCOLLECTION`
+|`STRUCT`
+|`io.debezium.data.geometry.Geometry`
+|Contains a structure with 2 fields +
+
+* `srid (INT32)` - Spatial Reference System Identifier defining what type of geometry object is stored in the structure
+* `wkb (BYTES)` - a binary representation of the geometry object encoded in thw Well-Known-Binary format.
+Please see http://www.opengeospatial.org/standards/sfa[Open Geospatial Consortium Simple Features Access specification] for the format details.
+
+|=======================
+
 [[fault-tolerance]]
 [[when-things-go-wrong]]
 === When things go wrong

diff --git a/docs/connectors/postgresql.asciidoc b/docs/connectors/postgresql.asciidoc
@@ -967,19 +967,31 @@ PostgreSQL supports `NaN` (not a number) special value to be stored in the `DECI
 [[postgis-types]]
 ==== PostGIS types
 
-The PostgreSQL connector also has limited support for some of the http://postgis.net[PostGIS data types]
+The PostgreSQL connector also has full support for all of the http://postgis.net[PostGIS data types]
 
 [cols="20%a,15%a,30%a,35%a",width=150,options="header,footer",role="table table-bordered table-striped"]
 |=======================
 |PostGIS Data Type
 |Literal type (schema type)
 |Semantic type (schema name)
 |Notes
+|planar types, e.g. `POLYGON`, `MULTIPOINT`
+|`STRUCT`
+|`io.debezium.data.geometry.Geometry`
+|Contains a structure with 2 fields +
 
-|`POINT`
+* `srid (INT32)` - Spatial Reference System Identifier defining what type of geometry object is stored in the structure
+* `wkb (BYTES)` - a binary representation of the geometry object encoded in thw Well-Known-Binary format.
+Please see http://www.opengeospatial.org/standards/sfa[Open Geospatial Consortium Simple Features Access specification] for the format details.
+
+|`GEOGRAPHY` (spherical)
 |`STRUCT`
-|`io.debezium.data.geometry.Point`
-|Contains a structure with 2 `FLOAT64` fields - `(x,y)` - each representing the coordinates of a geometric point
+|`io.debezium.data.geometry.Geography`
+|Contains a structure with 2 fields +
+
+* `srid (INT32)` - Spatial Reference System Identifier defining what type of geography object is stored in the structure
+* `wkb (BYTES)` - a binary representation of the geometry object encoded in thw Well-Known-Binary format.
+Please see http://www.opengeospatial.org/standards/sfa[Open Geospatial Consortium Simple Features Access specification] for the format details.
 
 |=======================