st_startpoint 関数

適用対象:はい Databricks SQL チェックが Databricks Runtime 17.1 以降" とマークされているチェック

Important

GEOGRAPHY 値のサポートは パブリック プレビュー段階です。 GEOMETRY 値のサポートが 一般公開されています

この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。

入力地理空間値が空でない行文字列の場合は、入力 GEOGRAPHY の最初のポイントまたは GEOMETRY 値を返します。

Syntax

st_startpoint ( geoExpr )

Arguments

  • geoExpr: ラインストリングを表す GEOGRAPHY または GEOMETRY 値。

Returns

linestring の最初のポイントを表す GEOGRAPHY 型または GEOMETRY型の値。

出力ポイントの SRID 値は、入力値と同じです。

出力ポイントのディメンションは、入力ライン文字列のディメンションと同じです。

入力がNULL場合、この関数はNULLを返します。

エラー条件

Examples

-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
  SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
  SRID=4326;POINT ZM (1 2 3 4)