st_length 関数

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

Important

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

注

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

入力 GEOGRAPHY または GEOMETRY 値の長さを返します。

Syntax

st_length ( geoExpr )

Arguments

  • geoExpr: GEOGRAPHY または GEOMETRY の値。

Returns

入力DOUBLEまたはGEOGRAPHY値の長さを表すGEOMETRY型の値。

入力が GEOGRAPHY 値の場合、関数は、 GEOGRAPHY 値の線形部分の 2D 測地線の長さを返します。 具体的には、この関数は、線文字列の測地線の長さと、複数行文字列内のライン文字列の長さの合計を返します。 非線形地理 (ポイント、多角形、マルチポイント、マルチポリゴン) 0 が返されますが、geometry コレクションの場合、関数はコレクション内の要素の長さの合計を返します。 結果は、WGS84 楕円体を想定して逆測地線計算を実行することによって計算されます。 結果の単位はメートルです。

入力が GEOMETRY 値の場合、この関数は GEOMETRY 値の線形部分の 2D デカルト長を返します。 具体的には、この関数は、行文字列の 2D デカルト長と、複数行文字列内のライン文字列の長さの合計を返します。 非線形ジオメトリ (ポイント、多角形、マルチポイント、マルチポリゴン) の場合は 0 が返されますが、geometry コレクションの場合は、コレクション内の要素の長さの合計が返されます。 結果の単位は、入力 GEOMETRY 値の空間参照システムの単位です。

いずれかの入力がNULLされている場合、関数はNULLを返します。

Examples

-- Returns the length of a 2D Cartesian linestring.
> SELECT round(st_length(st_geomfromtext('LINESTRING(10 34,44 57,30 24)')), 8);
  76.89564816
  • Last updated on