Kategorien:

Geodatenfunktionen

ST_COVEREDBY

Gibt TRUE zurück, wenn kein Punkt eines Geodatenobjekts außerhalb eines anderen Geodatenobjekts liegt. Mit anderen Worten:

  • GEOGRAPHY-Objekt g1 befindet sich außerhalb von GEOGRAPHY-Objekt g2.

  • GEOMETRY-Objekt g1 befindet sich außerhalb von GEOMETRY-Objekt g2.

Dies ist äquivalent zu ST_COVERS(g2, g1)

Auch wenn ST_COVEREDBY und ST_WITHIN ähnlich zu sein scheinen, gibt es doch feine Unterschiede zwischen den beiden Funktionen. Weitere Informationen zu den Unterschieden zwischen „abgedeckt von“ und „innerhalb von“ finden Sie unter DE-9IM (Dimensionally Extended 9-Intersection Model).

Bemerkung

Diese Funktion unterstützt nicht die Verwendung einer GeometryCollection oder FeatureCollection als Eingabewert.

Tipp

Sie können den Suchoptimierungsdienst verwenden, um die Leistung von Abfragen zu verbessern, die diese Funktion aufrufen. Weitere Details dazu finden Sie unter Suchoptimierungsdienst.

Siehe auch:

ST_COVERS, ST_WITHIN

Syntax

ST_COVEREDBY( <geography_expression_1> , <geography_expression_2> )

ST_COVEREDBY( <geometry_expression_1> , <geometry_expression_2> )
Copy

Argumente

geography_expression_1

Ein GEOGRAPHY-Objekt, das nicht ein GeometryCollection oder FeatureCollection ist.

geography_expression_2

Ein GEOGRAPHY-Objekt, das nicht ein GeometryCollection oder FeatureCollection ist.

geometry_expression_1

Ein GEOMETRY-Objekt, das nicht ein GeometryCollection oder FeatureCollection ist.

geometry_expression_2

Ein GEOMETRY-Objekt, das nicht ein GeometryCollection oder FeatureCollection ist.

Rückgabewerte

Ein BOOLEAN-Wert.

Nutzungshinweise

  • Bei GEOMETRY-Objekten meldet die Funktion einen Fehler, wenn die beiden eingegebenen GEOMETRY-Objekte unterschiedliche SRIDs haben.

Beispiele

GEOGRAPHY-Beispiele

Das folgende Beispiel zeigt eine einfache Verwendung der Funktion ST_COVEREDBY:

create table geospatial_table_01 (g1 GEOGRAPHY, g2 GEOGRAPHY);
insert into geospatial_table_01 (g1, g2) values 
    ('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0))', 'POLYGON((1 1, 2 1, 2 2, 1 2, 1 1))');
Copy
SELECT ST_COVEREDBY(g1, g2) 
    FROM geospatial_table_01;
+----------------------+
| ST_COVEREDBY(G1, G2) |
|----------------------|
| False                |
+----------------------+
Copy