Skip to content
Snippets Groups Projects
Unverified Commit 64f82436 authored by Jeff Bruemmer's avatar Jeff Bruemmer Committed by GitHub
Browse files

docs - updates for 50 (#44002)

parent 28fc3320
No related merge requests found
......@@ -226,7 +226,7 @@ Combining fullscreen mode and auto refresh is a great way to keep your team in s
{% include plans-blockquote.html feature="Caching dashboard results" %}
See [Caching per dashboard](../configuring-metabase/caching.md#caching-per-dashboard).
See [Caching per dashboard](../configuring-metabase/caching.md#dashboard-caching-policy).
## Sharing dashboards with public links
......
......@@ -58,7 +58,7 @@ To refresh a model's results, go to the model and click on the **i** info icon.
## View model persistence logs
You can view the logs for model caching by clicking on the **gear** icon in the upper right and selecting **Admin settings** > **Tools** > **Model caching logs**. See [Admin tools](../usage-and-performance-tools/tools.md).
You can view the logs for model persistence by clicking on the **gear** icon in the upper right and selecting **Admin settings** > **Tools** > **Model caching logs**. See [Admin tools](../usage-and-performance-tools/tools.md).
## Difference between persisted models and caching
......
......@@ -77,7 +77,7 @@ CSV files cannot exceed 50 MB in size.
> While Metabase limits uploads to 50 MB, the server you use to run your Metabase may impose a lower limit. For example, the default client upload limit for [NGINX is 1 MB](https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size). So you may need to change your server settings to allow uploads up to 50 MB. People on Metabase Cloud don't have to worry about this.
If you have a file larger than 50 MB, the workaround here is to split the data into multiple and [append those files to an existing model](../exploration-and-organization/collections.md#appending-to-a-model-created-by-an-upload).
If you have a file larger than 50 MB, the workaround here is to split the data into multiple and [append those files to an existing model](../exploration-and-organization/uploads.md#appending-to-a-model-created-by-an-upload)
## Date formats
......
......@@ -8,12 +8,12 @@ We recommend creating a `metabase` database user with the following database rol
- [`analytics` for read access](#minimum-database-privileges) to any schemas or tables used for analysis.
- Optional [`metabase_actions` for write access](#privileges-to-enable-actions) to tables used for Metabase actions.
- Optional [`metabase_model_caching` for write access](#privileges-to-enable-model-caching) to the schema used for Metabase model caching.
- Optional [`metabase_model_persistence` for write access](#privileges-to-enable-model-persistence) to the schema used for Metabase model persistence.
Bundling your privileges into roles based on use cases makes it easier to manage privileges in the future (especially in [multi-tenant situations](#multi-tenant-permissions)). For example, you could:
- Use the same `analytics` role for other BI tools in your [data stack](https://www.metabase.com/learn/databases/data-landscape#data-analysis-layer) that need read-only access to the analytics tables in your database.
- Revoke the write access for `metabase_model_caching` without affecting the write access for `metabase_actions`.
- Revoke the write access for `metabase_model_persistence` without affecting the write access for `metabase_actions`.
## Minimum database privileges
......@@ -107,31 +107,31 @@ GRANT INSERT, UPDATE, DELETE ON "your_table" IN SCHEMA "your_schema" TO metabase
GRANT metabase_actions TO metabase;
```
## Privileges to enable model caching
## Privileges to enable model persistence
[Model caching](../data-modeling/models.md#model-caching) lets Metabase save query results to a specific schema in your database. Metabase's database user will need the `CREATE` privilege to set up the dedicated schema for model caching, as well as write access (`INSERT`, `UPDATE`, `DELETE`) to that schema.
[Model persistence](../data-modeling/model-persistence.md) lets Metabase save query results to a specific schema in your database. Metabase's database user will need the `CREATE` privilege to set up the dedicated schema for model caching, as well as write access (`INSERT`, `UPDATE`, `DELETE`) to that schema.
In addition to the [minimum database privileges](#minimum-database-privileges):
- Create a new role called `metabase_model_caching`.
- Create a new role called `metabase_model_persistence`.
- Give the role `CREATE` access to the database.
- Give the role `INSERT`, `UPDATE`, and `DELETE` privileges to the schema used for model caching.
- Give the `metabase_model_caching` role to the `metabase` user.
- Give the role `INSERT`, `UPDATE`, and `DELETE` privileges to the schema used for model persistence.
- Give the `metabase_model_persistence` role to the `metabase` user.
```sql
-- Create a role to bundle database privileges for Metabase model caching.
CREATE ROLE metabase_model_caching WITH LOGIN;
-- Create a role to bundle database privileges for Metabase model persistence.
CREATE ROLE metabase_model_persistence WITH LOGIN;
-- If you don't want to give CREATE access to your database,
-- add the schema manually before enabling modeling caching.
-- add the schema manually before enabling modeling persistence.
GRANT CREATE ON "database" TO metabase_model_persistence;
 
-- Grant write privileges to the SCHEMA used for model caching.
 
-- Grant write privileges to the SCHEMA used for model persistence.
GRANT USAGE ON "your_schema" TO metabase_model_persistence;
GRANT INSERT, UPDATE, DELETE ON "your_model's_table" IN SCHEMA "your_schema" TO metabase_model_persistence;
-- Grant role to the metabase user.
-- Grant role to the metabase user.
GRANT metabase_model_persistence TO metabase;
```
## Privileges to enable uploads
......
......@@ -40,7 +40,7 @@ Instead of deleting a model and recreating it, you can replace the underlying da
Like appending to uploaded models, replacing the uploaded CSV data with a new CSV file requires the columns and headings to match.
If you [delete the uploaded table](../databases/uploads.md#deleting-uploaded-tables), you won't be able to replace the model's data.
If you [delete the uploaded table](../databases/uploads.md#deleting-tables-created-by-uploads), you won't be able to replace the model's data.
## Further reading
......
......@@ -79,9 +79,9 @@ Tools for keeping your Metabase organized, so people can find your most importan
All Metabase editions include global caching controls. Paid plans includes additional caching options that let you control caching for individual questions.
- [Caching questions](../configuring-metabase/caching.md#caching-per-question)
- [Caching dashboards](../configuring-metabase/caching.md#caching-per-dashboard)
- [Caching databases](../configuring-metabase/caching.md#caching-per-database)
- [Caching questions](../configuring-metabase/caching.md#question-caching-policy)
- [Caching dashboards](../configuring-metabase/caching.md#dashboard-caching-policy)
- [Caching databases](../configuring-metabase/caching.md#database-caching-policy)
## Model persistence for individual models
......
......@@ -53,7 +53,7 @@ Open the **three dot** (...) menu to:
Click the **info** icon to:
- Add a description
- Edit the [cache duration](../../configuring-metabase/caching.md#caching-per-question)\*
- Edit the [cache duration](../../configuring-metabase/caching.md#question-caching-policy)\*
- View [revision history](../../exploration-and-organization/history.md)
\* Available on [paid plans](https://www.metabase.com/pricing/).
......@@ -74,7 +74,7 @@ To use a saved question as the basis for another question, you can:
{% include plans-blockquote.html feature="Caching question results" %}
See [Caching per question](../../configuring-metabase/caching.md#caching-per-question).
See [Caching per question](../../configuring-metabase/caching.md#question-caching-policy).
## Sharing questions with public links
......
......@@ -19,6 +19,8 @@ To see what's new, check out all the [major release announcements](https://www.m
## Metabase Enterprise Edition releases
- [v1.50.0](https://github.com/metabase/metabase/releases/tag/v1.50.0)
- [v1.49.15](https://github.com/metabase/metabase/releases/tag/v1.49.15)
- [v1.49.14](https://github.com/metabase/metabase/releases/tag/v1.49.14)
- [v1.49.13](https://github.com/metabase/metabase/releases/tag/v1.49.13)
- [v1.49.12](https://github.com/metabase/metabase/releases/tag/v1.49.12)
......@@ -168,6 +170,8 @@ To see what's new, check out all the [major release announcements](https://www.m
## Metabase Open Source Edition releases
- [v0.50.0](https://github.com/metabase/metabase/releases/tag/v0.50.0)
- [v0.49.15](https://github.com/metabase/metabase/releases/tag/v0.49.15)
- [v0.49.14](https://github.com/metabase/metabase/releases/tag/v0.49.14)
- [v0.49.13](https://github.com/metabase/metabase/releases/tag/v0.49.13)
- [v0.49.12](https://github.com/metabase/metabase/releases/tag/v0.49.12)
......
......@@ -111,7 +111,7 @@ If you can’t solve your problem using the troubleshooting guides:
[block-data-permission]: ../permissions/data.md#blocked-view-data-permission
[cant-see-tables]: ./cant-see-tables.md
[collection-permissions]: ../permissions/collections.md
[data-access]: ../permissions/data.md#data-permissions
[data-access]: ../permissions/data.md#data-permission-types
[data-permissions]: ../permissions/data.md
[discourse]: https://discourse.metabase.com/
[groups]: ../people-and-groups/managing.md#groups
......
......@@ -25,8 +25,8 @@ If your changes to a model's metadata or underlying question aren't showing up:
## Model performance is poor
1. Use model persistence.
- Metabase can [write back to your data warehouse][model-caching]. If you enable model caching, Metabase will read a pre-computed and materialized version of the model directly from the database instead of running the query from scratch. Please consider this option is only available in some supported data warehouses.
- Metabase can [write back to your data warehouse][model-persistence]. If you enable model persistence, Metabase will read a pre-computed and materialized version of the model directly from the database instead of running the query from scratch. Please consider this option is only available in some supported data warehouses.
2. Optimize the underlying saved question or SQL query.
......@@ -75,4 +75,4 @@ If you can’t solve your problem using the troubleshooting guides:
[sql-explain-learn]: https://www.metabase.com/learn/sql-questions/sql-best-practices.html#explain
[summary-tables-learn]: https://www.metabase.com/learn/administration/making-dashboards-faster.html#aggregate-data-ahead-of-time-with-summary-tables
[troubleshooting-sandboxing]: ./sandboxing.md
[model-caching]: https://www.metabase.com/docs/latest/data-modeling/models#model-caching
[model-persistence]: https://www.metabase.com/docs/latest/data-modeling/model-persistence
......@@ -24,9 +24,9 @@ You can select and rerun multiple questions at a time while you troubleshoot to
Here you can view the:
- [Models](../data-modeling/models.md) being cached,
- The status of the last caching query,
- When the model was last cached,
- And who created the cache.
- [Models](../data-modeling/models.md) being persisted
- The status of the last model query refresh
- When the model was last refreshed
- And who created the persisted model
You can also click the refresh icon to rerun the model's query to update its cache.
You can also click the refresh icon to rerun the model's query to update its results.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment