共用方式為


st_geomfromtext函式

適用於:核取標示為是 Databricks SQL 核取標示為是 Databricks Runtime 17.1 和更新版本

Important

這項功能目前處於 公開預覽版

備註

這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型

剖析幾何的 WKT 描述,並傳回對應的 GEOMETRY 值。 傳回 GEOMETRY 值的 SRID 值是 如果指定,則為 sridExpr 的值,否則為 0。

Syntax

st_geomfromtext ( wktExpr[, sridExpr] )

Arguments

  • wktExpr:值 STRING ,表示 WKT 格式的幾何。
  • sridExpr:選擇性 INTEGER 值,設定為傳 GEOMETRY 回值的 SRID。

Returns

GEOMETRY(srid)的值,如果srid是常數(可折疊的)表達式,那麼sridExpr的值是sridExpr,否則是GEOMETRY(ANY)。 如果 sridExpr 省略 ,則傳回值的型別為 GEOMETRY(0)。 傳回的值是對應至輸入 WKT 描述的幾何。

如果任何輸入為 NULL,則函式會傳NULL回 。

錯誤條件

  • 如果的值 wktExpr 是無效的 WKT 描述,函 式會傳回WKT_PARSE_ERROR
  • 如果 sridExpr 的值不被支援,函式會傳回 ST_INVALID_SRID_VALUE

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0.
> SELECT st_srid(st_geomfromtext('POINT Z (1 2 3)'));
  0

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromtext('POINT Z (1 2 3)', 3857));
  SRID=3857;POINT Z (1 2 3)