st_interiorringn Fonction

S’applique à : Databricks SQL Databricks Runtime 17.3 et versions ultérieures

Retourne l’anneau intérieur n-ième du polygone d’entrée en tant que chaîne de ligne.

Syntaxe

st_interiorringn ( geoExpr, indexExpr )

Arguments

• geoExpr: Une valeur GEOGRAPHY ou GEOMETRY.
• indexExpr INTEGER: valeur représentant la position basée sur 1 de l’anneau intérieur dans le polygone.

Retours

L'anneau intérieur du polygone à l'index de base 1 indexExpr sous la forme d'une chaîne de ligne fermée. La valeur de sortie a le même type de données et SRID que geoExpr.

Remarques

La fonction retourne NULL si l’entrée est NULL.

Conditions d’erreur

• Si geoExpr ce n’est pas un polygone, la fonction retourne ST_INVALID_ARGUMENT. INVALID_TYPE.
• Si indexExpr elle n’est pas valide (inférieure à 1 ou supérieure à la valeur), ST_NumInteriorRings(geoExpr)la fonction retourne ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.

Examples

-- Example taking a 2D polygon GEOMETRY with three interior rings.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeomFromText('POLYGON((0 1,10 5,4 20,0 1),(3 12,9 7,5 13,3 12),(1 4,7 5,6 8,1 4),(3 6,4 11,2 10,3 6))', 3857), 3));
  SRID=3857;LINESTRING(3 6,4 11,2 10,3 6)
-- Example taking a 3DM polygon GEOGRAPHY with two interior rings.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeogFromText('POLYGON M ((0 1 111,10 5 222,4 20 333,0 1 444),(3 12 111,9 7 222,5 13 333,3 12 444),(1 4 111,7 5 222,6 8 333,1 4 444))'), 2));
  SRID=4326;LINESTRING M (1 4 111,7 5 222,6 8 333,1 4 444)
-- Example taking a 4D polygon GEOMETRY with one interior ring.
> SELECT ST_AsEWKT(ST_InteriorRingN(ST_GeomFromText('POLYGON ZM ((0 1 111 -11,10 5 222 -22,4 20 333 -33,0 1 444 -44),(3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44))'), 1));
  LINESTRING ZM (3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44)

Fonctions associées

• Fonction st_exteriorring
• Fonction st_makepolygon
• Fonction st_numinteriorrings