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 primeiro ponto do valor de entrada GEOGRAPHY ou GEOMETRY, se o valor geoespacial de entrada for uma linha de polígono não vazia.
Syntax
st_startpoint ( geoExpr )
Arguments
-
geoExpr: UmGEOGRAPHYouGEOMETRYvalor que representa uma cadeia de caracteres de linha.
Returns
Um valor do tipo GEOGRAPHY ou GEOMETRY, representando o primeiro ponto da cadeia de caracteres de linha.
O valor SRID do ponto de saída é o mesmo que o valor de entrada.
A dimensão do ponto de saída é a mesma que a da cadeia de caracteres de linha de entrada.
A função retorna NULL se a entrada 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.
Examples
-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
SRID=4326;POINT ZM (1 2 3 4)