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.
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)