st_removepoint fonksiyon

Şunun için geçerlidir: Databricks SQL Databricks Runtime 17.1 ve üzeri

Important

Bu özellik Genel Önizleme aşamasındadır.

Uyarı

Bu özellik Databricks SQL Klasik ambarlarında kullanılamaz. Databricks SQL ambarları hakkında daha fazla bilgi edinmek için bkz. SQL ambar türleri.

Giriş satır GEOGRAPHY dizesinden veya GEOMETRY değerinden n. noktayı kaldırır.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

• geoExpr: GEOGRAPHY veya GEOMETRY satır çizgisi değeri.
• indexExpr INTEGER: Kaldırılması gereken noktanın çizgi dizisindeki 1 tabanlı konumu gösteren değer.

Returns

GEOGRAPHY veya GEOMETRY türünde, indexExpr konumundaki nokta kaldırıldıktan sonra ortaya çıkan çizgi dizesini temsil eden bir değer.

Çıkış çizgi dizesinin SRID değeri, girişin GEOGRAPHY veya GEOMETRY değerin değerine eşittir.

Çıktı çizgi dizesinin boyutu, girişin GEOGRAPHY veya GEOMETRY değerin boyutuyla aynıdır.

Eğer girişlerden herhangi biri NULL ise, işlev NULL döndürür.

Hata koşulları

• Eğer geoExpr değeri bir çizgi dizesi değilse veya çizgi dizesi boşsa, işlev ST_INVALID_ARGUMENT.INVALID_TYPE döndürür.
• indexExpr değerinin mutlak değeri 0 veya çizgi dizisindeki nokta sayısından büyük ya da eşitse, işlev ST_INVALID_ARGUMENT.INVALID_INDEX_VALUE döndürür.

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)

İlgili işlevler

• st_addpoint işlev
• st_pointn işlev
• st_setpoint işlev