fungsi st_makepoint

Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 18.2 ke atas

Nota

Fitur ini tidak tersedia di gudang Databricks SQL Classic. Untuk mempelajari selengkapnya tentang gudang Databricks SQL, lihat Jenis gudang SQL.

Mengembalikan nilai titik GEOMETRY dengan koordinat yang diberikan. Fungsi ini mengambil 2, 3, atau 4 DOUBLE nilai, mewakili koordinat titik (x, y), (x, y, z), atau (x, y, z, m).

Syntax

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

Arguments

  • x: Nilai DOUBLE , yang mewakili koordinat pertama titik.
  • y: Nilai DOUBLE , mewakili koordinat kedua titik.
  • z: Nilai opsional DOUBLE , mewakili koordinat ketiga (Z) dari titik tersebut.
  • m: Nilai opsional DOUBLE , mewakili koordinat keempat (M) titik.

Returns

Nilai jenis GEOMETRY, mewakili titik dengan koordinat yang ditentukan.

Nilai SRID dari geometri yang dikembalikan selalu 0.

Jumlah koordinat input menentukan dimensi titik yang dikembalikan: 2D jika Anda hanya menyediakan dan x, 3DZ jika Anda juga menyediakan y, atau 4D jika Anda menyediakan keempat koordinat (z, , xy, dan z).m

Fungsi mengembalikan NULL jika salah satu input adalah NULL.

Examples

-- 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