Como se conectar ao banco de dados SAP com o AWS Schema Conversion Tool - AWS Schema Conversion Tool
Privilégios do SAP ASE Conectando-se ao SAP ASE como origemPrivilégios do MySQL como um destinoConfigurações de conversão do SAP ASE para MySQLPrivilégios do PostgreSQL como destinoConfigurações de conversão de SAP ASE para PostgreSQL.

Como se conectar ao banco de dados SAP com o AWS Schema Conversion Tool

Você pode usar a 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:

Privilégios do SAP ASE como um banco de dados de origem

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.

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

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

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. Na AWS Schema Conversion Tool, escolha Adicionar origem.

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

    A caixa de diálogo Adicionar origem é exibida.

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

  4. Use as credenciais do banco de dados da 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.

      2. 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 Configurar o AWS Secrets Manager no AWS Schema Conversion Tool.

    • Para inserir manualmente as informações de conexão do banco de dados do SAP ASE de origem, use as instruções a seguir:

      Parâmetro Ação
      Nome do servidor

      Digite o Sistema de Nomes de Domínio (DNS) ou o endereço IP do servidor de banco de dados de origem.
      Porta do servidor

      Digite a porta usada para se conectar ao servidor de banco de dados de origem.
      Database

      Insira o nome do banco de dados do SAP ASE.
      Nome de usuário e Senha

      Insira as credenciais do banco de dados para se conectar ao seu servidor de banco de dados de origem.

      nota

      A AWS SCT usa a senha para se conectar ao seu banco de dados de origem somente quando você escolhe se conectar ao seu banco de dados em um projeto. Para proteger-se contra a exposição da senha do banco de dados de origem, a AWS SCT não armazena a senha por padrão. Se fechar o projeto da AWS SCT e abri-lo novamente, você será solicitado a informar a senha para se conectar ao banco de dados de origem, conforme necessário.
      Usar SSL

      Escolha essa opção para usar Secure Sockets Layer (SSL) para se conectar ao banco de dados. Forneça as seguintes informações adicionais, conforme aplicável, na guia SSL:

      • Verificar certificado do servidor: selecione essa opção para verificar o certificado do servidor, usando um armazenamento confiável.

      • Armazenamento de confiança: a localização de um armazenamento de confiança que contém certificados.
      Armazenar senha

      A AWS SCT cria um cofre seguro para armazenar certificados SSL e senhas do banco de dados. Habilitar essa opção permite que você armazene a senha do banco de dados e se conecte rapidamente a ele sem a necessidade de informar a senha.

      Caminho do driver SAP ASE

      Digite o caminho para o driver a ser usado para a conexão com o banco de dados de origem. Para ter mais informações, consulte Instalação de drivers JDBC para o AWS Schema Conversion Tool.

      Se você armazenar o caminho do driver nas configurações globais do projeto, o caminho do driver não aparecerá na caixa de diálogo de conexão. Para ter mais informações, consulte Armazenamento de caminhos do driver nas configurações globais.

  5. Escolha Testar conexão para verificar se a AWS SCT pode se conectar ao banco de dados de origem.

  6. Escolha Conectar para se conectar ao banco de dados de origem.

Privilégios do MySQL como um banco de dados de destino

Os privilégios obrigatórios para MySQL como destino são listados a seguir:

  • CREATE ON *.*

  • ALTER ON *.*

  • DROP ON *.*

  • INDEX ON *.*

  • REFERENCES ON *.*

  • SELECT ON *.*

  • CREATE VIEW ON *.*

  • SHOW VIEW ON *.*

  • TRIGGER ON *.*

  • CREATE ROUTINE ON *.*

  • ALTER ROUTINE ON *.*

  • EXECUTE ON *.*

  • INSERT, UPDATE ON AWS_SAPASE_EXT.*

  • CREATE TEMPORARY TABLES ON AWS_SAPASE_EXT.*

É 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, substitua user_name pelo nome do seu usuário. Em seguida, substitua your_password 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

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, em seguida, escolha SAP ASE: MySQL ou SAP ASE: Amazon Aurora (compatível com MySQL). A AWS SCT exibe todas as configurações disponíveis para conversão de SAP ASE para PostgreSQL.

As configurações de conversão do SAP ASE para MySQL na 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. A 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, a AWS SCT converte os nomes dos objetos, variáveis e parâmetros do banco de dados em letras 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

Para usar o PostgreSQL como destino, a AWS SCT necessita do 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, substitua user_name pelo nome do seu usuário. Substitua, então, db_name pelo nome do banco de dados de destino. Por fim, substitua your_password 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 AWS SCT não consegue descartar um esquema. Para evitar essa mensagem de erro, use o perfil superuser.

Configurações de conversão de SAP ASE para PostgreSQL.

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, em seguida, escolha SAP ASE: PostgreSQL ou SAP ASE: Amazon Aurora (compatível com PostgreSQL). A AWS SCT exibe todas as configurações disponíveis para conversão de SAP ASE para PostgreSQL.

As configurações de conversão do SAP ASE para PostgreSQL em 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. A 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_db>: Usa o nome do banco de dados SAP ASE como nome de esquema no PostgreSQL.

    • <source_schema>: Usa o nome do esquema SAP ASE como nome do esquema no PostgreSQL.

    • <source_db>_<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, a AWS SCT converte os nomes dos objetos, variáveis e parâmetros do banco de dados em letras 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, a 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 a AWS SCT gere nomes exclusivos para todos os seus índices, selecione Gerar nomes exclusivos para índices.