fungsi st_z

Berlaku untuk: pemeriksaan Databricks SQL Databricks Runtime 17.1 ke atas

Important

Fitur ini ada di Pratinjau Publik.

Nota

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

Mengembalikan koordinat Z dari nilai titik GEOMETRY input, atau NULL jika titik kosong atau tidak memiliki koordinat Z.

Syntax

st_z ( geoExpr )

Arguments

• geoExpr: Nilai GEOMETRY .

Returns

Nilai jenis DOUBLE, sama dengan koordinat Z dari nilai titik GEOMETRY input.

Fungsi mengembalikan NULL jika input adalah NULL atau jika titik kosong.

Kondisi kesalahan

• Jika nilai geoExpr bukan titik, fungsi mengembalikan ST_INVALID_ARGUMENT. INVALID_TYPE.

Examples

-- Returns the Z coordinate of a non-empty point geometry with a Z coordinate.
> SELECT st_z(st_geomfromtext('POINT Z (1 2 3)'));
  3.0
-- Returns the Z coordinate of a non-empty point geometry without a Z coordinate.
> SELECT st_z(st_geomfromtext('POINT M (2 3 4)'));
  NULL
-- Returns `NULL` for an empty point geometry.
> SELECT st_z(st_geomfromtext('POINT ZM EMPTY'));
  NULL

Fungsi terkait

• st_m fungsi
• st_x fungsi
• st_y fungsi
• st_zmax fungsi
• st_zmin fungsi