适用于:
Databricks SQL
Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
注释
此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。
将输入几何图形的 X 和 Y 坐标从当前坐标引用系统(CRS)转换为所提供的 SRID 值描述的坐标引用系统。
Syntax
st_transform ( geo, srid )
Arguments
-
geo:一个GEOMETRY值。 -
srid:应将输入几何图形转换为的新坐标参考系统 (CRS) 的 SRID 值。
Returns
类型的 GEOMETRY值,表示转换后的几何图形。
如果几何图形具有 Z 和 M 坐标,它们将存在于输出几何图形中,并且不会修改。
输出 GEOMETRY 的 SRID 等于输入 SRID 值。
如果任何输入为NULL,该函数将返回NULL。
错误条件
- 如果无法从输入几何图形的 CRS 转换为提供的 SRID 值描述的 CRS,函数将返回 ST_INVALID_CRS_TRANSFORMATION_ERROR。
Examples
-- Transforms coordinates from WGS84 to Web Mercator.
> SELECT st_astext(st_transform(st_geomfromtext('MULTIPOINT Z (4 5 14,-3 8 27,EMPTY)', 4326), 3857));
MULTIPOINT Z ((445277.96317309426 557305.2572745768 14),(-333958.4723798207 893463.751012646 27),EMPTY)
-- Returns geometry in new coordinate system.
> SELECT st_srid(st_transform(st_geomfromtext('POINT(0 0)', 4326), 3857));
3857