fungsi st_pointn

Berlaku untuk: pemeriksaan Databricks SQL 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.

Mengembalikan poin ke-n dari linestring GEOGRAPHY atau GEOMETRY nilai input.

Syntax

st_pointn ( geoExpr, indexExpr )

Arguments

• geoExpr: Nilai GEOGRAPHY atau GEOMETRY yang mewakili linestring.
• indexExpr: Nilai INTEGER yang menunjukkan posisi berbasis 1 dalam linestring titik yang harus dikembalikan.

Returns

Nilai jenis GEOGRAPHY atau GEOMETRY, yang mewakili titik pada posisi ke-indexExpr dari jalur garis input.

Nilai SRID dari titik output sama dengan nilai input GEOGRAPHY atau GEOMETRY.

Dimensi titik output sama dengan input GEOGRAPHY atau GEOMETRY nilai.

Fungsi mengembalikan NULL jika salah satu input adalah NULL.

Kondisi kesalahan

• Jika nilai geoExpr bukan linestring, fungsi mengembalikan ST_INVALID_ARGUMENT. INVALID_TYPE.
• Jika nilai geoExpr adalah linestring kosong, fungsi akan mengembalikan ST_INVALID_ARGUMENT. EMPTY_LINESTRING.
• Jika nilai absolut dari nilai indexExpr adalah 0 atau lebih besar dari jumlah titik dalam linestring, fungsi mengembalikan ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.

Examples

-- Returns the third point of the linestring counting from the left.
> SELECT st_astext(st_pointn(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 3));
  POINT(5 6)
-- Returns the third point of the linestring counting from the right.
> SELECT st_astext(st_pointn(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -3));
  POINT(1 2)

Fungsi terkait

• st_addpoint fungsi
• st_removepoint fungsi
• st_setpoint fungsi