ST_DWithin - Amazon Redshift
SyntaxArgumenteRückgabetypBeispiele

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_DWithin

ST_DWithin gibt true zurück, wenn der euklidische Abstand zwischen den 2D-Projektionen der beiden Eingabegeometriewerte nicht größer als ein Schwellenwert ist.

Syntax

ST_DWithin(geom1, geom2, threshold)

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.

threshold

Ein Wert vom Datentyp DOUBLE PRECISION. Dieser Wert wird in Einheiten der Eingangsargumente angegeben.

Rückgabetyp

BOOLEAN

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

Wenn threshold1 negativ ist, wird ein Fehler 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 der Abstand zwischen zwei Polygonen innerhalb von fünf Einheiten liegt. 

SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);

st_dwithin
-----------
 true