Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
Databricks SQL Databricks Runtime 17.1 and above
Important
Esse recurso está em Visualização Pública.
Observação
Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.
Define o n-ésimo ponto da linhastring GEOGRAPHY de entrada ou valor GEOMETRY.
Syntax
st_setpoint ( geo1Expr, indexExpr, geo2Expr )
Arguments
-
geo1Expr: AGEOGRAPHYouGEOMETRYvalor que representa uma linha de linha. -
indexExpr: umINTEGERvalor que indica a posição baseada em 1 na linha onde o novo ponto deve ser definido. -
geo2Expr: AGEOGRAPHYouGEOMETRYvalor que representa um ponto.
Returns
Um valor de tipo GEOGRAPHY se ambos geo1Expr e geo2Expr são do tipo GEOGRAPHY, ou um valor de tipo GEOMETRY , se ambos geo1Expr e geo2Expr são do tipo GEOMETRY.
Se indexExpr for positivo, o valor retornado GEOGRAPHY ou GEOMETRY será um novo 'linestring' cujo indexExpr-ésimo ponto (contado a partir da esquerda) é definido como geo2Expr.
Se indexExpr for negativo, a posição baseada em 1 da linhagem em que o ponto é adicionado é medida da direita.
- A função retornará
NULLse qualquer uma das entradas forNULL. - O valor SRID da linhastring de saída é igual ao valor SRID comum dos valores de entrada
GEOGRAPHYouGEOMETRY. - A dimensão da saída
GEOGRAPHYouGEOMETRYlinestring é a mesma degeo1Expr. Segeo2Exprcontiver coordenadas cuja dimensão não existe nasgeo1Exprcoordenadas correspondentes, serão definidas como 0.
Condições de erro
- Se
geo1Exprfor do tipoGEOGRAPHYegeo2Exprfor do tipoGEOMETRY, ou o contrário, a função retornará DATATYPE_MISMATCH. - Se os valores SRID forem
geo1Exprdiferentes egeo2Exprforem diferentes, a função retornará ST_DIFFERENT_SRID_VALUES. - A função retorna ST_INVALID_ARGUMENT. INVALID_TYPE em qualquer um dos seguintes casos:
- O valor de
geo1Exprnão é um linestring. - O valor de
geo2Exprnão é um ponto.
- O valor de
- A função retorna ST_INVALID_ARGUMENT.EMPTY_LINESTRING se o valor de
geo1Exprfor um LineString vazio. - A função retorna ST_INVALID_ARGUMENT.EMPTY_POINT se o valor de
geo2Exprfor um ponto vazio. - Se o valor absoluto do valor de
indexExprfor 0 ou maior que o número de pontos no linestring, a função retornará 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)