Установка PostGIS

PostGIS добавляет поддержку географических объектов в PostgreSQL, превращая его в пространственную базу данных. GEOS, PROJ.4 и GDAL должны быть установлены перед построением PostGIS. Возможно, также потребуются дополнительные библиотеки, см. требования к PostGIS.

В Debian/Ubuntu рекомендуется установить следующие пакеты: postgresql-x.x, postgresql-x.x-postgis, postgresql-server-dev-x.x, python-psycopg2 (x.x соответствует версии PostgreSQL, которую вы хотите установить). Также обратитесь к инструкциям для конкретной платформы, если вы используете Mac OS X или Windows.

Компиляция из исходного кода

Сначала загрузите архив исходного кода и распакуйте его:

$ wget http://download.osgeo.org/postgis/source/postgis-2.1.5.tar.gz
$ tar xzf postgis-2.1.5.tar.gz
$ cd postgis-2.1.5

Затем сконфигурируйте, создайте и установите PostGIS:

$ ./configure

Наконец, создайте и установите:

$ make
$ sudo make install
$ cd ..

После установки

Создание пространственной базы данных с PostGIS 2.0 и PostgreSQL 9.1+

PostGIS 2 включает расширение для Postgres 9.1+, которое можно использовать для включения пространственной функциональности:

$ createdb  <db name>
$ psql <db name>
> CREATE EXTENSION postgis;

GeoDjango в настоящее время не использует функциональность топологии PostGIS. функциональность топологии PostGIS. Если вы планируете использовать эти функции в будущем, вы также можете установить расширение postgis_topology , выполнив команду CREATE EXTENSION postgis_topology;.

Создание шаблона пространственной базы данных для более ранних версий

Если у вас более ранняя версия PostGIS или PostgreSQL, CREATE EXTENSION недоступен, и вам нужно создать пространственную базу данных, следуя этим инструкциям.

Создание пространственной базы данных с PostGIS отличается от обычного, потому что необходимо загрузить дополнительный SQL для включения пространственной функциональности. Из-за шагов в этом процессе лучше создать шаблон базы данных, который можно будет использовать повторно позже.

Сначала вам нужно получить возможность выполнять команды от имени привилегированного пользователя базы данных. Например, вы можете использовать следующую команду, чтобы стать пользователем postgres:

$ sudo su - postgres

После того, как вы стали суперпользователем базы данных, вы можете выполнить следующие команды, чтобы создать шаблон пространственной базы данных PostGIS:

$ POSTGIS_SQL_PATH=`pg_config --sharedir`/contrib/postgis-2.0
# Creating the template spatial database.
$ createdb -E UTF8 template_postgis
$ createlang -d template_postgis plpgsql # Adding PLPGSQL language support.
# Allows non-superusers the ability to create from this template
$ psql -d postgres -c "UPDATE pg_database SET datistemplate='true' WHERE datname='template_postgis';"
# Loading the PostGIS SQL routines
$ psql -d template_postgis -f $POSTGIS_SQL_PATH/postgis.sql
$ psql -d template_postgis -f $POSTGIS_SQL_PATH/spatial_ref_sys.sql
# Enabling users to alter spatial tables.
$ psql -d template_postgis -c "GRANT ALL ON geometry_columns TO PUBLIC;"
$ psql -d template_postgis -c "GRANT ALL ON geography_columns TO PUBLIC;"
$ psql -d template_postgis -c "GRANT ALL ON spatial_ref_sys TO PUBLIC;"

Эти команды можно поместить в скрипт оболочки для последующего использования; для удобства доступны следующие скрипты:

После этого вы можете создать пространственную базу данных, просто указав template_postgis в качестве шаблона для использования (через опцию -T):

$ createdb -T template_postgis <db name>

$ createuser --createdb <user>

Ошибка PostgreSQL при создании базы данных

Когда кластер PostgreSQL использует кодировку отличную от UTF8, скрипт create_template_postgis-*.sh завершится ошибкой при выполнении createdb:

createdb: database creation failed: ERROR:  new encoding (UTF8) is incompatible
  with the encoding of the template database (SQL_ASCII)

Текущим решением является повторное создание кластера с использованием UTF8 (перед удалением кластера сохраните любые базы данных).

Управление базой данных

Для администрирования базы данных можно использовать программу pgAdmin III (Пуск ‣ PostgreSQL 9.x ‣ pgAdmin III) или оболочку SQL (Пуск ‣ PostgreSQL 9.x ‣ Оболочка SQL). Например, для создания пространственной базы данных и пользователя geodjango, можно выполнить следующие команды из оболочки SQL от имени пользователя postgres:

postgres# CREATE USER geodjango PASSWORD 'my_passwd';
postgres# CREATE DATABASE geodjango OWNER geodjango TEMPLATE template_postgis ENCODING 'utf8';