適用対象:
Databricks SQL Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
入力地理空間値が空でない行文字列の場合は、入力 GEOGRAPHY の最初のポイントまたは GEOMETRY 値を返します。
Syntax
st_startpoint ( geoExpr )
Arguments
-
geoExpr: ラインストリングを表すGEOGRAPHYまたはGEOMETRY値。
Returns
linestring の最初のポイントを表す GEOGRAPHY 型または GEOMETRY型の値。
出力ポイントの SRID 値は、入力値と同じです。
出力ポイントのディメンションは、入力ライン文字列のディメンションと同じです。
入力がNULL場合、この関数はNULLを返します。
エラー条件
-
geoExprの値が linestring でない場合、関数はST_INVALID_ARGUMENT.INVALID_TYPEを返します。 -
geoExprの値が空の linestring の場合、関数はST_INVALID_ARGUMENTを返します。EMPTY_LINESTRING。
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)