fungsi st_geometryn

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 elemen ke-n berbasis 1 dari nilai input GEOMETRY sebagai nilai GEOMETRY.

Syntax

st_geometryn ( geoExpr, nExpr )

Arguments

• geoExpr: Nilai GEOMETRY .
• nExpr: Indeks berbasis 1 dari elemen yang akan diambil.

Returns

Nilai jenis GEOMETRY, mewakili elemen ke-n dari geometri input.

Jika input adalah multipoint, multilinestring, multipoligon, atau koleksi geometri, fungsi mengembalikan elemen n-th, atau mengembalikan kesalahan jika elemen tidak ada.

Jika input adalah titik, linestring, atau poligon yang non-kosong dan nilai indeks sama dengan 1, fungsi mengembalikan input sebagai nilai GEOMETRY, jika tidak mengembalikan error.

Nilai SRID dari geometri output sama dengan nilai input.

Perhatikan bahwa indeks yang lebih kecil dari 1 tidak didukung, dan akan mengakibatkan kesalahan.

Fungsi mengembalikan NULL jika input adalah NULL.

Kondisi kesalahan

• Jika elemen di indeks n tidak ada, fungsi akan mengembalikan ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
• Jika indeks lebih kecil dari 1, fungsi akan mengembalikan ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
• Jika input adalah titik, linestring, atau poligon yang tidak kosong dan indeks tidak sama dengan 1, fungsi akan mengembalikan ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.

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)

Fungsi terkait

• st_dump fungsi
• st_geometrytype fungsi
• st_numgeometries fungsi