ST_CoveredBy - 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_CoveredBy

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

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

Sintaxis

ST_CoveredBy(geom1, geom2)

Argumentos

geom1

Un valor de tipo de datos GEOMETRY o una expresión que toma el valor de un tipo GEOMETRY. Este valor se compara con geom2 para determinar si está cubierto por geom2.

geom2

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

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 está cubierto por el segundo polígono. 

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

st_coveredby
-----------
 true