適用於:
Databricks SQL
Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲,請參閱 SQL 倉儲類型。
傳回線串 GEOMETRY 值,其點是幾何圖形輸入陣列中幾何圖形的非空白點,預期為點、線串或多點。
Syntax
st_makeline ( geoArray )
Arguments
-
geoArray:ARRAY值的GEOMETRY。
Returns
型別為 GEOMETRY 的值,表示線串。
點的順序會保留於輸出行字串中。
NULL會忽略輸入陣列中的任何值。
輸出行字串的 SRID 值是輸入幾何的通用 SRID 值。
輸出行字串的維度是輸入幾何的最大通用維度。
如果輸入陣列是空的,則會傳回 2D 空的行字串。 在此案例中,傳回行字串的 SRID 為 0。 如果所有輸入幾何都是空的,則會傳回 2D 空的行字串。 如果所有輸入幾何中的非空白點總數為一,我們會傳回具有兩個點的行字串,這兩個點都等於輸入中唯一的非空白點。
如果任何輸入為 NULL,則函式會傳NULL回 。
錯誤條件
- 如果任何輸入幾何圖形不是點、線串或多點,則函式會傳回 ST_INVALID_ARGUMENT。INVALID_TYPE。
- 如果輸入幾何沒有相同的 SRID 值,函式會 傳回ST_DIFFERENT_SRID_VALUES。
Examples
-- Returns a linestring with the points of the input geometries.
> SELECT st_astext(st_makeline(array(st_geomfromtext('POINT(1 2)'),st_geomfromtext('MULTIPOINT(5 6,7 8)'),st_geomfromtext('LINESTRING(5 6,7 8,-1 -3,-7 -9,-12 -20)'))));
LINESTRING(1 2,5 6,7 8,5 6,7 8,-1 -3,-7 -9,-12 -20)