st_contains Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve true si el primer GEOMETRY valor contiene el segundo GEOMETRY valor.

Syntax

st_contains ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: el primer GEOMETRY valor.
• geoExpr2: El segundo GEOMETRY valor.

Returns

Valor de tipo BOOLEAN, que indica si el primer GEOMETRY valor contiene el segundo GEOMETRY valor.

La función no admite colecciones de geometría.

Para obtener más detalles y la definición formal, vea el predicado Contains en la definición de matriz DE-9IM.

Condiciones de error

• Si alguna de las dos geometrías de entrada es una colección de geometrías, la función devuelve ST_INVALID_ARGUMENT. INVALID_TYPE.
• Si las dos geometrías de entrada tienen valores SRID diferentes, la función devuelve ST_DIFFERENT_SRID_VALUES.

Examples

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(1 1)'));
  true

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 0)'));
  false

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 6)'));
  false

Funciones relacionadas

• st_covers Función
• st_disjoint Función
• st_equals Función
• st_intersects Función
• st_touches Función
• st_within Función