Compartilhar via


st_startpoint Função

Aplica-se a:check marked yes Databricks SQL check marked yes 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 primeiro ponto do valor de entrada GEOGRAPHY ou GEOMETRY, se o valor geoespacial de entrada for uma linha que não esteja vazia.

Syntax

st_startpoint ( geoExpr )

Arguments

  • geoExpr: A GEOGRAPHY ou GEOMETRY valor que representa uma linha de linha.

Returns

Um valor de tipo GEOGRAPHY ou GEOMETRY, representando o primeiro ponto da linha.

O valor SRID do ponto de saída é o mesmo do valor de entrada.

A dimensão do ponto de saída é a mesma da linha de entrada.

A função retornará NULL se a entrada for NULL.

Condições de erro

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)