Compartilhar via

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

Analisa a descrição de entrada de uma geometria e retorna o valor correspondente GEOMETRY . O valor SRID do valor retornado GEOMETRY depende do formato de entrada.

Syntax

to_geometry ( geoRepExpr )

Arguments

  • geoRepExpr: BINARY ou STRING uma expressão que representa uma geometria em WKB, WKT, GeoJSON ou EWKB (Extended WKB).

Returns

Um valor de tipo GEOMETRY(ANY)correspondente à descrição de geografia de entrada.

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

Condições de erro

  • Se geoRepExpr for do tipo BINARY e o valor for um EWKB inválido, a função retornará EWKB_PARSE_ERROR.
  • Se geoRepExpr for do tipo BINARY e o valor for um WKB inválido, a função retornará WKB_PARSE_ERROR.
  • Se geoRepExpr for do tipo STRING e o valor for um WKT inválido, a função retornará WKT_PARSE_ERROR.
  • Se geoRepExpr for do tipo STRING e o valor for um GeoJSON inválido, a função retornará GEOJSON_PARSE_ERROR.

Examples

-- Input geometry is in WKT format.
> SELECT st_asgeojson(to_geometry('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geometry is in GeoJSON format.
> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[3,4,5]}'));
  POINT Z (3 4 5)

-- Input geometry is in WKB format.
> SELECT st_astext(to_geometry(X'0101000060110f0000000000000000084000000000000010400000000000001440'));
  POINT M (3 4 5)

-- Input geometry is in EWKB format.
> SELECT st_asewkt(to_geometry(X'01010000E0110F0000000000000000084000000000000010400000000000001440000000000000F0BF'));
  SRID=3857;POINT ZM (3 4 5 -1)
  • Last updated on