Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

ST_Z

ST_Z は、入力ポイントの z 座標を返します。

構文

ST_Z(point)

引数

戻り型

m 座標系の DOUBLE PRECISION 値。

point が null の場合、null が返されます。

point が 2D または 3DM のポイントの場合、null が返されます。

point が空のポイントの場合、null が返されます。

point が POINT でない場合、エラーが返されます。

例

次の SQL は、1 つのポイントの z 座標を、3DZ ジオメトリで返します。

SELECT ST_Z(ST_GeomFromEWKT('POINT Z (1 2 3)'));

st_z
-----------
 3                

次の SQL は、1 つのポイントの z 座標を、4D ジオメトリで返します。

SELECT ST_Z(ST_GeomFromEWKT('POINT ZM (1 2 3 4)'));

st_z
-----------
 3