创建脚本文件 (SybaseToSQL)

  • 项目

在启动 SSMA 控制台应用程序之前，第一步是创建脚本文件，如果需要，还应创建变量值文件和服务器连接文件。

脚本文件可以分为三个部分，包括：

  1. config：允许用户设置用于控制台应用程序的配置参数。

  2. server：允许用户设置源/目标服务器定义。 这一部分也可能位于单独的服务器连接文件中。

  3. script-command：允许用户执行 SSMA 工作流命令。

下面将详细介绍每个部分：

配置 Sybase 控制台设置

脚本的配置显示在控制台脚本文件中。

如果在配置节点中指定了任何元素，则会将其设置为全局设置，也就是说，它们适用于所有脚本命令。 如果用户希望覆盖全局设置，也可以在 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>

    或

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

    或

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

    或

    <!-- 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>

    或

    <!--synchronization-->  

<synchronize-target>  

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

</synchronize-target>

    或

    <!--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. 转换器覆盖提供程序：此属性将使用户能够处理目标元数据库中已经存在的对象。 可以执行的操作包括：

    • error：控制台显示一个错误并停止执行。

    • overwrite：覆盖现有的对象值。 默认执行此操作。

    • skip：控制台跳过数据库中已经存在的对象

    • ask-user：提示用户输入（“yes”/“no”）

    示例：

    <output-providers>  

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

</output-providers>

    或

    <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 Sybase 控制台将等待操作完成，并终止控制台执行。

    如果用户希望立即停止执行，则可以再次按下“Ctrl+C”热键，以便即时终止 SSMA 控制台应用程序

  8. 进度提供程序：通报每个控制台命令的进度。 此项默认禁用。 progress-reporting 属性包括：

    • 关闭

    • every-1%

    • every-2%

    • every-5%

    • every-10%

    • every-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>

    或

    <...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”。

    logger-level 选项包括：

    • fatal-error：仅记录严重错误消息。

    • error：仅记录错误和严重错误消息。

    • warning：记录除调试和信息消息以外的所有级别。

    • info：记录除调试消息以外的所有级别。

    • debug：记录所有级别的消息。

    注意

    系统会记录任何级别的强制消息。

    示例：

    <output-providers>  

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

</output-providers>

    或

    <...All commands...>  

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

</...All commands...>

  10. 覆盖加密密码：如果为“true”，服务器连接文件的服务器定义部分或者脚本文件中指定的明文密码将覆盖受保护的存储位置中存储的加密密码（如果存在）。 如果未以明文形式指定密码，系统会提示用户输入密码。

    随后会出现两种情况：

    1. 如果覆盖选项为 false，搜索顺序将是受保护的存储->脚本文件->服务器连接文件->提示用户。

    2. 如果覆盖选项为 true，搜索顺序将是脚本文件->服务器连接文件->提示用户。

    示例：

    <output-providers>  

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

</output-providers>

不可配置的选项为：

  • 最大重新连接尝试次数：当已建立的连接由于网络故障而超时或断开时，需要重新连接服务器。 允许尝试重新连接最多 5 次，此后，控制台会自动执行重新连接。 自动重新连接这一功能可以减少重新运行脚本的次数。

服务器连接参数

可以在脚本文件或服务器连接文件中定义服务器连接参数。 有关更多详细信息，请参阅创建服务器连接文件 (OracleToSQL) 部分

脚本命令

脚本文件包含 XML 格式的迁移工作流命令序列。 SSMA 控制台应用程序按照脚本文件中显示的命令顺序处理迁移。

例如，Sybase 数据库中的一个特定表的典型数据迁移遵循“数据库 -> 架构 -> 表”的层次结构。

成功执行脚本文件中的所有命令之后，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>

产品目录的 Sample Console Scripts 文件夹中提供了一些模板，这些模板包含 3 个脚本文件（用于执行各种场景）、变量值文件和服务器连接文件：

  • AssessmentReportGenerationSample.xml

  • ConversionAndDataMigrationSample.xml

  • SqlStatementConversionSample.xml

  • VariableValueFileSample.xml

  • ServersConnectionFileSample.xml

为了保持相关性而更改其中显示的参数之后，可以执行模板（文件）。

可以在执行 SSMA 控制台 (SybaseToSQL)中找到 script-command 的完整列表

脚本文件验证

用户可以对照“Schemas”文件夹中提供的架构定义文件“S2SSConsoleScriptSchema.xsd”，轻松验证自己的脚本文件

下一步

操作控制台的下一步是创建变量值文件 (SybaseToSQL)。

另请参阅

创建变量值文件 (SybaseToSQL)