Manage a role's tables and users

A role grants its members access to Lake and Warehouse tables, and you choose who holds it. Use this page to change a role's table access and its members; to create a role or change its description, icon, permissions or status, see Roles and permissions.

Change the tables a role can access

  1. Open Admin > Profile Management > Roles, then open the role.
  2. Open the tables editor: choose Manage Tables in the role's row menu on the Roles list, or open the role, go to its Tables section (the Tables quick action takes you there) and click Manage.
  3. Tick the tables the role should have, and untick the tables it should lose. The editor shows a Lake tables column and a Warehouse tables column. Use Search tables... to filter by name, Selected only to see just the tables the role currently has, and Select all or Deselect all for every row you can see.
  4. Click Save Changes.

Only the tables you changed are sent. Removals are processed before additions, and a large edit is processed in batches. Save Changes stays off until you change something, and reads Saving... while it saves; rows are disabled while the save runs.

If you close the editor with pending edits, DataMind OS asks Unsaved Changes before closing: "You have N unsaved changes. If you leave now, your changes will be discarded." Choose Keep editing to go back, or Discard changes to lose them.

Important

A table cannot be removed from a role while a Mind owned by that role uses it. The save fails and names the tables: Cannot remove role "<role>" from permission groups: table "<table>" is used in Minds: [<names>]. Remove those tables from the Minds first. Change those Minds so they no longer use the tables, or leave the tables ticked.

The built-in Admin role's table permissions cannot be changed, and a save is refused with Cannot update table permissions for admin role; its role panel also has no Manage link. While the editor loads it shows Loading table permissions...; if the load fails, it shows Failed to load table permissions with a Retry button that reloads the page.

Change who holds a role

  1. Open the role, then go to its Users section; the Users quick action takes you there.
  2. Under Assigned users, click Edit.
  3. Search with Search users..., then tick the users to add them and untick the users to remove them.
  4. For each assigned user, choose BI Viewer or BI Editor. This sets the user's BI access level through this role. Members of the built-in Admin role get no switch.
  5. Click Save changes.

The footer shows how many changes are pending. A reset control next to the search drops your pending ticks; its tooltip reads Reset pending changes, or No pending changes when nothing is pending. Save changes stays off until something changes, and reads Saving... while it saves. Selected only narrows the list to the users the role already has, and Select all and Clear apply only to the list you can see.

Closing with pending changes asks Unsaved changes with the same "You have N unsaved changes. If you leave now, your changes will be discarded." body and the same Keep editing and Discard changes choices. If the save fails, the editor shows the reason and returns the list to its last saved state, so a refused save never looks successful.

When a search or filter hides everyone, the editor says No users match your criteria with "Try a different search or clear the selected-only filter."; when nobody can be assigned, it says No users available with "There are no users that can be assigned to this role." Users whose name contains "admin" or "application" are left out of this list, so the search will not find them.

Read a role's tables and members

The role panel shows both lists without opening an editor.

The Manage and Edit actions appear only if your permissions allow you to update roles.

Questions, answered

Why is Save Changes greyed out?

Nothing has changed yet, or a save is running. The button turns on as soon as you tick or untick a table, and the members editor works the same way.

I closed an editor with unsaved changes. Are they lost?

Yes, if you chose Discard changes. Both editors ask first when edits are pending: Unsaved Changes in the tables editor and Unsaved changes in the members editor. Keep editing returns you to the editor, and Discard changes drops the pending edits.

Why can't I remove a table from this role?

A Mind owned by this role uses that table. The save fails and names the tables; remove those tables from those Minds first, or leave the tables ticked, then save again.

Why can't I change the Admin role's tables?

The built-in Admin role always has full access, so its table permissions cannot be changed. The row menu can still open the tables editor for it, but a save is refused with "Cannot update table permissions for admin role". Its panel also has no Manage link.

What do BI Viewer and BI Editor mean on a role member?

They set the user's BI access level through this role. BI Viewer can view and run queries and view dashboards and alerts; BI Editor can also create and edit queries and dashboards, see a query's source, and set schedules. A user's reporting account is provisioned from their roles: each role carries its own viewer and editor access and its own data source, so report access follows the role. A user whose reporting account is not there yet is skipped by reporting operations until an administrator resynchronises it; see Passwords, locks and limits for a user. Choose one next to each assigned user while you edit the role's members. Members of the built-in Admin role get no switch.

Why do some users not appear in the members editor?

Users whose name contains "admin" or "application" are left out of this list, so the search will not find them either.

Do Select all, Clear and Selected only act on everything, or only on what I can see?

Only on what you can see. Select all and Clear apply to the rows currently shown, after the search and Selected only filters. Selected only narrows the list itself: to the users the role already has in the members editor, and to the tables the role currently has in the tables editor.

The save failed and my edits disappeared. Why?

In the members editor, a failed save returns the list to its last saved state and shows the reason, so a refused save never looks successful. In the tables editor, the error appears inside the editor and your ticks stay put.

Which tables can I give a role?

Lake tables and Warehouse tables; the editor shows both columns. Table access is separate from permissions, and it decides which tables the role's members can use. See SQL dialect and data scope.

Where can I see a role's tables or members without opening an editor?

In the role panel: Tables lists the role's tables and opens one when you click it, and Assigned users lists its members. Both show a count badge, and longer lists get a search box.