Tableau Lineage Plus Connector – User Setup

To enable Bigeye to connect to Tableau and retrieve data lineage, you will need to create a dedicated user, configure permissions, and generate an API key.

1. Create a Tableau User and Group

1. Create a new user, for example:
   • Username: bigeye_lineage_user
2. Add this user to a group, for example:
   • Group name: BigeyeGroup

Note: Usernames and group names may be used interchangeably in the steps below.
Example project folder name: Tableau Samples.

2. Understand Project Folders

Tableau displays a list of Project Folders, where Workbooks, Views, and Data Sources are stored. Permissions must be configured at the Project Folder level or the Workbook level depending on your access strategy.

3. Configure Project-Level Permissions

1. Navigate to the Project Folder (e.g., Tableau Samples).
2. Click on Permissions.
3. Assign permissions to the group (e.g., BigeyeGroup):
   • View
   • Download Workbook

When permissions are locked to the project, these permissions apply to all workbooks within the folder.

4. Configure Workbook-Level Permissions (Optional)

If the project is set to Managed by the Owner rather than locked:

1. Each workbook must be configured individually.
2. For each workbook, assign the following permissions to the user or group:
   • View
   • Download Workbook

5. Create an API Key for the Tableau User

Bigeye uses a Tableau API key (personal access token) to authenticate. To generate an API key for the new user:

1. Log in to Tableau Server or Tableau Online as the newly created user (bigeye_lineage_user).
2. Click your profile icon in the top-right corner.
3. Navigate to My Account Settings.
4. Under the Personal Access Tokens section:
   • Click Create new token.
   • Enter a descriptive token name (e.g., bigeye_token).
   • Click Create.
5. Copy the generated Token Name and Token Value.
   • The token value is shown only once. Save it securely for use in Bigeye.

Configuration Parameters

The following fields can be configured:

• tableau.basefolder
• tableau.file.encoding (default: ISO-8859-1)
• metacenter.url
• tableau.extract.file
• tableau.server.url
• tableau.server.site.name
• tableau.server.name
• tableau.server.username
• tableau.server.password
• tableau.version
• tableau.projectfolder.include
• tableau.projectfolder.path.include
• tableau.projectfolder.match.path
• tableau.projectfolder.exclude
• tableau.workbook.include
• tableau.workbook.exclude
• tableau.server.version
• tableau.server.use.personal.token
• tableau.server.personal.token.name
• tableau.server.personal.token.secret.password

Summary of Steps

1. Create a user (e.g., bigeye_lineage_user).
2. Add the user to a group (e.g., BigeyeGroup).
3. Assign project-level permissions (View, Download Workbook).
4. If needed, assign workbook-level permissions when not locked at the project level.
5. Generate an API key for the Tableau user.