このトピックでは、Lindorm GanosBase でサポートされているコンストラクター関数について説明します。コンストラクター関数を使用すると、特定のジオメトリオブジェクトを直接、または既存の Well-known Text(WKT)文字列またはジオメトリオブジェクトに基づいて構築できます。
適用可能なエンジンとバージョン
このトピックで説明するコンストラクター関数は、LindormTable にのみ適用されます。
このトピックで説明されている集計関数は、LindormTable 2.6.5 以降のバージョンでサポートされています。 LindormTable のバージョンを表示またはアップグレードする方法の詳細については、「LindormTable のリリースノート」および「Lindorm インスタンスのマイナーエンジンバージョンをアップグレードする」をご参照ください。
Lindorm SQL のバージョンは 2.6.8 以降である必要があります。 Lindorm SQL のバージョンの表示方法の詳細については、「SQL バージョン」をご参照ください。
関数
次の表に、Lindorm GanosBase でサポートされているコンストラクター関数を示します。
関数 | 説明 |
指定された WKT 文字列に基づいてジオメトリオブジェクトを構築します。 | |
指定された MultiPoint オブジェクトに基づいて LineString オブジェクトを構築します。 | |
ポイントオブジェクトを構築します。 |
ST_GeomFromText
ST_GeomFromText 関数は、指定された WKT 文字列に基づいてジオメトリオブジェクトを構築します。
構文
geometry ST_GeomFromText(string wkt)パラメーター
パラメーター | 説明 |
wkt | ジオメトリオブジェクトの構築に使用する WKT 文字列。 |
この関数を呼び出すことで、Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon、および GeometryCollection のオブジェクトタイプを構築できます。
この関数は、Spatial Reference Identifier(SRID)を含む WKT 文字列をサポートしていません。構築するジオメトリオブジェクトの SRID(デフォルトは 4326)を格納する列をデータベースに作成できます。
サポートされているデータ型の空のジオメトリオブジェクトを構築できます。
例
例 1:ポイントオブジェクトを構築する。
SELECT ST_GeomFromText('POINT(1 1)') as geom;次の結果が返されます。
+-------------+ | geom | +-------------+ | POINT (1 1) | +-------------+例 2:ポリゴンオブジェクトを構築する。
SELECT ST_GeomFromText('POLYGON (( 1 1, 1 2, 2 2, 2 1, 1 1))') AS poly;次の結果が返されます。
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | poly | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 0020000003000010E600000001000000053FF00000000000003FF00000000000003FF000000000000040000000000000004000000000000000400000000000000040000000000000003FF00000000000003FF00000000000003FF0000000000000 | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+例 3:空のポリゴンオブジェクトを構築する。
SELECT ST_GeomFromText('POLYGON EMPTY') as geom;次の結果が返されます。
+---------------+ | geom | +---------------+ | POLYGON EMPTY | +---------------+
ST_LineFromMultiPoint
ST_LineFromMultiPoint 関数は、指定された MultiPoint オブジェクトに基づいて LineString オブジェクトを構築します。
構文
geometry ST_LineFromMultiPoint(geometry aMultiPoint)パラメーター
パラメーター | 説明 |
aMultiPoint |
|
例
SELECT ST_AsText(ST_LineFromMultiPoint(ST_Collect(ST_MakePoint(1,2),ST_MakePoint(3,4),ST_MakePoint(5,6)))) AS astext;次の結果が返されます。
+-------------------------+
| astext |
+-------------------------+
| LINESTRING(1 2,3 4,5 6) |
+-------------------------+ST_MakePoint
ST_MakePoint 関数は、ポイントオブジェクトを構築します。
構文
geometry ST_MakePoint(double x, double y)パラメーター
パラメーター | 説明 |
x | 構築するポイントオブジェクトの経度。このパラメーターの値は、DOUBLE 型の数値です。 INTEGER 型または LONG 型の数を指定すると、自動的に DOUBLE 型に変換されます。 |
y | 構築するポイントオブジェクトの緯度。このパラメーターの値は、DOUBLE 型の数値です。 INTEGER 型または LONG 型の数を指定すると、自動的に DOUBLE 型に変換されます。 |
この関数は、空間参照系(SRS)情報のない 2D ポイントオブジェクトのみを構築するために使用できます。
例
SELECT ST_AsText(ST_MakePoint(1, 2)) as text;次の結果が返されます。
+-------------+
| text |
+-------------+
| POINT (1 2) |
+-------------+