Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Funzione
Si applica a:
controllo SQL di Databricks Databricks Runtime 17.1 e versioni successive
Important
Questa funzionalità è in Anteprima Pubblica.
Annotazioni
Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.
Imposta il n-esimo punto della linestringa di input GEOGRAPHY o del valore GEOMETRY.
Syntax
st_setpoint ( geo1Expr, indexExpr, geo2Expr )
Arguments
-
geo1Expr: un valoreGEOGRAPHYoGEOMETRYche rappresenta un linestring. -
indexExprINTEGER: valore che indica la posizione in base 1 nella riga in cui deve essere impostato il nuovo punto. -
geo2Expr: un valoreGEOGRAPHYoGEOMETRYche rappresenta un punto.
Returns
Valore di tipo GEOGRAPHY se e geo1Exprgeo2Expr sono di tipo GEOGRAPHYo un valore di tipo GEOMETRY se e geo1Exprgeo2Expr sono di tipo GEOMETRY.
Se indexExpr è positivo, il valore restituito GEOGRAPHY o GEOMETRY è una nuova stringa di linee il cui indexExpr-esimo punto (conteggiato da sinistra) è impostato a geo2Expr.
Se indexExpr è negativo, la posizione in base 1 della linea in cui viene aggiunto il punto viene misurata a destra.
- La funzione restituisce
NULLse uno degli input èNULL. - Il valore SRID della stringa di output è uguale al valore SRID comune dei valori di input
GEOGRAPHYoGEOMETRY. - La dimensione dell'output
GEOGRAPHYoGEOMETRYdella stringa di riga è uguale a quella digeo1Expr. Segeo2Exprcontiene coordinate la cui dimensione non esiste nellegeo1Exprcoordinate corrispondenti è impostata su 0.
Condizioni di errore
- Se
geo1Exprè di tipoGEOGRAPHYegeo2Exprè di tipoGEOMETRY, oppure viceversa, la funzione restituisce DATATYPE_MISMATCH. - Se i valori SRID di
geo1Expregeo2Exprsono diversi, la funzione restituisce ST_DIFFERENT_SRID_VALUES. - La funzione restituisce ST_INVALID_ARGUMENT. INVALID_TYPE in uno dei casi seguenti:
- Il valore di
geo1Exprnon è una stringa di riga. - Il valore di
geo2Exprnon è un punto.
- Il valore di
- La funzione restituisce ST_INVALID_ARGUMENT. EMPTY_LINESTRING in se il valore di
geo1Exprè una riga vuota. - La funzione restituisce ST_INVALID_ARGUMENT. EMPTY_POINT in se il valore di
geo2Exprè un punto vuoto. - Se il valore assoluto del valore di
indexExprè 0 o maggiore del numero di punti nella riga, la funzione restituisce ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.
Examples
-- We set the first point of the linestring counting from the left.
> SELECT st_astext(st_setpoint(st_geomfromtext('LINESTRING(1 2,3 4)'), 1, st_geomfromtext('POINT(7 8)')));
LINESTRING(7 8,3 4)
-- We set the first point of the linestring counting from the right.
-- The point is missing a Z coordinate. This is set to 0 when we update the linestring.
> SELECT st_asewkt(st_setpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)'), -1, st_geogfromtext('POINT M (0 9 99)')));
SRID=4326;LINESTRING ZM (1 2 3 4,0 9 0 99)