How to set up Looker

Have more questions? Submit a request
πŸ€“ Who can do this? You will probably need your Looker administrator to run these commands β€” you may not have access yourself.

Atlan supports two options for user permissions in Looker. You should choose one of these methods to set up Looker:

Admin role

This role is required for Atlan to automatically generate lineage across Looker objects. When using this role, the crawler can access all folders in Looker including personal folders.

To set up this role:

  1. Log in to your Looker instance and ensure that you are an Admin user.
  2. From the menu in the upper left, click the Admin item.
  3. Under the Users section, click the Users item.
  4. In the table, find the user you're logged in as. Click the Edit button to the right of your user's row.
  5. Next to API3 Keys, click the Edit Keys button.
  6. On the resulting Edit User API3 Keys page, click the New API3 Key button.
  7. Save the generated credentials for crawling Looker.

Custom role

🚨 Careful! When using this approach, Atlan will not automatically generate lineage across Looker objects. You will need to individually allow access to each folder to be included in lineage.

Create role

To create a custom role for Atlan to access Looker:

  1. Log in to your Looker instance.
  2. From the menu in the upper left, click the Admin item.
  3. Under the Users section, click the Roles item.
  4. At the top of the page, click the New Permission Set button.
    1. Enter a name for the new permission set.
    2. For the permissions, select the following:
      • access_data allows access to the other permissions below.
      • see_lookml_dashboards allows Atlan to crawl LookML dashboards.
      • see_looks allows Atlan to crawl Looks.
      • see_user_dashboards allows Atlan to crawl user-defined dashboards.
      • explore allows Atlan to fetch from the Explore page.
      • see_sql allows Atlan to fetch the SQL of a query or Look, to generate lineage.
      • see_lookml allows Atlan to fetch model information from LookML.
      • develop allows Atlan to fetch connection names from models, to generate lineage.
      • see_datagroups allows Atlan to fetch all connection names, to generate lineage.
    3. At the bottom of the permissions list, click the New Permission Set button.
  5. Back on the Roles page, at the top click the New Role button.
    1. Enter a name for the new role.
    2. For Permission Set, select the permission set you created in the previous step.
    3. For Model Set, select the models that you want to give access to.
    4. At the bottom of the page click the New Role button.

Create user

To create a user through which Atlan can access Looker:

  1. Open the Admin menu in Looker.
  2. Under the Users section, click the Users item.
  3. At the top of the page, click the Add Users button.
    1. For Email addresses enter the email address for the user.
    2. For Send setup emails uncheck the setting.
    3. For Roles check the box next to the role you created above.
  4. At the bottom of the page, click the Add Users button.
  5. On the resulting page, click the Done button.

Generate API key for user

To generate an API key for the user:

  1. Open the Admin menu in Looker.
  2. Under the Users section, click the Users item.
  3. In the table, find the user created above. Click the Edit button to the right of that user's row.
  4. (Optional) Consider entering a First Name and Last Name for the user to make it easier to recognize and find in the future.
  5. Next to API3 Keys, click the Edit Keys button.
  6. On the resulting Edit User API3 Keys page, click the New API3 Key button.
  7. Save the generated credentials for crawling Looker.

Include folders for lineage

To include folders when using a custom role, give permission using the following steps:

  1. From the Looker menu in the upper left, click the Admin item.
  2. Under the Users section, click the Content Access item.
  3. In the resulting page next to Folders select the folder and then click on the Manage Access... button.
  4. In the blank box at the bottom of the table, select the user created above from the list.
    • To allow Atlan to crawl only dashboards, enable the View permission for this user.
    • To allow Atlan to crawl tiles and queries for dashboards, enable the Manage Access, Edit permission for this user.
  5. To the right of the row for that user, click the Add button.
  6. At the lower-right of the dialog, click the Save button.
🚨 Careful! You will need to repeat these steps for every folder you want Atlan to be able to access.

Related articles

Was this article helpful?
0 out of 0 found this helpful