適用於:
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)