CLIReferência para AWS Schema Conversion Tool - AWS Schema Conversion Tool
Pré-requisitosModo interativoObtendo CLI cenáriosEditando CLI cenáriosModo de scriptMaterial de referência

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

CLIReferência para AWS Schema Conversion Tool

Esta seção descreve como começar a usar a interface de linha de AWS SCT comando (CLI). Além disso, esta seção fornece informações sobre os principais comandos e modos de uso. Para obter uma referência completa dos AWS SCT CLI comandos, consulteMaterial 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.

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

AWS SCT CLImodo interativo

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

Para converter o esquema do banco de dados de origem em AWS SCT, execute uma operação de sequência: crie um novo projeto, conecte-se aos bancos de dados de origem e 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 AWS SCT CLI modo. Para obter mais informações, consulte Modo de script.

Você pode executar os AWS SCT CLI comandos na app pasta do seu caminho de AWS SCT instalação. 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 AWS SCT CLI interativo, use o comando a seguir depois de concluir os pré-requisitos.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Agora você pode executar AWS SCT CLI comandos. 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 AWS SCT CLI interativo, execute o comando a seguir.

help
/

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

help -command: 'command_name'
/

No exemplo anterior, substitua command_name com o nome de um comando.

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

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

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

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

ExecuteFile -file: 'file_path'
/

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

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

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'
/

Obtendo AWS SCT CLI cenários

Para obter os AWS SCT cenários mais usados, você pode usar o GetCliScenario comando. 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 executar o GetCliScenario comando, preencha os pré-requisitos e entre no AWS SCT CLI modo interativo. 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 com um dos tipos de modelo da tabela a seguir. Em seguida, substitua file_path com o caminho da pasta na qual você deseja baixar os scripts. Certifique-se de que 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 AWS SCT CLI modelos, execute o comando anterior sem a -type opção.

A tabela a seguir inclui os tipos de AWS SCT CLI modelos 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 Teradata Basic Teradata Query (BTEQ), FastExport FastLoad, e scripts em Amazon Redshift. MultiLoad RSQL Para obter mais informações, consulte Convertendo 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 SQL script e salva o relatório de avaliação. Para obter mais informações, consulte Conversão de esquemas.

GenericAppConversion

GenericApplicationConversionTemplate.scts

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

HadoopMigration

HadoopMigrationTemplate.scts

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

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

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

Informatica

InformaticaConversionTemplate.scts

Converte SQL código 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 destino em seus ETL scripts e salva os scripts convertidos após a conversão. Para obter mais informações, consulte Scripts da Informatica ETL.

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Converte SQL código incorporado em seus aplicativos C#, C++, Java e Pro*C com o conversor de aplicativos. AWS SCT Para obter mais informações, consulte Aplicativo de conversão SQL.

OozieConversion

OozieConversionTemplate.scts

Converte seus fluxos de trabalho do Apache Oozie em. AWS Step Functions Para obter mais informações, consulte Conectando-se aos 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 Migração 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 PDF arquivo CSV of. Para obter mais informações, consulte Relatório de avaliação da .

SQLScriptConversion

SQLScriptConversionTemplate.scts

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

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

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'
/

Editando AWS SCT CLI cenários

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 Instalando JDBC drivers para 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 tipos 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 SQL Postgre. Em seguida, você planeja salvar seu relatório de avaliação de migração de banco de dados como um 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. Use o procedimento a seguir para editar seu AWS SCT CLI modelo.

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

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

  2. Remova CreateFilter, converta -filter, ApplyToTarget -filter, SaveTargetSQLSaveTargetSQLbyStatement, e SaveReportCSVas operações do seu script.

  3. Para oracle_driver_file na SetGlobalSettingsoperação, insira o caminho para seu driver Oracle. Em seguida, para postgresql_driver_file, insira o caminho para seu driver Postgre. SQL

    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 SetGlobalSettingsoperação, consulte Matriz de configurações globais noMaterial de referência.

  4. (Opcional) Para 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. Para AddSource, insira o endereço IP do seu 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. Para AddTarget, insira o endereço IP do seu servidor de banco de dados de destino. 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 do banco de dados de origem e destino que você 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 AddServerMappingoperação 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.

AWS SCT CLImodo de script

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

Você pode executar AWS SCT CLI scripts a partir da app pasta do seu caminho de AWS SCT instalação. 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 PATH ambiente, você pode executar AWS SCT CLI scripts de qualquer pasta.

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

RunSCTBatch.cmd --pathtoscts "file_path"

No exemplo anterior, substitua file_path com o caminho para seu arquivo com um script.

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

RunSCTBatch.sh --pathtoscts "file_path"

No exemplo anterior, substitua file_path com o caminho para seu arquivo com 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 da interface de linha de AWS SCT comando emMaterial 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"

AWS SCT CLImaterial de referência

Você pode encontrar material de referência sobre a interface de linha de AWS Schema Conversion Tool comando (CLI) no guia a seguir: AWS Schema Conversion Tool CLIReferência.