View a markdown version of this page

ST_DWithin - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

ST_DWithin

ST_DWithin retorna true se a distância euclidiana entre as projeções 2D dos dois valores de geometria de entrada não for maior que um valor limite.

Sintaxe

ST_DWithin(geom1, geom2, threshold)

Argumentos

geom1

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

threshold

Um valor de de tipo de dados DOUBLE PRECISION. Esse valor está nas unidades dos argumentos de entrada.

Tipo de retorno

BOOLEAN

Nulo será retornado se geom1 ou geom2 for nulo.

Um erro será retornado se threshold for negativo.

Um erro será retornado se geom1 e geom2 não tiverem o mesmo valor do identificador do sistema referência espacial (SRID -spatial reference system identifier).

Um erro será retornado se geom1 ou geom2 for uma coleção de geometrias.

Exemplos

O SQL a seguir verifica se a distância entre dois polígonos está dentro de cinco unidades. 

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

st_dwithin
-----------
 true