すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_ZMin

最終更新日:Mar 28, 2026

Box2D、Box3D、またはジオメトリオブジェクトのバウンディングボックスにおける最小 z 座標を返します。

構文

float ST_ZMin(box3d aGeomorBox2DorBox3D);

パラメーター

パラメーター説明
aGeomorBox2DorBox3DBox2D、Box3D、またはジオメトリオブジェクトです。

注意事項

パラメーター型は box3d として定義されていますが、ST_ZMin は自動キャストにより Box2D およびジオメトリ値も受け付けます。ただし、Box2D またはジオメトリ値を文字列リテラルとして渡すと、自動キャストがバイパスされ、エラーが発生します。文字列形式の入力を利用する場合は、ST_GeomFromEWKT を使用するか、明示的なキャスト式(::geometry)で変換してください。

その他の動作:

  • z 座標を保持します — 3D オブジェクトから z ディメンションを削除しません。

  • 円弧文字列(circular strings)および曲線をサポートします。

LineString の最小 z 座標を取得

SELECT ST_ZMin('LINESTRING(0 1 2,3 4 5)'::geometry);
 st_zmin
---------
       2
(1 行)

Box3D の最小 z 座標を取得

SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');
 st_zmin
---------
       3
(1 行)

ST_GeomFromEWKT を使用してジオメトリ文字列を渡す

SELECT ST_ZMin(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));
 st_zmin
---------
       4
(1 行)

ジオメトリ文字列を直接渡すとエラーが発生

-- このクエリは失敗します。文字列は box3d へ自動キャストされないためです。
SELECT ST_ZMin('LINESTRING(1 3 4, 5 6 7)');
-- ERROR: BOX3D parser - doesn't start with BOX3D(

次のステップ

  • ST_ZMax:バウンディングボックスの最大の z 座標を返します。

  • ST_XMin: バウンディングボックスの最小 x 座標を返します。

  • ST_YMin: バウンディングボックスの最小の y 座標を返します。