ST_Covers - Amazon Redshift

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_Covers

ST_Covers gibt true zurück, wenn die 2D-Projektion der ersten Eingabegeometrie die 2D-Projektion der zweiten Eingabegeometrie abgedeckt. Die Geometrie A deckt die Geometrie B, wenn beide nicht leer sind und jeder Punkt in B ein Punkt in A ist.

ST_Covers(A, B) entspricht ST_CoveredBy(B, A).

Syntax

ST_Covers(geom1, geom2)

Argumente

geom1

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird.

geom2

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. Dieser Wert wird mit geom1 verglichen, um festzustellen, ob er geom1 abdeckt.

Rückgabetyp

BOOLEAN

Wenn geom1 oder geom2 null ist, wird null zurückgegeben.

Wenn geom1 und geom2 nicht den gleichen SRID-Wert (Spatial Reference System Identifier) haben, wird ein Fehler zurückgegeben.

Wenn geom1 oder geom2 eine Geometrie-Collection ist, wird ein Fehler zurückgegeben.

Beispiele

Das folgende SQL prüft, ob das erste Polygon das zweite Polygon abdeckt.

SELECT ST_Covers(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_covers ----------- false