Hologres:PostGIS spatial functions

-- Install PostGIS explicitly into the public schema.
CREATE EXTENSION IF NOT EXISTS postgis SCHEMA public;

SELECT public.postgis_full_version();

PostGIS'i kaldırma

Uzantıyı kaldırmak için:

DROP EXTENSION postgis;

Veritabanında hâlâ geometry veya geography türüne bağımlı nesneler varsa — örneğin, Geometry tablosu oluşturma ve sorgulama bölümünde açıklandığı gibi oluşturulan bir tablo — deyim cannot drop extension postgis because other objects depend on it hatasıyla başarısız olur. Önce bağımlı nesneleri silin:

1. Hâlâ mekânsal bir tür kullanan nesneleri ve sütunları bulun:

   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. Sorgunun döndürdüğü her tabloyu silin veya yalnızca mekânsal sütunlarını kaldırın:

   DROP TABLE <TABLE_NAME>;

   Not

   Tablo geri dönüşüm kutusu etkinse — ki bu, Hologres V3.1 ve sonraki sürümlerde varsayılan ayardır — DROP TABLE tabloyu geri dönüşüm kutusuna taşır; bu nedenle sonraki adımı da tamamlamanız gerekir. Geri dönüşüm kutusunu atlayıp sonraki adımdan kaçınmak için bunun yerine DROP TABLE <TABLE_NAME> FORCE; komutunu çalıştırın. Daha fazla bilgi için bkz. Tablo geri dönüşüm kutusu.

3. Geri dönüşüm kutusunu boşaltın. Geri dönüşüm kutusundaki tablolar hâlâ mekânsal türlere bağımlı olduğundan, kutu boşaltılana kadar bu türler kullanımda kalır:

   CALL hologres.hg_purge_all_tables();

   Önemli

   hg_purge_all_tables() , geçerli veritabanının geri dönüşüm kutusundaki her tabloyu kalıcı olarak siler. Bu işlem geri alınamaz. Çalıştırmadan önce, geri dönüşüm kutusunda hâlâ ihtiyacınız olan bir tablo olmadığından emin olun. Bu komut, geçerli örneğin bir süper kullanıcısı tarafından çalıştırılmalıdır.

4. Uzantıyı kaldırın:

   DROP EXTENSION postgis;

spatial_ref_sys çakışmasını çözme

CREATE EXTENSION postgis komutu relation spatial_ref_sys already exists hatasıyla başarısız olursa, veritabanında önceki bir kurulumdan kalan spatial_ref_sys sistem tablosu vardır. Normal bir DROP EXTENSION postgis işlemi geride hiçbir şey bırakmaz; bu nedenle bu hata genellikle başka bir veritabanından geçiş sonrası veya aynı ada sahip bir tablonun manuel olarak oluşturulması durumunda ortaya çıkar. Çakışmayı şu şekilde çözün:

1. Kısmen yüklenmiş uzantıyı kaldırın:

   DROP EXTENSION IF EXISTS postgis;

2. Kalan sistem tablosunu kaldırın. Bu deyimi çalıştırmadan önce, tablonun önceki bir kurulumdan kalan bir kalıntı mı yoksa bir iş tablosu mu olduğunu doğrulayın:

   DROP TABLE IF EXISTS spatial_ref_sys CASCADE;

3. PostGIS uzantısını yeniden yükleyin:

   CREATE EXTENSION IF NOT EXISTS postgis SCHEMA public;

4. Yüklemeyi doğrulayın:

   SELECT public.postgis_full_version();

1. Geometry tablosu oluşturma

Tablo oluştururken bir geometry alt türü belirtebilirsiniz. Desteklenen alt türler: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon.

Alt tür olmadan:

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

Alt tür ve mekânsal referans sistemi tanımlayıcısı (SRID) ile:

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

Bu örnekte alt tür Point ve SRID 4326 (WGS 84) olarak ayarlanmıştır. SRID belirtilmezse varsayılan değer 0 olur. Eklediğiniz veya sorgu yüklemelerinde kullandığınız geometrilerin SRID'si, sütunun SRID'siyle eşleşmelidir. Aksi takdirde, deyim Geometry SRID (0) does not match column SRID (4326) veya Operation on mixed SRID geometries gibi bir hatayla başarısız olur. SRID'ler hakkında daha fazla bilgi için PostGIS belgelerine bakın.

2. Mekânsal veri ekleme

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

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

Mekânsal işlevler hakkında daha fazla bilgi için bkz. Mekânsal işlevler.

3. Mekânsal veri sorgulama

Verileri ekledikten sonra aşağıdaki türdeki sorguları çalıştırabilirsiniz.

Dikdörtgen aralık sorgusu

Bir sınırlayıcı kutu içindeki tüm noktaları döndürür.

SRID olmadan:

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

SRID ile:

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

Her iki sorgu da şu sonucu döndürür:

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

Çokgen kesişim kontrolü

Rastgele bir çokgenin içinde kalan veya sınırında yer alan noktaları bulmak için çokgenle birlikte ST_Intersects kullanın. ST_MakeBox2D tarafından oluşturulan sınırlayıcı kutunun aksine, çokgen herhangi bir şekle sahip olabilir ve ST_Intersects sınır temasını eşleşme olarak sayar.

SRID olmadan:

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 ile:

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

Her iki sorgu da şu sonucu döndürür:

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

Geometry oluşturucuları

Bu gruptaki tüm işlevler HQE üzerinde çalışır.

Geometry erişicileri

Bu gruptaki tüm işlevler HQE üzerinde çalışır; ancak ST_IsPolygonCCW işlevi PQE üzerinde çalışır. Bunlar birbirinin tamamlayıcısı değildir: dış halka ve iç halkalar aynı yönlendirmeye sahip olduğunda ikisi de false döndürür. Saat yönünün tersi yönlendirmeyi test etmek için ST_IsPolygonCW işlevini olumsuzlamayın. Büyük bir tabloyu halka yönlendirmesine göre filtrelerken, bu iki işlevin farklı motorlarda çalıştığını da göz önünde bulundurun.

Geometry düzenleyicileri

Bu gruptaki tüm işlevler HQE üzerinde çalışır.

Geometry doğrulama

Mekânsal referans sistemi işlevleri

Bu gruptaki tüm işlevler HQE üzerinde çalışır.

Geometry girişi

Geometry çıkışı

Bu gruptaki tüm işlevler HQE üzerinde çalışır.

Mekânsal ilişki yüklemeleri

Bu grupta motor işleve göre değişir. Required engine sütununa bakın.

Ölçüm işlevleri

Bindirme işlevi

Geometry işleme işlevleri

Sınırlayıcı kutu işlevleri

Bu gruptaki tüm işlevler PQE üzerinde çalışır.

Doğrusal referanslama işlevi