ST_GeomFromText - 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_GeomFromText

ST_GeomFromText costruisce un oggetto geometrico a partire dalla rappresentazione in formato Well-Known Text (WKT) di un oggetto geometrico in input.

ST_GeomFromText accetta 3DZ, 3DM e 4D in cui il tipo di geometria è preceduto rispettivamente dal prefisso Z, M o ZM.

Sintassi

ST_GeomFromText(wkt_string)
ST_GeomFromText(wkt_string, srid)

Argomenti

wkt_string

Un valore di tipo VARCHAR che è una rappresentazione in formato WKT di un oggetto geometrico.

È possibile utilizzare la parola chiave WKT EMPTY per designare un punto vuoto, un multipunto con un punto vuoto o una raccolta di geometria con un punto vuoto. L'esempio seguente crea un punto multiplo con un punto vuoto e uno non vuoto. 

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
srid

Un valore di tipo INTEGER che rappresenta uno Spatial Reference Identifier (SRID). Se è fornito un valore SRID, l'oggetto geometrico restituito presenta tale valore SRID. In caso contrario, il valore SRID dell'oggetto geometrico restituito è impostato a zero (0).

Tipo restituito

GEOMETRY

Se wkt_string o srid sono nulli, allora viene restituito il valore nullo.

Se srid è negativo, allora viene restituito il valore nullo.

Se wkt_string non è valido, allora viene restituito un errore.

Se srid non è valido, allora viene restituito un errore.

Esempi

Il seguente comando SQL costruisce un oggetto geometrico a partire dalla rappresentazione WKT e dal valore SRID. 

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000