Skip to content

Connections

Connections are assets representing the sources of data in Spotlight. These are your external databases, Datameer workbooks, and each user's file uploads that are turned into a dataset. They enable you to browse through your connected datasets and add metadata to document the connection's role in your data landscape.

Connections can be followed to receive notices in your activity feed when Spotlight's regular introspection process adds new datasets from the connection.

Connections are not duplicated in Spotlight. If you add a connection that already exists, you will be redirected to the existing connection detail page and can immediately begin browsing its datasets. Connections for s3 and file uploads are created for each user and are only visible to that user and Spotlight adminstrators (see Configure visibility below).

Browse connected datasets#

The Datasets section of the connection detail page lists every dataset stored on the connected data system. Click on any of these listings to be taken to the individual dataset's detail page.

Change Ownership#

The owner setting controls who owns the Connection and all datasets connected through it. See Owner for the current owner. Use the 'Change Ownership' button button to transfer ownership to another user.

The special user-specific connections for S3 and locally uploaded files cannot have their ownership changed.

Configure Visibility#

The visibility setting for a connection defines metadata visibility for both the connection and for all datasets connected through it. Metadata visibility controls who can visit an asset's details page and who will see it as part of search results using the 'Find' icon find tool.

Read more

The current metadata visibility setting for a connection is visible in its "Visible to" metadata field. For connections using the Specific people setting, this field will include the list of allowed users.

The visibility settings are:

  • "Everyone at your company" - Anyone with a Spotlight account will have metadata visibility for the connection and connected datasets.
  • "Specific people" - A dialog will open when you select this option enabling you to search for and select other Spotlight users. Only the owner and the users selected in this dialog will have metadata visibility for the connection and connected datasets.
  • "Nobody except you". Only the owner has metadata visibility for the connection and connected datasets.

Connections are visible to everyone in your organization by default.

The connection's owner or a Spotlight administrator can change the connection's metadata visibility using the 'Configure Visibility' button management button.

A user's personal S3 and file upload connections are only visible to that user and cannot have their visibility settings changed.

Note that administrators have visibility for all assets in Spotlight.

Metadata#

The connection detail page displays user and machine-created metadata to help you better understand where the connection comes from, what it contains, and how it is being used in Spotlight.

Metadata fields

Name#

Names can be up to 100 characters, cannot start with an (_) character or a space, and cannot contain a (`) character.

Connection names are initially inherited from the source database, Datameer workbook, or other connected system they represent. This name can be changed by the owner of the connection asset in Spotlight and by Spotlight administrators.

Description#

400-characters to provide as much description as possible about the connection and its role in your organization's data landscape. The more a connection is documented, the better everyone will be able to understand the datasets it contains.

The description can be edited by the connection's owner and by Spotlight administrators.

Visible to#

Lists who has metadata visibility to this connection and the datasets it contains (see Concepts of Spotlight: Visibility and Configure Visibility above). For connections using the Specific people setting, this field will include the list of allowed users.

Properties#

Properties help you capture the state and features of an asset as structured data. This includes the "Status" value for datasets and other values that are customized for each asset type by your organization. Common properties include the person responsible for an asset's maintenance, how often the asset is supposed to be updated, and whether it has been trusted by a data steward. Using properties makes it easier to search for and categorize an asset (see "Find Assets: Find by other asset features").

Owner#

The owner is generally the person who added a connection to Spotlight. The owner has the ability to change basic information about the connection like its name and description, and to transfer ownership (the user-specific connections for uploaded local and S3 files cannot be transfered)).

Ownership of a conneciton also controls who owns datasets from that connection.

Dates#

Displays the dates on which the connection was created and last modified. A connection is considered to have been modified whenever the title or description is edited. The last modified date is used to sort some search results.

Tags#

Tags help quickly identify, search for, and categorize assets in Spotlight. Add some here to make this connection easier to find and easier to tell apart from the rest of your data systems.

A tag can be up to 80 characters (spaces are not allowed). Clicking on a tag launches a search for all assets with that tag in Spotlight.

Tags can be edited by the connection's owner and by Spotlight administrators.

Following#

Shows the number of users following the connection and is also a toggle button so that you can follow/un-follow the connection.

Anyone can follow or un-follow a connection. Anyone following the connection will receive a message in their Activity panel when new datasets from the connection are introspected and when the connection's name, description, or tags are edited.