st_pointn fonksiyon

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

Important

Bu özellik Genel Önizleme aşamasındadır. Önizlemeler sayfasında önizleme kaydını onaylayabilirsiniz. Bkz. Azure Databricks önizlemelerini yönetme.

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ı döndürür.

Syntax

st_pointn ( geoExpr, indexExpr )

Arguments

• geoExpr: Bir satır dizesini temsil eden bir GEOGRAPHY veya GEOMETRY değeri.
• indexExpr INTEGER: Döndürülmesi gereken noktanın çizgi dizisindeki 1 tabanlı konumu gösteren değer.

Returns

Girdi çizgi dizesinin GEOGRAPHY konumundaki noktayı GEOMETRY veya indexExpr türünde bir değer olarak temsil eden.

Çıkış noktasının SRID değeri, girişin GEOGRAPHY veya GEOMETRY değerin değerine eşittir.

Çıkış noktasının 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 linestring değilse, işlev ST_INVALID_ARGUMENT.INVALID_TYPE döndürür.
• değeri geoExpr boş bir çizgi dizesiyse işlev ST_INVALID_ARGUMENT döndürür. EMPTY_LINESTRING.
• 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 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)

İlgili işlevler

• st_addpoint işlev
• st_removepoint işlev
• st_setpoint işlev