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