大网数据广告活动
数据库与应用安全

执行 SSMA 控制台 (DB2ToSQL)

· 52CE 我爱测

Microsoft 你提供一组可靠的脚本来执行和控制 SSMA 活动文件命令。 接下来的几节详细介绍相同。 控制台应用程序在本部分中使用作为枚举的某些标准脚本文件命令。

Microsoft 你提供一组可靠的脚本来执行和控制 SSMA 活动文件命令。 接下来的几节详细介绍相同。 控制台应用程序在本部分中使用作为枚举的某些标准脚本文件命令。

项目脚本文件命令

创建项目、 打开、 保存和退出项目项目命令句柄。

Command

创建新的项目

创建新的 SSMA 项目。

脚本

  • project-folder 指示获取创建的项目的文件夹。

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

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

  • project-type:可选属性。 指示项目类型即"sql server 2005"项目或"sql server 2008"项目或的"sql server 2012"项目或"sql server 2014"项目或"sql azure"。 默认值为"sql server 2014"。

示例:

<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>"   (optional)  
  
/>  

覆盖如果-共存的属性是false默认情况下。

项目类型属性是sql server 2008默认情况下。

Command

打开项目

打开现有的项目。

脚本

  • project-folder 指示获取创建的项目的文件夹。 如果指定的文件夹不存在,则命令将失败。 {string}

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

语法示例:

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

适用于 DB2 控制台应用程序的 SSMA 支持向后兼容性。 你将能够打开创建的以前版本的 SSMA 项目。

Command

保存项目

保存迁移项目。

脚本

语法示例:

<save-project/>  

Command

关闭项目

关闭迁移项目。

脚本

语法示例:

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

数据库连接脚本文件命令

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

Command

connect-source-database

  • 执行与源数据库的连接并加载的源数据库但不是所有元数据的高级别元数据。

  • 如果无法建立到源的连接,会生成错误并停止进一步执行控制台应用程序。

脚本

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

语法示例:

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

Command

force-load-source/target-database

  • 加载源元数据。

  • 用于处理脱机迁移项目。

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

脚本

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

语法示例:

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

或多个

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

Command

reconnect-source-database

  • 重新连接到源数据库,但不会加载与连接源数据库命令不同的任何元数据。

  • 如果无法建立 (重新) 与源的连接,会生成错误和控制台应用程序停止进一步执行。

脚本

语法示例:

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

Command

连接目标数据库

  • 连接到目标 SQL Server 数据库并完全加载目标数据库的高级别的元数据,但不是元数据。

  • 如果无法建立到目标连接,会生成错误和控制台应用程序停止进一步执行。

脚本

从服务器部分中的服务器连接文件或脚本文件的每个连接而定义的 name 属性检索服务器定义

语法示例:

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

Command

reconnect-target-database

  • 重新连接到目标数据库,但不会加载任何元数据,与连接目标数据库命令不同。

  • 如果无法建立 (重新) 连接到目标,生成错误和控制台应用程序停止进一步执行。

脚本

语法示例:

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

报表脚本文件命令

报表命令生成各种 SSMA 控制台活动的性能上的报表。

Command

generate-assessment-report

  • 生成对源数据库的评估报告。

  • 如果执行此命令之前不执行源数据库连接,则会生成错误和控制台应用程序退出。

  • 命令执行期间,连接到源数据库服务器失败也会终止的控制台应用程序。

脚本

  • conversion-report-folder: 指定评估报告可以在其中存储的文件夹。(可选属性)

  • object-name: 指定的生成评估报告 (可能包含单个对象名或组对象名称) 时要考虑的对象。

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

  • 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>"   (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  
  
   conversion-report-folder="<folder-name>"   (optional)  
  
   conversion-report-overwrite="<true/false>"   (optional)  
  
>  
  
      <metabase-object object-name="<object-name>"  
  
         object-type="<object-category>"/>  
  
</generate-assessment-report>  

迁移脚本文件命令

迁移命令将目标数据库架构转换为源架构和数据迁移到目标服务器。 设置的迁移命令的默认控制台输出是与不进行详细的错误报告 Full 输出报告: 源对象树中根节点处仅摘要。

Command

convert-schema

  • 执行架构转换从源到目标架构。

  • 如果执行此命令之前不执行源或目标数据库连接或连接到源或目标数据库服务器失败命令执行时,会生成错误和控制台应用程序退出。

脚本

  • conversion-report-folder: 指定评估报告可以在其中存储的文件夹。(可选属性)

  • object-name: 指定源对象视为用于转换的架构 (可能包含单个对象名或组对象名称)。

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

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

Command

迁移数据: 将源数据迁移到目标。

脚本

  • conversion-report-folder: 指定评估报告可以在其中存储的文件夹。(可选属性)

  • object-name: 指定被视为用于迁移的源对象 (可能包含单个对象名或组对象名称) 的数据。

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

  • conversion-report-overwrite: 指定是否覆盖评估报表文件夹已存在。

    默认值: false。 (可选属性)

  • 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>"/>  

迁移准备脚本文件命令

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

Command

映射架构

源数据库到目标架构的架构映射。

脚本

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

  • sql-server-schema 指定我们想要的位置要迁移的目标架构。

语法示例:

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

Command

映射架构

源数据库到目标架构的架构映射。

脚本

source-schema 指定我们想要迁移的源架构。

sql-server-schema 指定我们想要的位置要迁移的目标架构。

语法示例:

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

可管理性的脚本文件命令

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

设置的迁移命令的默认控制台输出是与不进行详细的错误报告 Full 输出报告: 源对象树中根节点处仅摘要。

Command

同步目标

  • 将目标对象与目标数据库同步。

  • 如果对源数据库执行此命令时,遇到错误。

  • 如果执行此命令之前不执行目标数据库连接或连接到目标数据库服务器失败命令执行时,会生成错误和控制台应用程序退出。

脚本

  • object-name: 指定目标对象被视为与目标数据库 (可能包含单个对象名或组对象名称) 进行同步。

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

  • on-error: 指定是否为警告或错误指定同步错误。 错误上的可用选项包括:

    • 作为警告报告总数

    • 报表的每个-作为-警告

    • 脚本失败

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

Command

从数据库刷新

  • 刷新数据库中的源对象。

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

脚本

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

  • object-name: 指定用于刷新 (可能包含单个对象名或组对象名称) 的源数据库中被视为源对象。

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

  • on-error: 指定是否为警告或错误指定刷新错误。 错误上的可用选项包括:

    • 作为警告报告总数

    • 报表的每个-作为-警告

    • 脚本失败

  • 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 的输出。

Command

save-as-script

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

脚本

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

  • object-name: 指定的脚本将保存的对象。 (它可以具有单独的对象名称或组对象名称)

  • object-type: 指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。

  • 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/folder>"  
  
   overwrite="<true/false>"   (optional)  
  
/>  

或多个

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

Command

convert-sql-statement

  • 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 指定要转换的 DB2 sql 语句可以使用分隔一个或多个语句";"

  • sql-files 指定的路径的 sql 文件具有要转换为 T-SQL 代码。

  • write-summary-report-to 指定将生成报表的路径。 如果只提到的文件夹路径,然后将文件按名称ConvertSQLReport.XML创建。 (可选属性)

    创建具有 viz 进一步子类别的 2 的报表..,:

    • 报告错误 (="true/false",为"false"(可选属性) 的默认值)。

    • 详细 (="true/false",默认值为"false"(可选属性))。

脚本

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

语法示例:

<convert-sql-statement  
  
   context="<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)  
  
   file-name="<file-name>"  
  
   sql="SELECT 1 FROM DUAL;">  
  
   <output-window suppress-messages="<true/false>" />  
  
</convert-sql-statement>  

或多个

<convert-sql-statement  
  
   context="<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>"  
  
   destination="<stdout/file>"   (optional)  
  
   write-converted-sql-to="<file-name/folder-name>"  
  
   sql-files="<folder-name>\*.sql" />  

或多个

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

下一步

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

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

下一步取决于你的项目要求:

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 Shamikg)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 01/19/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。