Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Databricks SQL Databricks Runtime 17.1 e superior
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.
Retorna o n-ésimo ponto da cadeia de caracteres GEOGRAPHYGEOMETRY ou valor da linha de entrada.
Syntax
st_pointn ( 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 retornado.
Returns
Um valor do tipo GEOGRAPHY ou GEOMETRY, que representa o ponto na posição indexExpr-ésima da cadeia de caracteres de linha de entrada.
O valor SRID do ponto de saída é igual ao valor de entrada de GEOGRAPHY ou GEOMETRY.
A dimensão do ponto de saída é a mesma que a da entrada GEOGRAPHY ou GEOMETRY valor.
A função retorna NULL se qualquer uma das entradas for NULL.
Condições de erro
- Se o valor de
geoExprnão for uma linha poligonal, a função retornará ST_INVALID_ARGUMENT.INVALID_TYPE. - Se o valor de
geoExprfor uma linhastring vazia, a função retornará ST_INVALID_ARGUMENT.EMPTY_LINESTRING. - 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 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)