ST_CONTAINS (Lakehouse v1)

Retorna TRUE se o segundo objeto GEOMETRY estiver completamente dentro do primeiro objeto GEOMETRY.

Sintaxe SQL

ST_CONTAINS(<geometry1>, <geometry2>)

Argumentos

Argumentos	Descrição
<geometry1>	O argumento deve ser uma expressão do tipo objeto GEOMETRY que não seja uma GeometryCollection.
<geometry2>	O argumento deve ser uma expressão do tipo objeto GEOMETRY que não seja uma GeometryCollection.

Nota

• A função gera um erro se os dois objetos GEOMETRY de entrada tiverem SRIDs diferentes.

Tipo de retorno

Boolean.

Exemplos de SQL

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('POLYGON((-1 0, 0 1, 1 0, -1 0))')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ true     │
└──────────┘

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('LINESTRING(-1 1, 0 2, 1 1)')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ false    │
└──────────┘

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('LINESTRING(-2 0, 0 0, 0 1)')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ true     │
└──────────┘