AWS SCT CLI-Referenz - AWS Schema Conversion Tool
Voraussetzungeninteraktiver ModusCLI-Szenarien abrufenCLI-Szenarien bearbeitenSkriptmodusReferenzmaterial

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS SCT CLI-Referenz

In diesem Abschnitt werden die ersten Schritte mit der AWS SCT Befehlszeilenschnittstelle (CLI) beschrieben. Außerdem enthält dieser Abschnitt Informationen zu den Tastenbefehlen und Verwendungsmodi. Eine vollständige Referenz der AWS SCT CLI-Befehle finden Sie unterReferenzmaterial.

Voraussetzungen für die Verwendung der AWS SCT Befehlszeilenschnittstelle

Laden Sie die neueste Version von Amazon Corretto 11 herunter und installieren Sie sie. Weitere Informationen finden Sie unter Downloads für Amazon Corretto 11 im Amazon Corretto 11-Benutzerhandbuch.

Laden Sie die neueste Version von herunter und installieren Sie sie. AWS SCT Weitere Informationen finden Sie unter Wird installiert AWS SCT.

AWS SCT Interaktiver CLI-Modus

Sie können die AWS SCT Befehlszeilenschnittstelle im interaktiven Modus verwenden. In diesem Modus geben Sie Befehle nacheinander in die Konsole ein. In diesem interaktiven Modus können Sie mehr über CLI-Befehle erfahren oder die am häufigsten verwendeten CLI-Szenarien herunterladen.

Um Ihr Quelldatenbankschema zu konvertieren AWS SCT, führen Sie einen Sequenzvorgang aus: Erstellen Sie ein neues Projekt, stellen Sie eine Verbindung zu Quell- und Zieldatenbanken her, erstellen Sie Zuordnungsregeln und konvertieren Sie Datenbankobjekte. Da dieser Workflow komplex sein kann, empfehlen wir die Verwendung von Skripten im AWS SCT CLI-Modus. Weitere Informationen finden Sie unter Skriptmodus.

Sie können die AWS SCT CLI-Befehle im app Ordner Ihres AWS SCT Installationspfads ausführen. In Windows lautet der StandardinstallationspfadC:\Program Files\AWS Schema Conversion Tool\. Stellen Sie sicher, dass dieser Ordner die AWSSchemaConversionToolBatch.jar Datei enthält.

Verwenden Sie den folgenden Befehl, um in den interaktiven AWS SCT CLI-Modus zu wechseln, nachdem Sie die Voraussetzungen erfüllt haben.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Jetzt können Sie AWS SCT CLI-Befehle ausführen. Stellen Sie sicher, dass Sie Ihre Befehle mit / in einer neuen Zeile beenden. Stellen Sie außerdem sicher, dass Sie vor und nach den Werten der Befehlsparameter gerade einfache Anführungszeichen (') verwenden.

Anmerkung

Wenn der vorherige Befehl zurückkehrtUnexpected error, versuchen Sie Folgendes:

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

Führen Sie den folgenden Befehl aus, um die Liste der verfügbaren Befehle im interaktiven AWS SCT CLI-Modus anzuzeigen.

help
/

Verwenden Sie den folgenden Befehl, um Informationen zu einem AWS SCT CLI-Befehl anzuzeigen.

help -command: 'command_name'
/

Ersetzen Sie im vorherigen Beispiel command_name durch den Namen eines Befehls.

Verwenden Sie den folgenden Befehl, um Informationen zu den Parametern eines AWS SCT CLI-Befehls anzuzeigen.

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

Ersetzen Sie im vorherigen Beispiel command_name durch den Namen eines Befehls. Ersetzen Sie dann parameters_list durch eine Liste von Parameternamen, die durch ein Komma getrennt sind.

Verwenden Sie den folgenden Befehl, um ein Skript aus einer Datei im interaktiven AWS SCT CLI-Modus auszuführen.

ExecuteFile -file: 'file_path'
/

Ersetzen Sie im vorherigen Beispiel file_path durch den Pfad zu Ihrer Datei mit einem Skript. Stellen Sie sicher, dass Ihre Datei eine .scts Erweiterung hat.

Führen Sie den quit Befehl aus, um den interaktiven AWS SCT CLI-Modus zu beenden.

Beispiele

Im folgenden Beispiel werden die Informationen über den Convert Befehl angezeigt.

help -command: 'Convert'
/

Im folgenden Beispiel werden die Informationen zu zwei Parametern des Convert Befehls angezeigt.

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

AWS SCT CLI-Szenarien abrufen

Um die am häufigsten verwendeten AWS SCT Szenarien abzurufen, können Sie den GetCliScenario Befehl verwenden. Sie können diesen Befehl im interaktiven Modus ausführen und dann die heruntergeladenen Vorlagen bearbeiten. Verwenden Sie die bearbeiteten Dateien im Skriptmodus.

Der GetCliScenario Befehl speichert die ausgewählte Vorlage oder alle verfügbaren Vorlagen im angegebenen Verzeichnis. Die Vorlage enthält den vollständigen Befehlssatz zum Ausführen eines Skripts. Stellen Sie sicher, dass Sie die Dateipfade, Datenbankanmeldeinformationen, Objektnamen und andere Daten in diesen Vorlagen bearbeiten. Stellen Sie außerdem sicher, dass Sie die Befehle entfernen, die Sie nicht verwenden, und fügen Sie dem Skript bei Bedarf neue Befehle hinzu.

Um den GetCliScenario Befehl auszuführen, erfüllen Sie die Voraussetzungen und wechseln Sie in den interaktiven AWS SCT CLI-Modus. Weitere Informationen finden Sie unter interaktiver Modus.

Verwenden Sie als Nächstes die folgende Syntax, um den GetCliScenario Befehl auszuführen und die AWS SCT Szenarien abzurufen.

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

Ersetzen Sie im vorherigen Beispiel template_type durch einen der Vorlagentypen aus der folgenden Tabelle. Ersetzen Sie anschließend file_path durch den Pfad des Ordners, in den Sie Skripts herunterladen möchten. Stellen Sie sicher, dass Sie auf diesen Ordner zugreifen AWS SCT können, ohne Administratorrechte anzufordern. Stellen Sie außerdem sicher, dass Sie vor und nach den Werten der Befehlsparameter gerade einfache Anführungszeichen (') verwenden.

Um alle AWS SCT CLI-Vorlagen herunterzuladen, führen Sie den vorherigen Befehl ohne die -type Option aus.

Die folgende Tabelle enthält die Arten von AWS SCT CLI-Vorlagen, die Sie herunterladen können. Für jede Vorlage enthält die Tabelle den Dateinamen und die Beschreibung der Operationen, die Sie mit dem Skript ausführen können.

Typ der Vorlage Dateiname Beschreibung

BTEQ ScriptConversion

BTEQScriptConversionTemplate.scts

Konvertiert Teradata Basic Teradata Query (BTEQ), FastExport, und MultiLoad Skripten in Amazon Redshift FastLoad RSQL. Weitere Informationen finden Sie unter ETL-Prozesse konvertieren.

ConversionApply

ConversionTemplate.scts

Konvertiert Quelldatenbankschemas und wendet den konvertierten Code auf die Zieldatenbank an. Speichert optional den konvertierten Code als SQL-Skript und speichert den Bewertungsbericht. Weitere Informationen finden Sie unter Datenbankschemas konvertieren.

GenericAppConversion

GenericApplicationConversionTemplate.scts

Konvertiert mit dem generischen AWS SCT Anwendungskonverter in Ihre Anwendungen eingebetteten SQL-Code. Weitere Informationen finden Sie unter Konvertieren von SQL-Code in Ihren Anwendungen.

HadoopMigration

HadoopMigrationTemplate.scts

Migriert Ihren lokalen Hadoop-Cluster zu Amazon EMR. Weitere Informationen finden Sie unter Verwendung von Apache Hadoop als Quelle für AWS SCT.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Setzt eine unterbrochene Migration Ihres lokalen Hadoop-Clusters zu Amazon EMR fort. Weitere Informationen finden Sie unter Verwendung von Apache Hadoop als Quelle für AWS SCT.

Informatica

InformaticaConversionTemplate.scts

Konvertiert SQL-Code, der in Ihre Informatica-Skripts zum Extrahieren, Transformieren und Laden (ETL) eingebettet ist. Konfiguriert Verbindungen zu Ihren Quell- und Zieldatenbanken in Ihren ETL-Skripts und speichert die konvertierten Skripts nach der Konvertierung. Weitere Informationen finden Sie unter Konvertierung von Informatica ETL-Skripten.

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Konvertiert mit dem Anwendungskonverter SQL-Code, der in Ihre C#-, C++-, Java- und Pro*C-Anwendungen eingebettet ist. AWS SCT Weitere Informationen finden Sie unter Anwendungs-SQL konvertieren.

OozieConversion

OozieConversionTemplate.scts

Konvertiert Ihre Apache Oozie-Workflows in. AWS Step Functions Weitere Informationen finden Sie unter Verwendung von Apache Oozie als Quelle für AWS SCT.

RedshiftAgent

DWHDataMigrationTemplate.scts

Konvertiert Quell-Data Warehouse-Schemas und wendet den konvertierten Code auf die Amazon Redshift Redshift-Zieldatenbank an. Registriert dann einen Datenextraktionsagenten, erstellt und startet eine Datenmigrationsaufgabe. Weitere Informationen finden Sie unter Migration von einem Data Warehouse zu Amazon Redshift.

ReportCreation

ReportCreationTemplate.scts

Erstellt einen Datenbankmigrationsbericht für mehrere Quelldatenbankschemas. Speichert diesen Bericht dann als CSV- oder PDF-Datei. Weitere Informationen finden Sie unter Berichte über die Migrationsbewertung.

SQL ScriptConversion

SQLScriptConversionTemplate.scts

Konvertiert SQL*Plus- oder TSQL-Skripten nach PL/SQL und speichert konvertierte Skripten. Speichert außerdem einen Bewertungsbericht.

Nachdem Sie die AWS SCT CLI-Vorlage heruntergeladen haben, konfigurieren Sie das Skript mit dem Texteditor so, dass es in Ihren Quell- und Zieldatenbanken ausgeführt wird. Verwenden Sie als Nächstes den AWS SCT CLI-Skriptmodus, um Ihr Skript auszuführen. Weitere Informationen finden Sie unter AWS SCT CLI-Skriptmodus.

Beispiele

Im folgenden Beispiel werden alle Vorlagen in den C:\SCT\Templates Ordner heruntergeladen.

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

Im folgenden Beispiel wird die Vorlage für den ConversionApply Vorgang in den C:\SCT\Templates Ordner heruntergeladen.

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

AWS SCT CLI-Szenarien bearbeiten

Nachdem Sie Szenariovorlagen heruntergeladen haben, konfigurieren Sie sie so, dass funktionierende Skripts verfügbar sind, die in Ihren Datenbanken ausgeführt werden können.

Stellen Sie bei allen Vorlagen sicher, dass Sie den Pfad zu den Treibern für Ihre Quell- und Zieldatenbanken angeben. Weitere Informationen finden Sie unter Die erforderlichen Datenbanktreiber werden heruntergeladen.

Stellen Sie sicher, dass Sie die Datenbankanmeldedaten für Quell- und Zieldatenbanken angeben. Stellen Sie außerdem sicher, dass Sie Zuordnungsregeln einrichten, um ein Quell-Ziel-Paar für Ihr Konvertierungsprojekt zu beschreiben. Weitere Informationen finden Sie unter Mapping-Regeln erstellen.

Als Nächstes konfigurieren Sie den Umfang der auszuführenden Operationen. Sie können die Befehle entfernen, die Sie nicht verwenden, oder dem Skript neue Befehle hinzufügen.

Nehmen wir beispielsweise an, Sie planen, alle Schemas in Ihrer Oracle-Quelldatenbank nach PostgreSQL zu konvertieren. Anschließend planen Sie, Ihren Bewertungsbericht zur Datenbankmigration als PDF zu speichern und den konvertierten Code auf die Zieldatenbank anzuwenden. In diesem Fall können Sie die Vorlage für den ConversionApply Vorgang verwenden. Gehen Sie wie folgt vor, um Ihre AWS SCT CLI-Vorlage zu bearbeiten.

Um die AWS SCT CLI-Vorlage für den ConversionApply Vorgang zu bearbeiten

  1. Öffnen Sie die DateiConversionTemplate.scts, die Sie heruntergeladen haben. Weitere Informationen finden Sie unter Beispiele.

  2. Entfernen CreateFilterund konvertieren Sie -filter-, ApplyToTarget -filter -, SaveTargetSQL -LbyStatement, SaveTargetSQ - und SaveReportCSV-Operationen aus Ihrem Skript.

  3. Geben Sie für oracle_driver_file im SetGlobalSettingsVorgang den Pfad zu Ihrem Oracle-Treiber ein. Geben Sie dann für postgresql_driver_file den Pfad zu Ihrem PostgreSQL-Treiber ein.

    Wenn Sie andere Datenbank-Engines verwenden, verwenden Sie die entsprechenden Namen für die Einstellungen. Eine vollständige Liste der globalen Einstellungen, die Sie während des SetGlobalSettingsVorgangs festlegen können, finden Sie unter Globale Einstellungsmatrix in derReferenzmaterial.

  4. (Optional) Geben Sie für CreateProjectden Namen Ihres Projekts und den Speicherort Ihrer lokalen Projektdatei ein. Wenn Sie sich dafür entscheiden, mit den Standardwerten fortzufahren, stellen Sie sicher, dass Dateien in dem C:\temp Ordner erstellt werden AWS SCT können, ohne Administratorrechte anzufordern.

  5. Geben Sie für AddSourcedie IP-Adresse Ihres Quelldatenbankservers ein. Geben Sie außerdem den Benutzernamen, das Passwort und den Port ein, um eine Verbindung zu Ihrem Quelldatenbankserver herzustellen.

  6. Geben Sie für AddTargetdie IP-Adresse Ihres Zieldatenbankservers ein. Geben Sie außerdem den Benutzernamen, das Passwort und den Port ein, um eine Verbindung zu Ihrem Zieldatenbankserver herzustellen.

  7. (Optional) Geben Sie für AddServerMappingdie Quell- und Zieldatenbankobjekte ein, die Sie einer Zuordnungsregel hinzufügen möchten. Sie können targetTreePath Parameter sourceTreePath und verwenden, um den Pfad zu den Datenbankobjekten anzugeben. Optional können Sie sourceNamePath und verwenden, targetNamePath um die Namen der Datenbankobjekte anzugeben. Weitere Informationen finden Sie unter Befehle zur Serverzuordnung in derReferenzmaterial.

    Die Standardwerte des AddServerMappingVorgangs ordnen alle Quellschemas Ihrer Zieldatenbank zu.

  8. Speichern Sie die Datei und verwenden Sie dann den Skriptmodus, um sie auszuführen. Weitere Informationen finden Sie unter Skriptmodus.

AWS SCT CLI-Skriptmodus

Nachdem Sie ein AWS SCT CLI-Skript erstellt oder eine Vorlage bearbeitet haben, können Sie es mit dem RunSCTBatch Befehl ausführen. Stellen Sie sicher, dass Sie Ihre Datei mit dem CLI-Skript als .scts Erweiterung speichern.

Sie können AWS SCT CLI-Skripte aus dem app Ordner Ihres AWS SCT Installationspfads ausführen. In Windows lautet der StandardinstallationspfadC:\Program Files\AWS Schema Conversion Tool\. Stellen Sie sicher, dass dieser Ordner die RunSCTBatch.sh Datei RunSCTBatch.cmd oder enthält. Außerdem sollte dieser Ordner die AWSSchemaConversionToolBatch.jar Datei enthalten.

Alternativ können Sie den Pfad zur RunSCTBatch Datei in der PATH Umgebungsvariablen Ihres Betriebssystems hinzufügen. Nachdem Sie die PATH Umgebungsvariable aktualisiert haben, können Sie AWS SCT CLI-Skripts von jedem Ordner aus ausführen.

Verwenden Sie den folgenden Befehl in Windows, um ein AWS SCT CLI-Skript auszuführen.

RunSCTBatch.cmd --pathtoscts "file_path"

Ersetzen Sie im vorherigen Beispiel file_path durch den Pfad zu Ihrer Datei mit einem Skript.

Verwenden Sie den folgenden Befehl unter Linux, um ein AWS SCT CLI-Skript auszuführen.

RunSCTBatch.sh --pathtoscts "file_path"

Ersetzen Sie im vorherigen Beispiel file_path durch den Pfad zu Ihrer Datei mit einem Skript.

Sie können in diesem Befehl optionale Parameter angeben, z. B. Datenbankanmeldedaten, den Detaillierungsgrad in der Konsolenausgabe und andere. Weitere Informationen finden Sie in der Referenz zur AWS SCT Befehlszeilenschnittstelle unterReferenzmaterial.

Beispiele

Im folgenden Beispiel wird das ConversionTemplate.scts Skript im C:\SCT\Templates Ordner ausgeführt. Sie können dieses Beispiel in Windows verwenden.

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

Im folgenden Beispiel wird das ConversionTemplate.scts Skript im /home/user/SCT/Templates Verzeichnis ausgeführt. Sie können dieses Beispiel unter Linux verwenden.

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

AWS SCT CLI-Referenzmaterial

Referenzmaterial zur AWS Schema Conversion Tool Befehlszeilenschnittstelle (CLI) finden Sie in der folgenden Anleitung: AWS Schema Conversion Tool CLI Reference.