Resumen
Crea una réplica a una geodatabase a partir de una lista especificada de clases de entidad, capas, datasets y tablas de una geodatabase corporativa.
Uso
Todos los datasets deben provenir de la misma geodatabase corporativa.
Los datos que se replicarán deben estar registrados con versionado tradicional, pero no con la opción de mover las ediciones a la base.
El usuario de la base de datos que esté conectado también debe tener permisos de escritura para los datos.
Para las réplicas bidireccionales y ambos tipos de réplicas unidireccionales, todos los datasets deben tener una columna GlobalID.
Para las réplicas de check-out y unidireccionales, la geodatabase de réplica secundaria puede ser una geodatabase de archivos o corporativa.
Para las réplicas secundarias a principales bidireccionales y unidireccionales, la geodatabase secundaria debe ser corporativa.
Para utilizar el archivado de las réplicas unidireccionales, el espacio de trabajo principal debe estar conectado a la versión predeterminada. Para las réplicas secundarias a principales unidireccionales, el espacio de trabajo secundario debe estar conectado a la versión predeterminada.
Puede replicar todos los datos de los datasets o replicar subconjuntos de los datos. Existen tres formas de especificar los subconjuntos de datos a replicar:
- Utilizar consultas de definición en los datos.
- Especificar una extensión con la configuración del entorno Extensión de geoprocesamiento.
- Utilizar el parámetro Entidades de geometría.
En el caso de las tablas, el filtro predeterminado es Solo esquema; solo se replica el esquema de la tabla. Para aplicar un filtro a una tabla, cree primero una vista de tabla con los filtros deseados. A continuación, utilícela como entrada de la herramienta Crear réplica. Consulte Crear vista de tabla para obtener más información. Para obtener más información acerca de los filtros y la replicación, consulte Preparar datos para la replicación.
El parámetro Entidades de geometría de réplica se puede utilizar para definir la geometría de la réplica. También puede utilizar la configuración del entorno de Extensión para definir la geometría de la réplica.
- Si se establece el parámetro Entidades de geometría de réplica, se utilizará como la geometría de réplica.
Las entidades de geometría de réplica pueden ser puntos, líneas o polígonos.
Una capa de entidades utilizada para las entidades de geometría de réplica puede contener una o más entidades. Si hay más de una, se fusionan las geometrías y sólo se replican los datos que intersecan las geometrías fusionadas.
Si se definieron filtros (como de selección o de consulta de definición) en las entidades de geometría de réplica, para definir la geometría de réplica solo se utilizarán las entidades que cumplan con estos filtros. Consulte Preparar datos para la replicación para obtener más información.
Las opciones del parámetro Re-uso Esquema sólo están disponibles para las réplicas de check-out
Sintaxis
arcpy.management.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}, {register_existing_data})
Parámetro | Explicación | Tipo de datos |
in_data [in_data,...] | Los datos que se replicarán. Esta lista consta de capas y tablas que hacen referencia a datos editables y versionados de una geodatabase corporativa. | Table View; Dataset |
in_type | Especifica el tipo de réplica que se desea crear.
| String |
out_geodatabase | La geodatabase local que alojará la réplica secundaria. Los servicios de geodatos se utilizan para representar geodatabases remotas. La geodatabase puede ser corporativa o de archivos. En el caso de las réplicas bidireccionales, la geodatabase secundaria debe ser una geodatabase corporativa. En el caso de las réplicas unidireccionales y de check-out, la geodatabase puede ser de archivos o corporativa. Las geodatabases de archivos deben existir antes de ejecutar esta herramienta. | Workspace; GeoDataServer |
out_name | El nombre que identifica la réplica. | String |
access_type (Opcional) | Especifica el tipo de acceso de réplica.
| String |
initial_data_sender (Opcional) | Especifica qué réplica puede enviar cambios en modo desconectado. Si está trabajando en un modo conectado, este parámetro no es consecuente. Esto asegura que la réplica relativa no envíe actualizaciones hasta que los cambios se reciban primeramente del emisor de datos inicial.
| String |
expand_feature_classes_and_tables (Opcional) | Especifica si se agregarán las tablas y clases de entidad expandidas (por ejemplo, aquellas de redes, topologías o clases de relación).
| String |
reuse_schema (Opcional) | Especifica si se reutilizará una geodatabase que contenga el esquema de los datos que se van a replicar. Esto reduce la cantidad de tiempo necesario para replicar los datos. Esta opción solo está disponible para las réplicas de check-out.
| String |
get_related_data (Opcional) | Especifica si se replicarán las filas relacionadas con filas ya presentes en la réplica. Por ejemplo, considere una entidad (f1) dentro del filtro de réplica y una entidad relacionada (f2) de otra clase fuera del filtro. La entidad f2 se incluye en la réplica si elige obtener datos relacionados.
| String |
geometry_features (Opcional) | Las entidades utilizadas para definir el área que se replicará. | Feature Layer |
archiving (Opcional) | Especifica si la clase de archivo se utilizará para rastrear cambios en lugar de las tablas delta versionadas. Esto solo está disponible para réplicas unidireccionales.
| Boolean |
register_existing_data (Opcional) | Especifica si los datos que ya existen en la geodatabase secundaria se utilizarán para definir los datasets de réplica. Los datasets de la geodatabase secundaria deben tener los mismos nombres que los datasets de la geodatabase principal.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_child_geodatabase | La geodatabase secundaria de salida. | Espacio de trabajo |
output_replica_name | El nombre de la réplica de salida. | Cadena |
Muestra de código
En la siguiente secuencia de comandos de ventana de Python se muestra cómo utilizar la función CreateReplica en la ventana de Python.
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")
En la siguiente secuencia de comandos de Python se muestra cómo utilizar la función CreateReplica en una secuencia de comandos independiente de Python.
# 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)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí