st_force2d Função

Aplica-se a: Databricks SQL Databricks Runtime 18.1 and above

Importante

Esse recurso está em Visualização Pública.

Note

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 a projeção 2D da entrada GEOGRAPHY ou GEOMETRY do valor.

Sintaxe

st_force2d ( geoExpr )

Argumentos

• geoExpr: Um valor GEOGRAPHY ou GEOMETRY.

Devoluções

Um valor de tipo GEOGRAPHY ou GEOMETRY, representando a projeção 2D do valor de entrada.

O valor SRID da saída GEOGRAPHY ou GEOMETRY é igual ao valor de entrada.

A função retorna NULL se a entrada for NULL.

Observações

Se a entrada tiver coordenadas Z ou M, elas serão excluídas na saída.

Se a entrada já estiver 2D, a função a retornará inalterada.

Exemplos

-- Drops the M coordinate from a point geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POINT M (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a multipoint geography.
> SELECT st_astext(st_force2d(st_geogfromtext('MULTIPOINT ZM (EMPTY,0 0 10 20, 1 1 11 21)')));
  MULTIPOINT(EMPTY,(0 0),(1 1))
-- Drops the Z coordinate from a polygon geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POLYGON Z ((0 0 2,1 0 3,0 1 4,0 0 5))')));
  POLYGON((0 0,1 0,0 1,0 0))
-- Drops the Z coordinate from a point geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT Z (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a linestring geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('LINESTRING ZM (0 0 10 20, 1 1 11 21)')));
  LINESTRING(0 0,1 1)
-- Returns the input 2D geometry as is.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT(1 2)')));
  POINT(1 2)
-- Preserves the SRID of the input geography.
> SELECT st_srid(st_force2d(st_geogfromtext('POINT(1 2)')));
  4326
-- Preserves the SRID of the input geometry.
> SELECT st_srid(st_force2d(st_geomfromtext('POINT(1 2)', 4326)));
  4326
-- Returns NULL if the input is NULL.
> SELECT st_force2d(NULL);
   NULL

Funções relacionadas

• st_ndims função