Функция st_union

Применяется к:check помеченный да флажок Databricks SQL помечен да Databricks Runtime 17.1 и более поздних версий

Important

Эта функция доступна в общедоступной предварительной версии.

Замечание

Эта функция недоступна в классических хранилищах Databricks SQL. Дополнительные сведения о хранилищах SQL Databricks см. в разделе "Типы хранилища SQL".

Возвращает объединение множеств точек двух входных значений GEOMETRY в виде 2D-геометрии.

Syntax

st_union ( geo1, geo2 )

Arguments

  • geo1: первое GEOMETRY значение.
  • geo2: второе GEOMETRY значение.

Returns

Значение типа GEOMETRY, представляющее объединение точек двух входных GEOMETRY значений в виде 2D-геометрии.

SRID возвращаемого GEOMETRY значения — это общий SRID двух входных GEOMETRY значений.

Функция возвращает NULL, если какие-либо из входных данных NULL.

Условия ошибок

  • Если входные геометрии не имеют того же значения SRID, функция возвращает ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns union of multipoint and polygon.
> SELECT st_astext(st_union(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  GEOMETRYCOLLECTION(POINT(-1 8),POINT(5 6),POLYGON((0 0,0 10,10 0,0 0)))
-- Returns union of two overlapping polygons.
> SELECT st_astext(st_union(st_geomfromtext('POLYGON((0 0,5 0,5 5,0 5,0 0))'),st_geomfromtext('POLYGON((3 3,8 3,8 8,3 8,3 3))')));
  POLYGON((5 3,5 0,0 0,0 5,3 5,3 8,8 8,8 3,5 3))