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-server-2016
-
sql-azure
默认值为"sql server 2008"。
-
示例:
<create-new-project
project-folder="<project-folder>"
project-name="<project-name>"
overwrite-if-exists="<true/false>"
project-type=”<sql-server-2008 | sql-server-2005 | sql-server-2012 | sql-server-2014 | sql-azure>”
/>
覆盖如果-共存的属性是false默认情况下。
项目类型属性是sql server 2008默认情况下。
Command
打开项目: 打开现有项目。
脚本
-
project-folder指示获取创建的项目的文件夹。 如果指定的文件夹不存在,则命令将失败。 {string} -
project-name指示项目的名称。 如果指定的项目不存在,则命令将失败。 {string}
语法示例:
<open-project
project-folder="<project-folder>"
project-name="<project-name>"
/>
注意: SSMA 为访问控制台应用程序支持向后兼容性。 你将能够打开创建的以前版本的 SSMA 项目。
Command
保存项目: 将保存迁移项目。
脚本
语法示例:
<save-project/>
Command
关闭项目: 关闭迁移项目。
脚本
语法示例:
<close-project
if-modified="<save/error/ignore>" (optional)
/>
如果修改的属性是可选的忽略默认情况下。
数据库连接脚本文件命令
数据库连接命令可帮助连接到数据库。
浏览在控制台中不支持 UI 的功能。
Windows 身份验证并端口连接到 SQL Azure 时,参数不适用。
创建脚本文件的详细信息,请参阅创建脚本文件(AccessToSQL)。
Command
connect-source-database
-
执行与源数据库的连接并加载的源数据库但不是所有元数据的高级别元数据。
-
如果无法建立到源的连接,会生成错误并停止进一步执行控制台应用程序。
脚本
从服务器部分中的服务器连接文件或脚本文件的每个连接而定义的 name 属性中检索服务器定义。
语法示例:
<connect-source-database server="<server-unique-name>"/>
Command
负载 access 数据库: 用于加载访问数据库文件
脚本
语法示例:
<load-access-database database-file="<Access-database>"/>
或多个
<load-access-database>
<access-database database-file="<Access-database1>"/>
<access-database database-file="<Access-database2>"/>
</load-access-database>
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 或 SQL Azure 数据库并完全加载目标数据库的高级别的元数据,但不是元数据。
-
如果无法建立到目标连接,会生成错误和控制台应用程序停止进一步执行。
脚本
从服务器部分中的服务器连接文件或脚本文件的每个连接而定义的 name 属性检索服务器定义
语法示例:
<connect-target-database server="<server-unique-name>"/>
Command
reconnect-target-database
-
重新连接到目标数据库,但不会加载任何元数据,与连接目标数据库命令不同。
-
如果无法建立 (重新) 连接到目标,生成错误和控制台应用程序停止进一步执行。
脚本
语法示例:
<reconnect-target-database server="<server-unique-name>"/>
报表脚本文件命令
报表命令生成各种 SSMA 控制台活动的性能上的报表。
Command
generate-assessment-report
-
生成对源数据库的评估报告。
-
如果执行此命令之前不执行源数据库连接,则会生成错误和控制台应用程序退出。
-
命令执行期间,连接到源数据库服务器失败也会终止的控制台应用程序。
脚本
-
assessment-report-folder:指定评估报告可以在其中存储的文件夹。(可选属性) -
object-name:指定的生成评估报告 (可能包含单个对象名或组对象名称) 时要考虑的对象。 -
object-type:指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。 -
assessment-report-overwrite:指定是否覆盖评估报表文件夹已存在。默认值: false。 (可选属性)
-
write-summary-report-to:指定将生成报表的路径。如果只提到的文件夹路径,然后将文件按名称AssessmentReport<n>。XML创建。 (可选属性)
报表创建具有两个其他子类别:
-
report-errors(="true/false",默认值为"false"(可选属性)) -
verbose(="true/false",默认值为"false"(可选属性))
-
语法示例:
<generate-assessment-report
object-name="ssma.Procedures"
object-type="category"
write-summary-report-to="<file>" (optional)
verbose="<true/false>" (optional)
report-errors="<true/false>" (optional)
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
/>
或多个
<generate-assessment-report
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
>
<metabase-object object-name="ssma.Procedures"
object-type="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="ssma.Procedures"
object-type="category"
write-summary-report-to="<filepath/folder>" (optional)
verbose="<true/false>" (optional)
report-errors="<true/false>" (optional)
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
/>
或多个
<convert-schema
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
<metabase-object object-name="ssma.Procedures"
object-type="category"/>
</convert-schema>
Command
迁移数据
- 将源数据迁移到目标。
脚本
-
object-name:指定被视为用于迁移的源对象 (可能包含单个对象名或组对象名称) 的数据。 -
object-type:指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。 -
write-summary-report-to:指定将生成报表的路径。如果只提到的文件夹路径,然后将文件按名称DataMigrationReport<n>。XML创建。 (可选属性)
报表创建具有两个其他子类别:
-
report-errors(="true/false",默认值为"false"(可选属性)) -
verbose(="true/false",默认值为"false"(可选属性))
-
语法示例:
<migrate-data
write-summary-report-to="<filepath/folder>"
report-errors="true" verbose="true">
<metabase-object object-name="ssma.TT1"/>
<metabase-object object-name="ssma.TT2"/>
<metabase-object object-name="ssma.TT3"/>
<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="ssma.Tables"
object-type="category"
write-summary-report-to="<filepath/folder>"
report-errors="true" verbose="true"/>
Command
链接表: 此命令将源 (访问) 表链接到目标表。
脚本
语法示例:
<link-tables>
<metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
<metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</link-tables>
或多个
<link-tables>
<metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</link-tables>
Command
取消链接表: 此命令将取消链接的目标表中的源表 (访问)。
脚本
语法示例:
<unlink-tables>
<metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
<metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</unlink-tables>
或多个
<unlink-tables>
<metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</unlink-tables>
迁移准备脚本文件命令
迁移准备命令开始架构源和目标数据库之间的映射。
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="ots_triggers.dbo"
on-error="<report-total-as-warning|
report-each-as-warning|
fail-script>" (optional)
report-errors-to="<file-name>" (optional)
/>
或多个
<synchronize-target
object-name="ssma.dbo.Procedures"
object-type="category"/>
或多个
<synchronize-target>
<metabase-object object-name="ssma.dbo.TT1"/>
<metabase-object object-name="ssma.dbo.TT2"/>
<metabase-object object-name="ssma.dbo.TT3"/>
</synchronize-target>
Command
从数据库刷新
-
刷新数据库中的源对象。
-
如果对目标数据库执行此命令,则会生成错误。
脚本
作为命令行参数需要一个或多个元数据库节点。
-
object-name:指定用于刷新 (可能包含单个对象名或组对象名称) 的源数据库中被视为源对象。 -
object-type:指定的类型 (如果指定了对象类别,则对象类型将为"类别") 的对象名称属性中指定的对象。 -
on-error:指定是否为警告或错误指定刷新错误。 错误上的可用选项包括:-
作为警告报告总数
-
报表的每个-作为-警告
-
脚本失败
-
-
report-errors-to:刷新操作 (以属性为可选) 如果仅指定文件夹路径,然后将文件按名称指定的错误报告位置SourceDBRefreshReport.XML创建。
语法示例:
<refresh-from-database
object-name="ssma.TT1"
on-error="<report-total-as-warning|
report-each-as-warning|
fail-script>" (optional)
report-errors-to="<file-name>" (optional)
/>
或多个
<refresh-from-database
object-name="ssma.Procedures"
object-type="category"/>
或多个
<refresh-from-database>
<metabase-object object-name="ssma.TT_1"/>
</refresh-from-database>
脚本生成的脚本文件命令
脚本生成命令可帮助在脚本文件中保存的控制台输出。
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="ssma.dbo.Procedures"
object-type="category"
destination="<file/folder>"
overwrite="<true/false>" (optional)
/>
或多个
<save-as-script
metabase="<source/target>"
destination="<file/folder>"
<metabase-object object-name="ssma.dbo.Procedures"
object-type="category"/>
</save-as-script>
下一步
有关命令行选项的信息,请参阅SSMA 控制台中的命令行选项(AccessToSQL) 。
有关示例控制台脚本文件的信息,请参阅使用示例控制台脚本文件执行 SSMA 控制台(AccessToSQL)
下一步取决于你的项目要求:
-
用于指定密码或导出 / 导入密码,请参阅管理密码(AccessToSQL)。
-
用于生成报告,请参阅生成报表(AccessToSQL)。
-
有关故障排除控制台中的问题,请参阅故障排除(AccessToSQL)。
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 Shamikg)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
