

# Conectar-se à instância de banco de dados do Db2
<a name="USER_ConnectToDb2DBInstance"></a>

Depois que o Amazon RDS provisiona a instância de banco de dados do Amazon RDS para Db2, é possível usar qualquer aplicação cliente SQL padrão para se conectar à instância de banco de dados. Como o Amazon RDS é um serviço gerenciado, não é possível fazer login como `SYSADM`, `SYSCTRL`, `SECADM` e `SYSMAINT`.

É possível se conectar a uma instância de banco de dados que esteja executando o mecanismo de banco de dados IBM Db2 usando IBM Db2 CLP, IBM CLPPlus, DBeaver ou IBM Db2 Data Management Console. 

**nota**  
A conexão com um banco de dados do Db2 pode falhar se a instância de banco de dados do RDS para Db2 não tiver memória suficiente. Para ter mais informações, consulte [Erro de conexão de banco de dados](db2-troubleshooting.md#db2-database-connection-error).

**Topics**
+ [Encontrar o endpoint da instância de banco de dados do Amazon RDS para Db2](db2-finding-instance-endpoint.md)
+ [Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM Db2 CLP](db2-connecting-with-clp-client.md)
+ [Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM CLPPlus](db2-connecting-with-ibm-clpplus-client.md)
+ [Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o DBeaver](db2-connecting-with-dbeaver.md)
+ [Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md)
+ [Considerações sobre grupos de segurança com o Amazon RDS para Db2](db2-security-groups-considerations.md)

# Encontrar o endpoint da instância de banco de dados do Amazon RDS para Db2
<a name="db2-finding-instance-endpoint"></a>

Cada instância de banco de dados do Amazon RDS tem um endpoint, e cada ponto final possui o nome DNS e o número da porta para a instância de banco de dados. Para se conectar à instância de banco de dados do Amazon RDS para Db2 com uma aplicação cliente do SQL, é necessário ter o nome do DNS e o número da porta da instância de banco de dados.

É possível encontrar o endpoint de uma instância de banco de dados usando o Console de gerenciamento da AWS ou a AWS CLI.

## Console
<a name="db2-finding-instance-endpoint-console"></a>

**Como encontrar o endpoint de uma instância de banco de dados do RDS para Db2**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1.  No canto superior direito do console, selecione a Região da AWS da instância de banco de dados.

1. Encontre o nome do DNS e o número da porta da instância de banco de dados do RDS para Db2. 

   1. Escolha **Databases (Bancos de dados)** para exibir a lista das instâncias de banco de dados. 

   1. Escolha o nome da instância de banco de dados do RDS para Db2 para exibir os detalhes da instância. 

   1. Na guia **Connectivity & security (Conectividade e segurança)**, copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados.   
![\[Guia Conectividade e segurança de uma instância de banco de dados que mostra o endpoint e a porta.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/db2-connectivity-security.png)

## AWS CLI
<a name="db2-finding-instance-endpoint-cli"></a>

Para encontrar o endpoint de uma instância de banco de dados do RDS para Db2, execute o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). No exemplo a seguir, substitua *database-1* pelo nome da instância de banco de dados.

Para Linux, macOS ou Unix:

```
aws rds describe-db-instances \
    --db-instance-identifier database-1 \
    --query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' \
    --output json
```

Para Windows:

```
aws rds describe-db-instances ^
    --db-instance-identifier database-1 ^
    --query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' ^
    --output json
```

O comando vai produzir uma saída semelhante ao exemplo a seguir. A linha `Address` na saída contém o nome DNS. 

```
[
    {
        "DBInstanceIdentifier": "database-1",
        "DBName": "DB2DB",
        "Endpoint": {
            "Address": "database-1.123456789012.us-east-2.amazonaws.com",
            "Port": 50000,
            "HostedZoneId": "Z2OC4A7DETW6VH"
        }
    }
]
```

# Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM Db2 CLP
<a name="db2-connecting-with-clp-client"></a><a name="db2-downloading-package"></a>

É possível usar um utilitário de linha de comandos, como IBM Db2 CLP, para se conectar a instâncias de banco de dados do Amazon RDS para Db2. Esse utilitário faz parte do IBM Data Server Runtime Client. Para baixar o cliente** **do IBM Fix Central, consulte [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) no IBM Support. 

**Topics**
+ [Terminologia](#db2-connecting-ibm-clp-terms)
+ [Instalar o cliente](#db2-connecting-ibm-clp-install-client)
+ [Conexão a uma instância de banco de dados](#db2-connecting-ibm-clp-connect-db-instance)
+ [Solução de problema de conexão com a instância de banco de dados do RDS para Db2](#db2-troubleshooting-connections-clp)

## Terminologia
<a name="db2-connecting-ibm-clp-terms"></a>

Os termos a seguir ajudam a explicar os comandos usados ao [se conectar à instância de banco de dados do RDS para Db2](#db2-connecting-ibm-clp-connect-db-instance).

**catalog tcpip node**  
Esse comando registra um nó de banco de dados remoto com um cliente Db2 local, o que torna o nó acessível à aplicação cliente. Para catalogar um nó, você vai fornecer informações, como nome do host, número da porta e protocolo de comunicação do servidor. O nó catalogado então representa um servidor de destino onde residem um ou mais bancos de dados remotos. Para ter mais informações, consulte [CATALOG TCPIP/TCPIP4/TCPIP6 NODE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-tcpip-node) na documentação do IBM Db2.

**catalog database**  
Esse comando registra um banco de dados remoto com um cliente Db2 local, o que torna o banco de dados acessível à aplicação cliente. Para catalogar um banco de dados, você vai fornecer informações, como o alias do banco de dados, o nó no qual ele reside e o tipo de autenticação necessário para se conectar ao banco de dados. Para ter mais informações, consulte [CATALOG DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-database) na documentação do IBM Db2.

## Instalar o cliente
<a name="db2-connecting-ibm-clp-install-client"></a>

Depois de [downloading the package for Linux](#db2-downloading-package), instale o cliente usando privilégios raiz ou de administrador.

**nota**  
Para instalar o cliente no AIX ou no Windows, siga o mesmo procedimento, mas modifique os comandos do sistema operacional.

**Como instalar o cliente no Linux**

1. Execute **`./db2_install -f sysreq`** e escolha **`yes`** para aceitar a licença.

1. Selecione o local para instalar o cliente.

1. Execute **`clientInstallDir/instance/db2icrt -s client` *instance\$1name***. Substitua *instance\$1name* por um usuário válido do sistema operacional no Linux. Em Linux, o nome da instância de banco de dados do Db2 está vinculado ao nome de usuário do sistema operacional.

   Esse comando cria um diretório **`sqllib`** no diretório inicial do usuário designado no Linux.

## Conexão a uma instância de banco de dados
<a name="db2-connecting-ibm-clp-connect-db-instance"></a>

Para se conectar à instância de banco de dados do RDS para Db2, você precisa do nome do DNS e do número da porta. Para ter informações sobre como descobri-los, consulte [Encontrar o endpoint](db2-finding-instance-endpoint.md). Também é necessário saber o nome do banco de dados, o nome de usuário principal e a senha mestra que você definiu ao criar a instância de banco de dados do RDS para Db2. Para ter mais informações sobre como descobri-los, consulte [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**Como se conectar a uma instância de banco de dados do RDS para Db2 com IBM Db2 CLP**

1. Faça login com o nome de usuário que você especificou durante a instalação do cliente IBM Db2 CLP.

1. Catalogue a instância de banco de dados do RDS para Db2. No exemplo a seguir, substitua *node\$1name*, *dns\$1name* e *port* por um nome para o nó no catálogo local, o nome do DNS da instância de banco de dados e o número da porta.

   ```
   1. db2 catalog TCPIP node node_name remote dns_name server port
   ```

   **Exemplo**

   ```
   db2 catalog TCPIP node remnode remote database-1.123456789012.us-east-1.amazonaws.com server 50000
   ```

1. Catalogue o banco de dados `rdsadmin` e seu banco de dados. Isso permitirá que você se conecte ao banco de dados `rdsadmin` para realizar algumas tarefas administrativas usando procedimentos armazenados do Amazon RDS. Para obter mais informações, consulte [Administrar a instância de banco de dados do RDS para Db2](db2-administering-db-instance.md).

   No exemplo a seguir, substitua *database\$1alias*, *node\$1name * e *database\$1name* por aliases para esse banco de dados, o nome do nó definido na etapa anterior e o nome do banco de dados. O `server_encrypt` criptografa o nome de usuário e a senha na rede.

   ```
   db2 catalog database rdsadmin [ as database_alias ] at node node_name authentication server_encrypt
       
   db2 catalog database database_name [ as database_alias ] at node node_name authentication server_encrypt
   ```

   **Exemplo**

   ```
   db2 catalog database rdsadmin at node remnode authentication server_encrypt
       
   db2 catalog database testdb as rdsdb2 at node remnode authentication server_encrypt
   ```

1. Conecte-se ao banco de dados do RDS para Db2. No exemplo a seguir, substitua *rds\$1database\$1alias*, *master\$1username* e *master\$1password* pelo nome do banco de dados, o nome de usuário principal e a senha mestra da instância de banco de dados do RDS para Db2.

   ```
   db2 connect to rds_database_alias user master_username using master_password
   ```

   O comando vai produzir uma saída semelhante ao seguinte exemplo:

   ```
   Database Connection Information
       
       Database server        = DB2/LINUXX8664 11.5.9.0
       SQL authorization ID   = ADMIN
       Local database alias   = TESTDB
   ```

1. Execute consultas e visualize os resultados. O exemplo a seguir mostra uma declaração SQL que seleciona o banco de dados que você criou.

   ```
   db2 "select current server from sysibm.dual"
   ```

   O comando vai produzir uma saída semelhante ao seguinte exemplo:

   ```
   1
       ------------------
       TESTDB
       
       1 record(s) selected.
   ```

## Solução de problema de conexão com a instância de banco de dados do RDS para Db2
<a name="db2-troubleshooting-connections-clp"></a>

O erro `NULLID` a seguir geralmente indica que as versões do cliente e do servidor do RDS para Db2 não coincidem. Para ver as versões compatíveis do cliente do Db2, consulte [Supported combinations of clients, drivers and server levels](https://www.ibm.com/docs/en/db2/11.5?topic=communications-supported-combinations-clients-drivers-server-levels) na documentação do IBM Db2.

```
db2 "select * from syscat.tables"
SQL0805N Package "NULLID.SQLC2O29 0X4141414141454A69" was not found.
SQLSTATE=51002
```

Depois de receber esse erro, você deverá vincular pacotes do cliente do Db2 antigo a uma versão do servidor do Db2 compatível com o RDS para Db2. 

**Como vincular pacotes de um cliente do Db2 mais antigo a um servidor do Db2 mais recente**

1. Localize os arquivos de vinculação na máquina cliente. Normalmente, esses arquivos estão localizados no diretório **bnd** do caminho de instalação do cliente do Db2 e têm a extensão **.bnd**.

1. Conecte-se ao servidor do Db2. No exemplo a seguir, substitua *database\$1name* pelo nome do servidor do Db2. Substitua *master\$1username* e *master\$1password* por suas informações. Esse usuário tem autoridade `DBADM`. 

   ```
   db2 connect to database_name user master_username using master_password
   ```

1. Execute o comando `bind` para vincular os pacotes.

   1. Navegue até o diretório onde estão os arquivos de vinculação na máquina cliente.

   1. Execute o comando `bind` para cada arquivo.

      São necessárias as seguintes opções:
      + `blocking all`: vincula todos os pacotes no arquivo de associação em uma única solicitação de banco de dados. 
      + `grant public`: concede permissão a `public` para executar o pacote.
      + `sqlerror continue`: especifica que o processo `bind` continue mesmo se ocorrerem erros.

      Para ter mais informações sobre o comando `bind`, consulte [BIND command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-bind) na documentação do IBM Db2.

1. Verifique se a associação foi bem-sucedida consultando a visualização do catálogo `syscat.package` ou verificando a mensagem exibida após o comando `bind`.

Para ter mais informações, consulte [DB2 v11.5 Bind File and Package Name List](https://www.ibm.com/support/pages/node/6190455) em IBM Support.

# Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM CLPPlus
<a name="db2-connecting-with-ibm-clpplus-client"></a>

É possível usar um utilitário, como o IBM CLPPlus, para se conectar a uma instância de banco de dados do Amazon RDS para Db2. Esse utilitário faz parte do IBM Data Server Runtime Client. Para baixar o cliente** **do IBM Fix Central, consulte [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) no IBM Support. 

**Importante**  
Recomendamos executar o IBM CLPPlus em um sistema operacional compatível com interfaces gráficas de usuário, como macOS, Windows ou Linux com Desktop. Se estiver executando o Linux headless, use a opção **-nw** com comandos do CLPPlus.

**Topics**
+ [Instalar o cliente](#db2-connecting-ibm-clpplus-install-client)
+ [Conexão a uma instância de banco de dados](#db2-connecting-ibm-clpplus-connect-db-instance)
+ [Recuperar dados de CLOB de procedimentos armazenados do Db2](#db2-connecting-ibm-clpplus-retrieve-clob-data)

## Instalar o cliente
<a name="db2-connecting-ibm-clpplus-install-client"></a>

Depois de baixar o pacote para Linux, instale o cliente. 

**nota**  
Para instalar o cliente no AIX ou no Windows, siga o mesmo procedimento, mas modifique os comandos do sistema operacional.

**Como instalar o cliente no Linux**

1. Executar **`./db2_install`**.

1. Execute **`clientInstallDir/instance/db2icrt -s client` *instance\$1name***. Substitua *instance\$1name* por um usuário válido do sistema operacional no Linux. Em Linux, o nome da instância de banco de dados do Db2 está vinculado ao nome de usuário do sistema operacional.

   Esse comando cria um diretório **`sqllib`** no diretório inicial do usuário designado no Linux.

## Conexão a uma instância de banco de dados
<a name="db2-connecting-ibm-clpplus-connect-db-instance"></a>

Para se conectar à instância de banco de dados do RDS para Db2, você precisa do nome do DNS e do número da porta. Para ter informações sobre como descobri-los, consulte [Encontrar o endpoint](db2-finding-instance-endpoint.md). Também é necessário saber o nome do banco de dados, o nome de usuário principal e a senha mestra que você definiu ao criar a instância de banco de dados do RDS para Db2. Para ter mais informações sobre como descobri-los, consulte [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**Como se conectar a uma instância de banco de dados do RDS para Db2 com IBM CLPPlus**

1. Revise a sintaxe do comando. No exemplo a seguir, substitua *clientDir* pelo local em que o cliente está instalado. 

   ```
   cd clientDir/bin
       ./clpplus -h
   ```

1. Configure o servidor Db2. No exemplo a seguir, substitua *dsn\$1name*, *database\$1name*, *endpoint* e *port* pelo nome do DSN, nome do banco de dados, endpoint e porta da instância de banco de dados do RDS para Db2. Para obter mais informações, consulte [Encontrar o endpoint da instância de banco de dados do Amazon RDS para Db2](db2-finding-instance-endpoint.md).

   ```
   db2cli writecfg add -dsn dsn_name -database database_name -host endpoint -port port -parameter "Authentication=SERVER_ENCRYPT"
   ```

1. Conecte-se à instância de banco de dados do RDS para Db2. No exemplo a seguir, substitua *master\$1username* e *dsn\$1name* pelo nome de usuário principal e pelo nome do DNS.

   ```
   ./clpplus -nw master_username@dsn_name
   ```

1. Uma janela Java Shell é aberta. Digite a senha mestra da instância de banco de dados do RDS para Db2. 
**nota**  
Se a janela Java Shell não for aberta, execute `./clpplus -nw` para usar a mesma janela da linha de comandos.

   ```
   Enter password: *********
   ```

   Uma conexão é estabelecida e produz uma saída semelhante ao seguinte exemplo:

   ```
   Database Connection Information :
   ---------------------------------
   Hostname = database-1.abcdefghij.us-east-1.rds.amazonaws.com
   Database server = DB2/LINUXX8664  SQL110590
   SQL authorization ID = admin
   Local database alias = DB2DB
   Port = 50000
   ```

1. Execute consultas e visualize os resultados. O exemplo a seguir mostra uma declaração SQL que seleciona o banco de dados que você criou. 

   ```
   SQL > select current server from sysibm.dual;
   ```

   O comando vai produzir uma saída semelhante ao seguinte exemplo:

   ```
   1
       --------------------
       DB2DB
       SQL>
   ```

## Recuperar dados de CLOB de procedimentos armazenados do Db2
<a name="db2-connecting-ibm-clpplus-retrieve-clob-data"></a>

Procedimentos armazenados como rdsadmin.db2pd\$1command exibem resultados em colunas de CLOB, que comportam até 2 GB de dados. No entanto, o CLP do Db2 limita a saída de CLOB a 8 KB (8.192 bytes), truncando quaisquer dados além desse limite. Para recuperar a saída completa, use CLPPLUS em vez disso.

1. Obter o ID da tarefa (task\$1id) 

   ```
   db2 "select task_id, task_type, database_name, lifecycle, varchar(bson_to_json(task_input_params), 500) as task_params,
   cast(task_output as varchar(500)) as task_output, CREATED_AT, LAST_UPDATED_AT from table(rdsadmin.get_task_status(null,null,null))"
   ```

1. Executar o comando CLPPLUS

   Depois de obter o task\$1id, execute o seguinte comando no prompt do Unix (substitua TASK\$1ID pelo ID numérico real da tarefa):

   ```
   $ (echo "select task_output from table(rdsadmin.get_task_status(task_id,null,null));" ; echo "disconnect;" ; echo "exit;") | clpplus -nw -silent masteruser/MasterUserPassword@hostname:port_num/rdsadmin
   ```

# Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o DBeaver
<a name="db2-connecting-with-dbeaver"></a>

É possível usar ferramentas de terceiros, como o DBeaver, para se conectar a instâncias de banco de dados do Amazon RDS para Db2. Para baixar esse utilitário, consulte [DBeaver Community](https://dbeaver.io/). 

Para se conectar à instância de banco de dados do RDS para Db2, você precisa do nome do DNS e do número da porta. Para ter informações sobre como descobri-los, consulte [Encontrar o endpoint](db2-finding-instance-endpoint.md). Também é necessário saber o nome do banco de dados, o nome de usuário principal e a senha mestra que você definiu ao criar a instância de banco de dados do RDS para Db2. Para ter mais informações sobre como descobri-los, consulte [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**Como se conectar a uma instância de banco de dados do RDS para Db2 com DBeaver**

1. Início **DBeaver**.

1. Selecione o ícone **Nova conexão** na barra de ferramentas e, depois, escolha **Db2 para LUW**.  
![\[O menu que lista os tipos de mecanismo em DBeaver.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/dbeaver-add-connection.png)

1. Na janela **Conectar-se a um banco de dados**, forneça informações da instância de banco de dados do RDS para Db2.

   1.  Insira as seguintes informações:
      + Em **Host**, digite o nome do DNS da instância de banco de dados.
      + Em **Porta**, insira o número da porta da instância de banco de dados.
      + Em **Banco de dados**, insira o nome do banco de dados.
      + Em **Username (Nome do usuário)**, digite o nome do administrador do banco de dados da instância de banco de dados.
      + Em **Senha**, digite a senha do administrador do banco de dados da instância de banco de dados.

   1. Selecione **Salvar senha**.

   1. Selecione **Configurações do driver**.   
![\[A janela Conectar-se a um banco de dados com várias configurações de conexão preenchidas em DBeaver.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/dbeaver-connect-database.png)

1. Na janela **Editar driver**, especifique propriedades de segurança adicionais.

   1. Selecione a guia **Propriedades do driver**.

   1. Adicione duas **Propriedades do usuário**.

      1. Abra o menu de contexto (clique com o botão direito do mouse) e selecione **Adicionar nova propriedade**.

      1. Em **Nome da propriedade**, adicione **encryptionAlgorithm** e, depois, escolha **OK**.

      1. Com a linha **encryptionAlgorithm** selecionada, escolha a coluna **Valor** e adicione **2**.

      1. Abra o menu de contexto (clique com o botão direito do mouse) e selecione **Adicionar nova propriedade**.

      1. Em **Nome da propriedade**, adicione **securityMechanism** e escolha **OK**.

      1. Com a linha **securityMechanism** selecionada, escolha a coluna **Valor** e adicione **7**.

   1. Escolha **OK**.  
![\[Guia Propriedades do driver na janela Editar driver em DBeaver.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/dbeaver-driver-properties-tab.png)

1. Na janela **Conectar-se a um banco de dados**, selecione **Testar conexão**. Se você não tiver um driver DB2 JBDC instalado no computador, o driver será baixado automaticamente.

1. Escolha **OK**.

1. Escolha **Terminar**.

1. Na guia **Navegação no banco de dados**, selecione o nome do banco de dados. Agora, é possível explorar objetos.

Agora, está tudo pronto para executar comandos SQL.

**Como executar comandos SQL e visualizar os resultados**

1. No menu superior, selecione **SQL**. Um painel de script SQL será aberto.

1. No painel **Script**, insira um comando SQL.

1. Para executar o comando, selecione o botão **Executar consulta SQL**.

1. No painel de resultados SQL, visualize os resultados das consultas SQL.  
![\[Janela mostrando como executar um comando SQL e visualizar os resultados em DBeaver.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/dbeaver-sql-run-example.png)

# Conectar-se à instância de banco de dados do Amazon RDS para Db2 com o IBM Db2 Data Management Console
<a name="db2-connecting-with-ibm-data-management-console"></a>

É possível se conectar à instância de banco de dados do Amazon RDS para Db2 com o IBM Db2 Data Management Console. O IBM Db2 Data Management Console pode administrar e monitorar várias instâncias de banco de dados do RDS para Db2. 

**nota**  
Você deve ter uma máquina Linux ou Windows do Amazon EC2 que esteja na mesma VPC e grupo de segurança da instância de banco de dados do RDS para Db2. A VPC e o grupo de segurança controlam a conexão com a instância de banco de dados por meio da rede interna. 

O IBM Db2 Data Management Console requer um banco de dados do Db2 do repositório para armazenar metadados e métricas de desempenho, mas não pode criar automaticamente um banco de dados de repositório para o RDS para Db2. Em vez disso, é necessário criar um banco de dados de repositório para monitorar uma ou mais instâncias de banco de dados do RDS para Db2. Depois, é possível instalar o IBM Db2 Data Management Console e conectar-se à instância de banco de dados do RDS para Db2 com o IBM Db2 Data Management Console.

**Topics**
+ [Etapa 1: criar um banco de dados de repositório para monitorar instâncias de banco de dados](#db2-creating-repo-db-monitoring-dmc)
+ [Etapa 2: instalar e configurar o IBM Db2 Data Management Console](#db2-install-setup-dmc)
+ [Etapa 3: configurar o banco de dados do repositório e se conectar a instâncias de banco de dados do RDS para Db2](#db2-connecting-db-instances-with-dmc)
+ [Usar o IBM Db2 Data Management Console](#db2-using-dmc)

## Etapa 1: criar um banco de dados de repositório para monitorar instâncias de banco de dados
<a name="db2-creating-repo-db-monitoring-dmc"></a>

É possível usar uma instância de banco de dados do RDS para Db2 de tamanho adequado como um repositório para o IBM Db2 Data Management Console para monitorar outras instâncias de banco de dados do RDS para Db2. No entanto, como o usuário administrador não tem a autoridade `SYSCTRL` para criar grupos de buffer e espaços de tabela, o uso da criação do repositório IBM Db2 Data Management Console para criar um banco de dados do repositório falha. Em vez disso, é necessário criar um banco de dados de repositório. Esse banco de dados de repositório monitora as instâncias de banco de dados do RDS para Db2. 

É possível criar um banco de dados de repositório de duas maneiras diferentes. É possível criar um banco de dados do RDS para Db2 e criar manualmente um grupo de buffer, um espaço de tabela de usuário e um espaço de tabela temporário do sistema. Ou é possível criar uma instância separada do Amazon EC2 para hospedar um banco de dados de repositório do IBM Db2 Data Management Console.

**Topics**
+ [Criar manualmente um grupo de buffer, um espaço de tabela de usuário e um espaço de tabela temporário do sistema](#db2-manually-creating-dmc)
+ [Criar uma instância do Amazon EC2 para hospedar um repositório do IBM Db2 Data Management Console](#db2-creating-ec2-dmc)

### Criar manualmente um grupo de buffer, um espaço de tabela de usuário e um espaço de tabela temporário do sistema
<a name="db2-manually-creating-dmc"></a>

**Como criar um grupo de buffer, um espaço de tabela de usuário e um espaço de tabela temporário do sistema**

1. Conecte-se ao banco de dados `rdsadmin`. No exemplo a seguir, substitua *master\$1username* e *master\$1password* por suas próprias informações.

   ```
   db2 connect to rdsadmin user master_username using master_password  
   ```

1. Crie um grupo de buffer pool para IBM Db2 Data Management Console. No exemplo a seguir, substitua *database\$1name* pelo nome do repositório que você criou para o IBM Db2 Data Management Console monitorar as instâncias de banco de dados do RDS para Db2. 

   ```
   db2 "call rdsadmin.create_bufferpool('database_name', 
        'BP4CONSOLE', 1000, 'Y', 'Y', 32768)"
   ```

1. Crie um espaço de tabela do usuário para o IBM Db2 Data Management Console. No exemplo a seguir, substitua *database\$1name* pelo nome do repositório que você criou para o IBM Db2 Data Management Console monitorar as instâncias de banco de dados do RDS para Db2. 

   ```
   db2 "call rdsadmin.create_tablespace('database_name', 
        'TS4CONSOLE', 'BP4CONSOLE', 32768)"
   ```

1. Crie um espaço de tabela temporário do sistema para o IBM Db2 Data Management Console. No exemplo a seguir, substitua *database\$1name* pelo nome do repositório que você criou para o IBM Db2 Data Management Console monitorar as instâncias de banco de dados do RDS para Db2. 

   ```
   db2 "call rdsadmin.create_tablespace('database_name',
       'TS4CONSOLE_TEMP', 'BP4CONSOLE', 32768, 0, 0, 'S')"
   ```

Agora está tudo pronto para instalar o IBM Db2 Data Management Console. Consulte mais informações sobre instalação e configuração em [Etapa 2: instalar e configurar o IBM Db2 Data Management Console](#db2-install-setup-dmc).

### Criar uma instância do Amazon EC2 para hospedar um repositório do IBM Db2 Data Management Console
<a name="db2-creating-ec2-dmc"></a>

É possível criar uma instância separada do Amazon Elastic Compute Cloud (Amazon EC2) para hospedar um repositório do IBM Db2 Data Management Console. Consulte informações sobre como criar uma instância do Amazon EC2 em [Tutorial: Comece a usar instâncias do Linux do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) no *Guia do usuário do Amazon EC2*.

## Etapa 2: instalar e configurar o IBM Db2 Data Management Console
<a name="db2-install-setup-dmc"></a>

Depois de criar um grupo de buffer, um espaço de tabela do usuário e um espaço de tabela temporário do sistema, estará tudo pronto para instalar e configurar o IBM Db2 Data Management Console. 

**Importante**  
Você deve ter uma máquina Linux ou Windows do Amazon EC2 que esteja na mesma VPC e grupo de segurança da instância de banco de dados do RDS para Db2. A VPC e o grupo de segurança controlam a conexão com a instância de banco de dados por meio da rede interna. Além disso, você já deve ter [criado um banco de dados de repositório](#db2-creating-repo-db-monitoring-dmc) para o IBM Db2 Data Management Console.

**Como instalar e configurar o IBM Db2 Data Management Console**

1. Baixe o IBM Db2 Data Management Console do [IBM Db2 Data Management Console versão 3.1x](https://www.ibm.com/support/pages/ibm-db2-data-management-console-version-31x-releases-new-features-and-enhancements) no site do Suporte IBM.

1. Instalar o IBM Db2 Data Management Console.

1. Abra o IBM Db2 Data Management Console e use o endereço IP da máquina do Amazon EC2 e o número da porta que você usou para a conexão HTTP ou HTTPS com a instância do Amazon EC2. Por exemplo, use `http://xx.xx.xx.xx:11080` ou `https://xx.xx.xx.xx.11081`. Substitua `xx.xx.xx.xx` pelo endereço IP da máquina do Amazon EC2. `11080` e `11081` são as portas padrão para conexões HTTP e HTTPS.

1. (Opcional) Se quiser usar a porta 80 ou 443 na instância do Amazon EC2, você poderá usar o Apache httpd ou um servidor HTTP Nginx para fazer o proxy da porta IBM Db2 Data Management Console para a porta 80 ou 443. Consulte mais informações em [Apache HTTP Server Project](https://httpd.apache.org) e [o site do nginx](https://nginx.org/en/).

   Para permitir a conexão com o IBM Db2 Data Management Console, você deve editar as regras de entrada no grupo de segurança. Se você usa um proxy, altere a porta TCP/IP 80 ou 443 para redirecionar para as portas do IBM Db2 Data Management Console. Se você não estiver usando um proxy, altere a porta TCP/IP 80 ou 443 para as portas padrão 11080 (HTTP) ou 11081 (HTTPS).

Agora, é possível fazer login no IBM Db2 Data Management Console para configurar o banco de dados do repositório e estabelecer conexão com instâncias de banco de dados do RDS para Db2. Para obter mais informações, consulte [Configurar o banco de dados do repositório e se conectar a instâncias de banco de dados](#db2-connecting-db-instances-with-dmc).

## Etapa 3: configurar o banco de dados do repositório e se conectar a instâncias de banco de dados do RDS para Db2
<a name="db2-connecting-db-instances-with-dmc"></a>

Quando você se conecta ao banco de dados do repositório pela primeira vez, o IBM Db2 Data Management Console configura o repositório automaticamente. Depois que o banco de dados do repositório estiver configurado, você poderá adicionar conexões de banco de dados ao IBM Db2 Data Management Console. 

Para se conectar à instância de banco de dados do RDS para Db2, você precisa do nome do DNS e do número da porta. Para ter informações sobre como descobri-los, consulte [Encontrar o endpoint](db2-finding-instance-endpoint.md). Também é necessário saber o nome do banco de dados, o nome de usuário principal e a senha mestra que você definiu ao criar a instância de banco de dados do RDS para Db2. Para ter mais informações sobre como descobri-los, consulte [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating). Se você estiver se conectando pela Internet, permita o tráfego para a porta do banco de dados. Para obter mais informações, consulte [Criar uma instância de banco de dados](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).

**Como se conectar a instâncias de banco de dados do RDS para Db2 com IBM Db2 Data Management Console**

1. Faça login no IBM Db2 Data Management Console com as credenciais que você definiu durante a instalação.

1. Configure o repositório. 

   1. Na seção **Conexão e banco de dados**, insira as seguintes informações para a instância de banco de dados do RDS para Db2: 
      + Em **Host**, digite o nome do DNS da instância de banco de dados.
      + Em **Porta**, insira o número da porta da instância de banco de dados.
      + Em **Banco de dados**, insira o nome do banco de dados.  
![\[A seção Conexão e banco de dados no IBM Db2 Data Management Console com os campos Host, Porta e Banco de dados.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-connection-database.png)

   1. Na seção **Segurança e credencial**, insira as seguintes informações para a instância de banco de dados do RDS para Db2:
      + Em **Tipo de segurança**, selecione **Usuário e senha criptografados**.
      + Em **Username (Nome do usuário)**, digite o nome do administrador do banco de dados da instância de banco de dados.
      + Em **Senha**, digite a senha do administrador do banco de dados da instância de banco de dados.

   1. Selecione **Test connection (Testar conexão)**.
**nota**  
Se a conexão não for bem-sucedida, confirme se a porta do banco de dados está aberta por meio das regras de entrada do grupo de segurança. Para obter mais informações, consulte [Considerações sobre grupos de segurança com o Amazon RDS para Db2](db2-security-groups-considerations.md).

      Se você não [criou manualmente um grupo de buffer, um espaço de tabela de usuário e um espaço de tabela temporário do sistema no RDS para Db2](#db2-manually-creating-dmc), talvez receba a seguinte mensagem de erro:   
![\[Mensagem de erro sobre a falta de permissões para realizar operações.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-error-message.png)

      Você deve ter criado uma tabela de buffer, um espaço de tabela e objetos para um repositório do IBM Db2 Data Management Console para monitorar a instância de banco de dados do RDS para Db2. Ou é possível usar uma instância de banco de dados Db2 do Amazon EC2 para hospedar um repositório do IBM Db2 Data Management Console e monitorar a instância de banco de dados do RDS para Db2. Para obter mais informações, consulte [Etapa 1: criar um banco de dados de repositório para monitorar instâncias de banco de dados](#db2-creating-repo-db-monitoring-dmc).

   1. Depois de testar a conexão com êxito, selecione **Próximo**.  
![\[Seção Segurança e credencial no IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-security-credential.png)

   Se o IBM Db2 Data Management Console encontrar o grupo de buffer, o espaço de tabela do usuário e o espaço de tabela temporário do sistema na instância de banco de dados do RDS para Db2, o IBM Db2 Data Management Console configurará automaticamente o banco de dados do repositório. Se você usar a instância do Db2 na instância do Amazon EC2 como banco de dados do repositório, o IBM Db2 Data Management Console criará automaticamente o grupo buffer e outros objetos.

1. Na janela **Definir aceitação do monitor de eventos de estatísticas**, escolha **Próximo**. 

1. (Opcional) Adicione uma nova conexão. Se você quiser usar uma instância de banco de dados do RDS para Db2 diferente para administração e monitoramento, adicione uma conexão a uma instância de banco de dados do RDS para Db2 que não seja do repositório.

   1. Na seção **Conexão e banco de dados**, insira as seguintes informações para a instância de banco de dados do RDS para Db2 para administração e monitoramento:
      + Em **Nome da conexão**, insira o identificador do banco de dados do Db2. 
      + Em **Host**, digite o nome do DNS da instância de banco de dados.
      + Em **Porta**, insira o número da porta da instância de banco de dados.
      + Em **Banco de dados**, insira o nome do banco de dados.  
![\[A seção Conexão e banco de dados para a nova conexão no IBM Db2 Data Management Console com os campos Host, Porta e Banco de dados.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-connection-database.png)

   1. Na seção **Segurança e credencial**** **, selecione **Habilitar coleta de dados de monitoramento**.

   1. Insira as seguintes informações da instância de banco de dados do RDS para Db2: 
      + Em **Username (Nome do usuário)**, digite o nome do administrador do banco de dados da instância de banco de dados.
      + Em **Senha**, digite a senha do administrador do banco de dados da instância de banco de dados.

   1. Selecione **Test connection (Testar conexão)**.

   1. Depois de testar a conexão com êxito, selecione **Salvar**.  
![\[Seção Segurança e credencial para nova conexão no IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-security-credential.png)

   Depois que a conexão é adicionada, uma janela semelhante à seguinte é exibida. Essa janela indica que o banco de dados foi configurado com êxito.  
![\[A janela indicando que o banco de dados foi configurado com êxito no IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-configuration-success.png)

1. Selecione **Ir para bancos de dados**. Uma janela Bancos de dados semelhante ao seguinte é exibida. Essa janela é um painel que mostra métricas, status e conexões.  
![\[Janela de visão geral de Bancos de dados no IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-database-view.png)

Agora você pode começar a usar o IBM Db2 Data Management Console.

## Usar o IBM Db2 Data Management Console
<a name="db2-using-dmc"></a>

É possível usar o IBM Db2 Data Management Console para fazer os seguintes tipos de tarefa:
+ Gerenciar várias instâncias de banco de dados do RDS para Db2.
+ Executar comandos SQL.
+ Examinear, criar ou alterar dados e objetos de banco de dados.
+ Criar declarações `EXPLAIN PLAN` em SQL.
+ Ajustar as consultas.

**Como executar comandos SQL e visualizar os resultados**

1. Na barra de navegação esquerda, selecione **SQL**.

1. Insira um comando SQL.

1. Selecione **Executar tudo**.

1. Para visualizar os resultados, selecione a guia **Resultados**.

![\[Janela Banco de dados mostrando como executar um comando SQL e visualizar os resultados no IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ibm-dmc-sql-run-example.png)


# Considerações sobre grupos de segurança com o Amazon RDS para Db2
<a name="db2-security-groups-considerations"></a>

Para se conectar à instância de banco de dados do Amazon RDS para Db2, ela deve estar associada a um grupo de segurança que contenha a configuração de rede e os endereços IP necessários. A instância de banco de dados do RDS para Db2 pode usar o grupo de segurança padrão. Se você atribuiu um grupo de segurança padrão não configurado ao criar a instância de banco de dados do RDS para Db2, o firewall impedirá conexões com a Internet. Para obter informações sobre como criar um novo security group, consulte [Controlar acesso com grupos de segurança](Overview.RDSSecurityGroups.md).

Depois de criar o novo security group, você modifica sua instância de banco de dados para associá-la a esse security group. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). 

Você pode aprimorar a segurança usando o SSL para criptografar conexões com sua a instância de banco de dados. Para obter mais informações, consulte [Usar SSL/TLS com uma instância de banco de dados do Amazon RDS para Db2](Db2.Concepts.SSL.md).