Referência da CLI do AWS Schema Conversion Tool - AWS Schema Conversion Tool
Pré-requisitosModo interativoObter cenários de CLIEditar cenários de CLIModo de scriptMaterial de referência

Referência da CLI do AWS Schema Conversion Tool

Esta seção descreve como começar a usar a interface de linha de comandos (CLI) do AWS SCT. Além disso, esta seção fornece informações sobre os principais comandos e modos de uso. Para obter uma referência completa dos comandos da CLI do AWS SCT, consulte Material de referência.

Pré-requisitos para usar a interface de linha de comando do AWS SCT

Faça download e instale a versão mais recente do Amazon Corretto 11. Para obter mais informações, consulte Downloads do Amazon Corretto 11 no Guia do usuário do Amazon Corretto 11.

Faça download e instale a versão mais recente do AWS SCT. Para obter mais informações, consulte Instalação do AWS Schema Conversion Tool.

Usar o modo interativo da CLI do AWS SCT

Você pode usar a interface da linha de comando do AWS SCT no modo interativo. Nesse modo, você insere comandos no console um por um. Você pode usar esse modo interativo para saber mais sobre os comandos da CLI ou baixar os cenários da CLI mais usados.

Para converter o esquema do banco de dados de origem no AWS SCT, execute uma operação de sequência: crie um novo projeto, conecte-se aos bancos de dados de origem e de destino, crie regras de mapeamento e converta objetos do banco de dados. Como esse fluxo de trabalho pode ser complexo, recomendamos o uso de scripts no modo CLI do AWS SCT. Para obter mais informações, consulte Modo de script.

Você pode executar os comandos da CLI do AWS SCT na pasta app do seu caminho de instalação do AWS SCT. No Windows, o caminho de instalação padrão é C:\Program Files\AWS Schema Conversion Tool\. Certifique-se de que essa pasta inclua o arquivo AWSSchemaConversionToolBatch.jar.

Para entrar no modo interativo da CLI do AWS SCT, use o comando a seguir depois de concluir os pré-requisitos.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Agora você pode executar os comandos da CLI do AWS SCT. Certifique-se de finalizar seus comandos com / em uma nova linha. Além disso, certifique-se de usar aspas simples retas (') antes e depois dos valores dos parâmetros do comando.

nota

Se o comando anterior retornar Unexpected error, tente o seguinte:

java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar

Para ver a lista de comandos disponíveis no modo interativo da CLI do AWS SCT, execute o seguinte comando.

help
/

Para exibir informações sobre um comando da CLI do AWS SCT, use o comando a seguir.

help -command: 'command_name'
/

No exemplo anterior, substitua command_name pelo nome de um comando.

Para exibir informações sobre os parâmetros de um comando da CLI do AWS SCT, use o comando a seguir.

help -command: 'command_name' -parameters: 'parameters_list'
/

No exemplo anterior, substitua command_name pelo nome de um comando. Em seguida, substitua parameters_list por uma lista de nomes de parâmetros separados por vírgula.

Para executar um script a partir de um arquivo no modo interativo da CLI do AWS SCT, use o comando a seguir.

ExecuteFile -file: 'file_path'
/

No exemplo anterior, substitua file_path pelo caminho do seu arquivo por um script. Certifique-se de que seu arquivo tenha uma extensão .scts.

Para sair do modo interativo da CLI do AWS SCT, execute o comando quit.

Exemplos

O exemplo a seguir mostra informações sobre o comando Convert.

help -command: 'Convert'
/

O exemplo a seguir mostra informações sobre dois parâmetros do comando Convert.

help -command: 'Convert' -parameters: 'filter, treePath'
/

Obter cenários de CLI do AWS SCT

Para obter os cenários mais usados do AWS SCT, você pode usar o comando GetCliScenario. Você pode executar esse comando no modo interativo e, em seguida, editar os modelos baixados. Use os arquivos editados no modo script.

O comando GetCliScenario salva o modelo selecionado ou todos os modelos disponíveis no diretório especificado. O modelo contém o conjunto completo de comandos para executar um script. Certifique-se de editar os caminhos do arquivo, as credenciais do banco de dados, os nomes dos objetos e outros dados nesses modelos. Além disso, certifique-se de remover os comandos que não usa e adicionar novos comandos ao script quando necessário.

Para entrar no modo interativo da CLI do GetCliScenario, conclua os pré-requisitos e entre no modo interativo da CLI da AWS SCT. Para obter mais informações, consulte Modo interativo.

Em seguida, use a sintaxe a seguir para executar o comando GetCliScenario e obter os cenários do AWS SCT.

GetCliScenario -type: 'template_type' -directory: 'file_path'
/

No exemplo anterior, substitua template_type por um dos tipos de modelo da tabela a seguir. Em seguida, substitua file_path pelo caminho da pasta na qual você deseja baixar os scripts. Certifique-se de que o AWS SCT possa acessar essa pasta sem solicitar direitos de administrador. Além disso, certifique-se de usar aspas simples retas (') antes e depois dos valores dos parâmetros do comando.

Para baixar todos os modelos de CLI do AWS SCT, execute o comando anterior sem a opção -type.

A tabela a seguir inclui os tipos de modelos de CLI do AWS SCT que você pode baixar. Para cada modelo, a tabela inclui o nome do arquivo e a descrição das operações que você pode executar usando o script.

Tipo de modelo Nome do arquivo Descrição

BTEQScriptConversion

BTEQScriptConversionTemplate.scts

Converte scripts Teradata Basic Teradata Query (BTEQ), FastExport, FastLoad e MultiLoad em Amazon Redshift RSQL. Para obter mais informações, consulte Conversão de dados usando ETL.

ConversionApply

ConversionTemplate.scts

Converte esquemas do banco de dados de origem e aplica o código convertido ao banco de dados de destino. Opcionalmente, salva o código convertido como um script SQL e salva o relatório de avaliação. Para obter mais informações, consulte Conversão de esquemas.

GenericAppConversion

GenericApplicationConversionTemplate.scts

Converte o código SQL incorporado em seus aplicativos com o conversor genérico de aplicativos do AWS SCT. Para obter mais informações, consulte Código SQL.

HadoopMigration

HadoopMigrationTemplate.scts

Migra seu cluster Hadoop on-premises para o Amazon EMR. Para obter mais informações, consulte Como se conectar a bancos de dados do Apache Hadoop com o AWS Schema Conversion Tool.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Retoma uma migração interrompida do seu cluster Hadoop on-premises para o Amazon EMR. Para obter mais informações, consulte Como se conectar a bancos de dados do Apache Hadoop com o AWS Schema Conversion Tool.

Informatica

InformaticaConversionTemplate.scts

Converte o código SQL incorporado em seus scripts de extração, transformação e carregamento (ETL) da Informatica. Configura conexões com seus bancos de dados de origem e de destino em seus scripts ETL e salva os scripts convertidos após a conversão. Para obter mais informações, consulte Scripts de ETL da Informatica.

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Converte o código SQL incorporado em seus aplicativos C#, C++, Java e Pro*C com o conversor genérico de aplicativos do AWS SCT. Para obter mais informações, consulte Como converter o aplicativo SQL.

OozieConversion

OozieConversionTemplate.scts

Converte seus fluxos de trabalho do Apache Oozie em AWS Step Functions. Para obter mais informações, consulte Como se conectar a fluxos de trabalho do Apache Oozie com o AWS Schema Conversion Tool.

RedshiftAgent

DWHDataMigrationTemplate.scts

Converte esquemas do data warehouse de origem e aplica o código convertido ao banco de dados Amazon Redshift de destino. Em seguida, registra um agente de extração de dados, cria e inicia uma tarefa de migração de dados. Para obter mais informações, consulte Migrar de um data warehouse.

ReportCreation

ReportCreationTemplate.scts

Cria um relatório de migração de banco de dados para vários esquemas de banco de dados de origem. Em seguida, salva esse relatório como um arquivo CSV ou PDF. Para obter mais informações, consulte Relatório de avaliação da .

SQLScriptConversion

SQLScriptConversionTemplate.scts

Converte scripts SQL*Plus ou TSQL em PL/SQL e salva os scripts convertidos. Além disso, salva um relatório de avaliação.

Depois de baixar o modelo de CLI do AWS SCT, use o editor de texto para configurar o script para ser executado nos bancos de dados de origem e de destino. Em seguida, use o modo de script de CLI do AWS SCT para executar o script. Para obter mais informações, consulte Modo de script de CLI do AWS SCT.

Exemplos

O exemplo a seguir baixa todos os modelos para a pasta C:\SCT\Templates.

GetCliScenario -directory: 'C:\SCT\Templates'
/

O exemplo a seguir baixa todos os modelos para a operação ConversionApply para a pasta C:\SCT\Templates.

GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates'
/

Editar cenários de CLI do AWS SCT

Depois de baixar os modelos de cenário, configure-os para obter scripts funcionais que possam ser executados em seus bancos de dados.

Para todos os modelos, certifique-se de fornecer o caminho para os drivers dos bancos de dados de origem e de destino. Para obter mais informações, consulte Instalação de drivers JDBC para o AWS Schema Conversion Tool.

Certifique-se de incluir as credenciais do banco de dados para os bancos de dados de origem e de destino. Além disso, certifique-se de configurar regras de mapeamento para descrever um par de origem e destino para seu projeto de conversão. Para obter mais informações, consulte Mapeamento de tipo de dados.

Em seguida, configure o escopo das operações a serem executadas. Você pode remover os comandos que não usa ou adicionar novos comandos ao script.

Por exemplo, suponha que você planeje converter todos os esquemas em seu banco de dados Oracle de origem para PostgreSQL. Em seguida, você planeja salvar o relatório de avaliação da migração do banco de dados em PDF e aplicar o código convertido ao banco de dados de destino. Nesse caso, você pode usar o modelo para a operação ConversionApply. Siga o procedimento abaixo para editar o modelo de CLI do AWS SCT.

Para editar o modelo de CLI do AWS SCT para a operação ConversionApply

  1. Abra o ConversionTemplate.scts que você baixou. Para obter mais informações, consulte Exemplos.

  2. Remova as operações CreateFilter, Convert -filter, ApplyToTarget -filter, SaveTargetSQL, SaveTargetSQLByStatement e SaveReportCSV do seu script.

  3. Para oracle_driver_file na operação SetGlobalSettings, insira o caminho para seu driver Oracle. Em seguida, para postgresql_driver_file, insira o caminho para seu driver PostgreSQL.

    Se você usa outros mecanismos de banco de dados, use nomes apropriados para as configurações. Para obter uma lista completa das configurações globais que você pode definir na operação SetGlobalSettings, consulte Matriz de configurações globais no Material de referência.

  4. (Opcional) Em CreateProject, insira o nome do seu projeto e a localização do arquivo do projeto local. Se optar por continuar com os valores padrão, certifique-se de que AWS SCT pode criar arquivos na pasta C:\temp sem solicitar direitos de administrador.

  5. Em AddSource, digite o endereço IP do servidor de banco de dados de origem. Digite o nome de usuário, a senha e a porta para se conectar ao servidor de banco de dados de origem.

  6. Em AddTarget, digite o endereço IP do servidor de banco de dados de origem. Além disso, digite o nome de usuário, a senha e a porta para se conectar ao servidor de banco de dados de destino.

  7. (Opcional) Para AddServerMapping, insira os objetos de banco de dados de origem e de destino que deseja adicionar a uma regra de mapeamento. Você pode usar os parâmetros sourceTreePath e targetTreePath para especificar o caminho para os objetos do banco de dados. Opcionalmente, você pode usar sourceNamePath e targetNamePath para especificar os nomes dos objetos do banco de dados. Para obter mais informações, consulte Comandos de mapeamento de servidor em Material de referência.

    Os valores padrão da operação AddServerMapping mapeiam todos os esquemas de origem com seu banco de dados de destino.

  8. Salve o arquivo e use o modo de script para executá-lo. Para obter mais informações, consulte Modo de script.

Modo de script de CLI do AWS SCT

Depois de criar um script de CLI ou editar um modelo do AWS SCT, você pode executá-lo com o comando RunSCTBatch. Certifique-se de salvar seu arquivo com o script CLI como uma extensão .scts.

Você pode executar os scripts da CLI do AWS SCT na pasta app do seu caminho de instalação do AWS SCT. No Windows, o caminho de instalação padrão é C:\Program Files\AWS Schema Conversion Tool\. Certifique-se de que essa pasta inclua o arquivo RunSCTBatch.cmd ou o RunSCTBatch.sh. Além disso, essa pasta deve incluir o arquivo AWSSchemaConversionToolBatch.jar.

Como alternativa, você pode adicionar o caminho para o arquivo RunSCTBatch na variável de ambiente PATH do seu sistema operacional. Depois de atualizar a variável de ambiente PATH, você pode executar scripts de CLI do AWS SCT de qualquer pasta.

Para executar um script de CLI do AWS SCT, use o comando a seguir no Windows.

RunSCTBatch.cmd --pathtoscts "file_path"

No exemplo anterior, substitua file_path pelo caminho do seu arquivo por um script.

Para executar um script de CLI do AWS SCT, use o comando a seguir no Linux.

RunSCTBatch.sh --pathtoscts "file_path"

No exemplo anterior, substitua file_path pelo caminho do seu arquivo por um script.

Você pode fornecer parâmetros opcionais nesse comando, como credenciais do banco de dados, o nível de detalhes na saída do console e outros. Para obter mais informações, baixe a referência de interface de linha de comando AWS SCT em Material de referência.

Exemplos

O exemplo a seguir executa o script ConversionTemplate.scts na pasta C:\SCT\Templates. Você pode usar esse exemplo no Windows.

RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"

O exemplo a seguir executa o script ConversionTemplate.scts no diretório /home/user/SCT/Templates. Você pode usar esse exemplo no Linux.

RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"

Material de referência CLI do AWS SCT

Você pode encontrar material de referência sobre a interface de linha de comandos (CLI) do AWS Schema Conversion Tool no seguinte guia: Referência de CLI do AWS Schema Conversion Tool.