Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
Databricks SQL Databricks Runtime 17.1 e superior
Important
O suporte para valores de GEOGRAFIA está disponível em Pré-visualização Pública. O suporte para valores GEOMETRY está geralmente disponível.
Observação
Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.
Remove o n-ésimo ponto da cadeia de caracteres GEOGRAPHYGEOMETRY ou valor da linha de entrada.
Syntax
st_removepoint ( geoExpr, indexExpr )
Arguments
-
geoExpr: UmGEOGRAPHYouGEOMETRYvalor que representa uma cadeia de caracteres de linha. -
indexExpr: UmINTEGERvalor que indica a posição baseada em 1 na cadeia de caracteres de linha do ponto que deve ser removido.
Returns
Um valor do tipo GEOGRAPHY ou GEOMETRY, que representa a cadeia de caracteres de linha após o ponto na -ésima indexExprposição ter sido removido.
O valor SRID da linhastring de saída é igual ao valor de entrada GEOGRAPHY ou GEOMETRY.
A dimensão da linha de saída é a mesma do valor de entrada GEOGRAPHY ou GEOMETRY.
A função retorna NULL se qualquer uma das entradas for NULL.
Condições de erro
- Se o valor de
geoExprnão for um linestring ou for um linestring vazio, a função retornará ST_INVALID_ARGUMENT.INVALID_TYPE. - Se o valor absoluto de
indexExprfor 0 ou maior que o número de pontos na linha de sequência, a função devolve ST_INVALID_ARGUMENT.INVALID_INDEX_VALUE.
Examples
-- Returns the linestring after removing the second point counting from the left.
> SELECT st_astext(st_removepoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 2));
LINESTRING(1 2,5 6)
-- Returns the linestring after removing the first point counting from the right.
> SELECT st_asewkt(st_removepoint(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -1));
SRID=4326;LINESTRING(1 2,3 4)