描述
由企业级地理数据库中指定列表中的要素类、图层、数据集和表创建地理数据库的复本。
使用方法
所有数据集必须来自同一企业级地理数据库。
要复制的数据必须注册为传统版本化,但是无法通过“将编辑内容移动到基表”选项进行版本化。
此外,连接的数据库用户必须具有对数据的写入权限。
对于双向复本和单向复本(两种类型),所有数据集都必须具有 GlobalID 列。
对于检出复本和单向复本,子复本地理数据库可以是企业级或文件地理数据库。
对于双向复本和单向“子-父”复本,子地理数据库必须是企业级地理数据库。
要对单向复本使用归档,父工作空间必须连接至默认版本。对于单向“子-父”复本,子工作空间必须与默认版本连接。
您可以复制数据集中的所有数据或复制数据的子集。有三种方法可以指定要复制的数据子集:
- 对数据使用定义查询。
- 使用地理处理范围环境设置指定范围。
- 使用几何要素参数。
对于表,默认过滤器是“仅方案”,即只复制表的方案。要对表应用过滤器,首先请使用所需过滤器创建一个表视图。然后,请将其作为创建复本工具的输入使用。有关详细信息,请参阅创建表视图。要获取关于过滤器和复制的详细信息,请参阅准备要复制的数据。
复本几何要素可用来定义复本的几何。还可以使用范围环境设置定义复本几何。
- 如果已设置复本几何要素,则系统会将其用作复本几何。
复本几何要素可以是点、线或面。
用于复本几何要素的要素图层可以包含一个或多个要素。如果有多个要素,则将合并几何,并仅复制与合并的几何相交的数据。
- 如果已对复本几何要素定义了过滤器(例如选择内容或定义查询),则将仅使用符合这些过滤器的要素定义复本几何。有关详细信息,请参阅准备要复制的数据。
重用方案参数选项仅适用于检出复本。
语法
CreateReplica(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 | 指定要创建的复本类型。
| String |
out_geodatabase |
将托管子复本的本地地理数据库。地理数据服务用于表示远程地理数据库。地理数据库可以是企业级或文件地理数据库。对于双向复本,子地理数据库必须是企业级地理数据库。对于单向复本和检出复本,地理数据库可以是文件或者企业级地理数据库。运行此工具前,必须已存在文件地理数据库。 | Workspace; GeoDataServer |
out_name | 用于识别复本的名称。 | String |
access_type (可选) | 指定要创建的复本访问类型。
| String |
initial_data_sender (可选) | 指定在断开连接模式下哪个复本可发送更改信息。如果在连接模式下工作,此参数无关紧要。这样可确保首先从初始数据发送方接收到变更后,关系复本才发送更新。
| String |
expand_feature_classes_and_tables (可选) |
指定是否将添加扩展要素类和表(例如网络、拓扑或关系类中的要素类和表)。
| String |
reuse_schema (可选) | 指定是否将重用包含要复制数据的方案的地理数据库。这可以减少复制数据所需的时间。此选项仅适用于检出复本。
| String |
get_related_data (可选) | 指定是否将复制与复本中现有行相关的行。例如,假设复本过滤器内部存在一个要素 (f1),且该过滤器外部存在一个来自其他类的相关要素 (f2)。如果您选择获取相关数据,则要素 f2 会包含到复本中。
| String |
geometry_features (可选) | 用于定义要复制区域的要素。 | Feature Layer |
archiving | 指定是否使用存档类来追踪变更而非对增量表进行版本化。这仅适用于单向复本。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
out_child_geodatabase | 输出子地理数据库。 | 工作空间 |
output_replica_name | 输出复本的名称。 | 字符串 |
代码示例
以下 Python 窗口脚本演示了如何在 Python 窗口中使用 CreateReplica 函数。
import arcpy
arcpy.env.workspace = "C:/Data/MyData.sde"
arcpy.CreateReplica_management("roads", "ONE_WAY_REPLICA",
"C:\Data\MyTargetGDB.gdb", "MyReplica", "FULL",
"PARENT_DATA_SENDER", "USE_DEFAULTS",
"DO_NOT_REUSE", "TRUE")
以下 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
# Set workspace
arcpy.env.workspace = "C:/Data/MyData.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)
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是