

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á.

# Trabalhando com scripts de suporte de diagnóstico em AWS DMS
<a name="CHAP_SupportScripts"></a>

Se você encontrar algum problema ao trabalhar com AWS DMS, seu engenheiro de suporte pode precisar de mais informações sobre seu banco de dados de origem ou de destino. Queremos garantir que o AWS Support receba o máximo possível das informações necessárias no menor tempo possível. Portanto, desenvolvemos scripts para consultar essas informações para vários dos principais mecanismos de bancos de dados relacionais.

Se um script de suporte estiver disponível para o banco de dados, baixe-o utilizando o link no tópico do script correspondente descrito a seguir. Depois de verificar e analisar o script (descrito a seguir), é possível executá-lo de acordo com o procedimento descrito no tópico do script. Quando a execução do script estiver concluída, você poderá fazer o upload da saída para o seu caso de AWS Support (novamente, descrito a seguir).

Antes de executar o script, é possível detectar quaisquer erros que possam ter sido introduzidos ao baixar ou armazenar o script de suporte. Para fazer isso, compare a soma de verificação do arquivo de script com um valor fornecido por AWS. AWS usa o SHA256 algoritmo para a soma de verificação.

**Como verificar o arquivo de script de suporte utilizando uma soma de verificação**

1. Abra o arquivo de soma de verificação mais recente fornecido para verificar esses scripts de suporte em [https://d2pwp9zz55emqw.cloudfront.net/sha256Check.txt](https://d2pwp9zz55emqw.cloudfront.net/sha256Check.txt). Por exemplo, o arquivo pode ter conteúdo como o seguinte.

   ```
   MYSQL  dfafd0d511477c699f96c64693ad0b1547d47e74d5c5f2f2025b790b1422e3c8
   ORACLE  6c41ebcfc99518cfa8a10cb2ce8943b153b2cc7049117183d0b5de3d551bc312
   POSTGRES  6ccd274863d14f6f3146fbdbbba43f2d8d4c6a4c25380d7b41c71883aa4f9790
   SQL_SERVER  971a6f2c46aec8d083d2b3b6549b1e9990af3a15fe4b922e319f4fdd358debe7
   ```

1. Execute o comando de SHA256 validação do seu sistema operacional no diretório que contém o arquivo de suporte. Por exemplo, no sistema operacional macOS, é possível executar o comando a seguir em um script de suporte do Oracle descrito posteriormente neste tópico.

   ```
   shasum -a 256 awsdms_support_collector_oracle.sql
   ```

1. Compare os resultados do comando com o valor mostrado no arquivo `sha256Check.txt` aberto mais recentemente. Os dois valores devem corresponder. Caso contrário, entre em contato com o seu engenheiro de suporte sobre a incompatibilidade e sobre como é possível obter um arquivo de script de suporte limpo.

Se você tiver um arquivo de script de suporte limpo, antes de executar o script, leia e compreenda o SQL da perspectiva de desempenho e de segurança. Se você não se sentir confortável para executar algum SQL nesse script, poderá comentar ou remover o SQL problemático. Também é possível consultar o seu engenheiro de suporte sobre quaisquer soluções alternativas aceitáveis.

Após a conclusão bem-sucedida e salvo indicação em contrário, o script retorna a saída em um formato HTML legível. O script foi projetado para excluir desse HTML quaisquer dados ou detalhes de segurança que possam comprometer a sua empresa. Ele também não faz modificações no banco de dados ou no ambiente. No entanto, se você encontrar alguma informação no HTML que não se sente à vontade para compartilhar, sinta-se à vontade para remover as informações do problema antes de fazer o upload do HTML. Quando o HTML for aceitável, faça upload dele utilizando os **Anexos** nos **Detalhes do caso** do seu caso de suporte.

Cada um dos tópicos a seguir descreve os scripts disponíveis para um AWS DMS banco de dados compatível e como executá-los. O seu engenheiro de suporte direcionará você para um script específico documentado a seguir.

**Topics**
+ [Scripts de suporte a diagnóstico do Oracle](CHAP_SupportScripts.Oracle.md)
+ [Scripts de suporte de diagnóstico do SQL Server](CHAP_SupportScripts.SQLServer.md)
+ [Scripts de suporte de diagnóstico para bancos de dados compatíveis com o MySQL](CHAP_SupportScripts.MySQL.md)
+ [Scripts de apoio diagnóstico do PostgreSQL](CHAP_SupportScripts.PostgreSQL.md)

# Scripts de suporte a diagnóstico do Oracle
<a name="CHAP_SupportScripts.Oracle"></a>

A seguir, você pode encontrar os scripts de suporte de diagnóstico disponíveis para analisar um banco de dados local ou do Amazon RDS for Oracle em AWS DMS sua configuração de migração. Esses scripts funcionam com um endpoint de origem ou de destino. Todos os scripts são escritos para serem executados no utilitário de linha de comando SQL\$1Plus. Para obter mais informações sobre como utilizar esse utilitário, consulte [Utilizar a linha de comandos do SQL](https://docs.oracle.com/cd/B25329_01/doc/appdev.102/b25108/xedev_sqlplus.htm) na documentação do Oracle.

Antes de executar o script, verifique se a conta de usuário que você utiliza tem as permissões necessárias para acessar o banco de dados Oracle. As configurações de permissões mostradas pressupõem que um usuário tenha sido criado da seguinte forma.

```
CREATE USER script_user IDENTIFIED BY password;
```

Para um banco de dados on-premises, defina as permissões mínimas conforme mostrado a seguir para `script_user`.

```
GRANT CREATE SESSION TO script_user;
GRANT SELECT on V$DATABASE to script_user;
GRANT SELECT on V$VERSION to script_user;
GRANT SELECT on GV$SGA to script_user;
GRANT SELECT on GV$INSTANCE to script_user;
GRANT SELECT on GV$DATAGUARD_CONFIG to script_user;
GRANT SELECT on GV$LOG to script_user;
GRANT SELECT on DBA_TABLESPACES to script_user;
GRANT SELECT on DBA_DATA_FILES to script_user;
GRANT SELECT on DBA_SEGMENTS to script_user;
GRANT SELECT on DBA_LOBS to script_user;
GRANT SELECT on V$ARCHIVED_LOG to script_user;
GRANT SELECT on DBA_TAB_MODIFICATIONS to script_user;
GRANT SELECT on DBA_TABLES to script_user;
GRANT SELECT on DBA_TAB_PARTITIONS to script_user;
GRANT SELECT on DBA_MVIEWS to script_user;
GRANT SELECT on DBA_OBJECTS to script_user;
GRANT SELECT on DBA_TAB_COLUMNS to script_user;
GRANT SELECT on DBA_LOG_GROUPS to script_user;
GRANT SELECT on DBA_LOG_GROUP_COLUMNS to script_user;
GRANT SELECT on V$ARCHIVE_DEST to script_user;
GRANT SELECT on DBA_SYS_PRIVS to script_user;
GRANT SELECT on DBA_TAB_PRIVS to script_user;
GRANT SELECT on DBA_TYPES to script_user;
GRANT SELECT on DBA_CONSTRAINTS to script_user;
GRANT SELECT on V$TRANSACTION to script_user;
GRANT SELECT on GV$ASM_DISK_STAT to script_user;
GRANT SELECT on GV$SESSION to script_user;
GRANT SELECT on GV$SQL to script_user;
GRANT SELECT on DBA_ENCRYPTED_COLUMNS to script_user;
GRANT SELECT on DBA_PDBS to script_user;

GRANT EXECUTE on dbms_utility to script_user;
```

Para um banco de dados Amazon RDS, defina as permissões mínimas conforme mostrado a seguir.

```
GRANT CREATE SESSION TO script_user;
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$DATABASE','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$VERSION','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$SGA','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$INSTANCE','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$DATAGUARD_CONFIG','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$LOG','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACES','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_DATA_FILES','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_SEGMENTS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_LOBS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$ARCHIVED_LOG','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_MODIFICATIONS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLES','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_PARTITIONS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_MVIEWS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_LOG_GROUPS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_LOG_GROUP_COLUMNS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$ARCHIVE_DEST','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_SYS_PRIVS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_PRIVS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TYPES','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_CONSTRAINTS','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('V_$TRANSACTION','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$ASM_DISK_STAT','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$SESSION','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('GV_$SQL','script_user','SELECT');
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ENCRYPTED_COLUMNS','script_user','SELECT');

exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_PDBS','script_user','SELECT');

exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY','script_user','EXECUTE');
```

A seguir, é possível encontrar descrições de como baixar, revisar e executar cada script de suporte do SQL\$1Plus disponível para Oracle. Também é possível encontrar como analisar e enviar o resultado para o seu caso de AWS Support.

**Topics**
+ [awsdms\$1support\$1collector\$1oracle.sql script](#CHAP_SupportScripts.Oracle.Awsdms_Support_Collector_Oracle_Script)

## awsdms\$1support\$1collector\$1oracle.sql script
<a name="CHAP_SupportScripts.Oracle.Awsdms_Support_Collector_Oracle_Script"></a>

Baixe o script [https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_oracle.sql](https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_oracle.sql).

Esse script coleta informações sobre a configuração do banco de dados Oracle. Lembre-se de verificar a soma de verificação no script e, se a soma de verificação estiver verificada, revise o código SQL no script para comentar qualquer código que você não se sente à vontade para executar. Quando estiver satisfeito com a integridade e o conteúdo do script, será possível executá-lo.

**Como executar o script e fazer upload dos resultados para o caso de suporte**

1. Execute o script em seu ambiente de banco de dados utilizando a seguinte linha de comando do SQL\$1Plus.

   ```
   SQL> @awsdms_support_collector_oracle.sql
   ```

   O script exibe uma breve descrição e uma solicitação para continuar ou abortar a execução. Pressione [Enter] para continuar.

1. No prompt a seguir, insira o nome de somente um dos esquemas que deseja migrar.

1. No prompt a seguir, insira o nome do usuário (*script\$1user*) definido para se conectar ao banco de dados.

1. No prompt a seguir, insira o número de dias dos dados que você deseja examinar ou aceite o padrão. O script coleta os dados especificados no banco de dados.

   Depois de concluído, o script exibirá o nome do arquivo HTML de saída, por exemplo `dms_support_oracle-2020-06-22-13-20-39-ORCL.html`. O script salva esse arquivo em seu diretório de trabalho.

1. Revise esse arquivo HTML e remova todas as informações que você não se sente à vontade para compartilhar. Quando o HTML for aceitável para você compartilhar, faça o upload do arquivo para o seu caso de AWS Support. Para obter mais informações sobre como fazer upload desse arquivo, consulte [Trabalhando com scripts de suporte de diagnóstico em AWS DMS](CHAP_SupportScripts.md).

# Scripts de suporte de diagnóstico do SQL Server
<a name="CHAP_SupportScripts.SQLServer"></a>

A seguir, você encontrará uma descrição dos scripts de suporte de diagnóstico disponíveis para analisar um banco de dados local ou do Amazon RDS for SQL Server em AWS DMS sua configuração de migração. Esses scripts funcionam com um endpoint de origem ou de destino. Para um banco de dados on-premises, execute esses scripts no utilitário de linha de comando sqlcmd. Para obter mais informações sobre como usar esse utilitário, consulte [sqlcmd: utilizar o utilitário](https://docs.microsoft.com/en-us/sql/ssms/scripting/sqlcmd-use-the-utility?view=sql-server-ver15) na documentação da Microsoft. 

Para um banco de dados Amazon RDS, não é possível se conectar utilizando o utilitário de linha de comando sqlcmd. Em vez disso, execute esses scripts utilizando qualquer ferramenta de cliente que se conecte ao SQL Server do Amazon RDS.

Antes de executar o script, verifique se a conta de usuário utilizada tem as permissões necessárias para acessar o banco de dados SQL Server. Para um banco de dados on-premises e para um banco de dados Amazon RDS, é possível utilizar as mesmas permissões utilizadas para acessar o banco de dados SQL Server sem o perfil `SysAdmin`.

**Topics**
+ [Configurar permissões mínimas para um banco de dados SQL Server on-premises](#CHAP_SupportScripts.SQLServer.onprem)
+ [Configurar permissões mínimas para um banco de dados SQL Server do Amazon RDS](#CHAP_SupportScripts.SQLServer.rds)
+ [Scripts de suporte do SQL Server](#CHAP_SupportScripts.SQLServer.Scripts)

## Configurar permissões mínimas para um banco de dados SQL Server on-premises
<a name="CHAP_SupportScripts.SQLServer.onprem"></a>

**Configurar permissões mínimas para executar um banco de dados SQL Server on-premises**

1. Crie uma conta do SQL Server com autenticação por senha utilizando o SQL Server Management Studio (SSMS), por exemplo `on-prem-user`.

1. Na seção **Mapeamentos de usuário** do SSMS, escolha os bancos de dados **MSDB** e **MASTER** (que fornecem permissão pública) e atribua o perfil `DB_OWNER` ao banco de dados no qual você deseja executar a replicação contínua.

1. Abra o menu de contexto (clique com o botão direito do mouse) para a nova conta e escolha **Segurança** para conceder explicitamente o privilégio `Connect SQL`. 

1. Execute os seguintes comandos de concessão.

   ```
   GRANT VIEW SERVER STATE TO on-prem-user;
   USE MSDB;
   GRANT SELECT ON MSDB.DBO.BACKUPSET TO on-prem-user;
   GRANT SELECT ON MSDB.DBO.BACKUPMEDIAFAMILY TO on-prem-user;
   GRANT SELECT ON MSDB.DBO.BACKUPFILE TO on-prem-user;
   ```

## Configurar permissões mínimas para um banco de dados SQL Server do Amazon RDS
<a name="CHAP_SupportScripts.SQLServer.rds"></a>

**Como executar com as permissões mínimas para um banco de dados SQL Server do Amazon RDS**

1. Crie uma conta do SQL Server com autenticação por senha utilizando o SQL Server Management Studio (SSMS), por exemplo `rds-user`.

1. Na seção **Mapeamentos de usuário** do SSMS, escolha os bancos de dados do **MSDB** (que fornece permissão pública) e atribua o perfil `DB_OWNER` ao banco de dados em que você deseja executar o script.

1. Abra o menu de contexto (clique com o botão direito do mouse) para a nova conta e escolha **Segurança** para conceder explicitamente o privilégio `Connect SQL`.

1. Execute os seguintes comandos de concessão.

   ```
   GRANT VIEW SERVER STATE TO rds-user;
   USE MSDB;
   GRANT SELECT ON MSDB.DBO.BACKUPSET TO rds-user;
   GRANT SELECT ON MSDB.DBO.BACKUPMEDIAFAMILY TO rds-user;
   GRANT SELECT ON MSDB.DBO.BACKUPFILE TO rds-user;
   ```

## Scripts de suporte do SQL Server
<a name="CHAP_SupportScripts.SQLServer.Scripts"></a>

Os tópicos a seguir descrevem como baixar, revisar e executar cada script de suporte disponível para o SQL Server. Eles também descrevem como analisar e fazer upload do resultado do script para o seu caso do AWS Support.

**Topics**
+ [awsdms\$1support\$1collector\$1sql\$1server.sql script](#CHAP_SupportScripts.SQLServer.Awsdms_Support_Collector_SQLServer_Script)

### awsdms\$1support\$1collector\$1sql\$1server.sql script
<a name="CHAP_SupportScripts.SQLServer.Awsdms_Support_Collector_SQLServer_Script"></a>

Baixe o script [https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_sql_server.sql](https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_sql_server.sql).

**nota**  
Execute esse script de apoio diagnóstico somente no SQL Server 2014 e em versões superiores.

Esse script coleta informações sobre a configuração do banco de dados SQL Server. Lembre-se de verificar a soma de verificação no script e, se a soma de verificação estiver verificada, revise o código SQL no script para comentar qualquer código que você não se sente à vontade para executar. Quando estiver satisfeito com a integridade e o conteúdo do script, será possível executá-lo.

**Como executar o script para um banco de dados SQL Server on-premises**

1. Execute o script utilizando a linha de comando sqlcmd a seguir.

   ```
   sqlcmd -Uon-prem-user -Ppassword -SDMS-SQL17AG-N1 -y 0 
   -iC:\Users\admin\awsdms_support_collector_sql_server.sql -oC:\Users\admin\DMS_Support_Report_SQLServer.html -dsqlserverdb01
   ```

   Os parâmetros do comando sqlcmd especificados incluem o seguinte:
   + `-U`: nome do usuário do banco de dados.
   + `-P`: senha do usuário do banco de dados.
   + `-S`: nome do servidor do banco de dados SQL Server.
   + `-y`: largura máxima das colunas de saída do utilitário sqlcmd. Um valor de 0 especifica colunas de largura ilimitada.
   + `-i`: caminho do script de suporte a ser executado, neste caso `awsdms_support_collector_sql_server.sql`.
   + `-o`: caminho do arquivo HTML de saída, com um nome de arquivo que você especifica, contendo as informações de configuração do banco de dados coletado.
   + `-d`: nome do banco de dados SQL Server.

1. Depois que o script for concluído, revise o arquivo HTML de saída e remova todas as informações que você não se sente à vontade para compartilhar. Quando o HTML for aceitável para você compartilhar, faça o upload do arquivo para o seu caso de AWS Support. Para obter mais informações sobre como fazer upload desse arquivo, consulte [Trabalhando com scripts de suporte de diagnóstico em AWS DMS](CHAP_SupportScripts.md).

Com o Amazon RDS para SQL Server, não é possível se conectar utilizando o utilitário de linha de comando sqlcmd, portanto, utilize o procedimento a seguir.

**Como executar o script para um banco de dados RDS SQL Server**

1. Execute o script utilizando qualquer ferramenta de cliente que permita conectar-se ao RDS SQL Server como o usuário `Master` e salve a saída como um arquivo HTML.

1. Revise o arquivo HTML de saída e remova todas as informações que você não se sente à vontade para compartilhar. Quando o HTML for aceitável para você compartilhar, faça o upload do arquivo para o seu caso de AWS Support. Para obter mais informações sobre como fazer upload desse arquivo, consulte [Trabalhando com scripts de suporte de diagnóstico em AWS DMS](CHAP_SupportScripts.md).

# Scripts de suporte de diagnóstico para bancos de dados compatíveis com o MySQL
<a name="CHAP_SupportScripts.MySQL"></a>

A seguir, você pode encontrar os scripts de suporte de diagnóstico disponíveis para analisar um banco de dados local ou compatível com Amazon RDS para MySQL em sua configuração de migração. AWS DMS Esses scripts funcionam com um endpoint de origem ou de destino. Todos os scripts são escritos para serem executados na linha de comando do MySQL. 

Para obter informações sobre como instalar o cliente MySQL, consulte [Instalar o shell do MySQL](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install.html) na documentação do MySQL. Para obter informações sobre como utilizar o cliente MySQL, consulte [Utilizar comandos do shell do MySQL](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-configuring.html) na documentação do MySQL.

Antes de executar um script, verifique se a conta de usuário utilizada possui as permissões necessárias para acessar o banco de dados compatível com MySQL. Utilize o procedimento a seguir para criar uma conta de usuário e fornecer as permissões mínimas necessárias para executar esse script.

**Como configurar uma conta de usuário com as permissões mínimas para executar esses scripts**

1. Crie o usuário para executar os scripts.

   ```
   create user 'username'@'hostname' identified by password;
   ```

1. Conceda o comando `select` nos bancos de dados para analisá-los.

   ```
   grant select on database-name.* to username;
   grant replication client on *.* to username;
   ```

1. 

   ```
   grant execute on procedure mysql.rds_show_configuration to username;
   ```

Os tópicos a seguir descrevem como baixar, revisar e executar cada script de suporte disponível para um banco de dados compatível com o MySQL. Eles também descrevem como revisar e enviar a saída do script para seu caso de AWS Support.

**Topics**
+ [awsdms\$1support\$1collector\$1MySQL.sql script](#CHAP_SupportScripts.MySQL.Awsdms_Support_Collector_MySQL_Script)

## awsdms\$1support\$1collector\$1MySQL.sql script
<a name="CHAP_SupportScripts.MySQL.Awsdms_Support_Collector_MySQL_Script"></a>

Baixe o script [https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_MySQL.sql](https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_MySQL.sql).

Esse script coleta informações sobre a configuração do banco de dados compatível com o MySQL. Lembre-se de verificar a soma de verificação no script e, se a soma de verificação estiver verificada, revise o código SQL no script para comentar qualquer código que você não se sente à vontade para executar. Quando estiver satisfeito com a integridade e o conteúdo do script, será possível executá-lo.

Execute o script depois de se conectar ao ambiente de banco de dados utilizando a linha de comando.

**Como executar esse script e fazer upload dos resultados para o caso de suporte**

1. Conecte-se ao banco de dados utilizando o seguinte comando `mysql`.

   ```
   mysql -p -h hostname -P port -u username database-name
   ```

1. Execute o script utilizando o seguinte comando `source`.

   ```
   source awsdms_support_collector_MySQL.sql
   ```

   Analise o relatório gerado e remova todas as informações que você não se sente à vontade para compartilhar. Quando o conteúdo for aceitável para compartilhar, faça upload do arquivo para o seu caso do AWS Support. Para obter mais informações sobre como fazer upload desse arquivo, consulte [Trabalhando com scripts de suporte de diagnóstico em AWS DMS](CHAP_SupportScripts.md).

**nota**  
Se você já tiver uma conta de usuário com os privilégios necessários descritos em [Scripts de suporte de diagnóstico para bancos de dados compatíveis com o MySQL](#CHAP_SupportScripts.MySQL), poderá utilizar a conta de usuário existente para executar o script.
Lembre-se de se conectar ao banco de dados antes de executar o script.
O script gera sua saída no formato de texto.
Com as práticas recomendadas de segurança em mente, se você criar uma nova conta de usuário somente para executar esse script de apoio diagnóstico do MySQL. É recomendável excluir essa conta de usuário após a execução bem-sucedida do script.

# Scripts de apoio diagnóstico do PostgreSQL
<a name="CHAP_SupportScripts.PostgreSQL"></a>

A seguir, você pode encontrar os scripts de suporte de diagnóstico disponíveis para analisar qualquer RDBMS PostgreSQL (local, Amazon RDS ou Aurora PostgreSQL) em sua configuração de migração. AWS DMS Esses scripts funcionam com um endpoint de origem ou de destino. Os scripts são todos escritos para serem executados no utilitário de linha de comando psql. 

Antes de executar esses scripts, verifique se a conta de usuário utilizada possui as seguintes permissões necessárias para acessar qualquer PostgreSQL RDBMS:
+ PostgreSQL 10.x ou superior: uma conta de usuário com permissão de execução no perfil `pg_catalog.pg_ls_waldir`.
+ PostgreSQL 9.x ou anterior: uma conta de usuário com permissões padrão.

É recomendável utilizar uma conta existente com as permissões apropriadas para executar esses scripts.

Se for necessário criar uma conta de usuário ou conceder permissões a uma conta existente para executar esses scripts, é possível executar os seguintes comandos SQL para qualquer PostgreSQL RDBMS com base na versão do PostgreSQL.

**Como conceder permissões à conta para executar esses scripts em bancos de dados PostgreSQL versão 10.x ou superior**
+ Execute um dos seguintes procedimentos:
  + Para uma nova conta de usuário, execute o seguinte.

    ```
    CREATE USER script_user WITH PASSWORD 'password';
    GRANT EXECUTE ON FUNCTION pg_catalog.pg_ls_waldir TO script_user;
    ```
  + Para uma conta de usuário existente, execute o seguinte.

    ```
    GRANT EXECUTE ON FUNCTION pg_catalog.pg_ls_waldir TO script_user;
    ```

**Como conceder permissões à conta para executar esses scripts para um banco de dados PostgreSQL 9.x ou superior**
+ Execute um destes procedimentos:
  + Para uma nova conta de usuário, execute o seguinte com as permissões padrão.

    ```
    CREATE USER script_user WITH PASSWORD password;
    ```
  + Para uma conta de usuário existente, utilize as permissões existentes.

**nota**  
Esses scripts não são compatíveis com determinadas funcionalidades relacionadas à localização do tamanho do WAL para bancos de dados PostgreSQL 9.x e anteriores. Para obter mais informações, trabalhe com o AWS Support.

Os tópicos a seguir descrevem como baixar, revisar e executar cada script de apoio disponível para o PostgreSQL. Eles também descrevem como revisar e fazer upload da saída do script para o caso do AWS Support.

**Topics**
+ [awsdms\$1support\$1collector\$1postgres.sql script](#CHAP_SupportScripts.PostgreSQL.Awsdms_Support_Collector_PostgreSQL_Script)

## awsdms\$1support\$1collector\$1postgres.sql script
<a name="CHAP_SupportScripts.PostgreSQL.Awsdms_Support_Collector_PostgreSQL_Script"></a>

Baixe o script [https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_postgres.sql](https://d2pwp9zz55emqw.cloudfront.net/scripts/awsdms_support_collector_postgres.sql).

Esse script coleta informações sobre a configuração do banco de dados PostgreSQL. Lembre-se de verificar a soma de verificação no script. Se a soma de verificação for verificada, revise o código SQL no script para comentar qualquer código que você não se sente à vontade para executar. Quando estiver satisfeito com a integridade e o conteúdo do script, será possível executá-lo.

**nota**  
É possível executar esse script com a versão 10 ou superior do cliente psql.

É possível usar os procedimentos a seguir para executar esse script no ambiente de banco de dados ou na linha de comando. Em ambos os casos, é possível fazer upload do arquivo para o AWS Support mais tarde.

**Como executar esse script e fazer upload dos resultados para o caso de suporte**

1. Execute um destes procedimentos:
   + Execute o script no ambiente de banco de dados utilizando a seguinte linha de comando psql.

     ```
     dbname=# \i awsdms_support_collector_postgres.sql
     ```

     No prompt a seguir, insira o nome de somente um dos esquemas que deseja migrar.

     No prompt a seguir, insira o nome do usuário (`script_user`) definido para se conectar ao banco de dados.
   + Execute o script a seguir diretamente na linha de comando. Essa opção evita qualquer solicitação anterior à execução do script.

     ```
     psql -h database-hostname -p port -U script_user -d database-name -f awsdms_support_collector_postgres.sql
     ```

1. Revise o arquivo HTML de saída e remova todas as informações que você não se sente à vontade para compartilhar. Quando o HTML for aceitável para compartilhar, faça upload do arquivo para o caso do AWS Support. Para obter mais informações sobre como fazer upload desse arquivo, consulte [Trabalhando com scripts de suporte de diagnóstico em AWS DMS](CHAP_SupportScripts.md).