Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting
ST_MakeEnvelope
ST_MakeEnvelope gibt eine Geometrie zurück, und zwar wie folgt:
Wenn die Eingabekoordinaten einen Punkt angeben, ist die zurückgegebene Geometrie ein Punkt.
Wenn die Eingabekoordinaten eine Linie angeben, ist die zurückgegebene Geometrie ein Linestring.
Andernfalls ist die zurückgegebene Geometrie ein Polygon, bei dem die Eingabekoordinaten die untere linke und obere rechte Ecke eines Quaders angeben.
Sofern angegeben, wird der SRID-Wert (Spatial Reference System Identifier) der zurückgegebenen Geometrie auf den eingegeben SRID-Wert gesetzt.
Syntax
ST_MakeEnvelope(xmin, ymin, xmax, ymax)
ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)
Argumente
- xmin
-
Ein Wert vom Datentyp
DOUBLE PRECISION. Dieser Wert entspricht der ersten Koordinate in der unteren linken Ecke eines Quaders. - ymin
-
Ein Wert vom Datentyp
DOUBLE PRECISION. Dieser Wert entspricht der zweiten Koordinate in der unteren linken Ecke eines Quaders. - xmax
-
Ein Wert vom Datentyp
DOUBLE PRECISION. Dieser Wert entspricht der ersten Koordinate in der oberen rechten Ecke eines Quaders. - ymax
-
Ein Wert vom Datentyp
DOUBLE PRECISION. Dieser Wert entspricht der zweiten Koordinate in der oberen rechten Ecke eines Quaders. - srid
-
Ein Wert vom Datentyp
INTEGER, der einen Spatial Reference System Identifier (SRID) darstellt. Wenn der SRID-Wert nicht angegeben wird, wird er auf null gesetzt.
Rückgabetyp
GEOMETRY des Subtyps POINT, LINESTRING oder POLYGON.
Die SRID der zurückgegebenen Geometrie wird auf srid festgelegt, bzw. null, wenn srid nicht festgelegt wurde.
Wenn xmin, ymin, xmax, ymax oder srid null ist, wird null zurückgegeben.
Wenn srid negativ ist, wird ein Fehler zurückgegeben.
Beispiele
Die folgende SQL-Anweisung gibt ein Polygon zurück, das ein Envelope darstellt, das von den vier eingegebenen Koordinatenwerten definiert wird.
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7));
st_astext
---------------
POLYGON((2 4,2 7,5 7,5 4,2 4))
Die folgende SQL-Anweisung gibt ein Polygon zurück, das ein Envelope darstellt, das von den vier eingegebenen Koordinatenwerten und einem SRID-Wert definiert wird.
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7,4326));
st_astext
----------------------------------
SRID=4326;POLYGON((2 4,2 7,5 7,5 4,2 4))
