共用方式為


建立指令檔 (MySQLToSQL)

啟動 SSMA 主控台應用程式之前的第一步是建立指令檔,並視需要建立變數值檔案和伺服器連線檔案。

指令檔可以分成三個部分,即:

  1. config:可讓使用者設定主控台應用程式的設定參數。

  2. servers:可讓使用者設定來源/目標伺服器定義。 這也可以位於另外的伺服器連線檔案中。

  3. script-commands:可讓使用者執行 SSMA 工作流程命令。

以下詳細說明每一個部分:

設定 MySQL 主控台設定

指令碼的設定會顯示在主控台指令檔中。

如果在設定節點中指定任何元素,就會設定為全域設定,也就是適用於所有指令碼命令。 如果使用者想要覆寫全域設定,也可以在 script-command 部分的每個命令中設定這些設定元素。

使用者可設定的選項包括:

  1. 輸出視窗提供者:如果 suppress-messages 屬性設定為 'true',命令專屬訊息不會顯示在主控台上。 屬性描述如下:

    • destination:指定輸出是否需要列印至檔案或 stdout。 預設為 false。

    • file-name:檔案的路徑 (選用)。

    • suppress-messages:抑制主控台上的訊息。 預設為 'false'。

    範例︰

    <output-providers>  
    
      <output-window  
    
        suppress-messages="<true/false>"   (optional)  
    
        destination="<file/stdout>"        (optional)  
    
        file-name="<file-name>"            (optional)  
    
       />  
    
    </output-providers>  
    

    or

    <...All commands...>  
    
      <output-window  
    
         suppress-messages="<true/false>"   (optional)  
    
         destination="<file/stdout>"        (optional)  
    
         file-name="<file-name>"            (optional)  
    
       />  
    
    </...All commands...>  
    
  2. 資料移轉連線提供者:這會指定要考慮用於資料移轉的來源/目標伺服器。 Source-use-last-used 表示上次用於資料移轉的來源伺服器。 同樣地,target-use-last-used 表示上次用於資料移轉的目標伺服器。 使用者也可以使用 source-server 或 target-server 屬性來指定伺服器 (來源或目標)。

    只能使用其中一個指定的屬性,也就是:

    • source-use-last-used="true" (預設) 或 source-server="source_servername"

    • target-use-last-used="true" (預設) 或 target-server="target_servername"

    範例︰

    <output-providers>  
    
      <data-migration-connection  source-use-last-used="true"  
    
                                  target-server="<target-server-unique-name>"/>  
    
    </output-providers>  
    

    or

    <migrate-data>  
    
      <data-migration-connection   source-server="<source-server-unique-name>"  
    
                                   target-use-last-used="true"/>  
    
    </migrate-data>  
    
  3. 使用者輸入快顯:從資料庫載入物件時,這可讓您處理錯誤。 使用者提供輸入模式,在發生錯誤時,主控台會如使用者所指定繼續進行。

    這些模式包括:

    • ask-user - 提示使用者繼續 ('yes') 或錯誤輸出 ('no') 。

    • error- 主控台會顯示錯誤並停止執行。

    • continue- 主控台會繼續執行。

    預設模式為 error

    範例︰

    <output-providers>  
    
      <user-input-popup mode="<ask-user/continue/error>"/>  
    
    </output-providers>  
    

    or

    <!-- Connect to target database -->  
    
    <connect-target-database server="<target-server-unique-name>">  
    
      <user-input-popup mode="<ask-user/continue/error>"/>  
    
    </connect-target-database>  
    
  4. 重新連線提供者:這可讓使用者在連線失敗時設定重新連線設定。 可同時針對來源和目標伺服器設定。

    重新連線模式如下:

    • reconnect-to-last-used-server:如果連線非使用中,會嘗試重新連線到上次使用的伺服器最多 5 次。

    • generate-an-error:如果連線非使用中,就會產生錯誤。

    預設模式為 generate-an-error

    範例︰

    <output-providers>  
    
    <reconnect-manager  on-source-reconnect="<reconnect-to-last-used-server/generate-an-error>"  
    
                        on-target-reconnect="<reconnect-to-last-used-server/generate-an-error>"/>  
    
    </output-providers>  
    

    or

    <!--synchronization-->  
    
    <synchronize-target>  
    
      <reconnect-manager on-target-reconnect="reconnect-to-last-used-server"/>  
    
    </synchronize-target>  
    

    or

    <!--data migration-->  
    
    <migrate-data server="target-server-unique-name">  
    
      <reconnect-manager  
    
        on-source-reconnect="reconnect-to-last-used-server"  
    
        on-target-reconnect="generate-an-error"/>  
    
    </migrate-data>  
    
  5. 轉換器覆寫提供者:這可讓使用者處理已在目標 Metabase 上顯示的物件。 可能的動作包括:

    • error:主控台會顯示錯誤並停止執行。

    • overwrite:覆寫現有物件值。 預設已執行此動作。

    • skip:主控台會略過已在資料庫上的物件

    • ask-user:提示使用者輸入 ('yes'/ 'no')

    範例︰

    <output-providers>  
    
      <object-overwrite action="<error/skip/overwrite/ask-user>"/>  
    
    </output-providers>  
    

    or

    <convert-schema object-name="<object-name>">  
    
      <object-overwrite action="<error/skip/overwrite/ask-user>"/>  
    
    </convert-schema>  
    
  6. 失敗的必要條件提供者:這可讓使用者處理處理命令所需的任何必要條件。 strict-mode 預設為 'false'。 如果設定為 'true',就會因未符合必要條件產生例外狀況。

    範例︰

    <output-providers>  
    
      <prerequisites strict-mode="<true/false>"/>  
    
    </output-providers>  
    
  7. 停止作業:在作業中,如果使用者想要停止作業,可以使用 'Ctrl+C' 快速鍵。 SSMA for MySQL 主控台會等作業完成再終止主控台執行。

    如果使用者想立即停止執行,可再次按 'Ctrl+C' 快速鍵,中途終止 SSMA 主控台應用程式

  8. 進度提供者:告知每個主控台命令的進度。 此選項預設為停用狀態。 進度報告屬性包含:

    • 每 1%

    • 每 2%

    • 每 5%

    • 每 10%

    • 每 20%

    範例︰

    <output-providers>  
    
      <progress-reporting enable="<true/false>"          (optional)  
    
                         report-messages="<true/false>"  (optional)  
    
                         report-progress="<every-1%/every-2%/every-5%/every-10%/every-20%/off>" (optional)/>  
    
    </output-providers>  
    

    or

    <...All commands...>  
    
      <progress-reporting  
    
        enable="<true/false>"              (optional)  
    
        report-messages="<true/false>"     (optional)  
    
        report-progress="<every-1%/every-2%/every-5%/every-10%/every-20%/off>"     (optional)/>  
    
    </...All commands...>  
    
  9. 記錄器詳細程度:設定記錄詳細程度層級。 這會對應至 UI 中的 [所有類別] 選項。 記錄詳細程度層級預設為 "error"。

    記錄器層級選項包括:

    • fatal-error:只會記錄嚴重錯誤訊息。

    • error:只會記錄錯誤和嚴重錯誤訊息。

    • warning:記錄偵錯和資訊訊息以外的所有層級。

    • info:記錄偵錯訊息以外的所有層級。

    • debug:記錄所有訊息層級。

    注意

    所有層級都會記錄必要訊息。

    範例︰

    <output-providers>  
    
      <log-verbosity level="<fatal-error/error/warning/info/debug>"/>  
    
    </output-providers>  
    

    or

    <...All commands...>  
    
      <log-verbosity level="<fatal-error/error/warning/info/debug>"/>  
    
    </...All commands...>  
    
  10. 覆寫加密的密碼:如果為 'true',伺服器連線檔案或指令檔伺服器定義區段中指定的純文字密碼,會覆寫儲存在受保護儲存體中的加密密碼 (若有)。 如果未以純文字指定密碼,系統會提示使用者輸入密碼。

    會有下列兩種情況:

    1. 如果 override 選項為 false,搜尋順序會是受保護的儲存體 -> 指令檔 -> 伺服器連線檔案 -> 提示使用者。

    2. 如果 override 選項為 true,搜尋順序會是指令檔 -> 伺服器連線檔案 -> 提示使用者。

    範例︰

    <output-providers>  
    
      <encrypted-password override="<true/false>"/>  
    
    </output-providers>  
    

無法設定的選項為:

  • 重新連線嘗試次數上限:建立的連線因網路故障而逾時或中斷時,需要重新連線伺服器。 允許重新連線嘗試最多 5 次重試,之後主控台會自動執行重新連線。 自動重新連線功能可減少重新執行指令碼的心力。

伺服器連線參數

伺服器連線參數可以在指令檔或伺服器連線檔案中定義。 如需詳細資訊,請參閱建立伺服器連線檔案 (MySQLToSQL) 一節。

指令碼命令

指令檔包含一系列 XML 格式的移轉工作流程命令。 SSMA 主控台應用程式會依指令檔中顯示的命令順序來處理移轉。

例如,MySQL 資料庫中特定資料表的一般資料移轉遵循:資料庫 -> 資料表的階層。

成功執行指令檔中的所有命令時,SSMA 主控台應用程式會結束並將控制項傳回給使用者。 指令檔的內容與變數值檔案中,或是指令檔另外的變數值區段中包含的變數資訊或多或少相同。

範例︰

<!--Sample of script file commands -->  
  
<ssma-script-file>  
  
  <script-commands>  
  
    <create-new-project project-folder="<project-folder>"  
  
                        project-name="<project-name>"  
  
                        overwrite-if-exists="<true/false>"/>  
  
    <connect-source-database server="<source-server-unique-name>"/>  
  
    <save-project/>  
  
    <close-project/>  
  
  </script-commands>  
  
</ssma-script-file>  

在產品目錄的 [範例主控台指令碼] 資料夾中,提供包含 3 個指令檔 (用於執行各種情節)、變數值檔案和伺服器連線檔案的範本:

  • AssessmentReportGenerationSample.xml

  • ConversionAndDataMigrationSample.xml

  • SqlStatementConversionSample.xml

  • VariableValueFileSample.xml

  • ServersConnectionFileSample.xml

您可以在變更顯示於該處的參數以取得相關程度之後,執行範本 (檔案)。

可以在執行 SSMA 主控台 (MySQLToSQL) 中找到指令碼命令的完整清單

指令檔驗證

使用者可以輕鬆根據 [Schemas] 資料夾中的結構描述定義檔案 'M2SSConsoleScriptSchema.xsd',驗證其指令檔。

後續步驟

操作主控台的下一步是建立變數值檔案 (MySQLToSQL)

另請參閱

建立變數值檔案 (MySQLToSQL)