適用対象:
Databricks SQL Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
図形の入力配列内のジオメトリの空以外の点をポイントとするライン文字列 GEOMETRY 値を返します。これは、ポイント、ライン文字列、またはマルチポイントと想定されます。
Syntax
st_makeline ( geoArray )
Arguments
-
geoArray:ARRAYのGEOMETRY値。
Returns
行文字列を表す GEOMETRY型の値。
ポイントの順序は出力ライン文字列に保持されます。 入力配列内のすべての NULL 値は無視されます。
出力ラインストリングの SRID 値は、入力ジオメトリの共通 SRID 値です。
出力ライン文字列の寸法は、入力ジオメトリの最大共通寸法です。
入力配列が空の場合は、2D 空の linestring が返されます。 この場合、返される行文字列の SRID は 0 です。 すべての入力ジオメトリが空の場合、2D 空の linestring が返されます。 すべての入力ジオメトリの空でないポイントの合計数が 1 の場合は、2 つのポイントを含むラインストリングが返されます。どちらも入力内の一意の空でないポイントと等しくなります。
いずれかの入力が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)