

# Solução de problemas do Amazon RDS para Db2
<a name="db2-troubleshooting"></a>

O conteúdo a seguir pode ajudar a solucionar problemas que você encontrar com o RDS para Db2.

Para ter mais informações sobre como solucionar problemas gerais do Amazon RDS, consulte [Solução de problemas para o Amazon RDS](CHAP_Troubleshooting.md).

**Topics**
+ [Erro de conexão de banco de dados](#db2-database-connection-error)
+ [Erro de E/S de arquivo](#db2-file-input-output-error)
+ [Erros de procedimentos armazenados](#db2-troubleshooting-stored-procedures)

## Erro de conexão de banco de dados
<a name="db2-database-connection-error"></a>

A mensagem de erro a seguir indica que um banco de dados falhou na conexão porque o servidor não tem memória suficiente.

```
SQL1643C The database manager failed to allocate shared memory because the
database manager instance memory limit has been reached.
```

Aumente a memória da instância de banco de dados e tente se conectar ao banco de dados novamente. Para obter informações sobre o uso da memória e recomendações para bancos de dados, consulte [Vários bancos de dados em uma instância de banco de dados do Amazon RDS para Db2](db2-multiple-databases.md). Para obter informações sobre como atualizar a memória de um banco de dados do RDS para Db2, consulte [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).

## Erro de E/S de arquivo
<a name="db2-file-input-output-error"></a>

Você pode encontrar um erro de E/S de arquivo por diferentes motivos, como quando você usa o comando `LOAD` ou chama o procedimento armazenado `rdsadmin.restore_database`. 

Neste exemplo, você executa o comando `LOAD` a seguir. 

```
db2 "call sysproc.admin_cmd('load from "DB2REMOTE://s3test//public/datapump/t6.del" of del lobs from "DB2REMOTE://s3test/public/datapump/" modified by lobsinfile MESSAGES ON SERVER insert INTO RDSDB.t6 nonrecoverable ')"
```

O comando `LOAD` exibe a seguinte mensagem:

```
  Result set 1
  --------------

  ROWS_READ            ROWS_SKIPPED         ROWS_LOADED          ROWS_REJECTED        ROWS_DELETED         ROWS_COMMITTED       ROWS_PARTITIONED     NUM_AGENTINFO_ENTRIES MSG_RETRIEVAL                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    MSG_REMOVAL
  -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
                     -                    -                    -                    -                    -                    -                    -                     - SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG                                                                                                                                                                                                                                                                                                                                                                                                                                            CALL SYSPROC.ADMIN_REMOVE_MSGS('1594987316_285548770')

  1 record(s) selected.

  Return Status = 0

SQL20397W  Routine "SYSPROC.ADMIN_CMD" execution has completed, but at least
one error, "SQL1652", was encountered during the execution. More information
is available.  SQLSTATE=01H52
```

Para visualizar a mensagem de erro, execute o comando SQL conforme sugerido na resposta anterior. `SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG` exibe a seguinte mensagem:

```
SQLCODE   MSG
--------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
SQL2025N  An I/O error occurred. Error code “438”. Media on which this error occurred: “DB2REMOTE://s3test//public/datapump/t6.del”

SQL3500W The utility is beginning the LOAD phase at time “07/05/2024 21:21:48.082954”

SQL1652N File I/O error occurred
```

Os logs de diagnóstico do Db2 contêm um arquivo de log semelhante ao seguinte:

```
2024-07-05-21.20.09.440609+000 I1191321E864          LEVEL: Error
PID     : 2710                 TID : 139619509200640 PROC : db2sysc 0
INSTANCE: rdsdb                NODE : 000            DB   : NTP
APPHDL  : 0-12180              APPID: xxx.xx.x.xxx.xxxxx.xxxxxxxxxxxx
UOWID   : 5                    ACTID: 1
AUTHID  : ADMIN                HOSTNAME: ip-xx-xx-x-xx
EDUID   : 147                  EDUNAME: db2lmr 0
FUNCTION: DB2 UDB, oper system services, sqloS3Client_GetObjectInfo, probe:219
MESSAGE : ZRC=0x870F01B6=-2029059658=SQLO_FAILED
          "An unexpected error is encountered"
DATA #1 : String, 29 bytes
S3:HeadObject request failed.
DATA #2 : signed integer, 4 bytes
99
DATA #3 : String, 0 bytes
Object not dumped: Address: 0x00007EFC08A9AE38 Size: 0 Reason: Zero-length data
DATA #4 : String, 33 bytes
curlCode: 28, Timeout was reached
```

Esse erro de E/S do arquivo pode se originar de vários cenários diferentes. Por exemplo, a VPC associada ao grupo de segurança usado para criar a instância de banco de dados do RDS para Db2 pode não ter um endpoint do gateway do Amazon S3. Esse endpoint é essencial para permitir que o RDS para Db2 acesse o Amazon S3. Se a instância de banco de dados do RDS para Db2 estiver em sub-redes privadas, será necessário um endpoint do gateway do Amazon S3. É possível especificar se a instância de banco de dados usa sub-redes privadas ou públicas configurando grupos de sub-redes do Amazon RDS. Para obter mais informações, consulte [Trabalhar com grupos de sub-redes de banco de dados](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).

**Topics**
+ [Etapa 1: Criar um endpoint do gateway da VPC para o Amazon S3](#db2-creating-endpoint)
+ [Etapa 2: Confirmar se o endpoint do gateway da VPC para o Amazon S3 existe](#db2-confirming-endpoint)

### Etapa 1: Criar um endpoint do gateway da VPC para o Amazon S3
<a name="db2-creating-endpoint"></a>

Para que a instância de banco de dados do RDS para Db2 interaja com o Amazon S3, crie uma VPC e, em seguida, um endpoint do gateway do Amazon S3 para uso de sub-redes privadas.

**Como criar um endpoint do gateway da VPC para o S3**

1. Crie uma VPC. Para obter mais informações, consulte [Crie uma VPC](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) no *Guia do usuário da Amazon Virtual Private Cloud*.

1. Crie um endpoint do gateway do Amazon S3 para uso de sub-redes privadas. Para obter mais informações, consulte [Gateway endpoints](https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-endpoints.html) no *Guia do AWS PrivateLink*.

### Etapa 2: Confirmar se o endpoint do gateway da VPC para o Amazon S3 existe
<a name="db2-confirming-endpoint"></a>

Confirme se você criou com sucesso um endpoint do gateway do Amazon S3 usando o Console de gerenciamento da AWS ou a AWS CLI.

#### Console
<a name="db2-confirming-endpoing-console"></a>

**Como confirmar um endpoint do gateway do Amazon S3**

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

1.  No canto superior direito do console, escolha a Região da AWS da VPC.

1. Selecione a VPC que você criou.

1. Na guia **Mapa de recursos**, em **Conexões de rede**, confirme se um endpoint do gateway do Amazon S3 está listado. 

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

Para confirmar um endpoint do gateway do Amazon S3, execute o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html). No exemplo a seguir, substitua *vpc\$1id* pelo ID da VPC, *region* pela sua Região da AWS, e *profile* pelo seu nome de perfil.

Para Linux, macOS ou Unix:

```
aws ec2 describe-vpc-endpoints \
    --filters "Name=vpc-id,Values=$vpc_id" \
    "Name=service-name,\
    Values=com.amazonaws.${region}.s3" \
    --region $region --profile=$profile \
    --query "VpcEndpoints[*].VpcEndpointId" --output text
```

Para Windows:

```
aws ec2 describe-vpc-endpoints ^
    --filters "Name=vpc-id,Values=$vpc_id" ^
    "Name=service-name,^
    Values=com.amazonaws.${region}.s3" ^
    --region $region --profile=$profile ^
    --query "VpcEndpoints[*].VpcEndpointId" --output text
```

Este comando produz uma saída semelhante ao exemplo a seguir se existir um endpoint do gateway do Amazon S3. 

```
[
    "vpce-0ea810434ff0b97e4"
]
```

Este comando produz uma saída semelhante ao exemplo a seguir se não existir um endpoint do gateway do Amazon S3. 

```
[]
```

Se você não vir um endpoint do gateway do Amazon S3 listado, então siga a [Etapa 1: Criar um endpoint do gateway da VPC para o Amazon S3](#db2-creating-endpoint). 

## Erros de procedimentos armazenados
<a name="db2-troubleshooting-stored-procedures"></a>

Esta sessão descreve vários erros exibidos ao chamar procedimentos armazenados e como resolvê-los.


| Categoria | Erros de procedimentos armazenados | 
| --- | --- | 
|  Bancos de dados  |  [Erros rdsadmin.activate\$1database](#db2-troubleshooting-activate-database-sp-errors)  | 
|  Bancos de dados  |  [erros rdsadmin.backup\$1database](#db2-troubleshooting-backup-database-sp-errors)  | 
|  Bancos de dados  |  [Erros rdsadmin.create\$1database](#db2-troubleshooting-create-database-sp-errors)  | 
|  Bancos de dados  |  [Erros rdsadmin.deactivate\$1database](#db2-troubleshooting-deactivate-database-sp-errors)  | 
|  Bancos de dados  |  [Erros rdsadmin.drop\$1database](#db2-troubleshooting-drop-database-sp-errors)  | 
|  Bancos de dados  |  [Erros rdsadmin.reactivate\$1database](#db2-troubleshooting-reactivate-database-sp-errors)  | 
|  Bancos de dados  |  [erros rdsadmin.restore\$1database](#db2-troubleshooting-restore-database-sp-errors)  | 
|  Bancos de dados  |  [Erros rdsadmin.update\$1db\$1param](#db2-troubleshooting-update-db-param-sp-errors)  | 
|  Tablespaces  |  [Erros rdsadmin.alter\$1tablespace](#db2-troubleshooting-alter-tablespace-sp-errors)  | 

### Erros rdsadmin.activate\$1database
<a name="db2-troubleshooting-activate-database-sp-errors"></a>

Os erros a seguir podem ocorrer quando o procedimento armazenado [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Failed to allocate shared memory](#activate-database-sp-failed-to-allocate-shared-memory)  |  `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.`  | 
|  [Unable to activate because of running processes](#activate-database-sp-unable-to-activate-processes)  |  `The database can’t be activated because it's in the process of being created or restored.`  | 

**Falha ao alocar memória compartilhada**

A mensagem de erro a seguir indica que o procedimento armazenado falhou ao ativar um banco de dados porque a instância de banco de dados não tem memória suficiente.

```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```

Aumente a memória da instância de banco de dados e, em seguida, chame o procedimento armazenado `rdsadmin.activate_database` novamente. Para obter informações sobre o uso da memória e recomendações para bancos de dados, consulte [Vários bancos de dados em uma instância de banco de dados do Amazon RDS para Db2](db2-multiple-databases.md).

**Não é possível ativar devido a processos em execução**

A mensagem de erro a seguir indica que o procedimento armazenado não pôde ativar um banco de dados porque o procedimento armazenado `rdsadmin.create_database` ou `rdsadmin.restore_database` está em execução.

```
The database can’t be activated because it's in the process of being created or restored.
```

Aguarde alguns minutos e, depois, chame o procedimento armazenado `rdsadmin.activate_database` novamente.

### Erros rdsadmin.alter\$1tablespace
<a name="db2-troubleshooting-alter-tablespace-sp-errors"></a>

Os erros a seguir podem ocorrer quando o procedimento armazenado [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Statement not valid](#alter-tablespace-sp-statement-not-valid)  |  `DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned: ` `SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"`  | 
|  [tablespace_prefetch_size value not valid](#alter-tablespace-sp-prefetch-value-not-valid)  |  `Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.`  | 
|  [tablespace_prefetch_size numerical value not valid](#alter-tablespace-sp-prefetch-numerical-value-not-valid)  |  `Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.`  | 
|  [Parameter can't be used with tablespace_prefetch_size](#alter-tablespace-sp-prefetch-incompatible-parameter)  |  `You can't use tablespace_prefetch_size with {parameter}.`  | 
|  [Tablespace change failed](#alter-tablespace-sp-tablespace-change-failed)  |  `The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.`  | 

**Instrução não válida**

A mensagem de erro a seguir indica que o procedimento armazenado combinou parâmetros opcionais mutuamente exclusivos com outros parâmetros opcionais. Os parâmetros opcionais `reduce_max, reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` e `switch_online` para o procedimento armazenado `rdsadmin.alter_tablespace` são mutuamente exclusivos. Não é possível combiná-los com nenhum outro parâmetro opcional, como `buffer_pool_name`, no procedimento armazenado `rdsadmin.alter_tablespace`. Se você combiná-los, ao chamar a função `rdsadmin.get_task_status` definida pelo usuário, o Db2 exibirá essa mensagem de erro. 

```
DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned: 
SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"
```

Chame o procedimento armazenado `rdsadmin.alter_tablespace` novamente sem combinar parâmetros opcionais mutuamente exclusivos com outros parâmetros opcionais. Depois, chame a função definida pelo usuário `rdsadmin.get_task_status`. Para ter mais informações, consulte [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) e [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

**valor de tablespace\$1prefetch\$1size inválido**

A mensagem de erro a seguir indica que você não definiu `tablespace_prefetch_size` como `AUTOMATIC` ou um valor numérico não positivo. Por exemplo, você tentou configurá-lo como `testinput`.

```
Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.
```

Chame o procedimento armazenado `rdsadmin.alter_tablespace` novamente e defina `tablespace_prefetch_size` como `AUTOMATIC` ou um valor numérico não positivo.

**valor numérico de tablespace\$1prefetch\$1size inválido**

A mensagem de erro a seguir indica que você definiu `tablespace_prefetch_size` como um valor numérico maior que 32767.

```
Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.
```

Chame o procedimento armazenado `rdsadmin.alter_tablespace` novamente e defina `tablespace_prefetch_size` como um valor numérico positivo diferente de zero menor ou igual a 32767.

**O parâmetro não pode ser usado com tablespace\$1prefetch\$1size**

A mensagem de erro a seguir indica que você tentou usar `tablespace_prefetch_size` com um parâmetro incompatível. 

```
You can't use tablespace_prefetch_size with {parameter}.
```

Chame o procedimento armazenado `rdsadmin.alter_tablespace` novamente e use somente `tablespace_prefetch_size` com parâmetros compatíveis. Consulte informações sobre parâmetros que podem ser usados com `tablespace_prefetch_size` em [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace).

**Falha na alteração do espaço de tabela**

A mensagem de erro a seguir indica que você tentou alterar um espaço de tabela. 

```
The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.
```

### erros rdsadmin.backup\$1database
<a name="db2-troubleshooting-backup-database-sp-errors"></a>

Os erros a seguir podem ocorrer quando o procedimento armazenado [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Insufficient disk space](#backup-database-sp-insufficient-disk-space)  |  `Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.`  | 
|  [Internal error](#backup-database-sp-internal-error)  |  `Caught exception during executing task id 104, Aborting task. Reason Internal Error`  | 

**Espaço em disco insuficiente**

A mensagem de erro a seguir indica que a instância de banco de dados não tem espaço em disco suficiente para fazer backup do banco de dados:

```
Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.
```

Ao fazer backup de um banco de dados no armazenamento remoto, verifique se você tem espaço livre em disco suficiente para a sessão de backup e os arquivos de trabalho. Cada sessão de backup processa até 5 GB de dados, mas é necessário espaço adicional para logs de transações, arquivos temporários e operações contínuas do banco de dados. 

Recomendamos que você tenha o seguinte espaço livre em disco para backups com base no tamanho do banco de dados:
+ Para bancos de dados com menos de 5 GB: o tamanho do banco de dados \$1 3 GB de buffer.
+ Para bancos de dados de 5 GB ou mais: pelo menos 10 GB de espaço livre.

Essa quantidade de espaço livre em disco é responsável pelo processamento da sessão de backup, pelo acúmulo de logs de transações durante o backup, pelos arquivos de trabalho temporários e pelos fluxos de backup paralelos, se configurados. Para obter mais informações, consulte [Aumento da capacidade de armazenamento da instância de banco de dados](USER_PIOPS.ModifyingExisting.md).

Aumente o espaço em disco e, em seguida, chame o procedimento armazenado [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) novamente. Para confirmar se o backup do banco de dados foi feito corretamente, confira o status da tarefa usando [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). Você também pode verificar se os arquivos de backup existem em seu bucket do Amazon S3 em *s3\$1prefix/dbi\$1resource\$1id/db\$1name*.

**Erro interno**

A mensagem de erro a seguir indica que o procedimento armazenado encontrou um erro interno: 

```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```

Entrar em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).

### Erros rdsadmin.create\$1database
<a name="db2-troubleshooting-create-database-sp-errors"></a>

O erro a seguir pode ocorrer quando o procedimento armazenado [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Failed to allocate shared memory](#create-database-sp-failed-to-allocate-shared-memory)  |  `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.`  | 

**Falha ao alocar memória compartilhada**

A mensagem de erro a seguir indica que o procedimento armazenado falhou ao criar um banco de dados porque a instância de banco de dados não tem memória suficiente.

```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```

Aumente a memória da instância de banco de dados e, em seguida, chame o procedimento armazenado `rdsadmin.create_database` novamente. Para obter informações sobre o uso da memória e recomendações para bancos de dados, consulte [Vários bancos de dados em uma instância de banco de dados do Amazon RDS para Db2](db2-multiple-databases.md).

Para confirmar que o banco de dados foi criado, chame a função [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) definida pelo usuário e verifique se o novo banco de dados está listado.

### Erros rdsadmin.deactivate\$1database
<a name="db2-troubleshooting-deactivate-database-sp-errors"></a>

O erro a seguir pode ocorrer quando o procedimento armazenado [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Unable to deactivate because of running processes](#deactivate-database-sp-unable-to-deactivate-processes)  |  `The database can’t be deactivated because it's in the process of being created or restored.`  | 

**Não é possível desativar devido a processos em execução**

A mensagem de erro a seguir indica que o procedimento armazenado não pôde desativar um banco de dados porque o procedimento armazenado `rdsadmin.create_database` ou `rdsadmin.restore_database` está em execução.

```
The database can’t be deactivated because it's in the process of being created or restored.
```

Aguarde alguns minutos e, depois, chame o procedimento armazenado `rdsadmin.deactivate_database` novamente.

### Erros rdsadmin.drop\$1database
<a name="db2-troubleshooting-drop-database-sp-errors"></a>

Os erros a seguir podem ocorrer quando o procedimento armazenado [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Database name doesn't exist](#drop-database-sp-database-name-not-exist)  |  `SQL0438N Application raised error or warning with diagnostic text: "Cannot drop database. Database with provided name does not exist". SQLSTATE=99993`  | 
|  [Return status = 0](#drop-database-sp-return-status-zero)  |  `Return Status = 0`  | 
|  [Dropping database not allowed](#drop-database-sp-not-allowed)  |  `1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started. 2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. Reason Dropping database created via rds CreateDBInstance api is not allowed. Only database created using rdsadmin.create_database can be dropped`  | 

**O nome do banco de dados não existe**

A mensagem de erro a seguir indica que você transmitiu um nome de banco de dados incorreto no procedimento armazenado `rdsadmin.drop_database`.

```
SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993
```

Chame o procedimento armazenado `rdsadmin.drop_database` novamente com um nome de banco de dados correto. Para confirmar que o banco de dados foi descartado, chame a função [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) definida pelo usuário e verifique se o banco de dados descartado não está listado.

**Status de retorno = 0**

A mensagem de erro a seguir indica que o procedimento armazenado não pôde ser concluído. 

```
Return Status = 0
```

Depois de receber `Return Status = 0`, chame a função definida pelo usuário [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

**Não é permitido descartar o banco de dados**

A mensagem de erro a seguir indica que você criou o banco de dados usando o console do Amazon RDS ou a AWS CLI. Só é possível usar o procedimento armazenado `rdsadmin.drop_database` se você criou o banco de dados chamando o procedimento armazenado [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).

```
1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped
```

Para descartar um banco de dados que foi criado usando o console do Amazon RDS ou a AWS CLI, use um cliente para se conectar ao banco de dados e execute o comando apropriado.

### Erros rdsadmin.reactivate\$1database
<a name="db2-troubleshooting-reactivate-database-sp-errors"></a>

O erro a seguir pode ocorrer quando o procedimento armazenado [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Failed to allocate shared memory](#reactivate-database-sp-failed-to-allocate-shared-memory)  |  `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.`  | 
|  [Unable to reactivate because of running processes](#reactivate-database-sp-unable-to-reactivate-processes)  |  `The database can’t be reactivated because it's in the process of being created or restored.`  | 

**Falha ao alocar memória compartilhada**

A mensagem de erro a seguir indica que o procedimento armazenado falhou ao ativar um banco de dados porque a instância de banco de dados não tem memória suficiente.

```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```

Aumente a memória da instância de banco de dados e, em seguida, chame o procedimento armazenado `rdsadmin.activate_database` novamente. Para obter informações sobre o uso da memória e recomendações para bancos de dados, consulte [Vários bancos de dados em uma instância de banco de dados do Amazon RDS para Db2](db2-multiple-databases.md).

**Não é possível reativar devido a processos em execução**

A mensagem de erro a seguir indica que o procedimento armazenado não pôde reativar um banco de dados porque o procedimento armazenado `rdsadmin.create_database` ou `rdsadmin.restore_database` está em execução.

```
The database can’t be reactivated because it's in the process of being created or restored.
```

Aguarde alguns minutos e, depois, chame o procedimento armazenado `rdsadmin.reactivate_database` novamente.

### erros rdsadmin.restore\$1database
<a name="db2-troubleshooting-restore-database-sp-errors"></a>

Os seguintes erros podem ocorrer quando você chama o procedimento armazenado [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database):


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Insufficient disk space](#restore-database-sp-insufficient-disk-space)  |  `Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.`  | 
|  [Internal error](#restore-database-sp-internal-error)  |  `Caught exception during executing task id 104, Aborting task. Reason Internal Error`  | 
|  [Non-fenced routines not allowed](#restore-database-sp-non-fenced-routines)  |  `Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.`  | 
| [Tablespaces not restored](#restore-database-sp-tablespaces-not-restored) |  `Reason SQL0970N The system attempted to write to a read-only file. Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.`  | 

**Espaço em disco insuficiente**

A mensagem de erro a seguir indica que a instância de banco de dados não tem espaço em disco suficiente para restaurar o banco de dados:

```
Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.
```

O espaço livre na instância de banco de dados deve ser mais de duas vezes maior que o tamanho da imagem de backup. Se a imagem de backup estiver compactada, o espaço livre na instância de banco de dados deverá ser mais de três vezes maior que o tamanho da imagem de backup. Para obter mais informações, consulte [Aumento da capacidade de armazenamento da instância de banco de dados](USER_PIOPS.ModifyingExisting.md).

Aumente o espaço em disco e, em seguida, chame o procedimento armazenado `rdsadmin.restore_database` novamente. Para confirmar que o banco de dados foi restaurado, chame a função [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) definida pelo usuário e verifique se o banco de dados restaurado está listado.

**Erro interno**

A mensagem de erro a seguir indica que o procedimento armazenado encontrou um erro interno: 

```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```

Entrar em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/).

**Rotinas não protegidas não são permitidas**

A seguinte mensagem de erro indica que o banco de dados contém rotinas não protegidas:

```
Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.
```

O RDS para Db2 não permite rotinas não protegidas. Remova as rotinas não protegidas do banco de dados de origem e chame `rdsadmin.restore_database` novamente. Para confirmar que o banco de dados foi restaurado, chame a função [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) definida pelo usuário e verifique se o banco de dados restaurado está listado. Para obter mais informações, consulte [Rotinas não protegidas](db2-known-issues-limitations.md#db2-known-issues-limitations-non-fenced-routines).

**Espaços de tabela não restaurados**

A seguinte mensagem de erro indica que o RDS para Db2 restaurou com sucesso o banco de dados, mas não conseguiu restaurar um ou mais espaços de tabela:

```
Reason SQL0970N The system attempted to write to a read-only file.
Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.
```

O RDS para Db2 não permite armazenamento não automático. Converta o armazenamento não automático em automático e chame `rdsadmin.restore_database` novamente. Consulte mais informações em [Converting a nonautomatic storage database to use automatic storage](https://www.ibm.com/docs/en/db2/11.5?topic=databases-converting-nonautomatic-storage-database-use-automatic-storage) na documentação do IBM Db2.

Bancos de dados com armazenamento não automático de SMS exigem restauração manual. Se o seu banco de dados tiver armazenamento não automático de SMS, entre em contato com o [AWS Support](https://aws.amazon.com/premiumsupport/). 

Consulte informações sobre o armazenamento não automático e migrações únicas em [Espaços de tabela de armazenamento não automáticos durante a migração](db2-known-issues-limitations.md#db2-known-issues-limitations-non-automatic-storage-tablespaces).

### Erros rdsadmin.update\$1db\$1param
<a name="db2-troubleshooting-update-db-param-sp-errors"></a>

O erro a seguir pode ocorrer quando o procedimento armazenado [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) é chamado.


| Erro | A mensagem de erro | 
| --- | --- | 
|  [Parameter not supported or modifiable](#update-db-param-sp-parameter-not-supported-modifiable)  | SQL0438N Application raised error or warning with diagnostic text: "Parameter is either not supported or not modifiable to customers". SQLSTATE=99993 | 

**Parâmetro incompatível ou não modificável**

A mensagem de erro a seguir indica que você tentou modificar um parâmetro de configuração de banco de dados que não é compatível ou não é modificável.

```
SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993
```

É possível ver quais parâmetros são modificáveis visualizando os grupos de parâmetros. Para obter mais informações, consulte [Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Viewing.md).