funktion st_transform

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Transformerar X- och Y-koordinaterna för indatageometrin från det aktuella referenssystemet (CRS) till det koordinatreferenssystem som beskrivs av det angivna SRID-värdet.

Syntax

st_transform ( geo, srid )

Arguments

  • geo: Ett GEOMETRY värde.
  • srid: SRID-värdet för det nya koordinatreferenssystemet (CRS) till vilket indatageometrin ska transformeras.

Returns

Ett värde av typen GEOMETRY, som representerar den transformerade geometrin.

Om geometrin har Z- och M-koordinater kommer de att finnas i utdatageometrin och kommer inte att ändras.

SRID för utdata GEOMETRY är lika med indata-SRID-värdet.

Funktionen returnerar NULL om någon av indata är NULL.

Feltillstånd

  • Om det inte går att transformera från CRS för indatageometrin till crs som beskrivs av det angivna SRID-värdet returnerar funktionen ST_INVALID_CRS_TRANSFORMATION_ERROR.

Examples

-- Transforms coordinates from WGS84 to Web Mercator.
> SELECT st_astext(st_transform(st_geomfromtext('MULTIPOINT Z (4 5 14,-3 8 27,EMPTY)', 4326), 3857));
  MULTIPOINT Z ((445277.96317309426 557305.2572745768 14),(-333958.4723798207 893463.751012646 27),EMPTY)
-- Returns geometry in new coordinate system.
> SELECT st_srid(st_transform(st_geomfromtext('POINT(0 0)', 4326), 3857));
  3857