st_makepoint Funktion

Gilt für:Angekreuzt mit ja Databricks SQL angehakt ja Databricks Runtime 18.2 und höher Check-marked ja Lakehouse//RT

Note

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

Gibt einen Punktwert GEOMETRY mit den angegebenen Koordinaten zurück. Die Funktion akzeptiert 2,3 oder 4 DOUBLE Werte, die die Koordinaten (x, y), (x, y, z) oder (x, y, z, m) des Punkts darstellen.

Syntax

st_makepoint ( x, y [, z [, m ] ] )

Arguments

  • x: Ein DOUBLE Wert, der die erste Koordinate des Punktes darstellt.
  • y: Ein DOUBLE Wert, der die zweite Koordinate des Punktes repräsentiert.
  • z: Ein optionaler DOUBLE Wert, der die dritte (Z)-Koordinate des Punktes repräsentiert.
  • m: Ein optionaler DOUBLE Wert, der die vierte (M) Koordinate des Punktes darstellt.

Rückkehr

Ein Wert vom Typ GEOMETRY, der einen Punkt mit den angegebenen Koordinaten darstellt.

Der SRID-Wert der zurückgegebenen Geometrie ist immer 0.

Die Anzahl der Eingabekoordinaten bestimmt die Dimension des zurückgegebenen Punkts: 2D, wenn Sie nur x angeben und y, 3DZ, wenn Sie auch zangeben , oder 4D, wenn Sie alle vier Koordinaten (x, y, zund m).

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

Beispiele

-- Creates a 2D point with coordinates (10, 34).
> SELECT st_astext(st_makepoint(10.0, 34.0));
  POINT(10 34)
-- Creates a 3DZ point with coordinates (1, 2, 3).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0));
  POINT Z (1 2 3)
-- Creates a 4D point with coordinates (1, 2, 3, 4).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0, 4.0));
  POINT ZM (1 2 3 4)

-- The SRID of the returned geometry is always 0.
> SELECT st_srid(st_makepoint(10.0, 34.0));
  0
-- The type of the returned geometry is always geometry(0).
> SELECT typeof(st_makepoint(10.0, 34.0));
  geometry(0)

-- The function returns NULL if any of the inputs is NULL.
> SELECT st_astext(st_makepoint(10.0, NULL));
  NULL