Looker

Follow these steps to connect your Looker instance to Select Star.

Before you start

To connect Looker to Select Star, you will need...

Admin access to your Looker account.
Admin access to your LookML repo(s) in GitHub.

Complete all of the following steps to see Looker metadata, lineage, and popularity in Select Star.

If you want to create an API3 Key on a Looker account with Admin access, start at step 3.

1. Create a Select Star Permission Set and Role in Looker

Create a new Permission Set called Select Star with the following permissions:

Create a new role called Select Star Role . Choose the Select Star Permission Set you just created and the All Model Set as shown below.

When created, the Role Permissions will look like the following:

2. Create a Select Star user in Looker

Now the role is created, you can assign the Select Star Role to a Looker User.

You can either assign the role to an existing Looker user, or create a new user by sending an invite to selectstar@getselectstar.com with the Select Star Role.

You can also create an API3 key in your own Looker account, as long as your permissions include everything from step 1.

3. Create a new API3 Key

From the main Looker page, Click Admin, then Users.

Find your Select Star user and click the Edit button. Under API3 Keys, click the Edit Keys button.

Create a New API3 Key.

You will see a new API3 Key with a Client ID and Client Secret.

4. Grant view access to Shared Folder

You may need to grant view access to the user you created in step 1 on the Shared Folder in order to see your dashboards in Select Star.

Navigate to the Shared folder in Looker.

Find the gear icon in the upper right part of the screen and click Manage Access.

Grant View access to the Select Star user you created.

5. Connect Looker API to Select Star

Go to the Select Star Settings. Click Data in the sidebar, then + Add to create a new Data Source.

Choose Looker in the Source Type dropdown and provide the following information:

Display Name: This value is Looker by default, but you can override it if desired.
API Client ID: The API3 Client ID from Step 4 above.
API Client Secret: The API3 Client Secret from Step 4 above.
Host URL: The full URL of your Looker instance.

Click Connect to proceed.

6. Connect LookML repo to Select Star

In order for Select Star to connect the data warehouse and Looker data models, access to the GitHub repo for the LookML code is required. If you do not need to see lineage, you can click Next to skip this step.

Select Star will automatically detect LookML projects connected to your Looker instance.

If you do not see any LookML projects, please check the Model Set in Step 1. Select Star detects LookML projects based on access to Looker models using the API.

You must use a SSH connection when integrating Looker with Git. This is required to set up deploy keys on most major Git Repositories including Github and Gitlab.

Check the Connecting to Git using SSH section in the Looker docs.

https://docs.looker.com/data-modeling/getting-started/setting-up-git-connection

For each project you want to connect, click Copy Key.

Open your browser in a new window or tab, and go to your LookML repo in GitHub.

Click on Settings > Deploy keys on the sidebar.

Click the Add deploy key button in the corner.

Paste in the entire key copied from Select Star into the Key text box.

Set the title to a descriptive name, such as Select Star Ingestion Key.

You do not need to allow write access.

Click Add key.

Return to Select Star and click the Next button at the bottom of the modal.

Your metadata should start loading automatically. Please allow 24-48 hours to completely generate popularity and lineage.