导出数据变更消息 (数据管理)

摘要

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

使用情况

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

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

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

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

参数

对话框

标注	说明	数据类型
从复本地理数据库导出	将从中导出数据变更消息的复本地理数据库。 地理数据库可以是本地地理数据库也可以是远程地理数据库。	Workspace;GeoDataServer
输出数据变更文件	输出增量文件。	File
复本	包含要导出的更新的复本。	String
导出消息后切换为接收方	指定复本角色是否将从发送者更改为接收者。 在来自相关复本发送者的更新到达之前，接收者可能不会发送复本更新。 未选中 - 复本角色不会更改。 这是默认设置。 选中 - 复本角色将从发送者更改为接收者。	Boolean
包括未确认的数据变更	指定是否包括之前导出的未收到确认消息的数据变更。 未选中 - 先前发送的数据变更将不包括在内。 选中 - 将包括之前导出的未收到确认消息的数据变更。 这是默认设置。	Boolean
包括自上次导出以来的新数据变更	指定是否包含最后一次导出数据变更消息后所做的所有数据变更。 未选中 - 不包含最后一次导出数据变更消息后所做的数据变更。 选中 - 包含最后一次导出数据变更消息后所做的所有数据变更。 这是默认设置。 指定是否包含最后一次导出数据变更消息后所做的所有数据变更。 NO_NEW_CHANGES—不包含最后一次导出数据变更消息后所做的数据变更。 NEW_CHANGES—包含最后一次导出数据变更消息后所做的所有数据变更。 这是默认设置。	Boolean

Python

arcpy.management.ExportDataChangeMessage(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
arcpy.env.workspace = "C:/Data"
arcpy.ExportDataChangeMessage_management("MySDEdata.sde", "Changes.gdb", 
                                         "MyReplica1", "SWITCH", "TRUE", "TRUE")

ExportDataChangeMessage 示例 2（独立脚本）

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

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

# Import system modules
import arcpy

# Set workspace
arcpy.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)

环境

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