st_within 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 está dentro del segundo GEOMETRY valor.

Syntax

st_within ( geo1, geo2 )

Arguments

• geo1: el primer GEOMETRY valor.
• geo2: El segundo GEOMETRY valor.

Returns

Valor de tipo BOOLEAN, que indica si el primer GEOMETRY valor está dentro del 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 Within en la definición de matriz DE-9IM.

La función devuelve NULL si alguna de las entradas es NULL.

Condiciones de error

• Si alguna de las geometrías de entrada es una colección de geometrías, la función devuelve ST_INVALID_ARGUMENT. INVALID_TYPE.
• Si las geometrías de entrada no tienen el mismo valor SRID, la función devuelve ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false

Funciones relacionadas

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