View a markdown version of this page

ST_Envelope - Amazon Redshift

Amazon Redshift non supporterà più l'uso delle UDF Python dopo il 30 giugno 2026. Inizieremo ad applicarlo per fasi. Per ulteriori informazioni sulla fine del ciclo di vita e sulle opzioni di migrazione di Python, consulta il post del blog pubblicato il 30 giugno 2025.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ST_Envelope

ST_Envelope restituisce il riquadro di delimitazione minimo della geometria di input, come segue:

  • Se la geometria di input è vuota, la geometria restituita è una copia della geometria di input.

  • Se il riquadro di delimitazione minimo della geometria di input degenera in un punto, la geometria restituita è un punto.

  • Se il riquadro di delimitazione minimo della geometria di input è unidimensionale, viene restituita una linea a due punti.

  • Se nessuna delle precedenti condizioni è vera, la funzione restituisce un poligono orientato in senso orario i cui vertici sono gli angoli del riquadro di delimitazione minimo.

Il valore dell'identificatore del sistema di riferimento spaziale (SRID) dell'oggetto geometrico restituito è il valore SRID degli oggetti geometrici in input.

Per tutti gli input non vuoti, la funzione opera sulla proiezione 2D della geometria di input.

Sintassi

ST_Envelope(geom)

Arguments (Argomenti)

geom

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY.

Tipo restituito

GEOMETRY

Se geom è nullo, allora viene restituito il valore nullo.

Esempi

Il seguente codice SQL converte una rappresentazione di testo noto (WKT) di una LINESTRING a quattro punti in un oggetto GEOMETRY e restituisce un poligono i cui vertici e angoli sono il riquadro di delimitazione minimo.

SELECT ST_AsText(ST_Envelope(ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))')));
st_astext ------------------------------------ POLYGON((0 0,0 10,20 10,20 0,0 0))