Hologres:Fungsi spasial PostGIS

Uninstal PostGIS

Untuk menghapus ekstensi:

DROP EXTENSION postgis;

Jika database masih berisi objek yang bergantung pada tipe geometry atau geography — misalnya, tabel yang dibuat seperti dijelaskan dalam Buat dan kueri tabel geometry — pernyataan tersebut akan gagal dengan pesan cannot drop extension postgis because other objects depend on it. Hapus terlebih dahulu objek yang bergantung tersebut:

1. Cari objek dan kolom yang masih menggunakan tipe spasial:

   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. Hapus setiap tabel yang dikembalikan oleh kueri, atau hapus hanya kolom spasialnya:

   DROP TABLE <TABLE_NAME>;

   Catatan

   Jika recycle bin tabel diaktifkan — yang merupakan pengaturan default di Hologres V3.1 dan versi lebih baru — DROP TABLE memindahkan tabel ke recycle bin, sehingga Anda harus menyelesaikan langkah berikutnya. Untuk melewati recycle bin dan menghindari langkah berikutnya, jalankan DROP TABLE <TABLE_NAME> FORCE;. Untuk informasi lebih lanjut, lihat Recycle bin tabel.

3. Kosongkan recycle bin. Tabel di recycle bin masih bergantung pada tipe spasial, sehingga tipe tersebut tetap sedang digunakan sampai recycle bin dikosongkan:

   CALL hologres.hg_purge_all_tables();

   Penting

   hg_purge_all_tables() menghapus secara permanen semua tabel di recycle bin database saat ini. Tindakan ini tidak dapat dibatalkan. Sebelum menjalankannya, pastikan recycle bin tidak berisi tabel yang masih Anda perlukan. Perintah ini harus dijalankan oleh superuser instans saat ini.

4. Uninstal ekstensi:

   DROP EXTENSION postgis;

Selesaikan konflik spatial_ref_sys

Jika CREATE EXTENSION postgis gagal dengan error relation spatial_ref_sys already exists, database berisi sisa tabel sistem spatial_ref_sys dari instalasi sebelumnya. Perintah DROP EXTENSION postgis biasa tidak meninggalkan sisa apa pun, sehingga error ini biasanya muncul setelah migrasi dari database lain atau ketika tabel dengan nama yang sama dibuat secara manual. Selesaikan konflik sebagai berikut:

1. Hapus ekstensi yang terinstal sebagian:

   DROP EXTENSION IF EXISTS postgis;

2. Hapus tabel sistem sisa. Sebelum menjalankan pernyataan ini, pastikan bahwa tabel tersebut merupakan sisa dari instalasi sebelumnya, bukan tabel bisnis:

   DROP TABLE IF EXISTS spatial_ref_sys CASCADE;

3. Instal ulang ekstensi PostGIS:

   CREATE EXTENSION IF NOT EXISTS postgis SCHEMA public;

4. Verifikasi instalasi:

   SELECT public.postgis_full_version();

1. Buat tabel geometry

Saat membuat tabel, Anda dapat menentukan subtipe geometry. Subtipe yang didukung: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon.

Tanpa subtipe:

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

Dengan subtipe dan identifier sistem referensi spasial (SRID):

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

Pada contoh ini, subtipe adalah Point dan SRID-nya adalah 4326 (WGS 84). Jika SRID tidak ditentukan, nilai default-nya adalah 0. SRID geometri yang Anda masukkan atau gunakan dalam predikat kueri harus sesuai dengan SRID kolom. Jika tidak, pernyataan akan gagal dengan error seperti Geometry SRID (0) does not match column SRID (4326) atau Operation on mixed SRID geometries. Untuk informasi lebih lanjut tentang SRID, lihat dokumentasi PostGIS.

2. Masukkan data spasial

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

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

Untuk informasi lebih lanjut tentang fungsi spasial, lihat Fungsi spasial.

3. Kueri data spasial

Setelah memasukkan data, Anda dapat menjalankan jenis kueri berikut.

Kueri rentang persegi panjang

Mengembalikan semua titik dalam kotak pembatas.

Tanpa SRID:

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

Dengan 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
);

Kedua kueri mengembalikan:

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);

Pemeriksaan irisan poligon

Untuk menemukan titik yang berada di dalam poligon arbitrer atau berada di batasnya, gunakan ST_Intersects dengan poligon tersebut. Berbeda dengan kotak pembatas yang dibuat oleh ST_MakeBox2D, poligon dapat memiliki bentuk apa pun, dan ST_Intersects menganggap kontak batas sebagai kecocokan.

Tanpa 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
);

Dengan 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
);

Kedua kueri mengembalikan:

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

Konstruktor geometry

Semua fungsi dalam kelompok ini berjalan di HQE.

Aksesor geometry

Semua fungsi dalam kelompok ini berjalan di HQE, kecuali ST_IsPolygonCCW, yang berjalan di PQE. Fungsi-fungsi ini bukan komplemen: ketika cincin luar dan cincin dalam memiliki orientasi yang sama, keduanya mengembalikan false. Jangan menegasikan ST_IsPolygonCW untuk menguji orientasi berlawanan arah jarum jam. Saat Anda memfilter tabel besar berdasarkan orientasi cincin, perhatikan juga bahwa kedua fungsi ini berjalan di mesin yang berbeda.

Editor geometry

Semua fungsi dalam kelompok ini berjalan di HQE.

Validasi geometry

Fungsi sistem referensi spasial

Semua fungsi dalam kelompok ini berjalan di HQE.

Input geometry

Output geometry

Semua fungsi dalam kelompok ini berjalan di HQE.

Predikat hubungan spasial

Mesin bervariasi tergantung fungsinya dalam kelompok ini. Lihat kolom Mesin yang diperlukan.

Fungsi pengukuran

Fungsi overlay

Fungsi pemrosesan geometry

Fungsi kotak pembatas

Semua fungsi dalam kelompok ini berjalan di PQE.

Fungsi referencing linear