Crear réplica (Administración de datos)

Resumen

Crea una réplica en 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.

  • Puede utilizar el parámetro Entidades de geometría de réplica o la configuración de entorno 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

Parámetros

EtiquetaExplicaciónTipo de datos
Datasets de réplica

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
Tipo de réplica

Especifica el tipo de réplica que se creará.

  • Réplica bidireccionalLos cambios se enviarán entre las réplicas secundaria y principal, en ambas direcciones.
  • Réplica unidireccionalLos cambios se enviarán solamente de la réplica principal a la réplica secundaria.
  • Réplica de check-outLos datos se replicarán y editarán y se volverá a hacer el check-in una vez.
  • Réplica unidireccional de secundario a principalLos cambios se enviarán solamente de la réplica secundaria a la réplica principal.
String
Geodatabase para replicar datos a
(Opcional)

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 las de check-out, la geodatabase puede ser de archivos o corporativa. Las geodatabases de archivos deben existir antes de ejecutar esta herramienta.

Este parámetro es obligatorio si el parámetro Tipo de salida se define como Geodatabase.

Workspace; GeoDataServer
Nombre réplica

El nombre que identifica la réplica.

String
Tipo Acceso Réplica
(Opcional)

Especifica el tipo de acceso de réplica.

  • CompletoSe admiten los tipos complejos (como las topologías) 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 topologías) se convertirán en entidades simples (por ejemplo, clases de entidad poligonales, de puntos y de líneas).
String
Emisor de datos inicial
(Opcional)

Especifica qué réplica 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.

  • Secundaria como remitente de datosLa réplica secundaria será la remitente inicial de los datos. Esta es la opción predeterminada.
  • Principal como remitente de datosLa réplica principal será la remitente inicial de los datos.
String
Expandir clases de entidad y tablas
(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).

  • Usar valores predeterminadosSe 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.
  • Agregar solo con esquemaSe agregará solamente el esquema de las tablas y clases de entidad expandidas.
  • Todas las filasSe agregarán todas las filas de las tablas y clases de entidad expandidas.
  • No agregarNo se agregarán ni las tablas ni las clases de entidad expandidas.
String
Esquema de reutilización
(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. Este parámetro solo está disponible para las réplicas de check-out.

  • No reutilizarEl esquema no se reutilizará. Esta es la opción predeterminada.
  • ReutilizaciónEl esquema se reutilizará.
String
Replicar datos relacionados
(Opcional)

Especifica si se replicarán las filas relacionadas con filas ya presentes en la réplica. Por ejemplo, una entidad (f1) está dentro del filtro de replicación y una entidad relacionada (f2) de otra clase está fuera del filtro. La entidad f2 se incluirá en la réplica si elige obtener datos relacionados.

  • No obtener relacionadosLos datos relacionados no se replicarán.
  • Obtener relacionadosLos datos relacionados se replicarán. Esta es la opción predeterminada.
String
Entidades de geometría de réplica
(Opcional)

Las entidades que se utilizarán para definir el área que se replicará.

Feature Layer
Utilizar archivado para rastrear cambios de replicación unilateral
(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.

  • ArchivarSe utilizará el archivado para rastrear los cambios.
  • No utilizar archivadoNo se utilizará el archivado para rastrear los cambios. Esta es la opción predeterminada.
Boolean
Registrar solo datos existentes
(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 base de datos principal y ser propiedad del usuario que está conectado a la geodatabase secundaria.

  • Activado: los datos que ya existen en la geodatabase secundaria se utilizarán para registrar la réplica.
  • Desactivado: los datos de la geodatabase principal se copiarán en la geodatabase secundaria. Esta es la opción predeterminada.

Boolean
Tipo de Salida
(Opcional)

Especifica el tipo de salida de los datos que se replicarán.

  • GeodatabaseLos datos se replicarán en una geodatabase. Esta es la opción predeterminada.
  • Archivo XMLLos datos se replicarán en un documento de espacio de trabajo XML.
String
Archivo XML en el que replicar datos
(Opcional)

El nombre y la ubicación del archivo .xml que se creará.

Este parámetro es obligatorio si el parámetro Tipo de salida se ha definido como Archivo XML.

File
Todos los registros de tablas
(Opcional)

Especifica si se copiarán todos los registros o solo el esquema en la geodatabase secundaria para las tablas que no tienen filtros aplicados (como selecciones o consultas de definición).

Se respetarán las tablas con filtros aplicados.

  • Activado: para tablas sin filtros aplicados, todos los registros se copiarán en la geodatabase secundaria para tablas. Esta opción anulará el valor del parámetro Expandir tablas y clases de entidad.
  • Desactivado: para tablas sin filtros aplicados, solo se copiará el esquema en la geodatabase secundaria para tablas. Se respetarán las tablas con filtros aplicados. Esta es la opción predeterminada.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Espacio de trabajo secundario de salida

La geodatabase secundaria de salida.

Workspace
Nombre Réplica de salida

El nombre de la réplica de salida.

String

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}, {out_type}, {out_xml}, {all_records_for_tables})
NombreExplicació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 creará.

  • TWO_WAY_REPLICALos cambios se enviarán entre las réplicas secundaria y principal, en ambas direcciones.
  • ONE_WAY_REPLICALos cambios se enviarán solamente de la réplica principal a la réplica secundaria.
  • CHECK_OUTLos datos se replicarán y editarán y se volverá a hacer el check-in una vez.
  • ONE_WAY_CHILD_TO_PARENT_REPLICALos cambios se enviarán solamente de la réplica secundaria a la réplica principal.
String
out_geodatabase
(Opcional)

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 las de check-out, la geodatabase puede ser de archivos o corporativa. Las geodatabases de archivos deben existir antes de ejecutar esta herramienta.

Este parámetro es obligatorio si el parámetro out_type se define como GEODATABASE.

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 (como las topologías) 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 topologías) se convertirán en entidades simples (por ejemplo, clases de entidad poligonales, de puntos y de líneas).
String
initial_data_sender
(Opcional)

Especifica qué réplica 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 será la remitente inicial de los datos. Esta es la opción predeterminada.
  • PARENT_DATA_SENDERLa réplica principal será 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. Este parámetro 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, una entidad (f1) está dentro del filtro de replicación y una entidad relacionada (f2) de otra clase está fuera del filtro. La entidad f2 se incluirá 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 que se utilizarán 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 que ya existen en la geodatabase secundaria 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
out_type
(Opcional)

Especifica el tipo de salida de los datos que se replicarán.

  • GEODATABASELos datos se replicarán en una geodatabase. Esta es la opción predeterminada.
  • XML_FILELos datos se replicarán en un documento de espacio de trabajo XML.
String
out_xml
(Opcional)

El nombre y la ubicación del archivo .xml que se creará.

Este parámetro es obligatorio si el parámetro out_type se define como XML_FILE.

File
all_records_for_tables
(Opcional)

Especifica si se copiarán todos los registros o solo el esquema en la geodatabase secundaria para las tablas que no tienen filtros aplicados (como selecciones o consultas de definición).

Se respetarán las tablas con filtros aplicados.

  • ALL_RECORDS_FOR_TABLESPara tablas sin filtros aplicados, todos los registros se copiarán en la geodatabase secundaria. Esta opción anulará el valor del parámetro expand_feature_classes_and_tables.
  • SCHEMA_ONLY_FOR_TABLESPara las tablas sin filtros aplicados, solo se copiará el esquema en la geodatabase secundaria. Se respetarán las tablas con filtros aplicados. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_child_geodatabase

La geodatabase secundaria de salida.

Workspace
output_replica_name

El nombre de la réplica de salida.

String

Muestra de código

Ejemplo 1 de CreateReplica (ventana de Python)

En el siguiente script de la 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.management.CreateReplica("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 el siguiente script de Python se muestra cómo utilizar la función CreateReplica en un script 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"

# Run CreateReplica
arcpy.management.CreateReplica(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