---
title: "PostGIS a shuiteáil"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/install/postgis/
canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/install/postgis/
---
# PostGIS a shuiteáil

Cuireann PostGIS \`\_ tacaíocht réad geografach le PostgreSQL, agus é a iompú ina bhunachar sonraí spásúil. :ref: \`geosbuild, :ref: proj4 agus:ref: gdalbuild ba chóir a shuiteáil sula dtógtar PostGIS. B'fhéidir go mbeadh leabharlanna breise ag teastáil uait freisin, féach riachtanais PostGIS \_.

Teastaíonn an modúl [psycopg](https://www.psycopg.org/psycopg3/) nó [psycopg2](https://www.psycopg.org/) le húsáid mar an cuibheoir bunachar sonraí agus GeoDjango á úsáid le PostGIS.

Ar Debian/Ubuntu, moltar duit na pacáistí seo a leanas a shuiteáil: postgresql-x\`, postgresql-x-postgis-3\`, postgresql-server-dev-x\`, agus `python3-psycopg3` (x a mheaitseáil leis an leagan PostgreSQL is mian leat a shuiteáil). Ar mhalairt air sin, is féidir leat [tógáil ó fhoinse](https://postgis.net/docs/postgis_installation.html#install_short_version). Téigh i gcomhairle leis na treoracha atá sonrach don ardán má tá tú ar:ref: macos nó:ref: windows.

## Iar-shuiteáil

### Bunachar sonraí spásúil a chruthú

Cuimsíonn PostGIS síneadh do PostgreSQL a úsáidtear chun feidhmiúlacht spásúil a chumasú:

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

Caithfidh an t-úsáideoir bunachar sonraí a bheith ina sárúsáideoir d'fhonn CREATE EXTENSION postgis; a reáchtáil. Reáchtáiltear an t-ordú le linn an phróisis: djadmin: migrate. Rogha eile is ea oibríocht imirce a úsáid i do thionscadal:

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

class Migration(migrations.Migration):
    operations = [CreateExtension("postgis"), ...]
```

Má tá sé ar intinn agat feidhmiúlacht raster PostGIS a úsáid, ba cheart duit an síneadh postgis\_raster a ghníomhachtú freisin. Is féidir leat an síneadh a shuiteáil ag baint úsáide as oibríocht imirce: :class: ~django.contrib.postgres.operations.createExtension, nó go díreach trí CREATE EXTENSION postgis\_raster; a reáchtáil.

Faoi láthair ní ghiaráilíonn GeoDjango aon fheidhmiúlacht topolaíochta PostGIS \_\_. Má tá sé ar intinn agat na gnéithe sin a úsáid ag pointe éigin, is féidir leat an síneadh \`postgis\_topology a shuiteáil freisin trí CREATE EXTENSION postgis\_topology; a eisiúint.

### An bunachar sonraí a bhainistiú

Chun an bunachar sonraí a riaradh, is féidir leat an clár pgAdmin III a úsáid (:menuselection: Start -\> PostgreSQL X -\> pgAdmin III) nó an SQL Shell (:menuselection: Start --\> PostgreSQL X -\> SQL Shell'). Mar shampla, chun bunachar sonraí spásúil agus úsáideoir \`\`geodjango\` a chruthú, féadfar an méid seo a leanas a fhorghníomhú ón SQL Shell mar úsáideoir `postgres`:

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