Delen via


st_geomfromwkt functie

Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 17.1 en hoger

Important

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Parseert de WKT-beschrijving van een geometrie en retourneert de bijbehorende GEOMETRY waarde. De SRID-waarde van de geretourneerde GEOMETRY waarde is de waarde van de sridExpr indien opgegeven, of anders 0.

Syntax

st_geomfromwkt ( wktExpr[, sridExpr] )

Arguments

  • wktExpr: Een STRING waarde, dat een geometrie vertegenwoordigt in WKT-formaat.
  • sridExpr: Een optionele INTEGER waarde die is ingesteld op de SRID van de geretourneerde GEOMETRY waarde.

Returns

Een waarde van het type GEOMETRY(srid) waarbij srid gelijk is aan de waarde van sridExpr als sridExpr een constante (optimaliseerbare) expressie is, of aan GEOMETRY(ANY) anders. Als sridExpr wordt weggelaten, zal het type van de geretourneerde waarde GEOMETRY(0) zijn. De geretourneerde waarde is de geometrie die overeenkomt met de beschrijving van de invoer WKT .

De functie retourneert NULL als een van de invoerwaarden is NULL.

Foutvoorwaarden

  • Als de waarde wktExpr een ongeldige WKT-beschrijving is, retourneert de functie WKT_PARSE_ERROR.
  • Als de waarde van sridExpr niet wordt ondersteund, retourneert ST_INVALID_SRID_VALUEde functie .

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0.
> SELECT st_srid(st_geomfromwkt('POINT Z (1 2 3)'));
  0

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkt('POINT Z (1 2 3)', 3857));
  SRID=3857;POINT Z (1 2 3)