ST_ToGeomColl メソッド

geometry-expression.ST_ToGeomColl()

ST_GeomCollection geometry-expression が ST_GeomCollection タイプの場合は、geometry-expression を返します。geometry-expression が ST_Point、ST_Curve、または ST_Surface タイプの場合は、1 つの要素 (geometry-expression) を含むジオメトリコレクションを返します。geometry-expression が空のセットの場合は、ST_GeomCollection タイプの空のセットを返します。それ以外の場合は、例外条件が発生します。
結果の空間参照系識別子は、geometry-expression の空間参照系と同じです。

geometry-expression が ST_GeomCollection 値であるとすでにわかっている場合は、ST_ToGeomColl メソッドよりも TREAT( geometry-expression AS ST_GeomCollection ) を使用する方が効率的です。

注意

ST_ToGeomColl では、デフォルトで、使用可能な場合はジオメトリの元のフォーマットが使用されます。それ以外の場合は、内部フォーマットが使用されます。内部フォーマットと元のフォーマットの詳細については、STORAGE FORMAT 句、CREATE SPATIAL REFERENCE SYSTEM 文を参照してください。

SQL/MM (ISO/IEC 13249-3: 2006) 5.1.33

次の例では、結果として GeometryCollection (Point (0 1)) を返します。

SELECT NEW ST_Point( 0, 1 ).ST_ToGeomColl()

ST_ToGeomColl メソッド

構文

戻り値

備考

注意

参照

標準と互換性

例