导入消息 (数据管理)

摘要

将增量文件中的变更导入复本地理数据库或将确认消息导入复本地理数据库。

使用情况

• 在断开连接的情况下同步复本时使用此工具。 首先运行导出数据变更消息工具，该工具会创建一个包含要同步的变更的增量文件。 然后使用导入消息工具将增量文件复制并导入到相关复本。 如果增量文件丢失并且需要重新发送，请使用重新导出未确认消息工具重新生成增量文件。 导入变更后，您可以使用导出确认消息工具从相关复本导出确认文件。 使用导入消息工具复制并导入确认文件。 如果没有收到确认，下次发送变更时，其中将包括新变更和之前发送的变更。

• 该地理数据库可以是本地地理数据库，也可以是地理数据服务。

• 此工具接受确认消息或数据变更消息。 确认文件为 .xml 文件。 数据变更消息可以为增量文件地理数据库 (.gdb) 或增量 .xml 文件。

• 导入数据变更消息后，可以立即导出确认消息。 输出确认文件必须为 .xml 文件。

• 要在连接模式下同步复本，请参阅同步变更工具。

参数

对话框

标注	说明	数据类型
导入到复本地理数据库	将接收导入消息的复本地理数据库。 地理数据库可以是本地地理数据库也可以是远程地理数据库。	Workspace; GeoDataServer
从增量文件导入	将从中导入消息的文件。	Workspace ; File
输出确认文件 (可选)	将包含确认消息的文件。 导入数据变更时，还可以导出消息以确认数据变更消息的导入。 仅数据变更消息支持此参数。	File
冲突解决策略 (可选)	指定在导入数据变更消息时遇到冲突的情况下将如何解决冲突。 手动解决冲突—必须在版本协调环境中手动解决冲突。 数据库优先—冲突将自动解决，以便于数据库接收变更。 导入变更优先—冲突将自动解决，以便于导入变更。	String
冲突定义 (可选)	指定是按对象（行）还是按属性（列）检测发生冲突所需的条件。 按对象—将按行检测冲突。 按属性—将按列检测冲突。	String
使用父版本进行协调（检出复本） (可选)	指定在不存在冲突的情况下，是否在将数据变更发送到父复本后自动协调。 此参数仅对检出/检入复本有效。 未选中 - 变更将不会与父版本协调。 这是默认设置。 选中 - 变更将与父版本协调。	Boolean

派生输出

标注	说明	数据类型
输出复本地理数据库	更新的复本地理数据库。	Workspace; GeoDataServer

Python

arcpy.management.ImportMessage(in_geodatabase, source_delta_file, {output_acknowledgement_file}, {conflict_policy}, {conflict_definition}, {reconcile_with_parent_version})

名称	说明	数据类型
in_geodatabase	将接收导入消息的复本地理数据库。 地理数据库可以是本地地理数据库也可以是远程地理数据库。	Workspace; GeoDataServer
source_delta_file	将从中导入消息的文件。	Workspace ; File
output_acknowledgement_file (可选)	将包含确认消息的文件。 导入数据变更时，还可以导出消息以确认数据变更消息的导入。 仅数据变更消息支持此参数。	File
conflict_policy (可选)	指定在导入数据变更消息时遇到冲突的情况下将如何解决冲突。 MANUAL—必须在版本协调环境中手动解决冲突。 IN_FAVOR_OF_DATABASE—冲突将自动解决，以便于数据库接收变更。 IN_FAVOR_OF_IMPORTED_CHANGES—冲突将自动解决，以便于导入变更。	String
conflict_definition (可选)	指定是按对象（行）还是按属性（列）检测发生冲突所需的条件。 BY_OBJECT—将按行检测冲突。 BY_ATTRIBUTE—将按列检测冲突。	String
reconcile_with_parent_version (可选)	指定在不存在冲突的情况下，是否在将数据变更发送到父复本后自动协调。 此参数仅对检出/检入复本启用。 DO_NOT_RECONCILE—变更将不会与父版本协调。 这是默认设置。 RECONCILE—变更将与父版本协调。	Boolean

派生输出

名称	说明	数据类型
out_geodatabase	更新的复本地理数据库。	Workspace; GeoDataServer

代码示例

ImportMessage 示例（Python 窗口）

以下示例演示了如何在 Python 窗口中使用 ImportMessage 函数。

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.ImportMessage_management("MySDEdata.sde", "DataChanges.gdb", 
                               "acknowledgement.xml", 
                               "IN_FAVOR_OF_IMPORTED_CHANGES", "BY_OBJECT")

ImportMessage 示例 2（独立脚本）

以下演示了如何使用 ImportMessage 函数在独立 Python 脚本中导入数据变更文件。

# Name: ImportMessage_Example2.py
# Description: Import a data change message (from a delta gdb) into a replica workspace.   

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "DataChanges.gdb" # data changes file (delta gdb)
output_acknowledgement = "acknowledgement.xml" # optional
conflict_policy = "IN_FAVOR_OF_IMPORTED_CHANGES"
conflict_detection = "BY_OBJECT"
reconcile = "" # Only applicable for checkout replicas

# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, in_message, 
                               output_acknowledgement, conflict_policy, 
                               conflict_detection, reconcile)

ImportMessage 示例 3（独立脚本）

以下演示了如何使用 ImportMessage 函数在独立 Python 脚本中导入数据变更文件。

# Name: ImportMessage_Example3.py
# Description: Import an acknowledgement message into a replica workspace.  

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
replica_workspace = "MySDEdata.sde"
in_message = "acknowledgement.xml" # Acknowledgement file 
output_acknowledgement = "" 	# not applicable when importing an acknowledgement file
conflict_policy = ""        	# not applicable when importing an acknowledgement file 
conflict_detection = ""     	# not applicable when importing an acknowledgement file
reconcile = ""              	# not applicable when importing an acknowledgement file

# Execute Import Message
arcpy.ImportMessage_management(replica_workspace, dc_Message, 
                               output_acknowledgement, conflict_policy, 
                               conflict_detection, reconcile)

环境

当前工作空间, 临时工作空间

特殊情况

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是