Установка PostGIS

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

Для использования в качестве адаптера базы данных при работе с GeoDjango и PostGIS требуется модуль psycopg2.

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

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

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

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

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

Пользователь базы данных должен быть суперпользователем, чтобы выполнить CREATE EXTENSION postgis;. Команда выполняется во время процесса migrate. Альтернативный вариант — использовать операцию миграции в вашем проекте:

from django.contrib.postgres.operations import CreateExtension
from django.db import migrations

class Migration(migrations.Migration):

    operations = [
        CreateExtension('postgis'),
        ...
    ]

Если вы планируете использовать функции растровой обработки PostGIS в PostGIS 3+, вам также следует активировать расширение postgis_raster. Вы можете установить расширение, используя операцию миграции CreateExtension, или напрямую, выполнив CREATE EXTENSION postgis_raster;.

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

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

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

postgres# CREATE USER geodjango PASSWORD 'my_passwd';
postgres# CREATE DATABASE geodjango OWNER geodjango;