ST_Angle - Amazon Redshift
SintassiArgomentiTipo restituitoEsempi

Amazon Redshift non supporterà più la creazione di nuove UDF Python a partire dal 1º novembre 2025. Se desideri utilizzare le UDF Python, creale prima di tale data. Le UDF Python esistenti continueranno a funzionare normalmente. Per ulteriori informazioni, consulta il post del blog.

ST_Angle

ST_Angle restituisce l'angolo in radianti tra i punti misurati in senso orario.

  • Se vengono inseriti tre punti, l'angolo restituito P1-P2-P3 viene misurato come se fosse ottenuto ruotando da P1 a P3 attorno a P2 in senso orario.

  • Se vengono inseriti quattro punti, viene restituito l'angolo restituito in senso orario formato dalle linee dirette P1-P2 e P3-P4. Se l'input è un caso degenerato (ovvero, P1 è uguale a P2 o P3 uguale a P4), viene restituito null.

Il valore di restituzione è in radianti ed è compreso nell'intervallo [0, 2π).

ST_Angle opera sulle proiezioni 2D delle geometrie di input.

Sintassi

ST_Angle(geom1, geom2, geom3)
ST_Angle(geom1, geom2, geom3, geom4)

Argomenti

geom1

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom2

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom3

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom4

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

Tipo restituito

DOUBLE PRECISION.

Se geom1 è uguale a geom2 o geom2 è uguale a geom3, viene restituito un valore null.

Se geom1, geom2, geom3 o geom4 è null, viene restituito un valore null.

Se uno qualsiasi di geom1, geom2, geom3 o geom4 è il punto vuoto, viene restituito un errore.

Se geom1, geom2, geom3 e geom4 non hanno lo stesso valore di identificatore del sistema di riferimento spaziale (SRID), viene restituito un errore.

Esempi

Il seguente SQL restituisce l'angolo convertito in gradi di tre punti di input. 

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0)) / Pi() * 180.0 AS angle;

 angle
---------------
    45

Il seguente SQL restituisce l'angolo convertito in gradi di quattro punti di input. 

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0), ST_Point(2,0)) / Pi() * 180.0 AS angle;

 angle
---------------
   225