fungsi to_geography

Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 17.1 ke atas

Important

Fitur ini ada di Pratinjau Publik.

Nota

Fitur ini tidak tersedia di gudang Databricks SQL Classic. Untuk mempelajari selengkapnya tentang gudang Databricks SQL, lihat Jenis gudang SQL.

Mengurai deskripsi input geografi dan mengembalikan nilai yang GEOGRAPHY sesuai. Nilai SRID dari nilai yang dikembalikan GEOGRAPHY adalah 4326.

Syntax

to_geography ( geoRepExpr )

Arguments

Returns

Nilai jenis GEOGRAPHY(ANY), sesuai dengan deskripsi geografi input.

Fungsi mengembalikan NULL jika input adalah NULL.

Kondisi kesalahan

  • Jika geoRepExpr berjenis STRING dan nilainya adalah EWKT yang tidak valid, fungsi mengembalikan EWKT_PARSE_ERROR.
  • Jika geoRepExpr berjenis BINARY dan nilainya adalah WKB yang tidak valid, fungsi mengembalikan WKB_PARSE_ERROR.
  • Jika geoRepExpr berjenis STRING dan nilainya adalah WKT yang tidak valid, fungsi mengembalikan WKT_PARSE_ERROR.
  • Jika geoRepExpr berjenis STRING dan nilainya adalah GeoJSON yang tidak valid, fungsi mengembalikan GEOJSON_PARSE_ERROR.

Examples

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

-- Input geography is in GeoJSON format.
> SELECT st_asewkt(to_geography('{"type":"Point","coordinates":[3,4,5]}'));
  SRID=4326;POINT Z (3 4 5)

-- Input geography is in WKB format.
> SELECT st_astext(to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'));
  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_geography('SRID=4326;POINT Z (3 4 5)') AS g);
  4326;{"type":"Point","coordinates":[3,4,5]}