Freigeben über


st_transform-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Transformiert die X- und Y-Koordinaten der Eingabegeometrie vom aktuellen Koordinatenverweissystem (CRS) in das koordinatenreferenzsystem, das vom bereitgestellten SRID-Wert beschrieben wird.

Syntax

st_transform ( geo, srid )

Arguments

  • geo: Ein GEOMETRY Wert.
  • srid: Der SRID-Wert des neuen Koordinatenreferenzsystems (CRS), in das die Eingabegeometrie transformiert werden soll.

Returns

Ein Wert vom Typ GEOMETRY, der die transformierte Geometrie darstellt.

Wenn die Geometrie Z- und M-Koordinaten enthält, sind sie in der Ausgabegeometrie vorhanden und werden nicht geändert.

Die SRID der Ausgabe GEOMETRY ist gleich dem Eingabe-SRID-Wert.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

  • Wenn es nicht möglich ist, von der CRS der Eingabegeometrie in den durch den bereitgestellten SRID-Wert beschriebenen CRS zu transformieren, gibt die Funktion ST_INVALID_CRS_TRANSFORMATION_ERROR zurück.

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