MySQL には、ジオメトリ値を作成するために役立つ一連の非標準関数が用意されています。 このセクションで説明されている関数は、OpenGIS 仕様への MySQL 拡張です。
これらの関数は、引数としての WKB 値またはジオメトリオブジェクトからジオメトリオブジェクトを生成します。 いずれかの引数が適切な WKB でも、適切なオブジェクト型のジオメトリ表現でもない場合、戻り値は NULL になります。
たとえば、Point() からのジオメトリの戻り値を POINT カラムに直接挿入できます。
INSERT INTO t1 (pt_col) VALUES(Point(1,2));-
GeomCollection(g[,g] ...)ジオメトリ引数から
GeomCollection値を構築します。GeomCollection()は、サポートされていないジオメトリが存在する場合でも、引数に含まれるすべての適切なジオメトリを戻します。引数のない
GeomCollection()は、空のジオメトリを作成する方法として許可されています。 また、WKT ジオメトリコレクション引数を受け入れるST_GeomFromText()などの関数は、OpenGIS'GEOMETRYCOLLECTION EMPTY'標準構文と MySQL'GEOMETRYCOLLECTION()'非標準構文の両方を理解します。GeomCollection()とGeometryCollection()は同義ですが、GeomCollection()を使用することをお薦めします。 -
GeometryCollection(g[,g] ...)ジオメトリ引数から
GeomCollection値を構築します。GeometryCollection()は、サポートされていないジオメトリが存在する場合でも、引数に含まれるすべての適切なジオメトリを戻します。引数のない
GeometryCollection()は、空のジオメトリを作成する方法として許可されています。 また、WKT ジオメトリコレクション引数を受け入れるST_GeomFromText()などの関数は、OpenGIS'GEOMETRYCOLLECTION EMPTY'標準構文と MySQL'GEOMETRYCOLLECTION()'非標準構文の両方を理解します。GeomCollection()とGeometryCollection()は同義ですが、GeomCollection()を使用することをお薦めします。 -
LineString(pt[,pt] ...)複数の
Pointまたは WKBPoint引数からLineString値を構築します。 引数の数が 2 未満の場合、戻り値はNULLになります。 -
MultiLineString(ls[,ls] ...)LineStringまたは WKBLineString引数を使用してMultiLineString値を構築します。 -
MultiPoint(pt[,pt2] ...)Pointまたは WKBPoint引数を使用してMultiPoint値を構築します。 -
MultiPolygon(poly[,poly] ...)一連の
Polygonまたは WKBPolygon引数からMultiPolygon値を構築します。 -
Point(x,y)座標を使用して
Pointを構築します。 -
Polygon(ls[,ls] ...)複数の
LineStringまたは WKBLineString引数からPolygon値を構築します。 いずれかの引数がLinearRingを表していない (つまり、閉じた単純なLineStringでない) 場合、戻り値はNULLになります。