It is possible to link data connections together. This can have the following benefits.
If common structure is repeated - it means it is created and maintained in one place.
Content can be visible but locked away from users, who can otherwise edit a data connection.
Specifically in Multi-Organisational environments
You can allow tenants to build their own content on top of the standard shipped data connection.
Tenants can create content against a database - without being given or even able to view any Database connection details.
Tenants can have user restrictions applied to their own data connections - that they are not able to remove or alter.
There are use cases for linked data connections to be used within a single Organisation, however it is often used in conjunction with Organisations to provide additional security.
How to tell if my data connection is linked?
When you open a linked data connection, if you notice that a table has a hashed line around it then this table is from the linked data connection.
Also notice that some of the objects in this table a greyed out.
These objects also come from the ‘parent’ data connection so cannot be edited or deleted here.
They are read only.
If you see such a structure this is the first indication that you are working on a linked data connection or a ‘child’ connection.
If you now look at the connection tab,
We can’t see any of connection details. If we want to change any of the specifics about the connection to the database then we would have to edit the parent data connection. In this example that is a connection called Ad Spend. You may not be allowed to edit the parent, and the parent may even be in another organisation.
Creating a Linked Data Connection
The parent data connection is created and maintained as any other data connection. When you decide that you want this data connection to become a parent data connection, you tick the ‘Can Have Child Connections’ box on the Connection screen.
Now we can create a child from the parent. To do this create a connection as normal, but instead of setting the database credentials, we use the ‘Parent Connections’ droplist to select the parent to inherit from.
This list contains all the data connections you have access to, to appear in this list the following criteria must be met.
The data connection must be marked to allow child data connections.
You must have access to the category that the data connection belongs to.
If the data connection belongs to a different organisation, then you must have a subscription to that organisation, with access to the category that the data connection belongs to.
Once you have selected the parent data connection and saved.
The connection panel changes, At this moment the child data connection is attached to the parent. You are not allowed to remove the parent from this data connection. (A life long bond has been established). You cannot set a child to allow other data connections to be children of it. We allow only 1 level of inheritance.
You have the ability to transform an existing data connection into a child at any point, but it's important to approach this process with caution!
Now that our data connection is linked , i.e. it is a child, we can add local content to it.
You add tables / objects and joins as you would with any other data connection. The only difference is that you can’t edit any of the content that comes from the parent.
You can add objects to tables that come from the parent though.
If anyone creates new content in the parent data connection it will automatically appear in your child data connection.
You can only edit content in the child when you are in the child.
Always make sure you do join your tables back to the content of the main data connection. If the admin in the parent connection creates a user restriction for you, all your queries will fail with a SQL error (this is intended) until you link back to the main structure.
Exporting / Import A Child Connection
You cannot currently export / import child connections.
Using a Child Data Connection
It makes no difference to the user in the Edit Chart screen, the child data connection is presented to the user, without making them aware of which objects come from the parent and which from the child.
Linked Data Connections + Organisations
If we are giving one of our tenants the ability to create data connections then we probably do not want to.
Share the database connection details with them.
Not allow them to create a child from any of our data connections. We want them only to be able to use specific seed data connections.
Do want to enforce any [[VARIABLE]] replacement in the data connection details.
Enforce database tenancy using user restrictions (or Variables).
Share a set of default content that can be used as a starting position.
The configuration will look a little like this;
It is very important that all of the security related details are configured in the top level organisation.
Add Comment