导出数据变更消息 (Data Management)

摘要

创建包含来自输入复本的更新的输出增量文件。

用法

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

• 输出增量文件可以是增量文件地理数据库 (.gdb)、增量个人地理数据库 (.mdb) 或增量 XML 文件 (.xml)。指定输出增量文件时，必须包括适当的后缀（.gdb、.mdb 或 .xml）。

• 断开连接后对复本执行同步时使用此工具。要实现此操作，可先运行导出数据变更消息工具创建一个包含变更的增量文件以便进行同步。随后，将增量文件复制到相关复本中并使用导入消息工具导入。如果由于增量文件丢失而希望重新发送，则可使用重新导出未确认的消息工具重新生成增量文件。导入变更后，相关复本可通过导出确认消息工具导出一个确认文件。该确认文件将复制到复本中并使用导入消息工具导入。如果未收到确认消息，则下次发送变更时将包含新增变更和先前发送过的变更。

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

语法

ExportDataChangeMessage_management (in_geodatabase, out_data_changes_file, in_replica, switch_to_receiver, include_unacknowledged_changes, include_new_changes)

参数	说明	数据类型
in_geodatabase	指定要导出数据变更消息的复本地理数据库。地理数据库可以是本地地理数据库也可以是远程地理数据库。	Workspace ;GeoDataServer
out_data_changes_file	指定要导出到的增量文件。	File
in_replica	包含要导出的更新的复本。	String
switch_to_receiver	指示是否将复本的角色切换为接收方。直到相关复本发送方的更新到达后，接收方才能发送复本更新。 DO_NOT_SWITCH —不切换复本角色。这是默认设置。 SWITCH —将复本角色从发送方切换为接收方。	Boolean
include_unacknowledged_changes	指示是否包括先前导出的但尚未收到确认消息的数据变更。 NO_UNACKNOWLEDGED —不包括先前发送过的数据变更。 UNACKNOWLEDGED —包括先前导出的但尚未收到确认消息的所有数据变更。这是默认设置。	Boolean
include_new_changes	指示是否包括自上次导出数据变更消息之后创建的所有数据变更。 NO_NEW_CHANGES —不包括自上次导出数据变更消息之后创建的数据变更。 NEW_CHANGES —包括自上次导出数据变更消息之后创建的数据变更。这是默认设置。	Boolean

代码实例

ExportDataChangeMessage 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在 Python 窗口中使用 ExportDataChangeMessage 函数。

import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.ExportDataChangeMessage_management("MySDEdata.sde", "Changes.gdb", "MyReplica1", "SWITCH", "TRUE", "TRUE")

ExportDataChangeMessage 示例 2（独立 Python 脚本）

以下 Python 脚本演示了如何在独立脚本中使用 ExportDataChangeMessage 函数。

# Name: ExportDataChangesMessage_Example2.py
# Description: Exports a data change message to a delta file geodatabase (.gdb)


# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
in_geodatabase = "MySDEdata.sde"
out_dataChanges = "Changes.gdb"
replica_name = "MyReplica1"
switch_directions = "SWITCH"
acknowledge = "TRUE"
new_changes = "TRUE"

# Execute ExportDataChangeMessage
arcpy.ExportDataChangeMessage_management(in_geodatabase, out_dataChanges, replica_name, switch_directions, acknowledge, new_changes)

环境

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

许可信息

ArcGIS for Desktop Basic:否

ArcGIS for Desktop Standard:是

ArcGIS for Desktop Advanced:是