Функция st_multi

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

Important

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

Замечание

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

Возвращает входное значение GEOGRAPHY или GEOMETRY как эквивалентное многопространственное значение.

Syntax

st_multi ( geoExpr )

Arguments

• geoExpr: значение GEOGRAPHY или GEOMETRY значение.

Returns

Значение типа GEOGRAPHY или GEOMETRY, представляющее значение с несколькими геопространственными значениями.

Значение SRID выходных GEOGRAPHY данных или GEOMETRY значений равно входному значению.

Измерение выходных GEOGRAPHY данных или GEOMETRY значений совпадает с измерением входного значения.

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

Examples

-- Converts a point geometry to a multipoint geometry.
> SELECT st_asewkt(st_multi(st_geomfromtext('POINT Z (1 2 100)', 4326)));
  SRID=4326;MULTIPOINT Z ((1 2 100))
-- Converts a multipoint geometry to a multipoint geometry (identity).
> SELECT st_asewkt(st_multi(st_geomfromtext('MULTIPOINT Z (1 2 100)', 3857)));
  SRID=3857;MULTIPOINT Z ((1 2 100))
-- Converts a point geography to a multipoint geography.
> SELECT st_asewkt(st_multi(st_geogfromtext('POINT Z (1 2 100)')));
  SRID=4326;MULTIPOINT Z ((1 2 100))
-- Converts a multipoint geography to a multipoint geography (identity).
> SELECT st_asewkt(st_multi(st_geogfromtext('MULTIPOINT Z (1 2 100)')));
  SRID=4326;MULTIPOINT Z ((1 2 100))