Delen via

st_geomfromwkb 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 WKB-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_geomfromwkb ( wkbExpr[, sridExpr] )

Arguments

  • wkbExpr: Een BINARY waarde, die een geometrie in WKB-indeling vertegenwoordigt.
  • 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 wkb-invoerbeschrijving .

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

Foutvoorwaarden

  • Als de waarde wkbExpr een ongeldige WKB-beschrijving is, retourneert de functie WKB_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. Input is in little-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740'));
  POINT M (10 34 23)

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in big-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'00000007D1402400000000000040410000000000004037000000000000'));
  POINT M (10 34 23)

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 3857));
  SRID=3857;POINT M (10 34 23)

-- When invoking st_geomfromwkb with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 4269));
  geometry(4269)
  • Last updated on