نزّل أرشيف مصدر PostGIS من موقع التنزيلات https://download.osgeo.org/postgis/source/postgis-3.6.4.tar.gz

wget https://download.osgeo.org/postgis/source/postgis-3.6.4.tar.gz
tar -xvzf postgis-3.6.4.tar.gz
cd postgis-3.6.4

سيُنشئ هذا دليلًا باسم postgis-3.6.4 في دليل العمل الحالي.

بدلًا من ذلك، اسحب المصدر من مستودع git ‏ https://git.osgeo.org/gitea/postgis/postgis/ .

git clone https://git.osgeo.org/gitea/postgis/postgis.git postgis
cd postgis
sh autogen.sh
    

انتقل إلى الدليل postgis المُنشأ حديثًا لمتابعة التثبيت.

./configure

لـ PostGIS المتطلبات التالية للبناء والاستخدام:

إلزامية

اختيارية

كما في معظم عمليات التثبيت على Linux، تتمثل الخطوة الأولى في توليد ملف Makefile الذي سيُستخدم لبناء الشيفرة المصدرية. ويتم ذلك بتشغيل سكربت الصدفة

./configure

من دون معاملات إضافية، سيحاول هذا الأمر تحديد موقع المكوّنات والمكتبات اللازمة لبناء الشيفرة المصدرية لـ PostGIS على نظامك تلقائيًا. ومع أن هذا هو الاستخدام الأكثر شيوعًا لـ ./configure، فإن السكربت يقبل عدة معاملات لمن لديهم المكتبات والبرامج اللازمة في مواقع غير قياسية.

تعرض القائمة التالية المعاملات الأكثر استخدامًا فقط. وللاطلاع على القائمة الكاملة، استخدم المعاملين --help أو --help=short.

	إذا حصلت على PostGIS من مستودع الشيفرة ، فإن الخطوة الأولى في الواقع هي تشغيل السكربت ./autogen.sh سيولّد هذا السكربت سكربت configure الذي يُستخدم بدوره لتخصيص تثبيت PostGIS. أما إذا حصلت على PostGIS في صورة أرشيف tar، فلا حاجة إلى تشغيل ./autogen.sh لأن configure قد وُلّد مسبقًا.

بعد توليد ملف Makefile، يصبح بناء PostGIS بسيطًا بتشغيل

make

يجب أن يكون السطر الأخير من المخرجات "PostGIS was built successfully. Ready to install."

بدءًا من PostGIS v1.4.0، لجميع الدوال تعليقات مولَّدة من التوثيق. وإذا رغبت في تثبيت هذه التعليقات في قواعد بياناتك المكانية لاحقًا، فشغّل الأمر الذي يتطلب docbook. كما أن الملف postgis_comments.sql وملفات تعليقات الحزم الأخرى raster_comments.sql وtopology_comments.sql مضمَّنة في توزيعة tar.gz داخل المجلد doc، لذا لا حاجة إلى بناء التعليقات عند التثبيت من أرشيف tar. والتعليقات مضمَّنة أيضًا ضمن التثبيت باستخدام CREATE EXTENSION.

make comments

قُدّمت في PostGIS 2.0. يولّد هذا أوراق مرجعية مختصرة بصيغة html مناسبة للرجوع السريع أو للتوزيع على الطلاب. ويتطلب بناؤها xsltproc وسيولّد 4 ملفات في المجلد doc: topology_cheatsheet.html وtiger_geocoder_cheatsheet.html وraster_cheatsheet.html وpostgis_cheatsheet.html

يمكنك تنزيل بعض النسخ المبنية مسبقًا بصيغتي html وpdf من أدلة دراسة PostGIS / PostgreSQL

make cheatsheets

تُبنى امتدادات PostGIS وتُثبَّت تلقائيًا إذا كنت تستخدم PostgreSQL 9.1+.

إذا كنت تبني من مستودع المصدر، فعليك بناء أوصاف الدوال أولًا. وهي تُبنى إذا كان docbook مثبتًا. ويمكنك أيضًا بناؤها يدويًا بالتعليمة:

make comments

لا حاجة إلى بناء التعليقات إذا كنت تبني من أرشيف tar لإصدار رسمي، لأنها مضمَّنة فيه مبنية مسبقًا.

يجب أن تُبنى الامتدادات تلقائيًا ضمن عملية make install. ويمكنك عند الحاجة البناء من مجلدات الامتدادات أو نسخ الملفات إذا احتجت إليها على خادم آخر.

cd extensions
cd postgis
make clean
make
export PGUSER=postgres #overwrite psql variables
make check #to test before install
make install
# to test extensions
make check RUNTESTFLAGS=--extension

	يستخدم make check الأداة psql لتشغيل الاختبارات، ولذلك يمكنه استخدام متغيرات بيئة psql. ومن المتغيرات الشائعة المفيدة لتجاوز قيمها PGUSER وPGPORT وPGHOST. راجع متغيرات بيئة psql

تكون ملفات الامتداد دائمًا متطابقة للإصدار نفسه من PostGIS وPostgreSQL بغض النظر عن نظام التشغيل، لذا لا بأس بنسخ ملفات الامتداد من نظام تشغيل إلى آخر ما دامت البرامج الثنائية لـ PostGIS مثبتة بالفعل على خوادمك.

إذا أردت تثبيت الامتدادات يدويًا على خادم منفصل غير خادم التطوير، فعليك نسخ الملفات التالية من مجلد الامتدادات إلى المجلد PostgreSQL / share / extension في تثبيت PostgreSQL لديك، إضافة إلى البرامج الثنائية اللازمة لـ PostGIS العادي إذا لم تكن موجودة بالفعل على الخادم.

بعد ذلك، يُفترض أن ترى postgis وpostgis_topology بوصفهما امتدادين متاحين في PgAdmin -> extensions.

إذا كنت تستخدم psql، يمكنك التحقق من تثبيت الامتدادات بتشغيل هذا الاستعلام:

SELECT name, default_version,installed_version
FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%';

             name             | default_version | installed_version
------------------------------+-----------------+-------------------
 address_standardizer         | 3.6.4         | 3.6.4
 address_standardizer_data_us | 3.6.4         | 3.6.4
 postgis                      | 3.6.4         | 3.6.4
 postgis_raster               | 3.6.4         | 3.6.4
 postgis_sfcgal               | 3.6.4         |
 postgis_tiger_geocoder       | 3.6.4         | 3.6.4
 postgis_topology             | 3.6.4         |
(6 rows)

إذا كان الامتداد مثبتًا في قاعدة البيانات التي تستعلمها، فسترى ذلك مذكورًا في العمود installed_version. وإذا لم تحصل على أي سجلات، فهذا يعني أن امتدادات postgis غير مثبتة على الخادم إطلاقًا. كما يوفّر PgAdmin III 1.14+ هذه المعلومات في القسم extensions من شجرة مستعرض قاعدة البيانات، بل ويتيح الترقية أو إلغاء التثبيت بالنقر بزر الفأرة الأيمن.

إذا كانت الامتدادات متاحة لديك، يمكنك تثبيت امتداد postgis في قاعدة البيانات التي تختارها إما باستخدام واجهة الامتدادات في pgAdmin أو بتشغيل أوامر SQL التالية:

CREATE EXTENSION postgis;
CREATE EXTENSION postgis_raster;
CREATE EXTENSION postgis_sfcgal;
CREATE EXTENSION fuzzystrmatch; --needed for postgis_tiger_geocoder
--optional used by postgis_tiger_geocoder, or can be used standalone
CREATE EXTENSION address_standardizer;
CREATE EXTENSION address_standardizer_data_us;
CREATE EXTENSION postgis_tiger_geocoder;
CREATE EXTENSION postgis_topology;

في psql يمكنك استخدام ما يلي لمعرفة الإصدارات المثبتة لديك وكذلك المخطط الذي ثُبّتت فيه.

\connect mygisdb
\x
\dx postgis*

List of installed extensions
-[ RECORD 1 ]-------------------------------------------------
Name        | postgis
Version     | 3.6.4
Schema      | public
Description | PostGIS geometry, geography, and raster spat..
-[ RECORD 2 ]-------------------------------------------------
Name        | postgis_raster
Version     | 3.0.0dev
Schema      | public
Description | PostGIS raster types and functions
-[ RECORD 3 ]-------------------------------------------------
Name        | postgis_tiger_geocoder
Version     | 3.6.4
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.6.4
Schema      | topology
Description | PostGIS topology spatial types and functions

لا يمكن نسخ جداول الامتدادات spatial_ref_sys وlayer وtopology احتياطيًا بشكل صريح. إذ لا تُنسخ احتياطيًا إلا عند النسخ الاحتياطي للامتداد المقابل postgis أو postgis_topology، وهو ما يبدو أنه لا يحدث إلا عند النسخ الاحتياطي لقاعدة البيانات كاملة. وبدءًا من PostGIS 2.0.1، لا تُنسخ احتياطيًا عند النسخ الاحتياطي لقاعدة البيانات إلا سجلات srid غير المضمَّنة مع PostGIS، لذا لا تغيّر قيم srid التي نضمّنها وتتوقع أن تبقى تغييراتك. افتح تذكرة إذا وجدت مشكلة. ولا تُنسخ بنى جداول الامتدادات احتياطيًا أبدًا لأنها تُنشأ باستخدام CREATE EXTENSION ويُفترض أنها متطابقة لإصدار معيّن من الامتداد. وهذه السلوكيات مدمجة في نموذج الامتدادات الحالي في PostgreSQL، لذا لا يمكننا فعل شيء حيالها.

إذا ثبّتّ 3.6.4 دون استخدام نظام الامتدادات الرائع لدينا، يمكنك تحويله ليصبح قائمًا على الامتدادات بتشغيل الأوامر أدناه لتضمين الدوال في الامتدادات الخاصة بها. وقد أُزيل التثبيت باستخدام `unpackaged` في PostgreSQL 13، لذا يُنصح بالتحول إلى بناء قائم على الامتدادات قبل الترقية إلى PostgreSQL 13.

CREATE EXTENSION postgis FROM unpackaged;
CREATE EXTENSION postgis_raster FROM unpackaged;
CREATE EXTENSION postgis_topology FROM unpackaged;
CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;

إذا رغبت في اختبار بناء PostGIS، فشغّل

make check

سيُجري الأمر أعلاه فحوصًا واختبارات انحدار متنوعة باستخدام المكتبة المولَّدة على قاعدة بيانات PostgreSQL فعلية.

	إذا هيّأت PostGIS باستخدام مواقع غير قياسية لـ PostgreSQL أو GEOS أو Proj، فقد تحتاج إلى إضافة مواقع مكتباتها إلى متغير البيئة LD_LIBRARY_PATH.

	حاليًا، يعتمد make check على متغيري البيئة PATH وPGPORT عند إجراء الفحوص، ولا يستخدم إصدار PostgreSQL الذي ربما حُدِّد عبر معامل التهيئة --with-pgconfig. لذا احرص على تعديل PATH ليطابق تثبيت PostgreSQL المُكتشَف أثناء التهيئة، أو استعد للتعامل مع المتاعب القادمة.

عند النجاح، سيُنتج make check مخرجات ما يقارب 500 اختبار. وستبدو النتائج مشابهة لما يلي (مع حذف أسطر كثيرة أدناه):

CUnit - A unit testing framework for C - Version 2.1-3
     http://cunit.sourceforge.net/

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     44     44    n/a      0        0
               tests    300    300    300      0        0
             asserts   4215   4215   4215      0      n/a
Elapsed time =    0.229 seconds

        .
        .
        .

Running tests

        .
        .
        .

Run tests: 134
Failed: 0


-- if you build with SFCGAL

        .
        .
        .

Running tests

        .
        .
        .

Run tests: 13
Failed: 0

-- if you built with raster support

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     12     12    n/a      0        0
               tests     65     65     65      0        0
             asserts  45896  45896  45896      0      n/a


        .
        .
        .

Running tests

        .
        .
        .

Run tests: 101
Failed: 0

-- topology regress

.
.
.

Running tests

        .
        .
        .

Run tests: 51
Failed: 0

-- if you built --with-gui, you should see this too

     CUnit - A unit testing framework for C - Version 2.1-2
     http://cunit.sourceforge.net/

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      2      2    n/a      0        0
               tests      4      4      4      0        0
             asserts      4      4      4      0      n/a

يدعم الامتدادان postgis_tiger_geocoder وaddress_standardizer حاليًا أمر installcheck القياسي في PostgreSQL فقط. ولاختبارهما استخدم ما يلي. ملاحظة: لا حاجة إلى make install إذا كنت قد نفّذت make install بالفعل في جذر مجلد شيفرة PostGIS.

بالنسبة إلى address_standardizer:

cd extensions/address_standardizer
make install
make installcheck
          

يجب أن تبدو المخرجات هكذا:

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== running regression test queries        ==============
test test-init-extensions     ... ok
test test-parseaddress        ... ok
test test-standardize_address_1 ... ok
test test-standardize_address_2 ... ok

=====================
 All 4 tests passed.
=====================

بالنسبة إلى المرمِّز الجغرافي tiger، تأكد من توفر الامتدادين postgis وfuzzystrmatch في نسخة PostgreSQL لديك. وستُشغَّل اختبارات address_standardizer أيضًا إذا كنت قد بنيت postgis مع دعم address_standardizer:

cd extensions/postgis_tiger_geocoder
make install
make installcheck
          

يجب أن تبدو المخرجات هكذا:

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== installing fuzzystrmatch               ==============
CREATE EXTENSION
============== installing postgis                     ==============
CREATE EXTENSION
============== installing postgis_tiger_geocoder      ==============
CREATE EXTENSION
============== installing address_standardizer        ==============
CREATE EXTENSION
============== running regression test queries        ==============
test test-normalize_address   ... ok
test test-pagc_normalize_address ... ok

=====================
All 2 tests passed.
=====================

لتثبيت PostGIS، اكتب

make install

سينسخ هذا ملفات تثبيت PostGIS إلى الأدلة الفرعية المناسبة لها والمحددة بمعامل التهيئة --prefix. وعلى وجه الخصوص:

إذا كنت قد شغّلت سابقًا الأمر make comments لتوليد الملفين postgis_comments.sql وraster_comments.sql، فثبّت ملف sql بتشغيل

make comments-install

	فُصلت الملفات postgis_comments.sql وraster_comments.sql وtopology_comments.sql عن أهداف البناء والتثبيت المعتادة لأنها تتطلب اعتمادية إضافية هي xsltproc.

من الشكاوى الكثيرة لدى المستخدمين دالة توحيد العناوين Normalize_Address التي توحّد العنوان تمهيدًا للترميز الجغرافي. فهذه الدالة بعيدة عن الكمال، ومحاولة ترقيع عيوبها تستهلك قدرًا هائلًا من الموارد. لذلك أجرينا تكاملًا مع مشروع آخر لديه محرّك توحيد عناوين أفضل بكثير. ولاستخدام address_standardizer الجديد هذا، صرّف الامتداد كما هو موضّح في قسم 2.3, “تثبيت مُوحِّد العناوين واستخدامه” وثبّته امتدادًا في قاعدة بياناتك.

بعد تثبيت هذا الامتداد في قاعدة البيانات نفسها التي ثبّتّ فيها postgis_tiger_geocoder، يمكن استخدام Pagc_Normalize_Address بدلًا من Normalize_Address. وهذا الامتداد مستقل عن tiger، لذا يمكن استخدامه مع مصادر بيانات أخرى مثل العناوين الدولية. ويأتي امتداد المرمِّز الجغرافي tiger مضمَّنًا فيه نسخه المخصّصة من rules table (tiger.pagc_rules) وgaz table (tiger.pagc_gaz) وlex table (tiger.pagc_lex). ويمكنك الإضافة إليها وتحديثها لتحسين تجربة التوحيد بما يلائم احتياجاتك.

تنزّل عملية التحميل البيانات من موقع التعداد السكاني للملفات الوطنية والولايات المطلوبة، وتستخرج الملفات، ثم تحمّل كل ولاية في مجموعة جداول خاصة بها. ويرث كل جدول ولاية من الجداول المعرّفة في المخطط tiger، بحيث يكفي الاستعلام من تلك الجداول للوصول إلى جميع البيانات، ويمكن حذف مجموعة جداول ولاية في أي وقت باستخدام Drop_State_Tables_Generate_Script إذا احتجت إلى إعادة تحميل ولاية أو لم تعد بحاجة إليها.

لكي تتمكن من تحميل البيانات ستحتاج إلى الأدوات التالية:

إذا كنت تُرقّي من tiger_2010، فستحتاج أولًا إلى توليد Drop_Nation_Tables_Generate_Script وتشغيله. وقبل تحميل أي بيانات ولاية، عليك تحميل البيانات على مستوى البلاد، وذلك باستخدام Loader_Generate_Nation_Script التي ستولّد لك سكربت تحميل. وLoader_Generate_Nation_Script خطوة تُجرى مرة واحدة عند الترقية (من بيانات تعداد tiger لسنة سابقة) وعند التثبيت الجديد.

لتحميل بيانات الولايات راجع Loader_Generate_Script لتوليد سكربت تحميل بيانات لمنصتك للولايات التي تريدها. لاحظ أنه يمكنك تثبيتها على دفعات، فلا يلزمك تحميل جميع الولايات التي تريدها دفعة واحدة، بل يمكنك تحميلها كلما احتجت إليها.

بعد تحميل الولايات التي تريدها، احرص على تشغيل:

SELECT install_missing_indexes();

كما هو موضّح في Install_Missing_Indexes.

لاختبار أن الأمور تعمل كما ينبغي، جرّب تشغيل ترميز جغرافي لعنوان في ولايتك باستخدام Geocode

أولًا رقِّ امتداد postgis_tiger_geocoder كما يلي:

ALTER EXTENSION postgis_tiger_geocoder UPDATE;

بعد ذلك احذف جميع الجداول الوطنية وحمّل الجداول الجديدة. ولّد سكربت حذف بتعليمة SQL هذه كما هو مفصّل في Drop_Nation_Tables_Generate_Script

SELECT drop_nation_tables_generate_script();

شغّل تعليمات SQL المولَّدة للحذف.

ولّد سكربت تحميل البيانات الوطنية بتعليمة SELECT هذه كما هو مفصّل في Loader_Generate_Nation_Script

لنظام Windows

SELECT loader_generate_nation_script('windows'); 

لأنظمة unix/linux

SELECT loader_generate_nation_script('sh');

راجع قسم 2.4.1, “تفعيل المرمِّز الجغرافي Tiger في قاعدة بيانات PostGIS” للاطلاع على تعليمات تشغيل السكربت المولَّد. ولا يلزم ذلك إلا مرة واحدة.

	يمكن أن يكون لديك مزيج من جداول ولايات لسنوات مختلفة، ويمكنك ترقية كل ولاية على حدة. وقبل ترقية ولاية، عليك أولًا حذف جداول السنة السابقة لتلك الولاية باستخدام Drop_State_Tables_Generate_Script.