Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: data studion perms (#69203)

Alex Yarosh24649ede3e18
diff --git a/docs/data-studio/data-structure.md b/docs/data-studio/data-structure.md
index 1aae4c960a2..e70a24d805a 100644
--- a/docs/data-studio/data-structure.md
+++ b/docs/data-studio/data-structure.md
@@ -3,7 +3,7 @@ title: Data structure
summary: See all the tables in your Metabase, edit and sync metadata, edit column types, set visibility, publish tables, and more.
---
-## Data structure
+# Data structure
_Data studio > Data structure_
diff --git a/docs/data-studio/overview.md b/docs/data-studio/overview.md
index de9fed1c7ad..47bea6d8dc1 100644
--- a/docs/data-studio/overview.md
+++ b/docs/data-studio/overview.md
@@ -16,10 +16,10 @@ Data Studio provides tools to shape and track your data so everyone can trust th
## What's in Data Studio
- **[Library](./library.md)**\*: A curated space for your organization's most trusted analytics content—tables, metrics, and SQL snippets that your data team recommends.
-- Data structures. Add table metadata to make tables easier to work with.
-- Glossary. Define terms relevant to your business, both for people and agents trying to understand your data.
+- **[Data structure](./data-structure.md)**. Add table metadata to make tables easier to work with.
+- **[Glossary](../exploration-and-organization/data-model-reference.md#glossary)**. Define terms relevant to your business, both for people and agents trying to understand your data.
- **[Dependency graph](./dependency-graph.md)**\*: A visual map of how your content connects, so you can understand the impact of changes before you make them.
-- Dependency diagnostics\*. See which items have broken dependencies, or that aren't used.
-- Transforms
+- **[Dependency diagnostics](./dependency-diagnostics.md)**\*. See which items have broken dependencies, or that aren't used.
+- **[Transforms](./transforms/transforms-overview.md)**. Wrangle your data in Metabase, write the query results back to your database, and reuse them in Metabase as sources for new queries.
\* Available on [Pro and Enterprise plans](https://www.metabase.com/pricing/).
diff --git a/docs/people-and-groups/managing.md b/docs/people-and-groups/managing.md
index 17752545067..20760d5e3ef 100644
--- a/docs/people-and-groups/managing.md
+++ b/docs/people-and-groups/managing.md
@@ -180,6 +180,22 @@ The **All Users** group is another special one. Every Metabase user is always a
It's important that your All Users group should never have _greater_ access for an item than a group for which you're trying to restrict access — otherwise the more permissive setting will win out. See [Setting permissions](../permissions/start.md).
+#### Data analysts
+
+{% include plans-blockquote.html feature="Data Analysts group" %}
+
+You can add non-admins to the special **Data Analysts** group to give them access to [Data Studio](../data-studio/overview.md).
+
+By default (and you can't change this), the Data Analyst group gets:
+
+- Access to [Data Studio](../data-studio/overview.md).
+- [Curate permissions](../permissions/collections.md#curate-access) for the [Library collection](../data-studio/library.md)
+- [Manage table metadata permissions](../permissions/data.md#manage-table-metadata-permissions) for _all_ tables in all databases in your Metabase.
+
+Other than the fixed access listed above, you can assign data, collection, and application permissions to the Data Analyst group as you would normally.
+
+By default, a person in a Data Analysts group will have only read-only access to [Transforms](../data-studio/transforms/transforms-overview.md) that use tables which the person otherwise can view. To give a Data Analyst the ability to _create_ and _run_ transforms, you'll need to give them [transform permissions](../permissions/data.md#transform-permissions) on appropriate tables.
+
## Creating a group
Go to **Admin settings** > **People** > **Groups**, and click the **Add a group** button.
diff --git a/docs/permissions/data.md b/docs/permissions/data.md
index 8b29e095fdd..d76ed2f514e 100644
--- a/docs/permissions/data.md
+++ b/docs/permissions/data.md
@@ -33,6 +33,7 @@ You can set the following types of permissions on a database, schema, or table:
- [Download results](#download-results-permissions)
- [Manage table metadata](#manage-table-metadata-permissions)
- [Manage database](#manage-database-permissions)
+- [Transform](#transform-permissions)
If you need to change the target database based on who is logged in, check out [Database routing](./database-routing.md). Database routing is particularly useful when each of your customers has their own database.
@@ -142,7 +143,7 @@ The granular option lets you define Create queries permissions for each schema a
## Download results permissions
-{% include plans-blockquote.html feature="Download permissions" %}
+{% include plans-blockquote.html feature="Download permissions" is_plural=true %}
You can set permissions on whether people in a group can download results (and how many rows) from a data source. Options are:
@@ -155,7 +156,7 @@ Downloads of native queries are only allowed if a group has download permissions
## Manage table metadata permissions
-{% include plans-blockquote.html feature="Data model permissions" %}
+{% include plans-blockquote.html feature="Data model permissions" is_plural=true %}
You can define whether a group can [edit table metadata](../data-modeling/metadata-editing.md). Options are:
@@ -165,7 +166,7 @@ You can define whether a group can [edit table metadata](../data-modeling/metada
## Manage database permissions
-{% include plans-blockquote.html feature="Database management permissions" %}
+{% include plans-blockquote.html feature="Database management permissions" is_plural=true %}
The **Manage database** permission grants access to the settings page for a given database (i.e., the page at **Admin settings** > **Databases** > your database).
@@ -185,6 +186,14 @@ If you see this modal pop-up, Metabase is telling you that the people in the All
See [Upload permissions](../databases/uploads.md#add-people-to-a-group-with-data-access-to-the-upload-schema).
+## Transform permissions
+
+{% include plans-blockquote.html feature="Transform permissions" is_plural=true %}
+
+Transform permissions control who can manage and run [transforms](../data-studio/transforms/transforms-overview.md) on a database. Transform permissions can only be set on a database level, not on a table level.
+
+A group can only have transform permissions for a database if they also have "View data" and "Query builder and native" per for _all_ the tables in a database.
+
## Further reading
- [Permissions introduction](./introduction.md)