

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

# Conectando-se aos bancos de dados SAP com o AWS Schema Conversion Tool
<a name="CHAP_Source.SAP"></a>

Você pode usar AWS SCT para converter esquemas, objetos de código de banco de dados e código de aplicativo do SAP (Sybase) Adaptive Server Enterprise (ASE) para os seguintes destinos: 
+ Amazon RDS para MySQL
+ Amazon Aurora Edição Compatível com MySQL
+ Amazon RDS para MariaDB
+ Amazon RDS para PostgreSQL
+ Amazon Aurora Edição Compatível com PostgreSQL

Para obter mais informações, consulte as seções a seguir:

**Topics**
+ [Privilégios do SAP ASE como um banco de dados de origem](#CHAP_Source.SAP.Permissions)
+ [Conectando-se ao SAP ASE (Sybase) como origem](#CHAP_Source.SAP.Connecting)
+ [Privilégios do MySQL como um banco de dados de destino](#CHAP_Source.SAP.ConfigureMySQL)
+ [Configurações de conversão do SAP ASE para MySQL](#CHAP_Source.SAP.MySQLConversionSettings)
+ [Privilégios do PostgreSQL como um banco de dados de destino](#CHAP_Source.SAP.ConfigurePostgreSQL)
+ [Configurações de conversão de SAP ASE para PostgreSQL.](#CHAP_Source.SAP.PostgreSQLConversionSettings)

## Privilégios do SAP ASE como um banco de dados de origem
<a name="CHAP_Source.SAP.Permissions"></a>

Para usar um banco de dados do SAP ASE como origem, você cria um usuário de banco de dados e concede permissões. Para fazer isso, siga as etapas a seguir.

**Criar e configurar um usuário de banco de dados**

1. Conectar-se ao banco de dados de origem.

1. Criar um usuário de banco de dados com os seguintes comandos. Forneça uma senha para o novo usuário.

   ```
   USE master
   CREATE LOGIN min_privs WITH PASSWORD <password>
   sp_adduser min_privs
   grant select on dbo.spt_values to min_privs
   grant select on asehostname to min_privs
   ```

1. Para cada banco de dados que você vai migrar, conceda os seguintes privilégios.

   ```
   USE <database_name>
   sp_adduser min_privs
   grant select on dbo.sysusers to min_privs
   grant select on dbo.sysobjects to min_privs
   grant select on dbo.sysindexes to min_privs
   grant select on dbo.syscolumns to min_privs
   grant select on dbo.sysreferences to min_privs
   grant select on dbo.syscomments to min_privs
   grant select on dbo.syspartitions to min_privs
   grant select on dbo.syspartitionkeys to min_privs
   grant select on dbo.sysconstraints to min_privs
   grant select on dbo.systypes to min_privs
   grant select on dbo.sysqueryplans to min_privs
   ```

## Conectando-se ao SAP ASE (Sybase) como origem
<a name="CHAP_Source.SAP.Connecting"></a>

Use o procedimento a seguir para conectar seu banco de dados do SAP ASE de origem com a AWS Schema Conversion Tool. 

**Para se conectar a um banco de dados do SAP ASE de origem**

1. No AWS Schema Conversion Tool, escolha **Adicionar fonte**. 

1. Escolha **SAP ASE** e, em seguida, escolha **Avançar**.

   A caixa de diálogo **Adicionar origem** é exibida.

1. Em **Nome da conexão**, insira um nome para o banco de dados. A AWS SCT exibe esse nome na árvore no painel esquerdo. 

1. Use as credenciais do banco de dados AWS Secrets Manager ou insira-as manualmente:
   + Para usar as credenciais do banco de dados do Secrets Manager, use as instruções a seguir:

     1. Em **AWS Secret**, escolha o nome do segredo.

     1. Escolha **Preencher** para preencher automaticamente todos os valores na caixa de diálogo de conexão do banco de dados do Secrets Manager.

     Para obter informações sobre o uso de credenciais de banco de dados do Secrets Manager, consulte a [Configurando AWS Secrets Manager no AWS Schema Conversion Tool](CHAP_UserInterface.SecretsManager.md).
   + Para inserir manualmente as informações de conexão do banco de dados do SAP ASE de origem, use as instruções a seguir:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/SchemaConversionTool/latest/userguide/CHAP_Source.SAP.html)

1. Escolha **Testar conexão** para verificar se AWS SCT pode se conectar ao seu banco de dados de origem. 

1. Escolha **Conectar** para se conectar ao banco de dados de origem.

## Privilégios do MySQL como um banco de dados de destino
<a name="CHAP_Source.SAP.ConfigureMySQL"></a>

Os privilégios obrigatórios para MySQL como destino são listados a seguir:
+ CREATE ON \$1.\$1
+ ALTER ON \$1.\$1
+ DROP ON \$1.\$1
+ INDEX ON \$1.\$1
+ REFERENCES ON \$1.\$1
+ SELECT ON \$1.\$1
+ CREATE VIEW ON \$1.\$1
+ SHOW VIEW ON \$1.\$1
+ TRIGGER ON \$1.\$1
+ CREATE ROUTINE ON \$1.\$1
+ ALTER ROUTINE ON \$1.\$1
+ EXECUTE ON \$1.\$1
+ INSIRA, ATUALIZE EM AWS\$1SAPASE \$1EXT. \$1
+ CRIE TABELAS TEMPORÁRIAS EM AWS\$1SAPASE \$1EXT. \$1

É possível utilizar o exemplo de código a seguir para criar um usuário do banco de dados e conceder os privilégios.

```
CREATE USER 'user_name' IDENTIFIED BY 'your_password';
GRANT CREATE ON *.* TO 'user_name';
GRANT ALTER ON *.* TO 'user_name';
GRANT DROP ON *.* TO 'user_name';
GRANT INDEX ON *.* TO 'user_name';
GRANT REFERENCES ON *.* TO 'user_name';
GRANT SELECT ON *.* TO 'user_name';
GRANT CREATE VIEW ON *.* TO 'user_name';
GRANT SHOW VIEW ON *.* TO 'user_name';
GRANT TRIGGER ON *.* TO 'user_name';
GRANT CREATE ROUTINE ON *.* TO 'user_name';
GRANT ALTER ROUTINE ON *.* TO 'user_name';
GRANT EXECUTE ON *.* TO 'user_name';
GRANT INSERT, UPDATE ON AWS_SAPASE_EXT.* TO 'user_name';
GRANT CREATE TEMPORARY TABLES ON AWS_SAPASE_EXT.* TO 'user_name';
```

No exemplo anterior, *user\$1name* substitua pelo nome do seu usuário. Em seguida, *your\$1password* substitua por uma senha segura.

Para usar o Amazon RDS para MySQL ou o Aurora MySQL como destino, defina o parâmetro `lower_case_table_names` como `1`. Esse valor significa que o servidor MySQL manipula identificadores de nomes de objetos como tabelas, índices, acionadores e bancos de dados sem distinção entre maiúsculas e minúsculas. Se você ativou o registro binário em sua instância de destino, defina o parâmetro `log_bin_trust_function_creators` como `1`. Nesse caso, você não precisa usar as características `DETERMINISTIC`, `READS SQL DATA` ou `NO SQL` para criar funções armazenadas. Para configurar esses parâmetros, crie um novo grupo de parâmetros de banco de dados ou modifique um grupo de parâmetros de banco de dados existente.

## Configurações de conversão do SAP ASE para MySQL
<a name="CHAP_Source.SAP.MySQLConversionSettings"></a>

Para editar as configurações de conversão do SAP ASE para MySQL, escolha **Configurações** e, em seguida, escolha **Configurações de conversão**. Na lista superior, escolha **SAP ASE** e, depois, selecione **SAP ASE: MySQL** ou **SAP ASE: Amazon Aurora (compatível com MySQL)**. O AWS SCT exibe todas as configurações disponíveis para conversão de SAP ASE em PostgreSQL.

As configurações de conversão do SAP ASE para MySQL AWS SCT incluem opções para o seguinte:
+ Para limitar o número de comentários com itens de ação no código convertido.

  Em **Adicionar comentários no código convertido para os itens de ação de severidade selecionada e superior**, escolha a severidade dos itens de ação. AWS SCT adiciona comentários no código convertido para itens de ação da severidade selecionada e superior.

  Por exemplo, para minimizar o número de comentários em seu código convertido, escolha **Somente erros**. Para incluir comentários para todos os itens de ação em seu código convertido, escolha **Todas as mensagens**.
+ Para usar os nomes exatos dos objetos do banco de dados de origem no código convertido.

  Por padrão, AWS SCT converte os nomes dos objetos, variáveis e parâmetros do banco de dados em minúsculas. Para manter as maiúsculas e minúsculas originais desses nomes, selecione **Tratar nomes de objetos do banco de dados de origem com distinção entre maiúsculas e minúsculas**. Escolha essa opção se você usar nomes de objetos com distinção entre maiúsculas e minúsculas no servidor de banco de dados do SAP ASE de origem.

## Privilégios do PostgreSQL como um banco de dados de destino
<a name="CHAP_Source.SAP.ConfigurePostgreSQL"></a>

Para usar o PostgreSQL como destino AWS SCT , é necessário o privilégio. `CREATE ON DATABASE` Certifique-se de conceder esse privilégio para cada banco de dados PostgreSQL de destino.

Para usar os sinônimos públicos convertidos, altere o caminho de pesquisa padrão do banco de dados para `"$user", public_synonyms, public`.

É possível utilizar o exemplo de código a seguir para criar um usuário do banco de dados e conceder os privilégios.

```
CREATE ROLE user_name LOGIN PASSWORD 'your_password';
GRANT CREATE ON DATABASE db_name TO user_name;
ALTER DATABASE db_name SET SEARCH_PATH = "$user", public_synonyms, public;
```

No exemplo anterior, *user\$1name* substitua pelo nome do seu usuário. Em seguida, *db\$1name* substitua pelo nome do seu banco de dados de destino. Por fim, *your\$1password* substitua por uma senha segura.

No PostgreSQL, apenas o proprietário do esquema ou um `superuser` pode descartar um esquema. O proprietário pode descartar um esquema e todos os objetos incluídos nesse esquema, mesmo que o proprietário do esquema não possua alguns de seus objetos.

Ao usar usuários diferentes para converter e aplicar esquemas diferentes ao banco de dados de destino, você pode receber uma mensagem de erro quando não AWS SCT consegue descartar um esquema. Para evitar essa mensagem de erro, use o perfil `superuser`. 

## Configurações de conversão de SAP ASE para PostgreSQL.
<a name="CHAP_Source.SAP.PostgreSQLConversionSettings"></a>

Para editar as configurações de conversão do SAP ASE para PostgreSQL, escolha **Configurações** e, em seguida, escolha **Configurações de conversão**. Na lista superior, escolha **SAP ASE** e, depois, selecione **SAP ASE: PostgreSQL** ou **SAP ASE: Amazon Aurora (compatível com PostgreSQL)**. O AWS SCT exibe todas as configurações disponíveis para conversão de SAP ASE em PostgreSQL.

As configurações AWS SCT de conversão do SAP ASE para PostgreSQL incluem opções para o seguinte:
+ Para limitar o número de comentários com itens de ação no código convertido.

  Em **Adicionar comentários no código convertido para os itens de ação de severidade selecionada e superior**, escolha a severidade dos itens de ação. AWS SCT adiciona comentários no código convertido para itens de ação da severidade selecionada e superior.

  Por exemplo, para minimizar o número de comentários em seu código convertido, escolha **Somente erros**. Para incluir comentários para todos os itens de ação em seu código convertido, escolha **Todas as mensagens**.
+ Para definir o modelo a ser usado para os nomes dos esquemas no código convertido. Para **Modelo de geração de nome de esquema**, escolha uma das opções a seguir:
  + **<source\$1db>**: Usa o nome do banco de dados SAP ASE como nome de esquema no PostgreSQL.
  + **<source\$1schema>**: Usa o nome do esquema SAP ASE como nome do esquema no PostgreSQL.
  + **<source\$1db>\$1<schema>**: Usa uma combinação do banco de dados SAP ASE e dos nomes do esquema como um nome de esquema no PostgreSQL.
+ Para usar os nomes exatos dos objetos do banco de dados de origem no código convertido.

  Por padrão, AWS SCT converte os nomes dos objetos, variáveis e parâmetros do banco de dados em minúsculas. Para manter as maiúsculas e minúsculas originais desses nomes, selecione **Tratar nomes de objetos do banco de dados de origem com distinção entre maiúsculas e minúsculas**. Escolha essa opção se você usar nomes de objetos com distinção entre maiúsculas e minúsculas no servidor de banco de dados do SAP ASE de origem.

  Para operações com distinção entre maiúsculas e minúsculas, AWS SCT pode evitar a conversão de nomes de objetos do banco de dados em minúsculas. Para fazer isso, selecione **Evitar conversão para minúsculas para operações com distinção entre maiúsculas e minúsculas**.
+ Permitir o uso de índices com o mesmo nome em tabelas diferentes no SAP ASE.

  No PostgreSQL, todos os nomes de índice que você usa no esquema devem ser exclusivos. Para garantir que isso AWS SCT gere nomes exclusivos para todos os seus índices, selecione **Gerar nomes exclusivos para índices**.