Documentation Home
MySQL 8.0 リファレンスマニュアル
Download this Manual
PDF (US Ltr) - 36.1Mb
PDF (A4) - 36.2Mb


MySQL 8.0 リファレンスマニュアル  / ...  / 関数と演算子  / 空間分析関数  /  ジオメトリ値を作成する MySQL 固有の関数

このページは機械翻訳したものです。

12.17.5 ジオメトリ値を作成する MySQL 固有の関数

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 になります。