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.
Retorna o n-ésimo ponto da linestring GEOGRAPHY de entrada ou do valor GEOMETRY.
Syntax
st_pointn ( geoExpr, indexExpr )
Arguments
-
geoExpr: AGEOGRAPHYouGEOMETRYvalor que representa uma linha de linha. -
indexExpr: umINTEGERvalor que indica a posição baseada em 1 na linha do ponto que deve ser retornado.
Returns
Um valor do tipo GEOGRAPHY ou GEOMETRY, representando o ponto na posição indexExpr na linha de entrada.
O valor SRID do ponto de saída é igual ao valor de entrada GEOGRAPHY ou GEOMETRY.
A dimensão do ponto de saída é a mesma daquela do valor de entrada GEOGRAPHY ou GEOMETRY.
A função retornará NULL se qualquer uma das entradas for NULL.
Condições de erro
- Se o valor de
geoExprnão for um linestring, a função retornará ST_INVALID_ARGUMENT.INVALID_TYPE. - Se o valor de
geoExprfor um linestring vazio, a função retornará ST_INVALID_ARGUMENT.EMPTY_LINESTRING. - 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
-- Returns the third point of the linestring counting from the left.
> SELECT st_astext(st_pointn(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 3));
POINT(5 6)
-- Returns the third point of the linestring counting from the right.
> SELECT st_astext(st_pointn(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -3));
POINT(1 2)