本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CLI參考資料 AWS Schema Conversion Tool
本節說明如何開始使用指 AWS SCT 令行介面 (CLI)。此外，本節還提供有關按鍵指令和使用模式的資訊。如需指 AWS SCT CLI令的完整參考，請參閱參考材料。
主題
使用 AWS SCT 指令行介面的先決條件
下載並安裝最新版本的 Amazon Corretto 11. 如需詳細資訊，請參閱 Amazon Corretto 11 使用者指南中的下載。
下載並安裝最新版本的 AWS SCT. 如需詳細資訊，請參閱安裝中 AWS Schema Conversion Tool。
AWS SCT CLI互動模式
您可以在交互模式下使用 AWS SCT 命令行界面。在此模式下，您可以一個接一個地將命令輸入控制台。您可以使用此互動模式來進一步瞭解CLI指令或下載最常用的CLI案例。
若要在中轉換來源資料庫結構描述 AWS SCT，請執行序列作業：建立新專案、連線至來源和目標資料庫、建立對應規則，以及轉換資料庫物件。由於此工作流程可能很複雜，因此建議您在 AWS SCT CLI模式中使用指令碼。如需詳細資訊，請參閱指令碼模式。
您可以從 AWS SCT 安裝路徑的app資料夾執行 AWS SCT CLI命令。在視窗中，預設安裝路徑為C:\Program Files\AWS Schema Conversion Tool\。請確定此資料夾包含AWSSchemaConversionToolBatch.jar檔案。
若要進入 AWS SCT CLI互動模式，請在完成先決條件之後使用下列指令。
java -jar AWSSchemaConversionToolBatch.jar -type interactive
現在，您可以運行 AWS SCT CLI命令。確保您以新行結束命令。/此外，請確定您在指令參數值之前和之後使用直單引號 (')。
注意
如果前面的命令返回Unexpected error，請嘗試以下操作：
java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar
若要查看 AWS SCT CLI互動模式下可用指令的清單，請執行下列命令。
help /
若要檢視有關 AWS SCT CLI指令的資訊，請使用下列命令。
help -command: 'command_name' /
在前面的例子中，替換 command_name 使用命令的名稱。
若要檢視有關 AWS SCT CLI指令參數的資訊，請使用下列指令。
help -command: 'command_name' -parameters: 'parameters_list' /
在前面的例子中，替換 command_name 使用命令的名稱。然後，更換 parameters_list 以逗號分隔的參數名稱清單。
若要在 AWS SCT CLI互動模式下從檔案執行指令碼，請使用下列指令。
ExecuteFile -file: 'file_path' /
在前面的例子中，替換 file_path 使用腳本的文件的路徑。請確定您的檔案具有.scts副檔名。
若要結束 AWS SCT CLI互動模式，請執行quit指令。
範例
下列範例會顯示有關Convert指令的資訊。
help -command: 'Convert' /
下列範例會顯示有關Convert命令兩個參數的資訊。
help -command: 'Convert' -parameters: 'filter, treePath' /
取得 AWS SCT CLI案例
要獲得最常用的 AWS SCT 場景，您可以使用GetCliScenario命令。您可以在交互模式下運行此命令，然後編輯下載的模板。在腳本模式下使用編輯過的文件。
指GetCliScenario令會將選取的樣板或所有可用的樣板儲存到指定的目錄中。該模板包含用於運行腳本的完整命令集。請務必編輯這些範本中的檔案路徑、資料庫認證、物件名稱和其他資料。此外，請確定您移除不使用的命令，並在需要時將新命令新增至指令碼。
若要執行指GetCliScenario令，請完成先決條件並進入 AWS SCT CLI互動模式。如需詳細資訊，請參閱互動式模式。
接下來，使用下列語法來執行GetCliScenario命令並取得 AWS SCT
案例。
GetCliScenario -type: 'template_type' -directory: 'file_path' /
在前面的例子中，替換 template_type 使用下表中的其中一種範本類型。接下來，更換 file_path 與路徑要下載腳本的文件夾。確保 AWS SCT 可以在不要求管理員權限的情況下訪問此文件夾。此外，請確定您在指令參數值之前和之後使用直單引號 (')。
若要下載所有 AWS SCT CLI範本，請不使用-type選項執行上述命令。
下表包含您可以下載的 AWS SCT CLI範本類型。對於每個範本，表格包含檔案名稱和您可以使用指令碼執行的作業說明。
| 模板類型 | 檔案名稱 | 描述 |
|---|---|---|
|
BTEQScriptConversion |
|
將 Teradata 基本查詢 (BTEQ) FastExport FastLoad、和 MultiLoad 指令碼轉換為 Amazon Redshift。RSQL如需詳細資訊，請參閱轉換資料使用 ETL。 |
ConversionApply |
|
轉換來源資料庫結構描述，並將轉換的程式碼套用至目標資料庫。選擇性地將轉換後的程式碼儲存為SQL指令碼，並儲存評估報告。如需詳細資訊，請參閱轉換綱要。 |
GenericAppConversion |
|
使用一般應用程式轉換器，轉換內嵌至應用 AWS SCT 程式的程式SQL碼 如需詳細資訊，請參閱SQL代碼。 |
HadoopMigration |
|
將您的現場部署 Hadoop 叢集遷移到 Amazon。EMR如需詳細資訊，請參閱使用連接到阿帕奇 Hadoop 數據庫 AWS Schema Conversion Tool。 |
HadoopResumeMigration |
|
繼續將現場部署 Hadoop 叢集中斷移轉至 Amazon。EMR如需詳細資訊，請參閱使用連接到阿帕奇 Hadoop 數據庫 AWS Schema Conversion Tool。 |
信息 |
|
轉換SQL嵌入到資訊擷取、轉換和 load (ETL) 指令碼中的程式碼。在ETL指令碼中設定與來源和目標資料庫的連線，並在轉換後儲存轉換的指令碼。如需詳細資訊，請參閱信息腳本 ETL。 |
LanguageSpecificAppConversion |
|
使用應用程式轉換器，將內嵌至 C#、C++、Java 和 Pro*C 應用程式的程式SQL碼轉換。 AWS SCT 如需詳細資訊，請參閱轉換應用 SQL。 |
OozieConversion |
|
將您的工作流程轉換為 AWS Step Functions. 如需詳細資訊，請參閱連接到阿帕奇工作流程 AWS Schema Conversion Tool。 |
RedshiftAgent |
|
轉換來源資料倉儲結構描述，並將轉換後的程式碼套用至目標 Amazon Redshift 資料庫。然後註冊資料擷取代理程式，建立並啟動資料移轉任務。如需詳細資訊，請參閱從資料倉儲移轉。 |
ReportCreation |
|
為數個來源資料庫結構描述建立資料庫移轉報表。然後將此報告另存為CSVPDF檔案。如需詳細資訊，請參閱評估報告。 |
SQLScriptConversion |
|
將 SQL * Plus 或TSQL腳本轉換為 PL/ SQL 並保存轉換後的腳本。此外，還可以儲存評估報告。 |
下載 AWS SCT CLI範本之後，請使用文字編輯器來設定要在來源和目標資料庫上執行的指令碼。接下來，使用 AWS SCT CLI腳本模式運行腳本。如需詳細資訊，請參閱AWS SCT CLI腳本模式。
範例
下列範例會將所有範本下載到資C:\SCT\Templates料夾中。
GetCliScenario -directory: 'C:\SCT\Templates' /
下列範例會將ConversionApply作業的範本下載到C:\SCT\Templates資料夾中。
GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates' /
編輯 AWS SCT CLI案例
下載案例範本之後，請將它們設定為取得可在資料庫上執行的工作指令碼。
對於所有範本，請確定您已為來源和目標資料庫提供驅動程式的路徑。如需詳細資訊，請參閱安裝JDBC驅動程式 AWS Schema Conversion Tool。
請確定包含來源和目標資料庫的資料庫認證。此外，請務必設定對映規則來描述轉換專案的來源-目標配對。如需詳細資訊，請參閱資料類型對映。
接下來，設定要執行的作業範圍。您可以移除不使用的命令，或將新命令新增至指令碼。
例如，假設您計劃將來源 Oracle 資料庫中的所有綱要轉換為 Postgre SQL。然後，您計劃將資料庫移轉評估報告另存為，PDF並將轉換後的程式碼套用至目標資料庫。在此情況下，您可以使用範本進行ConversionApply作業。請使用下列步驟來編輯 AWS SCT CLI範本。
若要編輯ConversionApply作業的 AWS SCT CLI範本
打開
ConversionTemplate.scts您下載的。如需詳細資訊，請參閱範例。從腳本中刪除 CreateFilter，轉換 ApplyToTarget -filter SaveTarget SQL，過濾器 SaveTargetSQLbyStatement，和SaveReportCSV操作。
對於SetGlobalSettings作業中的 Oracle_driver 檔案，請輸入 Oracle 驅動程式的路徑。然後，對於 Postgreql_file，請輸入您的驅動程序的路徑。SQL
如果您使用其他資料庫引擎，請為設定使用適當的名稱。如需可在作業中設定之全域設定的完整清SetGlobalSettings單，請參閱中的全域設定矩陣參考材料。
(可選) 在中 CreateProject，輸入專案的名稱和本端專案檔的位置。如果您選擇繼續使用預設值，請確定 AWS SCT 可以在不要求管理員權限的情況下在
C:\temp資料夾中建立檔案。在中 AddSource，輸入來源資料庫伺服器的 IP 位址。此外，請輸入使用者名稱、密碼和連接埠，以連接到來源資料庫伺服器。
在中 AddTarget，輸入目標資料庫伺服器的 IP 位址。此外，請輸入要連線到目標資料庫伺服器的使用者名稱、密碼和連接埠。
(選擇性) 在中 AddServerMapping，輸入您要新增至對應規則的來源和目標資料庫物件。您可以使用
sourceTreePath和targetTreePath參數來指定資料庫物件的路徑。或者，您可以使用sourceNamePath和targetNamePath來指定資料庫物件的名稱。如需詳細資訊，請參閱中的伺服器對應命令參考材料。AddServerMapping作業的預設值會將所有來源結構描述與您的目標資料庫對映。
儲存檔案，然後使用指令碼模式執行檔案。如需詳細資訊，請參閱指令碼模式。
AWS SCT CLI腳本模式
建立指令 AWS SCT CLI碼或編輯範本之後，您可以使用RunSCTBatch指令來執行它。請務必將您的檔案與CLI指令碼一起儲存為.scts副檔名。
您可以從 AWS SCT 安裝路徑的app資料夾執行 AWS SCT CLI指令碼。在視窗中，預設安裝路徑為C:\Program Files\AWS Schema Conversion Tool\。請確定此資料夾包含RunSCTBatch.cmd或RunSCTBatch.sh檔案。此外，此文件夾應包含該AWSSchemaConversionToolBatch.jar文件。
或者，您也可以在作業系統上的PATH環境變數中新增RunSCTBatch檔案的路徑。更新PATH環境變數之後，您可以從任何資料夾執行 AWS SCT CLI指令碼。
若要執行指令 AWS SCT CLI碼，請在 Windows 中使用下列命令。
RunSCTBatch.cmd --pathtoscts "file_path"
在前面的例子中，替換 file_path 使用腳本的文件的路徑。
要運行 AWS SCT CLI腳本，請在 Linux 中使用以下命令。
RunSCTBatch.sh --pathtoscts "file_path"
在前面的例子中，替換 file_path 使用腳本的文件的路徑。
您可以在此命令中提供選擇性參數，例如資料庫認證、主控台輸出中的詳細資料層級等。如需詳細資訊，請在下載 AWS SCT 指令行介面參考參考材料。
範例
下列範例會在C:\SCT\Templates資料夾中執行ConversionTemplate.scts指令碼。您可以在視窗中使用這個範例。
RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"
下列範例會在/home/user/SCT/Templates目錄中執行ConversionTemplate.scts指令碼。您可以在 Linux 中使用這個範例。
RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"
AWS SCT CLI參考材料
您可以在以下指南中找到有關指 AWS Schema Conversion Tool 令行介面 (CLI) 的參考材料：AWS Schema Conversion Tool CLI參考
