geometry-expression.ST_Equals(geo2)

Testet, ob ein ST_Geometry-Wert gleich einem anderen ST_Geometry-Wert ist.

Der Test auf räumliche Gleichheit erfolgt durch den Vergleich der begrenzenden Rechtecke der beiden Geometrien. Wenn sie innerhalb der Toleranz nicht gleich sind, werden die beiden Geometrien als ungleich angesehen und 0 wird zurückgegeben. Andernfalls gibt der Datenbankserver 1 zurück, wenn geometry-expression.ST_SymDifference( geo2 ) eine leere Menge ist, sonst 0.

Der SQL/MM-Standard definiert ST_Equals nur für ST_SymDifference, ohne zusätzlichen Vergleich der begrenzenden Rechtecke. Es gibt einige Geometrien, die mit ST_SymDifference eine leere Ergebnismenge zurückgeben, obwohl ihre begrenzenden Rechtecke nicht gleich sind. Diese Geometrien würden vom SQL/MM-Standard als gleich angesehen, nicht aber von SQL Anywhere. Dieser Unterschied kann auftreten, wenn eine oder beide Geometrien Spitzen oder Punktierungen enthalten.

Zwei Geometriewerte können als gleichwertig angesehen werden, selbst wenn sie unterschiedliche Darstellungen haben. Beispiel: Zwei Linienfolgen können unterschiedliche Ausrichtungen haben, aber dieselbe Gruppe von Punkten im Raum enthalten. Diese beiden Linienfolgen werden von ST_Equals als gleich angesehen, nicht aber von ST_OrderingEquals. Siehe Funktionsweise räumlicher Vergleiche.

ST_Equals kann durch die Auflösung des räumlichen Bezugssystem oder die Präzision der Daten begrenzt sein.

• ST_OrderingEquals-Methode für den ST_Geometry-Datentyp
• ST_EqualsFilter-Methode für den ST_Geometry-Datentyp

Das folgende Beispiel gibt den Wert 16 zurück. Für die ShapeID entsprechende Form enthält das Ergebnis 16 die gleichen Punkte, allerdings in anderer Reihenfolge als das angegebene Polygon.

SELECT ShapeID FROM SpatialShapes
WHERE Shape.ST_Equals( NEW ST_Polygon( 'Polygon ((2 0, 1 2, 0 0, 2 0))' ) ) = 1

Im folgenden Beispiel wird das Ergebnis 1 zurückgegeben. Es zeigt, dass die zwei Linienfolgen gleich sind, obwohl sie eine unterschiedliche Anzahl von Stellen in einer anderen Reihenfolge enthalten und der Zwischenpunkt nicht genau auf der Linie liegt. Der Zwischenpunkt ist rund 3.33e-7 entfernt von der Linie mit nur zwei Punkten, aber diese Entfernung ist geringer als die Toleranz 1e-6 für das räumliche Standard-Bezugssystem (SRID 0).

SELECT NEW ST_LineString( 'LineString( 0 0, 0.333333 1, 1 3 )' )
        .ST_Equals( NEW ST_LineString( 'LineString( 1 3, 0 0 )' ) )