Mapworks User Guide

Appearance

Connection References ​

Overview ​

Connections sit at the top of the Mapworks resource hierarchy:

Connection → Dataset → Layer → Map

Each connection provides the link to an underlying data source and can have multiple Datasets created from it. Understanding these relationships helps you:

  • Navigate between related resources
  • Understand what will be affected when modifying a connection
  • Track which datasets depend on a connection

Viewing Child Datasets ​

A connection can have multiple datasets created from its data source. Each dataset represents a specific table from the connection.

To view datasets created from a connection: ​

  1. Go to Mapworks UI
  2. Click the Connections Tab and search for the desired connection
  3. If datasets have been created from this connection, a button will display the number of datasets.

Connection Child Datasets

  1. Click the Datasets button to view a list of all datasets created from this connection.

Understanding Connection Dependencies ​

Connections are the foundation of the data hierarchy. Changes to a connection can have wide-reaching effects:

If you modify...It affects...
Connection credentialsAll datasets using that connection (may cause data refresh failures)
Connection sourceAll datasets, layers, and maps downstream
Connection permissionsUsers who lose access will see an exclamation mark on affected layers

⚠️ Warning

When deleting a connection that has child datasets, you will be prompted with the option to also delete all downstream resources. If you choose to delete them, all child datasets and their layers will be permanently removed. If you choose to delete only the connection, the child datasets and their layers will be left broken and unusable, and cannot be recovered. Always check connection references before deleting.

From Connection to Datasets ​

  1. Navigate to the desired connection
  2. Click the Datasets button to view a list of all datasets created from this connection.

Connection References

From Connection to Layers ​

  1. Navigate to a child dataset
  2. Click the Layers button to view a list of all layers created from this dataset.

Dataset Child Layers

From Dataset to Connection ​

  1. Navigate to the desired dataset
  2. Click on the parent connection

Parent Connection