Skip to main content Skip to complementary content

Sharing a connection

You can make your connections accessible to other users to enable collaborative work on a single data source.

Sharing a connection can be useful to share a data source, and allow other users to create datasets. Connections can be shared by users who have been given the Share connections permission in Talend Management Console.

Users or group of users that you can share connections with are also managed in Talend Management Console, and you can assign them specific roles with different rights. These rights are:

  • Owner: is able to see, edit, delete, and share the connection.
  • Editor: is able to see, edit, and share the connection.
  • Viewer: is able to see and share the connection.

However, users can only share a connection with rights less than or equal to the ones they already have. If User A has the Editor role on a connection and shares it with User B, User A can only give User B the Viewer or Editor role, but not the Owner role.

There are three sharing statuses:
  • No sharing icon means the connection is not shared yet.
  • Shared with others icon means the connection is shared with other users as Owner.
  • Shared with me icon means the connection is shared with you as Editor or Viewer.

When sharing a connection, the behavior is the following:

  • Directly sharing a connection will give access to it, and allow actions based on the rights given by the one sharing the connection.
  • Revoking access to a connection will prevent other users from seeing or using it.
  • Revoking access to a connection will not prevent other users from seeing datasets based on this connection, but every actions that require the connection will not be available anymore, like refreshing the sample, or running a pipeline.

To summarize the previous rules and behaviors, let's take the following example:

  1. User A has access to Connection 1 and decides to share it with User B.
    A Connection 1 owned by User A is shared with User B.
  2. User B now has access to Connection 1, and can even create a new dataset (Dataset 2) based on the shared connection.
    The Connection 1 that has been shared with User B is being used by this user to create Dataset 2.
  3. User A now stops sharing Connection 1 with User B.
    The Connection 1 is unshared by User A.

    User B completely loses access to Connection 1. However, User B can still access Dataset 2 with limited actions, namely they will not be able to refresh the dataset sample and display up to date data. To restore full access to the dataset based on Connection 1, User B must ask User A to share the connection again.

Procedure

  1. Go to the Connections page.
  2. To share your connection from the connection list:
    1. Hover over the connection until the icons appear.
    2. Click the Sharing icon sharing icon to open the configuration window.
      Sharing configuration panel of an Amazon S3 connection.
  3. To share your connection with one user or one user group:
    1. Confirm that user groups have been previously created in Talend Management Console.
    2. Select the group or person's name on the left panel.
    3. Click the + icon that appears when you hover over the name in order to add this user as a collaborator.
  4. To share your connection with several users or several user groups at once:
    1. Confirm that user groups have been previously created in Talend Management Console.
    2. Select the groups or users on the left panel pressing Ctrl + Click or Shift + Click .
    3. Select the role you want to give them in the Add as... list to add these users as collaborators.
  5. To change the collaborators rights on the connection, select the appropriate access level on the list next to their names.
    A drop-down list shows the Editor and Owner access rights that you can choose when sharing a connection.
  6. To remove users or groups from the list of collaborators, click the red cross icon that appears when you hover over their names.
  7. Click Share to take your changes into account and close the configuration window.

Results

The selected users or user groups have been added to the list of contributors and they can now see your connection in the Connections page.

The connection sharing status changes to connection shared with other user(s).

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!