Create a one-way replica

Available with Standard or Advanced license.

One-way replication allows data changes to be sent multiple times in a single direction, either from the parent replica to the child replica or from the child replica to the parent replica. For one-way parent-to-child replicas, the child replica geodatabase can be an enterprise or file geodatabase. For one-way child-to-parent replicas, the child geodatabase must be an enterprise geodatabase. See Replication types for more information.

You can use the Create Replica option Create Replica on the Distributed Data context menu to create a one-way replica One Way Replica from an enterprise geodatabase. After the initial synchronization of changes, a one-way replicas persists, allowing you to continue sending data changes. One-way replication is ideal for when you want to publish changes from a production server to a publication server.

Before getting started, see Prepare data for replication to review the data requirements. For a list of data types supported with geodatabase replication in ArcGIS Pro, see Replication and geodatabase compatibility.

Follow these steps to create a one-way replica:

  1. Start ArcGIS Pro and open an existing ArcGIS Pro project, or begin without a template.
  2. In the Catalog pane, right-click an existing geodatabase connection and click the Distributed Geodatabase context menu.

    Distributed Geodatabase context menu


    To create a replica, you must use a connection to an enterprise geodatabase as a user with data creator privileges.

  3. Select Create Replica Create Replica.

    Distributed Geodatabase context menu options

    The Create Replica geoprocessing tool dialog box appears with default settings.

    Create Replica geoprocessing tool
  4. For Replica Datasets, use the browse button to select the layers to replicate within this one-way replica.
    Replica Datasets drop-down menu


    • There must be at least one layer in the map for the Add Many icon Add Many to appear.
    • Use Add Many Add Many next to Replica Datasets to add multiple datasets at once.
    • If you are replicating a subset of data, apply definition queries as described in Determine datasets to replicate. Then use the drop-down menu to add datasets containing a subset of data to this one-way replica. If the browse button is used to select datasets containing a subset of data instead of the drop-down menu, the definition queries will not be honored, and the default behavior will be applied.
    • To include tables in your replica, it’s important to understand that the default behavior for tables is replicate schema only. To replicate all records, specify the SQL expression 1=1 for your definition query. To replicate a subset of records in your table, set the appropriate SQL expression.

  5. For Replica Type, select either One way replica or One way child to parent replica from the drop-down menu.

    Replica Type

  6. For Output Type, from the drop-down menu, choose to replicate to a Geodatabase (default) or an XML file.
    • If you choose Geodatabase, for Geodatabase to replicate data to, click the browse button Browse to browse to the geodatabase that will host the child replica.

      For a one-way replica, this geodatabase can be a file or enterprise geodatabase.

      For a one-way child replica to parent replica, this must be an enterprise geodatabase.

    • If you choose XML file, for XML file to replicate data to, click the browse button Browse to browse to the location and provide a name for the XML file that will host the child replica.

      You can later use this output XML file as input into another geodatabase by using the  Import XML Workspace Document   tool.

      Replicating data in a disconnected environment is only possible if you replicate your data to an XML workspace document. To learn more, see Replicas in a disconnected environment.

  7. For Replica Name, type a name to identify the replica. The name of each replica must be unique to the user creating the replica.
    When deciding on a replica name, make note of these additional rules:
    • Names must begin with a letter, not a number or special character such as an asterisk (*) or percent sign (%).
    • Names should not contain spaces. If you have a two-part name for your replica, connect the words with an underscore (_).
    • Names should not contain reserved words, such as select or add. Consult your DBMS documentation for additional reserved words.
    • The length of a replica's name depends on the underlying database. Be sure to consult your DBMS documentation for maximum name lengths.
    See Name and Alias for more information regarding rules for geodatabase objects.
  8. Click Advanced Setting to expand additional options if you want to override the default replication options. If you are not making any change to the default options, skip to step 15.

    Advanced Setting in the Create Replica tool

  9. Under Advanced Setting, for Replica Access Type, choose Full or Simple for the geodatabase model.
  10. From Expand Feature Classes and Tables, select one of the following four options:
    • Use defaults—Adds the expanded feature classes and tables related to the feature classes and tables in the replica. The default for feature classes is to replicate all features intersecting the spatial filter. If no spatial filter has been provided, all features are included. The default for tables is to replicate the schema only.
    • Add with schema only—Adds only the schema for the expanded feature classes and tables.
    • All rows—Adds all rows for expanded feature classes and tables.
    • Do not add—Doesn't add expanded feature classes and tables.
  11. For Replicate Related Data, choose Get related or Do not get related to specify whether to replicate rows related to rows already in the replica. Get related is the default setting.

    See Replication and related data to learn more about how this setting works when replicating data.

  12. Replica Geometry Features can be used to define the replica geometry:
    • The replica geometry features can be a feature layer with points, lines, or polygons.
    • A feature layer used for the replica geometry features can contain one or more features. If there are more than one, the geometries are merged, and only data that intersects the merged geometries will be replicated.
    • If filters (such as a definition query) have been defined on the replica geometry features, only features that satisfy these filters will be used to define the replica geometry.
    • You can also use the Extent environment setting to define the replica geometry:
      • If Replica Geometry Features is set, it is used as the replica geometry.
      • If Replica Geometry Features is not set, the Extent environment is used as the replica geometry.
      • If both Replica Geometry Features and the Extent environment are set, the Replica Geometry Features setting is used.
      • If neither Replica Geometry Features nor the Extent environment is specified, the full extent of the data is used.
  13. Optionally, check Use archiving to track changes for 1 way replication at the bottom of the tools dialog box to turn this option on. To use archiving for one-way replicas, the parent workspace must be connected to the default version. For one-way child-to-parent replicas, the child workspace must be connected to the default version.

    Using archiving when creating a one-way replica

  14. Optionally, check Register existing data only if the data already exists in the child geodatabase and is used to define the replica datasets. If Register existing data only is left unchecked, which is the default, data in the parent geodatabase is copied to the child geodatabase.
    Register existing data only option located on the Create Replica geoprocessing tool

    See Register existing data only for a list of additional geodatabase replication requirements that must be met prior to selecting this option on the Create Replica geoprocessing tool.

  15. Click Run to create the one-way replica.

Related topics 

In this topic
  1. Related topics