fungsi st_geomfromtext

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 WKT dari geometri dan mengembalikan nilai yang GEOMETRY sesuai. Nilai SRID dari nilai yang dikembalikan GEOMETRY adalah nilai sridExpr jika ditentukan, atau 0 sebaliknya.

Syntax

st_geomfromtext ( wktExpr[, sridExpr] )

Arguments

  • wktExpr: Nilai STRING , mewakili geometri dalam format WKT .
  • sridExpr: Nilai opsional INTEGER yang diatur menjadi SRID dari nilai yang dikembalikan GEOMETRY .

Returns

Nilai tipe GEOMETRY(srid) di mana srid adalah nilai sridExpr jika sridExpr adalah ekspresi konstanta (yang dapat dilipat), atau akan menjadi GEOMETRY(ANY) jika tidak. Jika sridExpr dihilangkan, jenis nilai yang dikembalikan adalah GEOMETRY(0). Nilai yang dikembalikan adalah geometri yang sesuai dengan deskripsi WKT input.

Fungsi mengembalikan NULL jika salah satu input adalah NULL.

Kondisi kesalahan

  • Jika nilai wktExpr adalah deskripsi WKT yang tidak valid, fungsi akan mengembalikan WKT_PARSE_ERROR.
  • Jika nilai sridExpr tidak didukung, fungsi mengembalikan ST_INVALID_SRID_VALUE.

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0.
> SELECT st_srid(st_geomfromtext('POINT Z (1 2 3)'));
  0

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromtext('POINT Z (1 2 3)', 3857));
  SRID=3857;POINT Z (1 2 3)

-- When invoking st_geomfromtext with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_geomfromtext('POINT Z (1 2 3)', 4269));
  geometry(4269)