Delen via


st_exteriorring functie

Van toepassing op:aangevinkt ja Databricks SQL aangevinkt ja Databricks Runtime 17.2 en hoger

Belangrijk

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Retourneert de buitenring van de invoer veelhoek als een lijnentring.

Syntaxis

st_exteriorring ( geoExpr )

Arguments

  • geoExpr: A GEOGRAPHY of GEOMETRY waarde.

Retouren

Een waarde van hetzelfde type als geoExpr. De functie retourneert een lege lijnentring als de invoer een lege veelhoek is. Anders retourneert de functie de buitenring van de veelhoek als een (gesloten) lijnentring. De SRID van de uitvoerwaarde is gelijk aan die van de invoerwaarde.

Opmerkingen

De functie retourneert NULL als de invoer is NULL.

Foutvoorwaarden

Voorbeelden

-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON EMPTY')));
  LINESTRING EMPTY

-- Example taking an empty 2D polygon GEOMETRY with one empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON(EMPTY)')));
  LINESTRING EMPTY

-- Example taking a 2D polygon GEOMETRY with one non-empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))', 3857)));
  SRID=3857;LINESTRING(0 0,10 0,0 10,0 0)

-- Example taking a 3DZ polygon GEOGRAPHY with two rings.
> SELECT st_asewkt(st_exteriorring(st_geogfromtext('POLYGON Z ((0 0 -1,10 0 -2,0 10 -3,0 0 -1),(1 1 -5,4 1 -6,1 4 -7,1 1 -5))')));
  SRID=4326;LINESTRING Z (0 0 -1,10 0 -2,0 10 -3,0 0 -1)

-- Example taking a NULL input.
> SELECT st_exteriorring(NULL);
  NULL