PostgreSQL: Utilizar PostgreSQL com Django

Esta documentação faz parte do guia Introdução. Consulte o guia completo aqui: Como começar com PostgreSQL.

👋 Bem-vindo à documentação da Stackhero!

A Stackhero oferece uma solução cloud PostgreSQL pronta a usar que proporciona uma série de benefícios, incluindo:

• Conexões e transferências de dados ilimitadas.
• Interface web PgAdmin incluída.
• Muitos módulos incluídos como PostGIS, TimescaleDB e PgVector.
• Atualizações sem esforço com apenas um clique.
• Desempenho ótimo e segurança robusta alimentados por uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: leva apenas 5 minutos para experimentar a solução de cloud hosting PostgreSQL da Stackhero!

Se ainda não estiver instalado, instale o módulo psycopg, que será usado para se conectar ao PostgreSQL:

pip install psycopg

Nesta etapa inicial, irá armazenar a palavra-passe diretamente no ficheiro settings.py. Este método é apenas para testes, pois não é seguro. Mais adiante nesta documentação, encontrará um exemplo de boa prática.

Abra o ficheiro settings.py e adicione a seguinte configuração:

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.postgresql',
    'HOST': '<XXXXXX>.stackhero-network.com',
    'PORT': <PORT>,
    'OPTIONS': {
      'sslmode': 'require',
    },
    'NAME': 'admin',
    'USER': 'admin',
    'PASSWORD': '<ADMIN_PASSWORD>'
  }
}

Atenção: este exemplo não é recomendado para produção e destina-se apenas a fins de teste!

Uma vez que a sua conexão funcione, pode adotar um método mais seguro para armazenar credenciais. O exemplo seguinte usa django-environ e armazena credenciais num ficheiro .env.

1. Instale django-environ:

   pip install django-environ
   

2. Abra o ficheiro settings.py e modifique-o da seguinte forma:

   import environ
   env = environ.Env()
   environ.Env.read_env()
   
   DATABASES = {
     'default': {
       'ENGINE': 'django.db.backends.postgresql',
       'HOST': env('STACKHERO_POSTGRESQL_HOST'),
       'PORT': <PORT>,
       'OPTIONS': {
         'sslmode': 'require',
       },
       'NAME': 'admin',
       'USER': 'admin',
       'PASSWORD': env('STACKHERO_POSTGRESQL_ADMIN_PASSWORD')
     }
   }
   

3. Abra ou crie o ficheiro .env no mesmo diretório que settings.py e adicione:

   STACKHERO_POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com
   STACKHERO_POSTGRESQL_ADMIN_PASSWORD=<ADMIN_PASSWORD>
   

4. Finalmente, adicione .env ao seu ficheiro .gitignore para garantir que as suas credenciais não sejam armazenadas no seu repositório Git:

echo ".env" >> .gitignore