创建复本

摘要

由企业级地理数据库中指定列表中的要素类、图层、数据集和/或表创建地理数据库的复本。

用法

• 所有数据集必须来自同一企业级地理数据库。

• 您希望复制的数据必须进行版本化，但是无法通过“将编辑内容移动到基表”选项进行版本化。连接的数据库用户也必须具有对该数据的写入权限。对于双向复本和单向复本(两种类型)，所有数据集都必须具有 globalid 列并且具有高精度的空间参考。

• 对于检出复本和单向复本，子复本地理数据库可以是企业级、文件或个人地理数据库。

• 对于双向复本和单向“子-父”复本，子地理数据库必须是企业级地理数据库。

• 要对单向复本使用归档，父工作空间必须连接至“默认”版本。对于单向“子-父”复本，子工作空间必须连接至“默认”版本。

• 在 ArcMap 中，针对图层或表中设置的定义查询和选择属性用于确定复制哪些数据。

• 对于表，默认过滤器是“仅方案”，即只复制表的方案。要对表应用过滤器，必须首先创建一个表视图，用于设置所需过滤器。然后，您便可将其作为创建复本工具的输入使用。有关详细信息，请参阅创建表视图。要获取关于过滤器和复制的更多信息，请参阅准备要复制的数据。

• 复本几何要素可用来定义复本的几何。还可以使用范围环境设置定义复本几何。

  • 如果仅设置了复本几何要素，则仅复制与复本几何要素相交的数据。
  • 如果仅设置了范围环境设置，则仅复制与范围相交的数据。
  • 如果同时设置了复本几何要素和范围环境，则将使用复本几何要素。
  • 如果复本几何要素或范围环境均未指定，则使用数据的全部范围。

• 复本几何要素可以是点、线或面。

• 用于复本几何要素的要素图层可以包含一个或多个要素。如果有多个要素，则将合并几何，并仅复制与合并的几何相交的数据。

• 如果已对复本几何要素定义了过滤器（例如空间、选择内容或定义查询），则将仅使用符合这些过滤器的要素定义复本几何。有关详细信息，请参阅准备要复制的数据。

• 重用方案参数选项仅适用于检出复本。

语法

CreateReplica_management (in_data, in_type, out_geodatabase, out_name, {access_type}, {initial_data_sender}, {expand_feature_classes_and_tables}, {reuse_schema}, {get_related_data}, {geometry_features}, archiving)

参数	说明	数据类型
in_data [in_data,...]	要复制的数据。此列表中所包含的图层和表引用了来自企业级地理数据库中版本化的可编辑数据。	Layer; Table View; Dataset
in_type	要创建复本的类型。 TWO_WAY_REPLICA — 变更可以在子复本和父复本之间进行双向发送。 ONE_WAY_REPLICA —变更只能从父复本发送到子复本。 CHECK_OUT —一次复制、编辑并检回数据。 ONE_WAY_CHILD_TO_PARENT_REPLICA —变更只能从子复本发送到父复本。	String
out_geodatabase	将存储子复本的本地地理数据库或地理数据服务。地理数据服务用于表示远程地理数据库。地理数据库可以是企业级、文件或个人地理数据库。对于双向复本，子地理数据库必须是企业级地理数据库。对于单向复本和检出复本，地理数据库可以是个人、文件或者企业级地理数据库。运行此工具前，必须已存在个人或文件地理数据库。	Workspace ; GeoDataServer
out_name	用于识别复本的名称。	String
access_type (可选)	所需访问类型： FULL —支持复杂类型（拓扑和几何网络）并要求对数据进行版本化。 SIMPLE —子复本上的数据不可版本化且必须为简单形式。将允许复本互相操作。在复制期间，父地理数据库中的非简单要素（例如，几何网络和拓扑中的要素）转换为简单要素（例如点、线和面要素类）。	String
initial_data_sender (可选)	供复制时使用，以确定在断开模式下哪个复本可发送更改信息。如果在连接模式下工作，此参数无关紧要。这样可确保首先从初始数据发送方接收到变更后，关系复本才发送更新。 CHILD_DATA_SENDER PARENT_DATA_SENDER	String
expand_feature_classes_and_tables (可选)	指定是否要包含扩展要素类和表，例如：几何网络、拓扑或关系类中的扩展要素类和表。 USE_DEFAULTS —添加与复本中的要素类和表相关的扩展要素类和表。要素类的默认设置是复制所有要素；而表的默认设置是仅复制方案。如果定义了空间过滤器，则会将其应用于要素类。 ADD_WITH_SCHEMA_ONLY —只为扩展要素类和表添加方案。 ALL_ROWS —为扩展要素类和表添加所有行。 DO_NOT_ADD —不添加扩展要素类和表。	String
reuse_schema (可选)	指示是否重新使用包含要复制数据的方案的地理数据库。这可以减少复制数据所需的时间。此选项仅适用于检出复本。 DO_NOT_REUSE —不重新使用方案。这是默认设置。 REUSE —重新使用方案。	String
get_related_data (可选)	指定是否复制与复本中现有行相关的行。例如，假设复本过滤器内部存在一个要素 (f1)，且该过滤器外部存在一个来自其他类的相关要素 (f2)。如果您选择获取相关数据，则要素 f2 会包含到复本中。 DO_NOT_GET_RELATED —不复制相关行。 GET_RELATED —复制相关数据。这是默认设置。	String
geometry_features (可选)	用于定义要复制区域的要素。	Feature Layer
archiving	指定是否使用归档类追踪变更，而不是使用版本化增量表。这仅适用于单向复本。 ARCHIVING —使用归档追踪变更。 DO_NOT_USE_ARCHIVING —不使用归档追踪变更。这是默认设置。	Boolean

代码示例

CreateReplica 示例 1（Python 窗口）

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

import arcpy
from arcpy import env
env.workspace = "C:/Data/MySDEdata.sde"
arcpy.CreateReplica_management("roads", "ONE_WAY_REPLICA", "C:\Data\MyTargetGDB.gdb", "MyReplica", "FULL", \
"PARENT_DATA_SENDER", "USE_DEFAULTS", "DO_NOT_REUSE", "TRUE")

CreateReplica 示例 2（独立 Python 脚本）

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

# Name: CreateReplica_Example2.py
# Description: Create a one-way replica of a Feature Dataset to a file geodatabase. 
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/MySDEdata.sde"
# Set local variables
in_data = "Parks" # a feature dataset
replica_type = "ONE_WAY_REPLICA"
output_workspace = "C:\Data\MyTargetGDB.gdb"
replica_name = "MyReplica"
access_type = "FULL"
initial_sender = "PARENT_DATA_SENDER"
expand = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related = "GET_RELATED"
replica_geometry = "LA_County"
archiving = "DO_NOT_USE_ARCHIVING"
# Execute CreateReplica
arcpy.CreateReplica_management(in_data, replica_type, output_workspace, replica_name, access_type, \
initial_sender, expand, reuse_schema, get_related, replica_geometry, archiving)

环境

• 当前工作空间
• 输出配置关键字
• 范围
• 临时工作空间

许可信息

• ArcGIS Desktop Basic: 否
• ArcGIS Desktop Standard: 是
• ArcGIS Desktop Advanced: 是