ST_Covers - Amazon Redshift
SintaxisArgumentosTipo de devoluciónEjemplos

Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del 1 de noviembre de 2025. Si desea utilizar las UDF de Python, créelas antes de esa fecha. Las UDF de Python existentes seguirán funcionando con normalidad. Para obtener más información, consulte la publicación del blog.

ST_Covers

ST_Covers devuelve true si la proyección 2D de la primera geometría de entrada cubre la proyección 2D de la segunda geometría de entrada. La geometría A cubre la geometría B si ninguna de ellas está vacía y cada punto de B es un punto en A.

ST_Covers(A, B) es equivalente a ST_CoveredbBy(B, A).

Sintaxis

ST_Covers(geom1, geom2)

Argumentos

geom1

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY.

geom2

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY. Este valor se compara con geom1 para determinar si cubre geom1.

Tipo de devolución

BOOLEAN

Si geom1 o geom2 son null, entonces se devuelve el valor null.

Si geom1 y geom2 no tienen el mismo valor en el identificador de sistema de referencia espacial (SRID), se devuelve un error.

Si geom1 o geom2 son una colección geométrica, se devuelve un error.

Ejemplos

El siguiente SQL revisa si el primer polígono cubre el segundo polígono. 

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