Mapping multiple temporal tables where the source datastore manages the history

You can use a wizard to map multiple temporal tables, where the source datastore manages the history.

Procedure

  1. Click Configuration > Subscriptions.
  2. Select the subscription and ensure that it has been defined so that the source datastore manages the history.
  3. Right-click and select Map Tables.
  4. Select Multiple One-to-One Mappings > Standard and click Next.
  5. Determine the type of tables to be mapped. Select a table type and click Next:
    Map Tables With History
    Specifies that the list of source and target tables available for mapping will be filtered to include only system temporal or bitemporal tables. The subscription will automatically replicate history for the source tables.
    Map Tables Without History
    Specifies that the list of source and target tables available for mapping will not be filtered and will include all source tables. However, you may only map to tables on the target that are not system temporal or bitemporal, as you cannot map non-temporal source tables to temporal target tables.
  6. Expand the database, schema, or table from the Source Tables list to view tables from your database that are available for mapping. Right-click the database user or schema and click Refresh if you do not see your table listed.

    You may be prompted to filter databases, schemas, or tables if Automatically prompt for filter when expanding nodes is enabled in your preferences. For more information see, Setting advanced preferences. To manually define a filter, select a datastore, database, or schema and click Specify Filter.

  7. Enable one or more tables to map from the Source Tables list. If you do not see your table listed, right-click the database user or schema and select Refresh.
  8. If you want to hide columns so that the target is not aware of them, select a source table and click Filter Columns. Clear the check box for the column you want to hide and click OK.
  9. Click Next.
  10. Select Map to existing target tables and click Next.
  11. Expand the database, schema, or table from the Target Tables list to view tables from your database that are available for mapping. Right-click the database user or schema and click Refresh if you do not see your table listed.

    The wizard uses the relationship between this target table and the selected source table to map the remaining source and target tables. You can click Change Example Table if you want the Map Tables wizard to base the mapping on a different source table. This option is only available if you have selected more than one source table.

  12. Enable a table to map from the Target Table list. If you do not see your table listed, right-click the database user or schema and select Refresh.
  13. Click Next.
  14. Verify the mappings in the Complete Mappings dialog, and click Next.
    Note: The Map Tables wizard may leave some source tables unmapped if it did not find a target table that shared the same table structure or similar column names. You must map these manually.
  15. Choose a replication method from the following and click Next:
    Mirror (Change Data Capture)
    Immediately replicates changes made to the source table to the target table or accumulate source table changes and replicate at a later time. If your configuration requires you to prevent recursive updates when mirroring, enable the Prevent Recursion check box. This check box is only available in components of CDC Replication that support both source and target databases.
    Refresh (Snapshot)
    Replicates a snapshot of the source table to the target table.
  16. Review the mapping summary and click Finish.