执行 SSMA 控制台 (SybaseToSQL)

Microsoft 提供了一组可靠的脚本文件命令，用来执行和控制 SSMA 活动。 随后的各节详细介绍了相同的内容。

脚本文件命令

控制台应用程序将使用此部分中列举的一些标准脚本文件命令。

项目命令

“项目”命令用来创建、打开、保存和退出项目。

create-new-project

此命令创建新的 SSMA 项目。

• project-folder 表示所创建的项目的文件夹。

• project-name 表示项目的名称。 {string}

• overwrite-if-exists可选属性指示是否应覆盖现有项目。 {boolean}

• project-type: 可选属性。 表示项目类型，即“sql-server-2005”项目或“sql-server-2008”项目或“sql-server-2012”项目或“sql-server-2014”项目或“sql-azure”项目。 默认设置为“sql-server-2008”。

语法示例：

<create-new-project  
  
  project-folder="<project-folder>"  
  
  project-name="<project-name>"  
  
  overwrite-if-exists="<true/false>" (optional)  
  
   project-type="<sql-server-2008/sql-server-2005/sql-server-2012/sql-server-2014/sql-azure>"  
/>  

默认情况下，属性“overwrite-if-exists”为 false。

默认情况下，属性“project-type”为 sql-server-2008。

open-project

此命令将打开项目。

• project-folder 表示所创建的项目的文件夹。 如果指定的文件夹不存在，此命令将失败。 {string}

• project-name 表示项目的名称。 如果指定的项目不存在，此命令将失败。 {string}

语法示例：

<open-project  
  
  project-folder="<project-folder>"  
  
  project-name="<project-name>"  
  
/>  

注意

SAP ASE 控制台应用程序的 SSMA 支持后向兼容。 你可以打开由旧版本的 SSMA 创建的项目。

save-project

此命令将保存迁移项目。

语法示例：

<save-project/>  

close-project

此命令将关闭迁移项目。

语法示例：

<close-project   
  if-modified="<save/error/ignore>"   (optional)  
/>  

属性“if-modified”为可选的，默认情况下为 ignore。

数据库连接命令

“数据库连接”命令可以帮助连接到数据库。

注意

• 控制台不支持 UI 的“浏览”功能。
• 有关创建脚本文件的详细信息，请参阅创建脚本文件 (SybaseToSQL)。

connect-source-database

此命令将执行与源数据库的连接，并加载源数据库的简要元数据，而不是加载所有元数据。

如果无法与源建立连接，将会生成一个错误，控制台应用程序将停止进一步执行。

从为服务器连接文件或脚本文件的服务器部分中的每个连接定义的名称属性中，检索服务器定义。

语法示例：

<connect-source-database  server="<server-unique-name>"/>  

force-load-source/target-database

此命令将加载源元数据，这对于脱机处理迁移项目非常有用。

如果无法与源/目标建立连接，将会生成一个错误，控制台应用程序将停止进一步执行。

此命令需要一个或多个元数据库节点作为命令行参数。

语法示例：

<force-load metabase="<source/target>" >  
  
  <metabase-object object-name="<object-name>"/>  
  
</force-load>  

reconnect-source-database

此命令将重新连接到源数据库，但与 connect-source-database 命令不同，它不加载任何元数据。

如果无法（重新）与源建立连接，将会生成一个错误，控制台应用程序将停止进一步执行。

语法示例：

<reconnect-source-database  server="<server-unique-name>"/>  

connect-target-database

此命令将连接到目标 SQL Server 数据库，并加载目标数据库的简要元数据，而不是加载所有元数据。

如果无法与目标建立连接，将会生成一个错误，控制台应用程序将停止进一步执行。

从为服务器连接文件或脚本文件的服务器部分中的每个连接定义的名称属性中，检索服务器定义。

语法示例：

<connect-target-database  server="<server-unique-name>"/>  

reconnect-target-database

此命令将重新连接到目标数据库，但与 connect-target-database 命令不同，它并不加载任何元数据。

如果无法（重新）与目标建立连接，将会生成一个错误，控制台应用程序将停止进一步执行。

语法示例：

<reconnect-target-database  server="<server-unique-name>"/>  

报告命令

“报告”命令用来生成有关各种 SSMA 控制台活动的性能报告。

generate-assessment-report

此命令将为源数据库生成评估报表。

如果在执行此命令之前未连接到源数据库，将会生成一个错误，控制台应用程序将退出。

如果在命令执行期间未能连接到源数据库服务器，也会导致控制台应用程序终止。

• conversion-report-folder: 指定可存储评估报表的文件夹。 （可选属性）

• object-name: 指定在生成评估报表时考虑使用的对象（支持单独的对象名或组对象名）。

• object-type: 指定在 object-name 属性中调用的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• conversion-report-overwrite: 指定是否覆盖评估报告文件夹（如果已存在）。

  默认值：false。 （可选属性）

• write-summary-report-to: 指定生成报表的路径。

  如果只提及文件夹路径，将使用名称 AssessmentReport<n>.XML 创建文件。 （可选属性）

  报表创建操作还有两个子类别：

  • report-errors（="true/false"，默认值为“false”[可选的属性]）

  • verbose（="true/false"，默认值为“false”[可选的属性]）

语法示例：

<generate-assessment-report  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  write-summary-report-to="<file-name/folder-name>"             (optional)  
  
  verbose="<true/false>"                       (optional)  
  
  report-errors="<true/false>"                 (optional)  
  
  assessment-report-folder="<folder-name>"          (optional)  
  
  conversion-report-overwrite="<true/false>"   (optional)  
  
/>  

、

<generate-assessment-report  
  
  assessment-report-folder="<folder-name>"            (optional)  
  
  conversion-report-overwrite="<true/false>"     (optional)  
  
>  
<metabase-object object-name="<object-name>"  
  
        object-type="<object-category>"/>  
  
</generate-assessment-report>  

迁移命令

迁移命令可将目标数据库架构转换为源架构，并将数据迁移到目标服务器。

convert-schema

此命令将执行从源架构到目标架构的架构转换。

如果在执行此命令之前未连接到源或目标数据库，或者在命令执行期间未能连接到源或目标数据库服务器，将会生成一个错误，控制台应用程序将退出。

• conversion-report-folder: 指定可在其中存储评估报表的文件夹。 （可选属性）

• object-name: 指定在转换架构时考虑使用的源对象（支持单独的对象名称或组对象名称）。

• object-type: 指定在 object-name 属性中调用的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• conversion-report-overwrite: 指定是否覆盖评估报告文件夹（如果已存在）。

  默认值：false。 （可选属性）

• write-summary-report-to: 指定生成摘要报表的路径。

  如果只提及文件夹路径，将使用名称 SchemaConversionReport<n>.XML 创建文件。 （可选属性）

  报表创建操作还有两个子类别：

  • report-errors（="true/false"，默认值为“false”[可选的属性]）

  • verbose（="true/false"，默认值为“false”[可选的属性]）

语法示例：

<convert-schema  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  write-summary-report-to="<file-name/folder-name>"     (optional)  
  
  verbose="<true/false>"                          (optional)  
  
  report-errors="<true/false>"                    (optional)  
  
  conversion-report-folder="<folder-name>"             (optional)  
  
  conversion-report-overwrite="<true/false>"      (optional)  
  
/>  

、

<convert-schema  
  
  conversion-report-folder="<folder-name>"         (optional)  
  
  conversion-report-overwrite="<true/false>"> (optional)  
  
  <metabase-object object-name="<object-name>"  
  
    object-type="<object-category>"/>  
  
</convert-schema>  

migrate-data

此命令可将源数据迁移到目标。

• object-name: 指定在迁移数据时考虑使用的源对象（支持具有单独的对象名或组对象名）。

• object-type: 指定在 object-name 属性中调用的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• write-summary-report-to: 指定生成报表的路径。

  如果只提及文件夹路径，将创建名称为 DataMigrationReport<n>.XML 的文件。 （可选属性）

  报表创建操作还有两个子类别：

  • report-errors（="true/false"，默认值为“false”[可选的属性]）

  • verbose（="true/false"，默认值为“false”[可选的属性]）

语法示例：

<migrate-data  
  
  write-summary-report-to="<file-name/folder-name>"  
  
  report-errors="<true/false>" verbose="<true/false>">  
  
    <metabase-object object-name="<object-name>"/>  
  
    <metabase-object object-name="<object-name>"/>  
  
    <metabase-object object-name="<object-name>"/>  
  
    <data-migration-connection  
  
      source-use-last-used="true"/source-server="<server-unique-name>"  
  
      target-use-last-used="true"/target-server="<server-unique-name>"/>  
  
</migrate-data>  

、

<migrate-data  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  write-summary-report-to="<file-name/folder-name>"  
  
  report-errors="<true/false>" verbose="<true/false>"/>  

迁移准备命令

迁移准备命令可启动源数据库和目标数据库之间的架构映射。

注意

迁移命令的默认控制台输出设置是“完整”输出报告，不包含详细的错误报告：只包含源对象树根节点的摘要。

map-schema

此命令将提供从源数据库架构到目标架构的架构映射。

• source-schema 指定要迁移的源架构。

• sql-server-schema 指定要将源架构迁移到的目标架构。

语法示例：

<map-schema source-schema="<source-schema>"  
  
sql-server-schema="<target-schema>"/>  

可管理性命令

可管理性命令可帮助用户将目标数据库对象与源数据库同步。

注意

迁移命令的默认控制台输出设置是“完整”输出报告，不包含详细的错误报告：只包含源对象树根节点的摘要。

synchronize-target

此命令可将目标对象与目标数据库同步。

如果对源数据库执行此命令，会遇到错误。

如果在执行此命令之前未连接到目标数据库，或者在命令执行期间未能连接到目标数据库服务器，将会生成一个错误，控制台应用程序将退出。

• object-name: 指定在与目标数据库同步时考虑使用的目标对象（支持单独的对象名称或组对象名称）。

• object-type: 指定在 object-name 属性中调用的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• on-error: 指定是将同步错误指定为警告还是错误。 错误时的可用选项：

  • report-total-as-warning

  • report-each-as-warning

  • fail-script

• report-errors-to: 指定同步操作的错误报告的位置（可选属性）。 如果仅指定文件夹路径，则会创建名称为 TargetSynchronizationReport.XML 的文件。

语法示例：

<synchronize-target  
  
object-name="<object-name>"  
  
on-error="<report-total-as-warning/  
  
report-each-as-warning/  
  
fail-script>" (optional)  
  
  report-errors-to="<file-name/folder-name>"        (optional)  
  
/>  

、

<synchronize-target  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"/>  

、

<synchronize-target>  
  
  <metabase-object object-name="<object-name>"/>  
  
  <metabase-object object-name="<object-name>"/>  
  
  <metabase-object object-name="<object-name>"/>  
  
</synchronize-target>  

refresh-from-database

此命令将从数据库刷新源对象。

如果对目标数据库执行此命令，则会生成错误。

此命令需要一个或多个元数据库节点作为命令行参数。

• object-name: 指定在从源数据库刷新时考虑使用的源对象（支持单独的对象名称或组对象名称）。

• object-type: 指定对象名属性中指定的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• on-error: 指定是将刷新错误指定为警告还是错误。 错误时的可用选项：

  • report-total-as-warning

  • report-each-as-warning

  • fail-script

• report-errors-to: 指定刷新操作的错误报告的位置（可选属性）。 如果仅指定文件夹路径，则创建名称为 SourceDBRefreshReport.XML 的文件。

语法示例：

<refresh-from-database  
  
  object-name="<object-name>"  
  
  on-error="<report-total-as-warning/  
  
             report-each-as-warning/  
  
             fail-script>"              (optional)  
  
  report-errors-to="<file-name/folder-name>"        (optional)  
  
/>  

、

<refresh-from-database  
  
  object-name="<object-name>"  
  
  object-type="<object-category>" />  

、

<refresh-from-database>  
  
  <metabase-object object-name="<object-name>"/>  
  
</refresh-from-database>  

脚本生成命令

脚本生成命令执行双重任务：将控制台输出保存在脚本文件中；并根据指定的参数将 T-SQL 输出记录到控制台或文件。

save-as-script

当 metabase=target 时，此命令用于将对象的脚本保存到提及的文件中。 这是同步命令的替代方法，我们将在其中获取脚本并在目标数据库上执行相同操作。

此命令需要一个或多个元数据库节点作为命令行参数。

• object-name: 指定要保存其脚本的对象（支持单个对象名称或组对象名称）。

• object-type: 指定在 object-name 属性中调用的对象的类型（如果指定了对象类别，对象类型将为“category”）。

• metabase: 指定它是源元数据库还是目标元数据库。

• destination: 指定必须保存脚本的路径或文件夹。 如果未提供文件名，则会提供格式为（object_name 属性值）.out 的文件名。

• overwrite: 如果为 true，则会在存在同一文件名时进行覆盖。 它可以具有值 (true/false)。

语法示例：

<save-as-script  
  
  metabase="<source/target>"  
  
  object-name="<object-name>"  
  
  object-type="<object-category>"  
  
  destination="<file-name/folder-name>"  
  
  overwrite="<true/false>"   (optional)  
  
/>  

、

<save-as-script  
  
  metabase="<source/target>"  
  
  destination="<file-name/folder-name>"  
  
    <metabase-object object-name="<object-name>"  
  
                     object-type="<object-category>"/>  
  
</save-as-script>  

convert-sql-statement

此命令将转换 SQL 语句。

• context 指定架构名称。

• destination 指定是否应将输出存储在文件中。

  如果未指定此属性，则会在控制台上显示转换后的 T-SQL 语句。 （可选属性）

• conversion-report-folder 指定可存储评估报表的文件夹。 （可选属性）

• conversion-report-overwrite 指定是否覆盖评估报告文件夹（如果已存在）。

  默认值：false。 （可选属性）

• write-converted-sql-to 指定已转换的 T-SQL 将要存储到的文件或文件夹路径。 指定随附 sql-files 属性的文件夹路径时，每个源文件都将在指定文件夹下创建相应的目标 T-SQL 文件。 指定随附 sql 属性的文件夹路径时，会将转换后的 T-SQL 写入到指定文件夹下的一个名为 Result.out 的文件中。

• sql 指定要转换的 Sybase sql 语句，可以使用“;”分隔一个或多个语句

• sql-files 指定必须转换为 T-SQL 代码的 sql 文件的路径。

• write-summary-report-to 指定将生成摘要报告的路径。 如果只提及文件夹路径，将使用名称 ConvertSQLReport.XML 创建文件。 （可选属性）

  摘要报告创建操作还有两个子类别：

  • report-errors（="true/false"，默认值为“false”[可选的属性]）。

  • verbose（="true/false"，默认值为“false”[可选的属性]）。

此命令需要一个或多个元数据库节点作为命令行参数。

语法示例：

<convert-sql-statement  
  
       context="<database-name>.<schema-name>"  
  
        conversion-report-folder="<folder-name>"  
  
        conversion-report-overwrite="<true/false>"  
  
        write-summary-report-to="<file-name/folder-name>"   (optional)  
  
        verbose="<true/false>"   (optional)  
  
        report-errors="<true/false>"   (optional)  
  
        destination="<stdout/file>"   (optional)  
  
        write-converted-sql-to ="<file-name/folder-name>"  
  
        sql="SELECT 1 FROM DUAL;">  
  
    <output-window suppress-messages="<true/false>" />  
  
</convert-sql-statement>  

、

<convert-sql-statement  
  
         context="<database-name>.<schema-name>"  
  
         conversion-report-folder="<folder-name>"  
  
         conversion-report-overwrite="<true/false>"  
  
         write-summary-report-to="<file-name/folder-name>"   (optional)  
  
         verbose="<true/false>"   (optional)  
  
         report-errors="<true/false>"   (optional)  
  
         destination="<stdout/file>"   (optional)  
  
         write-converted-sql-to ="<file-name/folder-name>"  
  
         sql-files="<folder-name>\*.sql"  
  
/>  

、

<convert-sql-statement  
  
         context="<database-name>.<schema-name>"  
  
         conversion-report-folder="<folder-name>"  
  
         conversion-report-overwrite="<true/false>"  
  
         sql-files="<folder-name>\*.sql"  
  
/>  

后续步骤

有关命令行选项的信息，请参阅 SSMA 控制台中的命令行选项 (AccessToSQL)。

有关示例控制台脚本文件的信息，请参阅使用示例控制台脚本文件 (SybaseToSQL)。

下一步取决于项目要求：

• 有关指定密码或导出/导入密码的信息，请参阅管理密码 (SybaseToSQL)。

• 有关生成报表的信息，请参阅生成报表 (SybaseToSQL)。

• 有关控制台问题的故障排除，请参阅故障排除 (SybaseToSQL)。