CLIReferenz für AWS Schema Conversion Tool - AWS Schema Conversion Tool
Voraussetzungeninteraktiver ModusCLISzenarien abrufenCLISzenarien 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.

CLIReferenz für AWS Schema Conversion Tool

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 Schema Conversion Tool.

AWS SCT CLIinteraktiver 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 in diesem 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.

Um in den AWS SCT CLI interaktiven Modus zu wechseln, verwenden Sie den folgenden Befehl, 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 AWS SCT CLI interaktiven Modus anzuzeigen.

help
/

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

help -command: 'command_name'
/

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

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

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

Ersetzen Sie im vorherigen Beispiel command_name durch den Namen eines Befehls. Dann ersetze parameters_list mit einer Liste von Parameternamen, die durch ein Komma getrennt sind.

Verwenden Sie den folgenden Befehl, um ein Skript aus einer Datei im AWS SCT CLI interaktiven 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 AWS SCT CLI interaktiven Modus zu beenden.

Beispiele

Im folgenden Beispiel werden die Informationen zum 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 CLISzenarien 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, müssen Sie die Voraussetzungen erfüllen und in den AWS SCT CLI interaktiven Modus wechseln. 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. Als Nächstes ersetzen file_path mit dem Pfad den Ordner, in den Sie Skripte herunterladen möchten. Stellen Sie sicher, dass AWS SCT Sie auf diesen Ordner zugreifen 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 Typen 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

BTEQScriptConversion

BTEQScriptConversionTemplate.scts

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

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 Schemas werden konvertiert.

GenericAppConversion

GenericApplicationConversionTemplate.scts

Konvertiert den in Ihre Anwendungen eingebetteten SQL Code mit dem generischen AWS SCT Anwendungskonverter. Weitere Informationen finden Sie unter SQLCode.

HadoopMigration

HadoopMigrationTemplate.scts

Migriert Ihren lokalen Hadoop-Cluster zu Amazon. EMR Weitere Informationen finden Sie unter Herstellen einer Verbindung zu Apache Hadoop-Datenbanken mit dem AWS Schema Conversion Tool.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Setzt eine unterbrochene Migration Ihres lokalen Hadoop-Clusters zu Amazon fort. EMR Weitere Informationen finden Sie unter Herstellen einer Verbindung zu Apache Hadoop-Datenbanken mit dem AWS Schema Conversion Tool.

Informatica

InformaticaConversionTemplate.scts

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

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 Anwendung wird konvertiert SQL.

OozieConversion

OozieConversionTemplate.scts

Konvertiert Ihre Apache Oozie-Workflows in. AWS Step Functions Weitere Informationen finden Sie unter Herstellen einer Verbindung zu Apache Oozie-Workflows mit dem AWS Schema Conversion Tool.

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 aus einem Data Warehouse.

ReportCreation

ReportCreationTemplate.scts

Erstellt einen Datenbankmigrationsbericht für mehrere Quelldatenbankschemas. Speichert diesen Bericht dann als CSV PDF OF-Datei. Weitere Informationen finden Sie unter Bewertungsbericht.

SQLScriptConversion

SQLScriptConversionTemplate.scts

Konvertiert SQL *Plus oder TSQL Skripte 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 CLISkriptmodus.

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 CLISzenarien 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 JDBCTreiber werden installiert für AWS Schema Conversion Tool.

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 Zuordnung von Datentypen.

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 SQL Postgre zu konvertieren. Anschließend planen Sie, Ihren Bewertungsbericht zur Datenbankmigration als zu speichern PDF 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, SaveTargetSQLSaveTargetSQLbyStatement, und die SaveReportCSVOperationen 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 Postgre-Treiber ein. SQL

    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 mit den Standardwerten fortfahren möchten, 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 für die Verbindung zu Ihrem Quelldatenbankserver ein.

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

  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 CLISkriptmodus

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 Skripts 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 unter Linux den folgenden Befehl, 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 CLIReferenzmaterial

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