st_setpoint function

适用于:勾选为是 Databricks SQL 勾选为是 Databricks 运行时 17.1 及以上 勾选 是 Lakehouse//RT

Important

支持 GEOGRAPHY 值以 公共预览版提供。 对 GEOMETRY 值的支持 已正式发布。

注释

此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型。

设置输入线字符串 GEOGRAPHY 或 GEOMETRY 值的第 n 个点。

Syntax

st_setpoint ( geo1Expr, indexExpr, geo2Expr )

Arguments

  • geo1Expr: A GEOGRAPHY 或 GEOMETRY 值,表示一条线串。
  • indexExpr:一个 INTEGER 值,表示线串中以1为基础的位置,应设置新点。
  • geo2Expr: A GEOGRAPHY 或 GEOMETRY 表示一个点的值。

Returns

如果GEOGRAPHY和geo1Expr都是geo2Expr类型,则返回GEOGRAPHY类型的值;如果GEOMETRY和geo1Expr都是geo2Expr类型,则返回GEOMETRY类型的值。 如果 indexExpr 为正值,则返回 GEOGRAPHY 或 GEOMETRY 值为新的线字符串,其 indexExpr第一个点(从左计数)设置为 geo2Expr。 如果 indexExpr 为负数,则从右侧测量从 1 开始的添加点的线串位置。

  • 如果任何输入为NULL,该函数将返回NULL。
  • 输出行字符串的 SRID 值等于输入 GEOGRAPHY 或 GEOMETRY 值的通用 SRID 值。
  • 输出 GEOGRAPHY 或 GEOMETRY 线字符串的维度与该 geo1Expr维度相同。 如果geo2Expr中包含了一些坐标,而这些坐标的维度在geo1Expr中不存在,那么对应的这些坐标将被设置为0。

错误条件

Examples

-- We set the first point of the linestring counting from the left.
> SELECT st_astext(st_setpoint(st_geomfromtext('LINESTRING(1 2,3 4)'), 1, st_geomfromtext('POINT(7 8)')));
  LINESTRING(7 8,3 4)

-- We set the first point of the linestring counting from the right.
-- The point is missing a Z coordinate. This is set to 0 when we update the linestring.
> SELECT st_asewkt(st_setpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)'), -1, st_geogfromtext('POINT M (0 9 99)')));
  SRID=4326;LINESTRING ZM (1 2 3 4,0 9 0 99)