From 7d69cd430ed090c3e79feb74d47165e1dc38ecc1 Mon Sep 17 00:00:00 2001 From: Jiri Pechanec Date: Tue, 26 Jun 2018 11:22:23 +0200 Subject: [PATCH] DBZ-752 Geometry documentation --- docs/connectors/mysql.asciidoc | 25 +++++++++++++++++++++++++ docs/connectors/postgresql.asciidoc | 20 ++++++++++++++++---- 2 files changed, 41 insertions(+), 4 deletions(-) diff --git a/docs/connectors/mysql.asciidoc b/docs/connectors/mysql.asciidoc index bcc4c9d869..79792b20cd 100644 --- 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 index 368720f6e8..0c0975eb83 100644 --- a/docs/connectors/postgresql.asciidoc +++ b/docs/connectors/postgresql.asciidoc @@ -967,7 +967,7 @@ 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"] |======================= @@ -975,11 +975,23 @@ The PostgreSQL connector also has limited support for some of the http://postgis |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. |=======================