st_geometryn fonksiyon

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

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ş GEOMETRY değerinin 1 tabanlı n. öğesini değer GEOMETRY olarak döndürür.

Syntax

st_geometryn ( geoExpr, nExpr )

Arguments

• geoExpr: Bir GEOMETRY değer.
• nExpr: Alınacak öğenin 1'e dayalı dizini.

Returns

Giriş geometrisinin n. öğesini temsil eden türünde GEOMETRYbir değer.

Giriş çok noktalı, çoklu çizgi dizesi, çokgen veya geometri koleksiyonuysa, işlev n'inci öğeyi döndürür veya öğe yoksa bir hata döndürür.

Giriş, boş olmayan bir nokta, çizgi, veya çokgense ve indeks değeri 1'e eşitse işlev, girdiyi GEOMETRY değeri olarak döndürür, aksi takdirde hata döndürür.

Çıkış geometrisinin SRID değeri, giriş değerinin değeriyle aynıdır.

1'den küçük dizinlerin desteklenmediğini ve hataya neden olacağını unutmayın.

İşlev, birinci parametre NULL ise NULL döndürür.

Hata koşulları

• Eğer n dizinindeki öğe mevcut değilse, işlev ST_INVALID_ARGUMENT.INVALID_INDEX_VALUE döndürür.
• Dizin 1'den küçükse işlev ST_INVALID_ARGUMENT döndürür. INVALID_INDEX_VALUE.
• Giriş, boş olmayan bir nokta, çizgi dizisi veya çokgense ve dizin 1'e eşit değilse, işlev ST_INVALID_ARGUMENT.INVALID_INDEX_VALUE döndürür.

Examples

-- Returns the second element of a geometry collection.
> SELECT st_astext(st_geometryn(st_geomfromtext('GEOMETRYCOLLECTION(POINT(4 5),LINESTRING(10 3,24 37,44 85))'), 2));
  LINESTRING(10 3,24 37,44 85)
-- Returns the first element of a multipoint.
> SELECT st_astext(st_geometryn(st_geomfromtext('MULTIPOINT((1 2),(3 4),(5 6))'), 1));
  POINT(1 2)

İlgili işlevler

• st_dump işlev
• st_geometrytype işlev
• st_numgeometries işlev