funktion st_translate

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.

Översätter indatavärdet GEOMETRY i riktningarna X, Y och, om det anges, Z med hjälp av de angivna förskjutningarna.

Syntax

st_translate ( geoExpr, xfactor, yfactor[, zfactor] )

Arguments

  • geoExpr: Ett GEOMETRY värde.
  • xfactor: Ett DOUBLE värde som representerar förskjutningen i X-riktningen.
  • yfactor: Ett DOUBLE värde som representerar förskjutningen i Y-riktningen.
  • zfactor: Ett DOUBLE värde som representerar förskjutningen i Z-riktningen (valfritt). Standardvärdet är 0.

Returns

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

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

Dimensionen för utdatavärdet GEOMETRY är samma som för indatavärdet.

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

Examples

-- Translates a point by 10 in the X direction and 20 in the Y direction.
> SELECT st_astext(_FUNC_(st_geomfromtext('MULTIPOINT ZM (1 2 3 -4,5 6 7 -8,EMPTY)'), 10.0, 20.0));
  MULTIPOINT ZM ((11 22 3 -4),(15 26 7 -8),EMPTY)
-- Translates a point by 10 in the X direction, 20 in the Y direction, and 3 in the Z direction.
> SELECT st_astext(_FUNC_(st_geomfromtext('MULTIPOINT ZM (1 2 3 -4,5 6 7 -8,EMPTY)'), 10.0, 20.0, 30.0));
  MULTIPOINT ZM ((11 22 33 -4),(15 26 37 -8),EMPTY)