Hologres:PostGIS 空間関数

PostGIS のアンインストール

拡張機能を削除するには、次を実行します。

DROP EXTENSION postgis;

データベースにまだ geometry または geography 型に依存するオブジェクト (例えば、「ジオメトリテーブルの作成とクエリ」で説明されているように作成されたテーブル) が含まれている場合、ステートメントは cannot drop extension postgis because other objects depend on it で失敗します。まず依存オブジェクトを削除してください。

1. まだ空間型を使用しているオブジェクトと列を見つけます。

   SELECT n.nspname AS schema_name, c.relname AS object_name, a.attname AS column_name, t.typname
   FROM pg_attribute a
     JOIN pg_class c ON c.oid = a.attrelid
     JOIN pg_type t ON t.oid = a.atttypid
     JOIN pg_namespace n ON n.oid = c.relnamespace
   WHERE t.typname IN ('geometry', 'geography')
     AND c.relkind IN ('r', 'p', 'm', 'f')
     AND a.attnum > 0
     AND NOT a.attisdropped
     AND n.nspname NOT LIKE 'pg_%';

2. クエリによって返された各テーブルを削除するか、その空間列のみを削除します。

   DROP TABLE <TABLE_NAME>;

   説明

   テーブルのごみ箱が有効になっている場合 (Hologres V3.1 以降のデフォルト)、DROP TABLE はテーブルをごみ箱に移動するため、次のステップも完了する必要があります。ごみ箱をバイパスして次のステップをスキップするには、代わりに DROP TABLE <TABLE_NAME> FORCE; を実行します。詳細については、「テーブルのごみ箱」をご参照ください。

3. ごみ箱を空にします。ごみ箱内のテーブルはまだ空間型に依存しているため、ごみ箱が空になるまで型は使用中のままです。

   CALL hologres.hg_purge_all_tables();

   重要

   hg_purge_all_tables() は、現在のデータベースのごみ箱にあるすべてのテーブルを完全に削除します。この操作は元に戻せません。実行する前に、ごみ箱にまだ必要なテーブルがないことを確認してください。このコマンドは、現在のインスタンスのスーパーユーザーが実行する必要があります。

4. 拡張機能をアンインストールします。

   DROP EXTENSION postgis;

spatial_ref_sys の競合解決

CREATE EXTENSION postgis がエラー relation spatial_ref_sys already exists で失敗した場合、データベースには以前のインストールから残された spatial_ref_sys システムテーブルが含まれています。通常の DROP EXTENSION postgis は何も残さないため、このエラーは通常、別のデータベースからの移行後、または同じ名前のテーブルが手動で作成された場合に表示されます。次のように競合を解決します。

1. 部分的にインストールされた拡張機能を削除します。

   DROP EXTENSION IF EXISTS postgis;

2. 残されたシステムテーブルを削除します。このステートメントを実行する前に、テーブルが以前のインストールからの残り物であり、業務テーブルではないことを確認してください。

   DROP TABLE IF EXISTS spatial_ref_sys CASCADE;

3. PostGIS 拡張機能を再インストールします。

   CREATE EXTENSION IF NOT EXISTS postgis SCHEMA public;

4. インストールを検証します。

   SELECT public.postgis_full_version();

1. ジオメトリテーブルの作成

テーブルを作成する際に、ジオメトリのサブタイプを指定できます。サポートされているサブタイプ：Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon。

サブタイプなし：

CREATE TABLE holo_gis_1 (
  id   INT,
  geom geometry,
  PRIMARY KEY (id)
);

サブタイプと空間参照系識別子 (SRID) あり：

CREATE TABLE holo_gis_2 (
  id   INT,
  geom geometry(point, 4326),
  PRIMARY KEY (id)
);

この例では、サブタイプは Point で、SRID は 4326 (WGS 84) です。SRID が指定されていない場合、デフォルトは 0 です。挿入またはクエリ述語で使用するジオメトリの SRID は、列の SRID と一致する必要があります。そうでない場合、ステートメントは Geometry SRID (0) does not match column SRID (4326) や Operation on mixed SRID geometries などのエラーで失敗します。SRID の詳細については、「PostGIS ドキュメント」をご参照ください。

2. 空間データの挿入

-- SRID なし
INSERT INTO holo_gis_1 VALUES (1, ST_GeomFromText('point(116 39)'));

-- SRID 4326 あり
INSERT INTO holo_gis_2 VALUES (1, ST_GeomFromText('point(116 39)', 4326));

空間関数の詳細については、「空間関数」をご参照ください。

3. 空間データのクエリ

データを挿入した後、次の種類のクエリを実行できます。

矩形範囲クエリ

バウンディングボックス内のすべてのポイントを返します。

SRID なし：

SELECT st_astext(geom)
FROM holo_gis_1
WHERE ST_Covers(
  ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)),
  geom
);

SRID あり：

SELECT st_astext(geom)
FROM holo_gis_2
WHERE ST_Covers(
  ST_SetSRID(ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40)), 4326),
  geom
);

両方のクエリが返す結果：

st_astext
-------------
POINT(116 39)

SELECT st_astext(geom)
FROM holo_gis_1
WHERE geom && ST_MakeBox2D(ST_Point(116, 39), ST_Point(117, 40))
  AND ST_Intersects(ST_GeomFromText('POLYGON((116 39,117 39,117 40,116 40,116 39))'), geom);

ポリゴン交差チェック

任意のポリゴン内に収まる、またはその境界上にあるポイントを見つけるには、ポリゴンで ST_Intersects を使用します。ST_MakeBox2D によって構築されたバウンディングボックスとは異なり、ポリゴンは任意の形状を持つことができ、ST_Intersects は境界の接触を一致としてカウントします。

SRID なし：

SELECT st_astext(geom)
FROM holo_gis_1
WHERE ST_Intersects(
  ST_GeomFromText('POLYGON((116 39,117 39,117 40,116 40,116 39))'),
  geom
);

SRID を使用する場合:

SELECT st_astext(geom)
FROM holo_gis_2
WHERE ST_Intersects(
  ST_SetSRID(ST_GeomFromText('POLYGON((116 39,117 39,117 40,116 40,116 39))'), 4326),
  geom
);

どちらのクエリも以下を返します：

st_astext
-------------
POINT(116 39)

ジオメトリコンストラクター

このグループのすべての関数は HQE で実行されます。

ジオメトリアクセサー

このグループのすべての関数は HQE で実行されますが、ST_IsPolygonCCW は PQE で実行されます。これらは補完的ではありません。外環と内環の向きが同じ場合、両方とも false を返します。反時計回りの向きをテストするために ST_IsPolygonCW を否定しないでください。大きなテーブルを環の向きでフィルタリングする場合、これら 2 つの関数が異なるエンジンで実行されることにも注意してください。

ジオメトリエディター

このグループのすべての関数は HQE で実行されます。

ジオメトリの検証

空間参照系関数

このグループのすべての関数は HQE で実行されます。

ジオメトリ入力

ジオメトリ出力

このグループのすべての関数は HQE で実行されます。

空間関係述語

このグループのエンジンは関数によって異なります。[必須エンジン] 列をご参照ください。

計測関数

オーバーレイ関数

ジオメトリ処理関数

バウンディングボックス関数

このグループのすべての関数は PQE で実行されます。

線形参照関数