st_collect functie

Van toepassing op:controleren gemarkeerd als Ja Databricks Runtime 18 LTS en hoger

Note

Databricks Runtime 18 is nieuwer dan Databricks Runtime 18.0, 18.1 en 18.2. Functies die eerder als een latere genummerde versie werden verzonden, worden nu verzonden als gedateerde updates voor Databricks Runtime 18. Zie Voor meer informatie over geïntegreerde releaseopmerkingen.

Important

Ondersteuning voor GEOGRAFIE-waarden bevindt zich in openbare preview. Ondersteuning voor GEOMETRIE-waarden is algemeen beschikbaar.

Verzamelt een matrix of GEOGRAPHYGEOMETRY waarden in één multipoint-, multilinestring-, multipolygon- of geometrieverzameling.

Syntax

st_collect ( geoArray )

Arguments

  • geoArray: Een matrix met GEOGRAPHY waarden of een matrix met GEOMETRY waarden.

Returns

Een waarde van het type GEOGRAPHY of GEOMETRY, die een verzameling multipoints, multilinestring, multipolygon of geometrie vertegenwoordigt.

Alle NULL waarden in de invoermatrix worden genegeerd. Het type uitvoer is afhankelijk van de typen niet-invoergeometrieënNULL :

  • Als alle niet-elementenNULL punten zijn, wordt een multipoint geretourneerd.
  • Als alle niet-elementenNULL lijnen zijn, retourneert u een multilinestring.
  • Als alle niet-elementenNULL veelhoeken zijn, retourneert u een multipolygon.
  • Anders wordt een geometrieverzameling geretourneerd.

Elke uitvoer bevat één element per niet-matrixelementNULL .

Invoer met meerdere typen (multipoint, multilinestring, multipolygon) en geometrieverzamelingsinvoer blijven behouden als elementen van de resulterende geometrieverzameling; ze zijn niet afgevlakt.

De SRID-waarde van de uitvoer is de gemeenschappelijke SRID-waarde van de niet-invoergeometrieënNULL .

De dimensie van de uitvoer is de maximale gemeenschappelijke dimensie van de niet-invoergeometrieënNULL .

Als de invoermatrix leeg is of alleen NULL waarden bevat, wordt de verzameling 2D lege geometrie geretourneerd. In dit geval wordt de SRID van de uitvoer als volgt bepaald:

  • Als het elementtype van de invoermatrix is GEOGRAPHY(ANY), is 4326de SRID van de uitvoer .
  • Als het elementtype van de invoermatrix is GEOMETRY(ANY), is 0de SRID van de uitvoer .
  • Anders is de SRID van de uitvoer dat van het elementtype van de invoermatrix.

De functie retourneert NULL als de invoer is NULL.

Foutvoorwaarden

  • Als er twee niet-invoergeometrieënNULL verschillende WAARDEN voor SRID hebben, retourneert de functie ST_DIFFERENT_SRID_VALUES.

Examples

-- Collects an array of points into a multipoint.
> SELECT st_astext(st_collect(array(st_geomfromtext('POINT(1 2)'),st_geomfromtext('POINT(3 4)'))));
  MULTIPOINT((1 2),(3 4))
-- Collects an array of polygons into a multipolygon.
> SELECT st_astext(st_collect(array(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'))));
  MULTIPOLYGON(((0 0,10 0,10 10,0 10,0 0)))
-- Collects an array of mixed geometry kinds into a geometry collection.
> SELECT st_astext(st_collect(array(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'),st_geomfromtext('LINESTRING(1 2,3 4)'))));
  GEOMETRYCOLLECTION(POLYGON((0 0,10 0,10 10,0 10,0 0)),LINESTRING(1 2,3 4))
-- Returns the 2D empty geometry collection for an empty input array.
> SELECT st_astext(st_collect(array()));
  GEOMETRYCOLLECTION EMPTY
-- Returns NULL for a NULL input.
> SELECT st_collect(NULL);
  NULL
  • Last updated on