ST_Union Method | Geospatial Data Types | Teradata Vantage - ST_Union Method - Analytics Database - Teradata Vantage

Geospatial Data Types

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2023-08-30
dita:mapPath
qgk1628112272483.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
ghz1472251264557
lifecycle
latest
Product Category
Teradata Vantage™

Returns an ST_Geometry value that represents the point set union of two ST_Geometry values.

Valid Data Types

All ST_Geometry types except geometry collections.

This method can be called on 3D geometries (those that include z coordinates). However, the z coordinate is ignored in method calculations. Consequently, any z coordinates returned by this method should be ignored. Teradata recommends using the Make_2D method to strip out the z coordinates of the return value.

Result Type

The type that the ST_Geometry return type represents is one from the possible set of types in the following table, depending on the parameter types.

a ∪ b Ø ST_Point ST_LineString, GeoSequence ST_Polygon ST_MultiPoint ST_MultiLineString ST_MultiPolygon
Ø Ø R01 R02 R03 R04 R05 R06
ST_Point R01 R20 R15 R22 R04 R17 R19
ST_LineString, GeoSequence R02 R15 R16 R21 R15 R16 R18
ST_Polygon R03 R22 R21 R23 R22 R21 R23
ST_MultiPoint R04 R04 R15 R22 R04 R17 R19
ST_MultiLineString R05 R17 R16 R21 R17 R16 R18
ST_MultiPolygon R06 R19 R18 R23 R19 R18 R23
Where:
  • R09 = ST_Point
  • R02 = ST_LineString
  • R03 = ST_Polygon
  • R04 = ST_MultiPoint
  • R05 = ST_MultiLineString
  • R06 = ST_MultiPolygon
  • R15 = ST_LineString, ST_GeomCollection of ST_Point and ST_LineString values
  • R16 = ST_LineString, ST_MultiLineString
  • R17 = ST_MultiLineString, ST_GeomCollection of ST_Point and ST_LineString values
  • R18 = ST_MultiPolygon, ST_GeomCollection of ST_LineString and ST_Polygon values
  • R19 = ST_MultiPolygon, ST_GeomCollection of ST_Point and ST_Polygon values
  • R20 = ST_Point, ST_MultiPoint
  • R21 = ST_Polygon, ST_GeomCollection of ST_LineString and ST_Polygon values
  • R22 = ST_Polygon, ST_GeomCollection of ST_Point ST_Polygon values
  • R23 = ST_Polygon, ST_MultiPolygon

Vantage converts GeoSequence types that are involved in the ST_Union method to ST_LineString values. Therefore, ST_Union never returns a GeoSequence type.