Поделиться через

Функция st_difference

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

Important

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

Замечание

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

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

Syntax

st_difference ( geoExpr1, geoExpr2 )

Arguments

  • geoExpr1: первое GEOMETRY значение.
  • geoExpr2: второе GEOMETRY значение.

Returns

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

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

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

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

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

Examples

> SELECT st_astext(st_difference(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  MULTIPOINT((-1 8),(5 6))
  • Last updated on