Crear réplica (Administración de datos)

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.
    • Si no se establece el parámetro Entidades de geometría de réplica, se utilizará el entorno Extensión como la geometría de réplica.
    • Si no se especifica el parámetro Entidades de geometría de réplica ni el entorno Extensión, se utilizará la extensión completa de los datos.

  • 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ámetroExplicaciónTipo 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.

  • TWO_WAY_REPLICA Los cambios se pueden enviar entre las réplicas secundaria y principal, en ambas direcciones.
  • ONE_WAY_REPLICALos cambios se pueden enviar solamente de la réplica principal a la réplica secundaria.
  • CHECK_OUTLos datos se replican, se editan y se vuelven a verificar en una sola vez.
  • ONE_WAY_CHILD_TO_PARENT_REPLICALos cambios se pueden enviar solamente de la réplica secundaria a la réplica principal.
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.

  • FULLSe admiten los tipos complejos (topologías y redes) y los datos deben estar versionados. Esta es la opción predeterminada.
  • SIMPLELos datos en la secundaria no son versionados y deben ser simples. Esto permite que la réplica sea interoperable. Las entidades que no son simples en el elemento primario (por ejemplo, entidades de redes y topologías) se convierten en entidades simples (por ejemplo, clases de entidad poligonales, de puntos y de líneas).
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.

  • CHILD_DATA_SENDERLa réplica secundaria es la remitente inicial de los datos. Esta es la opción predeterminada.
  • PARENT_DATA_SENDERLa réplica principal es la remitente inicial de los datos.
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).

  • USE_DEFAULTSSe agregarán las tablas y clases de entidad expandidas relacionadas con tablas y clases de entidad de la réplica. La opción predeterminada para clases de entidad es replicar todas las entidades que intersecan el filtro espacial. Si no se ha proporcionado ningún filtro espacial, se incluirán todas las entidades. La opción predeterminada para las tablas es replicar solo el esquema. Esta es la opción predeterminada.
  • ADD_WITH_SCHEMA_ONLYSe agregará solamente el esquema de las tablas y clases de entidad expandidas.
  • ALL_ROWSSe agregarán todas las filas de las tablas y clases de entidad expandidas.
  • DO_NOT_ADDNo se agregarán ni las tablas ni las clases de entidad expandidas.
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.

  • DO_NOT_REUSEEl esquema no se reutilizará. Esta es la opción predeterminada.
  • REUSEEl esquema se reutilizará.
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.

  • DO_NOT_GET_RELATEDLos datos relacionados no se replicarán.
  • GET_RELATEDLos datos relacionados se replicarán. Esta es la opción predeterminada.
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.

  • ARCHIVINGSe utilizará el archivado para rastrear los cambios.
  • DO_NOT_USE_ARCHIVINGNo se utilizará el archivado para rastrear los cambios. Esta es la opción predeterminada.
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.

  • REGISTER_EXISTING_DATALos datos ya existen en la geodatabase secundaria y se utilizarán para registrar la réplica.
  • DO_NOT_USE_REGISTER_EXISTING_DATALos datos de la geodatabase principal se copiarán en la geodatabase secundaria. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo 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

Ejemplo 1 de CreateReplica (ventana de Python)

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")
Ejemplo 2 de CreateReplica (script independiente)

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)

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados