Skip to content

Commit 74f0afb

Browse files
author
Metabase Docs bot
committed
[auto] adding content to poc-transform-table->master
1 parent c10b273 commit 74f0afb

File tree

148 files changed

+11823
-11831
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

148 files changed

+11823
-11831
lines changed

_docs/master/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ With your data connected, get started asking questions, creating dashboards, and
4242

4343
### [A tour of Metabase](/learn/metabase-basics/overview/tour-of-metabase)
4444

45-
Metabase is a deep product with a lot of tools to simplify business intelligence, from embeddable charts and interactive dashboards, to GUI and SQL editors, to auditing and row and column security, and more.
45+
Metabase is a deep product with a lot of tools to simplify business intelligence, from embeddable charts and interactive dashboards, to GUI and SQL editors, to auditing and data sandboxing, and more.
4646

4747
## Documentation topics
4848

@@ -189,8 +189,8 @@ Metabase's reference documentation.
189189
- [Data permissions](./permissions/data)
190190
- [Collection permissions](./permissions/collections)
191191
- [Application permissions](./permissions/application)
192-
- [Row and column security](./permissions/row-and-column-security)
193-
- [Row and column security examples](./permissions/row-and-column-security-examples)
192+
- [Data sandboxes](./permissions/data-sandboxes)
193+
- [Data sandbox examples](./permissions/data-sandbox-examples)
194194
- [Connection impersonation](./permissions/impersonation)
195195
- [Database routing](./permissions/database-routing)
196196
- [Snippets folder permissions](./permissions/snippets)

_docs/master/configuring-metabase/caching.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ If you select "Don't cache results" for a question, dashboard, or database, Meta
8181

8282
{% include plans-blockquote.html feature="Refresh cache automatically" %}
8383

84-
> **Refreshing the cache automatically doesn't apply when [row and column security](../permissions/row-and-column-security) or [connection impersonation](../permissions/impersonation) permissions are in effect.** In those permissions setups, Metabase ignores the automatically generated cache and runs a fresh query (which it will then cache). So _caching_ still works for row and column security and impersonation, it's just that this preemptive, automatic caching doesn't apply in these cases, as those permissions setups filter data specific to each viewer.
84+
> **Refreshing the cache automatically doesn't apply when [data sandboxing](../permissions/data-sandboxes) or [connection impersonation](../permissions/impersonation) permissions are in effect.** In those permissions setups, Metabase ignores the automatically generated cache and runs a fresh query (which it will then cache). So _caching_ still works for sandboxing and impersonation, it's just that this preemptive, automatic caching doesn't apply in these cases, as those permissions setups filter data specific to each viewer.
8585
8686
If you turn on refresh cache automatically for a question or dashboard, Metabase will rerun the query/queries as soon as the cache is invalidated by whichever caching policy you've set. Normally, Metabase only refreshes the cache when someone views the item _after_ its cache has expired. So, normally, when the cache has expired, the next person to view the question will be stuck waiting for the query to run and refresh the cache. But by automatically refreshing results to update the cache, the loading times will always be as fast as possible, and people will always get valid, cached results.
8787

@@ -144,8 +144,8 @@ To set a caching policy for a question, you must have [curate access](../permiss
144144
1. Go to your question.
145145
2. Click on the three-dot menu **...** and select **Edit settings**.
146146
3. Under **Caching**, select the [caching invalidation policy](#cache-invalidation-policies).
147-
4. Optional: if you select a Duration or Schedule policy, you'll have the option to [refresh cache automatically](#refresh-cache-automatically).
148-
5. Save your changes.
147+
5. Optional: if you select a Duration or Schedule policy, you'll have the option to [refresh cache automatically](#refresh-cache-automatically).
148+
6. Save your changes.
149149

150150
## How dashboard, question, database, and default caching policies interact
151151

_docs/master/configuring-metabase/config-template.md

Lines changed: 39 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ clojure -M:doc:ee config-template
1919

2020
The template lists example `database`, `user`, and `settings` sections for the [config file](./config-file).
2121

22+
2223
```yaml
2324
# A config file template for Metabase.
2425
# You'll need to update (or remove) the `users` and `databases` sections.
@@ -33,45 +34,45 @@ The template lists example `database`, `user`, and `settings` sections for the [
3334
version: 1
3435
config:
3536
users:
36-
- first_name: First
37-
last_name: Person
38-
password: metabot1
39-
40-
- first_name: Normal
41-
last_name: Person
42-
password: metabot1
43-
44-
- first_name: Admin
45-
last_name: Person
46-
password: metabot1
47-
is_superuser: true
48-
37+
- first_name: First
38+
last_name: Person
39+
password: metabot1
40+
41+
- first_name: Normal
42+
last_name: Person
43+
password: metabot1
44+
45+
- first_name: Admin
46+
last_name: Person
47+
password: metabot1
48+
is_superuser: true
49+
4950
databases:
50-
- name: Sample PostgreSQL
51-
engine: postgres
52-
details:
53-
host: postgres-data
54-
port: 5432
55-
user: metabase
56-
password: metasample123
57-
dbname: sample
58-
- name: Sample MySQL
59-
engine: mysql
60-
details:
61-
host: mysql-data
62-
port: 3306
63-
user: metabase
64-
password: metasample123
65-
dbname: sample
51+
- name: Sample PostgreSQL
52+
engine: postgres
53+
details:
54+
host: postgres-data
55+
port: 5432
56+
user: metabase
57+
password: metasample123
58+
dbname: sample
59+
- name: Sample MySQL
60+
engine: mysql
61+
details:
62+
host: mysql-data
63+
port: 3306
64+
user: metabase
65+
password: metasample123
66+
dbname: sample
6667
api-keys:
67-
- name: Admin API key
68-
group: admin
69-
70-
key: mb_firsttestapikey123
71-
- name: All Users API key
72-
group: all-users
73-
74-
key: mb_secondtestapikey456
68+
- name: Admin API key
69+
group: admin
70+
71+
key: mb_firsttestapikey123
72+
- name: All Users API key
73+
group: all-users
74+
75+
key: mb_secondtestapikey456
7576
settings:
7677
admin-email: null
7778
aggregated-query-row-limit: null
@@ -175,7 +176,7 @@ config:
175176
jwt-identity-provider-uri: null
176177
jwt-shared-secret: null
177178
jwt-user-provisioning-enabled: true
178-
landing-page: ""
179+
landing-page: ''
179180
landing-page-illustration: default
180181
landing-page-illustration-custom: null
181182
ldap-attribute-email: mail

_docs/master/configuring-metabase/email.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ Check if [email quotas](https://docs.aws.amazon.com/ses/latest/dg/quotas.html) a
146146

147147
Allowed email address domain(s) for new [dashboard subscriptions](../dashboards/subscriptions) and [alerts](../questions/alerts).
148148

149-
Adding approved domains allows you to restrict which email addresses people can send alerts and subscriptions to. This restriction only applies to sending email to people who lack an account with that Metabase. People with Metabase accounts who aren't [restricted by row or column security](../permissions/row-and-column-security) will be able to email any other person with an account in that same Metabase.
149+
Adding approved domains allows you to restrict which email addresses people can send alerts and subscriptions to. This restriction only applies to sending email to people who lack an account with that Metabase. People with Metabase accounts who aren't [sandboxed](../permissions/data-sandboxes) will be able to email any other person with an account in that same Metabase.
150150

151151
To allow all domains, leave the field empty (allowing all domains is the default).
152152

@@ -168,7 +168,7 @@ Options include:
168168
- Only suggest users in the same groups
169169
- Don't show suggestions
170170

171-
People with [row or column restrictions](../permissions/row-and-column-security) won't see suggestions.
171+
People who are sandboxed won't see suggestions.
172172

173173
## Further reading
174174

_docs/master/configuring-metabase/localization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ Report timezone is only supported for the following databases:
121121

122122
### First day of the week
123123

124-
If you need to, you can change the first day of the week for your instance (the default is Sunday).
124+
If you need to, you can change the first day of the week for your instance (the default is Sunday).
125125

126126
Setting the first day of the week affects how the [query builder](../questions/query-builder/editor) filters or groups by week. People can, however, use the `week` function to override this default when filtering or grouping by week of year. See [using a different first week of the year](../questions/query-builder/expressions/week#using-a-different-first-week-of-the-year).
127127

_docs/master/configuring-metabase/slack.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,6 @@ It can take a little time for metabase to see all the channels the app has been
9191

9292
In order for metabase to see private channels, the app must have the `groups:read` oauth scope. Although this scope should be granted when setting up the app through metabase, older installations might not have this scope.
9393
If you think this might be the case [visit the app settings in slack](https://api.slack.com/apps/):
94-
9594
- Click on the metabase app in the app listing.
9695
- Click on **OAuth & Permissions** in the sidebar.
9796
- Under **Scopes** add the `groups:read` scope.

_docs/master/dashboards/filters.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ There are two basic types of widgets you can add. The type of filter or paramete
3535

3636
### Parameter widgets
3737

38-
**Parameters** determine _how_ to show the data. The time grouping parameter, for example, changes the granularity of time-based visualizations (like showing data by month instead of by day) without removing any data points.
38+
**Parameters** determine _how_ to show the data. The time grouping parameter, for example, changes the granularity of time-based visualizations (like showing data by month instead of by day) without removing any data points.
3939

4040
- [Time grouping](#time-grouping-parameter)
4141

@@ -45,13 +45,12 @@ There are two basic types of widgets you can add. The type of filter or paramete
4545

4646
1. Click the **pencil icon** to enter dashboard editing mode.
4747
2. You can add a filter or parameter widget to:
48-
49-
- **The whole dashboard**. You'll need to connect these dashboard-level filters to individual cards. Metabase will only display dashboard-level widgets if they're connected to a card on the current tab.
50-
- **Heading cards**. Not text cards, only [heading cards](./introduction#adding-headings-or-descriptions-with-text-cards). Can only be connected to cards on the current tab.
51-
- **Question cards**. Can only be connected to cards on the current tab.
52-
48+
49+
- **The whole dashboard**. You'll need to connect these dashboard-level filters to individual cards. Metabase will only display dashboard-level widgets if they're connected to a card on the current tab.
50+
- **Heading cards**. Not text cards, only [heading cards](./introduction#adding-headings-or-descriptions-with-text-cards). Can only be connected to cards on the current tab.
51+
- **Question cards**. Can only be connected to cards on the current tab.
52+
5353
Go to where you want to add a filter and click the **filter icon**.
54-
5554
3. Select a [filter type](#filter-and-parameter-widgets).
5655
4. [Connect your filter or parameter widget to one or more dashboard cards](#connecting-a-filter-or-parameter-widget-to-dashboard-cards). Only dashboard-level widgets can be connected to cards on multiple tabs.
5756
5. [Configure your filter](#editing-a-filter).
@@ -190,7 +189,7 @@ To undo this auto-connecting of cards, click on the toast that pops up when Meta
190189

191190
## Filtering dashboards with native/SQL questions
192191

193-
For filters, you'll need to [add a variable or field filter to your query](../questions/native-editor/sql-parameters).
192+
For filters, you'll need to [add a variable or field filter to your query](../questions/native-editor/sql-parameters).
194193

195194
For parameters, check out [Time grouping parameters](../questions/native-editor/time-grouping-parameters).
196195

_docs/master/dashboards/introduction.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -236,7 +236,7 @@ You can change the width of a dashboard by going into the three dots menu in the
236236
- **Fixed width** (default). Metabase will restrict the layout to a fixed width in the center of the screen. This fixed width can keep dashboard layouts consistent between smaller laptop screens and larger desktop screens.
237237
- **Full width**. The layout and cards will expand to take up the full width of the screen.
238238

239-
## Editing dashboard cards
239+
## Editing dashboard cards
240240

241241
To edit a card's:
242242

@@ -274,7 +274,7 @@ If you want to revert a dashboard card to its original visualization settings (i
274274

275275
1. Go to your dashboard and click the **pencil icon** to go into edit mode.
276276
2. Hover over the card (question) that you want to edit.
277-
3. Click the **palette icon** to bring up the visualization settings for that card.
277+
3. Click the **palette icon** to bring up the visualization settings for that card.
278278
4. Click **Reset to defaults** (bottom right).
279279
5. Click **Done** to save the card's visualization settings.
280280
6. Click **Save** to save the dashboard.
@@ -318,7 +318,7 @@ If your Metabase administrator has enabled [public sharing](../embedding/public-
318318

319319
![Share icon](./images/share-icon.png)
320320

321-
Public links can be viewed by anyone, even if they don't have access to Metabase. You can also use the public embedding code to embed your question or dashboard in a simple web page or blog post. Check out examples of simple apps with embedded dashboards in our [embedding-reference-apps repository](https://github.com/metabase/embedding-reference-apps). To learn more about [embedding](../embedding/introduction), check out our article on [How to use Metabase to deliver analytics to your customers](/learn/metabase-basics/embedding/overview), as well as an article on how to combine branding, Single Sign-On, full app embedding, and row and column security to deliver [multi-tenant, self-service analytics](/learn/metabase-basics/embedding/multi-tenant-self-service-analytics).
321+
Public links can be viewed by anyone, even if they don't have access to Metabase. You can also use the public embedding code to embed your question or dashboard in a simple web page or blog post. Check out examples of simple apps with embedded dashboards in our [embedding-reference-apps repository](https://github.com/metabase/embedding-reference-apps). To learn more about [embedding](../embedding/introduction), check out our article on [How to use Metabase to deliver analytics to your customers](/learn/metabase-basics/embedding/overview), as well as an article on how to combine branding, Single Sign-On, full app embedding, and data sandboxing to deliver [multi-tenant, self-service analytics](/learn/metabase-basics/embedding/multi-tenant-self-service-analytics).
322322

323323
## Exporting results from a dashboard
324324

_docs/master/dashboards/multiple-series.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ You can layer multiple questions on a single dashboard card. You can even layer
5252

5353
![Edit visualization](./images/edit-visualization.png)
5454

55-
4. **Add more data**. In the Manage data sidebar on the left, click on **Add more data**.
55+
4. **Add more data**. In the Manage data sidebar on the left, click on **Add more data**.
5656

5757
![Manage data sidebar](./images/add-data.png)
5858

_docs/master/data-modeling/formatting.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ You can override the global defaults for a specific field by going to the `Table
2828

2929
## Formatting options depend on the data type and the semantic type
3030

31-
The options you'll see here will depend on the field's data type and it's [semantic type](./semantic-types).
31+
The options you'll see here will depend on the field's data type and it's [semantic type](./semantic-types).
3232

3333
## Text formatting options
3434

@@ -38,11 +38,11 @@ Options depend on the [semantic type](./semantic-types) you select for the field
3838

3939
### Align
4040

41-
Whether to display the values in the middle, left, or right in table cells.
41+
Whether to display the values in the middle, left, or right in table cells.
4242

4343
### Display As
4444

45-
If you have text, like an image URL, you may need to change the semantic type before Metabase will offer you the option to display the text as an image.
45+
If you have text, like an image URL, you may need to change the semantic type before Metabase will offer you the option to display the text as an image.
4646

4747
- Text (display "as is").
4848
- Email link (i.e., if you have a `mailto` link).
@@ -94,7 +94,7 @@ This lets you choose if this time field should be displayed by default without t
9494

9595
- **Off** - Display only the date without time
9696
- **HH:MM** - Display hours and minutes
97-
- **HH:MM:SS** - Display hours, minutes, and seconds
97+
- **HH:MM:SS** - Display hours, minutes, and seconds
9898
- **HH:MM:SS.MS** - Display hours, minutes, seconds, and milliseconds
9999

100100
### Time style
@@ -129,7 +129,7 @@ Only applies to table visualizations. Displays a bar for each value to show larg
129129
Lets you choose to display the number as a plain number, a percent, in scientific notation, or as a currency.
130130

131131
- **Normal** - Display as a regular number
132-
- **Percent** - Display as a percentage
132+
- **Percent** - Display as a percentage
133133
- **Scientific notation** - Display in scientific format (e.g., 1.23e+4)
134134
- **Currency** - Display with currency formatting
135135

0 commit comments

Comments
 (0)