st_geomfromwkb 関数

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

注

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

ジオメトリの WKB の説明を解析し、対応する GEOMETRY 値を返します。 返される GEOMETRY 値の SRID 値は、指定されている場合は sridExpr の値、それ以外の場合は 0 です。

Syntax

st_geomfromwkb ( wkbExpr[, sridExpr] )

Arguments

  • wkbExpr: BINARY 形式のジオメトリを表す値。
  • sridExpr: 返されるINTEGER値の SRID に設定されている省略可能なGEOMETRY値。

Returns

GEOMETRY(srid)型の値は、sridが定数 (折りたたみ可能) の式である場合はsridExprの値であり、それ以外の場合はsridExprです。 sridExprを省略した場合、戻り値の型はGEOMETRY(0)。 返される値は、入力 WKB の説明に対応するジオメトリです。

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

エラー条件

  • wkbExprの値が無効な WKB の説明である場合、関数はWKB_PARSE_ERRORを返します。
  • sridExprの値がサポートされていない場合、関数はST_INVALID_SRID_VALUEを返します。

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in little-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740'));
  POINT M (10 34 23)

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in big-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'00000007D1402400000000000040410000000000004037000000000000'));
  POINT M (10 34 23)

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 3857));
  SRID=3857;POINT M (10 34 23)

-- When invoking st_geomfromwkb with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 4269));
  geometry(4269)
  • Last updated on