to_geometry 関数

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

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

ジオメトリの入力説明を解析し、対応する GEOMETRY 値を返します。 返される GEOMETRY 値の SRID 値は、入力形式によって異なります。

Syntax

to_geometry ( geoRepExpr )

Arguments

Returns

入力 geography の説明に対応する GEOMETRY(ANY)型の値。

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

エラー条件

  • geoRepExprBINARY型で、値が無効な EWKB の場合、関数はEWKB_PARSE_ERRORを返します。
  • geoRepExprBINARY型で、値が無効な EWKT の場合、関数はEWKT_PARSE_ERRORを返します。
  • geoRepExprBINARY型で、値が無効な WKB の場合、関数はWKB_PARSE_ERRORを返します。
  • geoRepExprSTRING型で、値が無効な WKT の場合、関数はWKT_PARSE_ERRORを返します。
  • geoRepExprSTRING型で、値が無効な GeoJSON の場合、関数はGEOJSON_PARSE_ERRORを返します。

Examples

-- Input geometry is in WKT format.
> SELECT st_asgeojson(to_geometry('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geometry is in GeoJSON format.
> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[3,4,5]}'));
  POINT Z (3 4 5)

-- Input geometry is in WKB format.
> SELECT st_astext(to_geometry(X'0101000060110f0000000000000000084000000000000010400000000000001440'));
  POINT M (3 4 5)

-- Input geometry is in EWKB format.
> SELECT st_asewkt(to_geometry(X'01010000E0110F0000000000000000084000000000000010400000000000001440000000000000F0BF'));
  SRID=3857;POINT ZM (3 4 5 -1)

-- Input geometry is in EWKT format.
> SELECT concat_ws(';', st_srid(g)::STRING, st_asgeojson(g)) FROM (SELECT to_geometry('SRID=3857;POINT Z (3 4 5)') AS g);
  3857;{"type":"Point","coordinates":[3,4,5]}