As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Adicionar uma instância de banco de dados do Amazon RDS ao seu ambiente Python Elastic Beanstalk
<a name="create-deploy-python-rds"></a>

Este tópico fornece instruções para criar o Amazon RDS usando o console do Elastic Beanstalk. É possível usar uma instância de banco de dados do Amazon Relational Database Service (Amazon RDS) para armazenar dados coletados e modificados pela aplicação. O banco de dados pode ser acoplado ao seu ambiente e gerenciado pelo Elastic Beanstalk ou pode ser criado como desacoplado e gerenciado externamente por outro serviço. Nestas instruções, o banco de dados é acoplado ao ambiente e gerenciado pelo Elastic Beanstalk. Para obter mais informações sobre como integrar um Amazon RDS com o Elastic Beanstalk, consulte [Adição de um banco de dados ao seu ambiente do Elastic Beanstalk](using-features.managing.db.md).

**Topics**
+ [Adicionar uma instância de banco de dados ao seu ambiente](#python-rds-create)
+ [Download de um driver](#python-rds-drivers)
+ [Conectar-se a um banco de dados](#python-rds-connect)

## Adicionar uma instância de banco de dados ao seu ambiente
<a name="python-rds-create"></a>

**Para adicionar uma instância de banco de dados ao ambiente**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

1. No painel de navegação, selecione **Ambientes** e selecione o nome do ambiente na lista.

1. No painel de navegação, escolha **Configuration (Configuração)**.

1. Na categoria de configuração **Database (Banco de dados)**, escolha **Edit (Editar)**.

1. Escolha um mecanismo de banco de dados e insira um nome de usuário e senha.

1. Para salvar as alterações, escolha **Apply (Aplicar)** na parte inferior da página.

A adição de uma instância de banco de dados leva cerca de 10 minutos. Quando a atualização do ambiente for concluída, o nome de host da instância de banco de dados e outras informações de conexão estarão disponíveis para o seu aplicativo por meio das seguintes propriedades de ambiente:


| Nome da propriedade | Descrição | Valor da propriedade | 
| --- | --- | --- | 
| `RDS_HOSTNAME` | O nome do host da instância de banco de dados. | Na guia **Connectivity & security (Conectividade e segurança)** no console do Amazon RDS: **Endpoint**. | 
| `RDS_PORT` | A porta na qual a instância de banco de dados aceita conexões. O valor padrão varia entre os mecanismos de banco de dados. | Na guia **Connectivity & security (Conectividade e segurança)** do console do Amazon RDS: **Port (Porta)**. | 
| `RDS_DB_NAME` | O nome do banco de dado, **ebdb**. | Na guia **Configuration (Configuração)** no console do Amazon RDS: **DB Name (Nome do banco de dados)**. | 
| `RDS_USERNAME` | O nome de usuário que você configurou para seu banco de dados. | Na guia **Configuration (Configuração)** do console do Amazon RDS: **Nome de usuário primário**. | 
| `RDS_PASSWORD` | A senha que você configurou para seu banco de dados. | Não disponível para referência no console do Amazon RDS. | 

Para obter mais informações sobre como configurar uma instância de banco de dados acoplada a um ambiente Elastic Beanstalk, consulte [Adição de um banco de dados ao seu ambiente do Elastic Beanstalk](using-features.managing.db.md).

## Download de um driver
<a name="python-rds-drivers"></a>

Adicione o driver de banco de dados ao [arquivo de requisitos](python-configuration-requirements.md) de seu projeto.

**Example requirements.txt: Django com MySQL**  

```
Django==2.2
mysqlclient==2.0.3
```

**Pacotes de drivers comuns para Python**
+ **MySQL** – `mysqlclient`
+ **PostgreSQL** – `psycopg2`
+ **Oracle**: `cx_Oracle`
+ **SQL Server** – `adodbapi`

Para obter mais informações, consulte [Python DatabaseInterfaces](https://wiki.python.org/moin/DatabaseInterfaces) e [Django 2.2](https://docs.djangoproject.com/en/2.2/ref/databases) - bancos de dados suportados.

## Conectar-se a um banco de dados
<a name="python-rds-connect"></a>

O Elastic Beanstalk fornece informações de conexão referentes às instâncias de banco de dados associadas nas propriedades de ambiente. Use `os.environ['{{VARIABLE}}']` para ler as propriedades e configurar uma conexão de banco de dados.

**Example Arquivo de configurações Django: dicionário de BANCOS DE DADOS**  

```
import os

if 'RDS_HOSTNAME' in os.environ:
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': os.environ['RDS_DB_NAME'],
            'USER': os.environ['RDS_USERNAME'],
            'PASSWORD': os.environ['RDS_PASSWORD'],
            'HOST': os.environ['RDS_HOSTNAME'],
            'PORT': os.environ['RDS_PORT'],
        }
    }
```