fungsi st_removepoint

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.

Menghapus titik ke-n dari linestring GEOGRAPHY atau GEOMETRY nilai input.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

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

Returns

Nilai bertipe GEOGRAPHY atau GEOMETRY, yang mewakili linestring setelah titik pada posisi ke-indexExpr telah dihapus.

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

Dimensi linestring output sama dengan input GEOGRAPHY atau GEOMETRY nilai.

Fungsi mengembalikan NULL jika salah satu input adalah NULL.

Kondisi kesalahan

• Jika nilai geoExpr bukan linestring atau adalah linestring kosong, fungsi mengembalikan ST_INVALID_ARGUMENT. INVALID_TYPE.
• 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 linestring after removing the second point counting from the left.
> SELECT st_astext(st_removepoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 2));
  LINESTRING(1 2,5 6)
-- Returns the linestring after removing the first point counting from the right.
> SELECT st_asewkt(st_removepoint(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -1));
  SRID=4326;LINESTRING(1 2,3 4)

Fungsi terkait

• st_addpoint fungsi
• st_pointn fungsi
• st_setpoint fungsi