v0.55

环境变量

本文档通过运行以下命令从源代码生成

clojure -M:ee:doc environment-variables-documentation

Metabase 中的许多设置可以在管理面板中查看和修改，也可以通过环境变量设置。环境变量始终优先。请注意，与在 Metabase 管理设置中配置的设置不同，环境变量不会写入应用程序数据库。

如何设置环境变量

环境变量的设置方式因您运行 Metabase 的方式而异。

JAR 文件

# Mac, Linux and other Unix-based systems
export MB_SITE_NAME="Awesome Company"
# Windows Powershell
$env:MB_SITE_NAME="Awesome Company"
# Windows batch/cmd
set MB_SITE_NAME="Awesome Company"

java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

或者将其设置为 Java 属性，这在所有系统上都适用

java -DMB_SITE_NAME="Awesome Company" -jar metabase.jar

Docker

docker run -d -p 3000:3000 -e MB_SITE_NAME="Awesome Company" --name metabase metabase/metabase

Metabase 云版上的环境变量

如果您正在运行 Metabase 云版，您可以联系支持来调整 Metabase 的环境变量。

环境变量列表

`MB_ADMIN_EMAIL`

类型：字符串
默认值：null
配置文件名：admin-email

用户遇到问题时应联系的电子邮件地址。

`MB_AGGREGATED_QUERY_ROW_LIMIT`

类型：整数
默认值：10000
导出为：aggregated-query-row-limit。
配置文件名：aggregated-query-row-limit

通过 API 为聚合查询返回的最大行数。

必须小于 1048575。另请参阅 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

`MB_AI_PROXY_BASE_URL`

类型：字符串
默认值：https://:8000

AI 代理服务的 URL。

`MB_ALLOWED_IFRAME_HOSTS`

类型：字符串
默认值：youtube.com, youtu.be, loom.com, vimeo.com, docs.google.com, calendar.google.com, airtable.com, typeform.com, canva.com, codepen.io, figma.com, grafana.com, miro.com, excalidraw.com, notion.com, atlassian.com, trello.com, asana.com, gist.github.com, linkedin.com, twitter.com, x.com
导出为：allowed-iframe-hosts。
配置文件名：allowed-iframe-hosts

允许的 iframe 主机。

`MB_ANON_TRACKING_ENABLED`

类型：布尔值
默认值：true
配置文件名：anon-tracking-enabled

启用匿名使用数据收集，以帮助 Metabase 改进。

`MB_API_KEY`

类型：字符串
默认值：null

设置后，调用 /notify/ 端点需要此密钥。

此中间件通过请求头 X-Metabase-Apikey 对 /notify 端点的客户端进行验证。如果请求头可用，则会根据 MB_API_KEY 进行验证。如果匹配，请求将继续；否则，将以 403 Forbidden 响应阻止。MB_API_KEY 仅用于 /notify 端点，与用于认证其他 API 请求的 Metabase API 密钥不同。MB_API_KEY 可以是任意字符串。

`MB_APPLICATION_COLORS`

类型：JSON
默认值：{}
导出为：application-colors。
配置文件名：application-colors

选择 Metabase 用户界面中使用的颜色以及专门用于图表的颜色。您需要刷新浏览器才能看到更改生效。

更改用户界面颜色

{
 "brand":"#ff003b",
 "filter":"#FF003B",
 "summarize":"#FF003B"
}

更改图表颜色

{
 "accent0":"#FF0005",
 "accent1":"#E6C367",
 "accent2":"#B9E68A",
 "accent3":"#8AE69F",
 "accent4":"#8AE6E4",
 "accent5":"#8AA2E6",
 "accent6":"#B68AE6",
 "accent7":"#E68AD0"
}

`MB_APPLICATION_FAVICON_URL`

类型：字符串
默认值：app/assets/img/favicon.ico
导出为：application-favicon-url。
配置文件名：application-favicon-url

上传文件作为网站图标。

`MB_APPLICATION_FONT`

类型：字符串
默认值：Lato
导出为：application-font。
配置文件名：application-font

将字体系列替换为“Lato”。

`MB_APPLICATION_FONT_FILES`

类型：JSON
默认值：null
导出为：application-font-files。
配置文件名：application-font-files

告诉我们每个字体粗细的文件在哪里。您无需包含所有文件，但如果包含，效果会更好。

示例值

[
  {
    "src": "https://example.com/resources/font-400",
    "fontFormat": "ttf",
    "fontWeight": 400
  },
  {
    "src": "https://example.com/resources/font-700",
    "fontFormat": "woff",
    "fontWeight": 700
  }
]

请参阅字体。

`MB_APPLICATION_LOGO_URL`

类型：字符串
默认值：app/assets/img/logo.svg
导出为：application-logo-url。
配置文件名：application-logo-url

上传文件以替换顶部栏上的 Metabase 标志。

不支持内联样式和内联脚本。

`MB_APPLICATION_NAME`

类型：字符串
默认值：Metabase
导出为：application-name。
配置文件名：application-name

替换所有出现“Metabase”字样的地方。

`MB_ATTACHMENT_ROW_LIMIT`

类型：正整数
默认值：null
导出为：attachment-row-limit。

文件附件中的行数限制（不包括标题）。

`MB_ATTACHMENT_TABLE_ROW_LIMIT`

类型：正整数
默认值：20

警报或订阅图像中渲染的最大行数。

范围：1-100。要限制电子邮件仪表板订阅的文件附件中包含的总行数，请使用 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

`MB_BCC_ENABLED`

类型：布尔值
默认值：true
配置文件名：bcc-enabled

是否启用密送 (bcc) 电子邮件，默认行为是启用。

`MB_BREAKOUT_BIN_WIDTH`

类型：双精度浮点数
默认值：10.0
配置文件名：breakout-bin-width

当对坐标类型（如纬度和经度）的字段使用默认分箱策略时，此数字将用作默认分箱宽度（以度为单位）。

`MB_BREAKOUT_BINS_NUM`

类型：整数
默认值：8
导出为：breakout-bins-num。
配置文件名：breakout-bins-num

当使用默认分箱策略且未提供分箱数量时，此数字将用作默认值。

`MB_CHECK_FOR_UPDATES`

类型：布尔值
默认值：true
配置文件名：check-for-updates

识别 Metabase 新版本何时可用。

`MB_CONFIG_FROM_FILE_SYNC_DATABASES`

类型：布尔值
默认值：true

在配置文件初始化期间是否（异步）同步新创建的数据库。默认情况下为 true，但如果您想手动同步或使用 SerDes 填充其数据模型，则可以禁用此行为。

`MB_CUSTOM_FORMATTING`

类型：JSON
默认值：{}
导出为：custom-formatting。
配置文件名：custom-formatting

按类型键控的对象，包含格式设置。

`MB_CUSTOM_GEOJSON`

类型：JSON
默认值：null
导出为：custom-geojson。
配置文件名：custom-geojson

包含自定义 GeoJSON 文件信息的 JSON，用于地图可视化，而不是默认的美国州或世界 GeoJSON。

`MB_CUSTOM_GEOJSON_ENABLED`

类型：布尔值
默认值：true
导出为：custom-geojson-enabled。
配置文件名：custom-geojson-enabled

是否启用自定义 GeoJSON 的使用。

`MB_CUSTOM_HOMEPAGE`

类型：布尔值
默认值：false
配置文件名：custom-homepage

选择一个仪表板作为主页。没有仪表板访问权限的用户将被定向到默认主页。

`MB_CUSTOM_HOMEPAGE_DASHBOARD`

类型：整数
默认值：null
配置文件名: custom-homepage-dashboard

用作主页的仪表板 ID。

`MB_DB_CONNECTION_TIMEOUT_MS`

类型：整数
默认值：10000

如果 metabase.driver/can-connect? / can-connect-with-details? 在此毫秒数后仍未能成功连接，则视为连接失败。默认值为 10 秒。

连接到数据库（包括 Metabase 应用程序数据库和数据连接）的超时时间（毫秒）。如果您通过 SSH 隧道连接并遇到超时，您可能会考虑增加此值，因为通过隧道的连接比不通过隧道的连接开销更大。

`MB_DB_QUERY_TIMEOUT_MINUTES`

类型：整数
默认值：20

默认值为 20 分钟。

数据库查询执行的超时时间（分钟），包括 Metabase 应用程序数据库和数据连接。如果您有长时间运行的查询，您可能会考虑增加此值。调整超时时间不会影响 Metabase 的前端。请注意，其他服务（如 Nginx）可能仍会中断长时间运行的查询。

`MB_DEFAULT_MAPS_ENABLED`

类型：布尔值
默认值：true
导出为: default-maps-enabled。
配置文件名: default-maps-enabled

是否启用默认的 GeoJSON 地图。

`MB_DOWNLOAD_ROW_LIMIT`

类型：正整数
默认值：null
导出为: download-row-limit。

文件导出中的行数限制，不包括标题行。强制最小值为 1048575 行（不包括标题行）。即使此限制更高，xlsx 下载本身也仅限于 1048575 行。

`MB_EE_AI_FEATURES_ENABLED`

类型：布尔值
默认值：false
配置文件名: ee-ai-features-enabled

启用 AI 功能。

此功能尚处于实验阶段。

`MB_EE_OPENAI_API_KEY`

类型：字符串
默认值：null
配置文件名: ee-openai-api-key

Metabase 企业版中使用的 OpenAI API 密钥。

此功能尚处于实验阶段。

`MB_EE_OPENAI_MODEL`

类型：字符串
默认值: gpt-4-turbo-preview
配置文件名: ee-openai-model

OpenAI 模型（例如“gpt-4”、“gpt-3.5-turbo”）。

此功能尚处于实验阶段。

`MB_EMAIL_FROM_ADDRESS`

类型：字符串
默认值: notifications@metabase.com
配置文件名: email-from-address

您希望用于电子邮件发件人的电子邮件地址。

`MB_EMAIL_FROM_NAME`

类型：字符串
默认值：null
配置文件名: email-from-name

您希望用于电子邮件发件人的名称。

`MB_EMAIL_MAX_RECIPIENTS_PER_SECOND`

类型：整数
默认值：null
导出为: email-max-recipients-per-second。
配置文件名: email-max-recipients-per-second

每秒发送的收件人总数上限（跨所有电子邮件）。请注意，如果最后一封发送的电子邮件有多个收件人，它可能会超出此限制。

`MB_EMAIL_REPLY_TO`

类型：JSON
默认值：null
配置文件名: email-reply-to

如果您希望回复地址与发件人地址不同，请填写此电子邮件地址。

`MB_EMAIL_SMTP_HOST`

类型：字符串
默认值：null
配置文件名: email-smtp-host

处理您的电子邮件的 SMTP 服务器地址。

`MB_EMAIL_SMTP_PASSWORD`

类型：字符串
默认值：null
配置文件名: email-smtp-password

SMTP 密码。

`MB_EMAIL_SMTP_PORT`

类型：整数
默认值：null
配置文件名: email-smtp-port

您的 SMTP 服务器用于发送邮件的端口。

`MB_EMAIL_SMTP_SECURITY`

类型: 关键字
默认值: :none
配置文件名: email-smtp-security

SMTP 安全连接协议。(tls, ssl, starttls, 或 none)。

`MB_EMAIL_SMTP_USERNAME`

类型：字符串
默认值：null
配置文件名: email-smtp-username

SMTP 用户名。

`MB_EMBEDDING_APP_ORIGIN [已弃用]`

类型：字符串
默认值：null
配置文件名: embedding-app-origin

允许此来源嵌入完整的 Metabase 应用程序。

`MB_EMBEDDING_APP_ORIGINS_INTERACTIVE`

类型：字符串
默认值：null
配置文件名: embedding-app-origins-interactive

允许这些以空格分隔的来源交互式嵌入 Metabase。

`MB_EMBEDDING_APP_ORIGINS_SDK`

类型：字符串
默认值: localhost:*
配置文件名: embedding-app-origins-sdk

允许 Metabase SDK 访问这些以空格分隔的来源。

`MB_EMBEDDING_HOMEPAGE`

类型: 关键字
默认值: :hidden
导出为: embedding-homepage。
配置文件名: embedding-homepage

嵌入式主页状态，指示其是否可见、隐藏或已被关闭。

`MB_EMBEDDING_SECRET_KEY`

类型：字符串
默认值：null
配置文件名: embedding-secret-key

用于为 /api/embed 端点请求签名 JSON Web 令牌的密钥。

`MB_ENABLE_EMBEDDING [已弃用]`

类型：布尔值
默认值：false
导出为: enable-embedding。
配置文件名: enable-embedding

允许管理员将问题和仪表板安全地嵌入到其他应用程序中吗？

`MB_ENABLE_EMBEDDING_INTERACTIVE`

类型：布尔值
默认值：false
配置文件名: enable-embedding-interactive

允许管理员通过交互式嵌入来嵌入 Metabase 吗？

`MB_ENABLE_EMBEDDING_SDK`

类型：布尔值
默认值：false
配置文件名: enable-embedding-sdk

允许管理员通过 SDK 嵌入 Metabase 吗？

`MB_ENABLE_EMBEDDING_STATIC`

类型：布尔值
默认值：false
配置文件名: enable-embedding-static

允许管理员通过静态嵌入来嵌入 Metabase 吗？

`MB_ENABLE_PASSWORD_LOGIN`

类型：布尔值
默认值：true
配置文件名: enable-password-login

允许通过电子邮件和密码登录。

`MB_ENABLE_PIVOTED_EXPORTS`

类型：布尔值
默认值：true
导出为: enable-pivoted-exports。
配置文件名: enable-pivoted-exports

启用旋转导出和旋转订阅。

`MB_ENABLE_PUBLIC_SHARING`

类型：布尔值
默认值：true
配置文件名: enable-public-sharing

允许管理员为问题和仪表板创建公开可见的链接（和可嵌入的 iframe）吗？

`MB_ENABLE_QUERY_CACHING`

类型：布尔值
默认值：true
配置文件名: enable-query-caching

允许缓存长时间运行的查询结果。

`MB_ENABLE_XRAYS`

类型：布尔值
默认值：true
导出为: enable-xrays。
配置文件名: enable-xrays

允许用户使用 X 光探索数据。

`MB_FOLLOW_UP_EMAIL_SENT`

类型：布尔值
默认值：false

我们是否已向实例管理员发送了后续电子邮件？

`MB_GOOGLE_AUTH_AUTO_CREATE_ACCOUNTS_DOMAIN`

类型：字符串
默认值：null
配置文件名: google-auth-auto-create-accounts-domain

设置后，如果用户的 Google 帐户电子邮件地址来自此域，则允许用户自行注册。

`MB_GOOGLE_AUTH_CLIENT_ID`

类型：字符串
默认值：null
配置文件名: google-auth-client-id

Google 登录的客户端 ID。

`MB_GOOGLE_AUTH_ENABLED`

类型：布尔值
默认值：null
配置文件名: google-auth-enabled

Google 登录当前是否已启用？

`MB_GSHEETS`

类型：JSON
默认值：null
导出为: gsheets。
配置文件名: gsheets

有关 Google 表格集成的信息。

`MB_HEALTH_CHECK_LOGGING_ENABLED`

类型：布尔值
默认值：true

是否记录来自会话中间件的健康检查请求。

`MB_HELP_LINK`

类型: 关键字
默认值: :metabase
配置文件名: help-link

用于控制帮助链接白标签的关键字设置。有效值为 :metabase、:hidden 和 :custom。如果设置为 :custom，则帮助链接将使用 help-link-custom-destination 中指定的 URL，如果未设置则隐藏。

`MB_HELP_LINK_CUSTOM_DESTINATION`

类型：字符串
默认值: https://metabase.net.cn/help/premium
配置文件名: help-link-custom-destination

帮助链接的自定义 URL。

`MB_HUMANIZATION_STRATEGY`

类型: 关键字
默认值: :simple
导出为: humanization-strategy。
配置文件名: humanization-strategy

为了使表格和字段名称更具人性化，Metabase 将用空格替换其中的破折号和下划线。同时，我们将每个单词的首字母大写，因此“last_visited_at”将变为“Last Visited At”。

`MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE`

类型：整数
默认值: 15

c3p0 连接池的最大大小。

如果您发现常规使用消耗了所有或几乎所有连接，请将其更改为更高的值。

当所有连接都在使用中时，Metabase 返回查询结果的速度会变慢，因为它必须等待可用连接才能处理队列中的下一个查询。

有关最大值设置，请参阅 MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE。

`MB_JWT_ATTRIBUTE_EMAIL`

类型：字符串
默认值: email
配置文件名: jwt-attribute-email

用于检索 JWT 用户电子邮件地址的键。

`MB_JWT_ATTRIBUTE_FIRSTNAME`

类型：字符串
默认值: first_name
配置文件名: jwt-attribute-firstname

用于检索 JWT 用户名字的键。

`MB_JWT_ATTRIBUTE_GROUPS`

类型：字符串
默认值: groups
配置文件名: jwt-attribute-groups

用于检索 JWT 用户组的键。

`MB_JWT_ATTRIBUTE_LASTNAME`

类型：字符串
默认值: last_name
配置文件名: jwt-attribute-lastname

用于检索 JWT 用户姓氏的键。

`MB_JWT_ENABLED`

类型：布尔值
默认值：false
配置文件名: jwt-enabled

JWT 身份验证是否已配置并启用？

设置为 true 时，将启用 JWT 身份验证，并使用 MB_JWT_* 变量中配置的选项。这适用于 JWT SSO 身份验证，与静态嵌入无关，静态嵌入是 MB_EMBEDDING_SECRET_KEY。

`MB_JWT_GROUP_MAPPINGS`

类型：JSON
默认值：{}
配置文件名: jwt-group-mappings

包含 JWT 到 Metabase 组映射的 JSON。

包含 JWT 到 Metabase 组映射的 JSON 对象，其中键是 JWT 组，值是 Metabase 组 ID 的列表。

`MB_JWT_GROUP_SYNC`

类型：布尔值
默认值：false
配置文件名: jwt-group-sync

启用与 JWT 的组成员身份同步。

`MB_JWT_IDENTITY_PROVIDER_URI`

类型：字符串
默认值：null
配置文件名: jwt-identity-provider-uri

基于 JWT 的登录页面 URL。如果仅与嵌入式分析 SDK 一起使用 JWT SSO，则可选。

`MB_JWT_SHARED_SECRET`

类型：字符串
默认值：null
配置文件名: jwt-shared-secret

用于播种用于验证 JWT 消息的私钥的字符串。强烈建议使用十六进制编码的 256 位密钥（即 64 个字符的字符串）。

`MB_JWT_USER_PROVISIONING_ENABLED`

类型：布尔值
默认值：true
配置文件名: jwt-user-provisioning-enabled

当我们启用 JWT 用户预配时，对于没有 Metabase 帐户的用户，我们会在 JWT 登录时自动为其创建 Metabase 帐户。

`MB_LANDING_PAGE`

类型：字符串
默认值: ``
导出为: landing-page。
配置文件名: landing-page

输入要显示给用户的着陆页 URL。这将覆盖上面的自定义主页设置。

`MB_LANDING_PAGE_ILLUSTRATION`

类型：字符串
默认值: default
导出为: landing-page-illustration。
配置文件名: landing-page-illustration

着陆页插图的显示选项。

`MB_LANDING_PAGE_ILLUSTRATION_CUSTOM`

类型：字符串
默认值：null
导出为: landing-page-illustration-custom。
配置文件名: landing-page-illustration-custom

着陆页的自定义插图。

`MB_LDAP_ATTRIBUTE_EMAIL`

类型：字符串
默认值: mail
配置文件名: ldap-attribute-email

用于用户电子邮件的属性。（通常为“mail”、“email”或“userPrincipalName”）。

`MB_LDAP_ATTRIBUTE_FIRSTNAME`

类型：字符串
默认值: givenName
配置文件名: ldap-attribute-firstname

用于用户名字的属性。（通常为“givenName”）。

`MB_LDAP_ATTRIBUTE_LASTNAME`

类型：字符串
默认值: sn
配置文件名: ldap-attribute-lastname

用于用户姓氏的属性。（通常为“sn”）。

`MB_LDAP_BIND_DN`

类型：字符串
默认值：null
配置文件名: ldap-bind-dn

要绑定为的专有名称（如果有），此用户将用于查找有关其他用户的信息。

`MB_LDAP_ENABLED`

类型：布尔值
默认值：false
配置文件名: ldap-enabled

LDAP 当前是否已启用？

`MB_LDAP_GROUP_BASE`

类型：字符串
默认值：null
配置文件名: ldap-group-base

组搜索基准。对于提供“memberOf”覆盖的 LDAP 目录（如 Active Directory）不是必需的。（将递归搜索）。

`MB_LDAP_GROUP_MAPPINGS`

类型：JSON
默认值：{}
配置文件名: ldap-group-mappings

包含 LDAP 到 Metabase 组映射的 JSON。

`MB_LDAP_GROUP_MEMBERSHIP_FILTER`

类型：字符串
默认值: (member={dn})
配置文件名: ldap-group-membership-filter

组员资格查找筛选器。占位符 {dn} 和 {uid} 将分别被用户的专有名称和 UID 替换。

`MB_LDAP_GROUP_SYNC`

类型：布尔值
默认值：false
配置文件名: ldap-group-sync

启用与 LDAP 的组成员资格同步。

`MB_LDAP_HOST`

类型：字符串
默认值：null
配置文件名: ldap-host

服务器主机名。

`MB_LDAP_PASSWORD`

类型：字符串
默认值：null
配置文件名: ldap-password

用于查找用户的绑定密码。

`MB_LDAP_PORT`

类型：整数
默认值: 389
配置文件名: ldap-port

服务器端口，如果使用 SSL 通常为 389 或 636。

`MB_LDAP_SECURITY`

类型: 关键字
默认值: :none
配置文件名: ldap-security

使用 SSL、TLS 或纯文本。

`MB_LDAP_SYNC_USER_ATTRIBUTES`

类型：布尔值
默认值：true
配置文件名: ldap-sync-user-attributes

当有人通过 LDAP 登录时，我们是否应该同步用户属性？

`MB_LDAP_SYNC_USER_ATTRIBUTES_BLACKLIST`

类型: csv
默认值: userPassword,dn,distinguishedName
配置文件名: ldap-sync-user-attributes-blacklist

以逗号分隔的用户属性列表，用于跳过 LDAP 用户的同步。

`MB_LDAP_USER_BASE`

类型：字符串
默认值：null
配置文件名: ldap-user-base

用户搜索基准。（将递归搜索）。

`MB_LDAP_USER_FILTER`

类型：字符串
默认值: (&(objectClass=inetOrgPerson)(|(uid={login})(mail={login})))
配置文件名: ldap-user-filter

用户查找筛选器。占位符“{login}”将被用户提供的登录名替换。

`MB_LDAP_USER_PROVISIONING_ENABLED`

类型：布尔值
默认值：true
配置文件名: ldap-user-provisioning-enabled

当我们启用 LDAP 用户预配时，对于没有 Metabase 帐户的用户，我们会在 LDAP 登录时自动为其创建 Metabase 帐户。

`MB_LOADING_MESSAGE`

类型: 关键字
默认值: :doing-science
导出为: loading-message。
配置文件名: loading-message

选择查询运行期间要显示的消息。可能的值为“doing-science”、“running-query”或“loading-results”。

`MB_LOGIN_PAGE_ILLUSTRATION`

类型：字符串
默认值: default
导出为: login-page-illustration。
配置文件名: login-page-illustration

登录页插图的显示选项。

`MB_LOGIN_PAGE_ILLUSTRATION_CUSTOM`

类型：字符串
默认值：null
导出为: login-page-illustration-custom。
配置文件名: login-page-illustration-custom

登录页的自定义插图。

`MB_MAP_TILE_SERVER_URL`

类型：字符串
默认值: https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
配置文件名: map-tile-server-url

地图可视化中使用的地图瓦片服务器 URL 模板，例如来自 OpenStreetMaps 或 MapBox。

`MB_NATIVE_QUERY_AUTOCOMPLETE_MATCH_STYLE`

类型: 关键字
默认值: :substring
导出为: native-query-autocomplete-match-style。
配置文件名: native-query-autocomplete-match-style

原生查询编辑器自动补全的匹配样式。可以是“substring”（子字符串）、“prefix”（前缀）或“off”（关闭）。大型实例在使用子字符串匹配时可能会出现性能问题，因此可以使用前缀匹配或关闭自动补全。

`MB_NESTED_FIELD_COLUMNS_VALUE_LENGTH_LIMIT`

类型：整数
默认值: 50000
导出为: nested-field-columns-value-length-limit。

JSON 字符串的最大长度，超过此长度在同步 JSON 展开时将跳过。如果设置过高，可能导致同步缓慢或内存不足错误。

`MB_NO_DATA_ILLUSTRATION`

类型：字符串
默认值: default
导出为: no-data-illustration。
配置文件名: no-data-illustration

运行问题后没有结果时显示插图的选项。

`MB_NO_DATA_ILLUSTRATION_CUSTOM`

类型：字符串
默认值：null
导出为: no-data-illustration-custom。
配置文件名: no-data-illustration-custom

运行问题后没有结果时的自定义插图。

`MB_NO_OBJECT_ILLUSTRATION`

类型：字符串
默认值: default
导出为: no-object-illustration。
配置文件名: no-object-illustration

搜索后没有结果时显示插图的选项。

`MB_NO_OBJECT_ILLUSTRATION_CUSTOM`

类型：字符串
默认值：null
导出为: no-object-illustration-custom。
配置文件名: no-object-illustration-custom

搜索后没有结果时的自定义插图。

`MB_NON_TABLE_CHART_GENERATED`

类型：布尔值
默认值：false
导出为: non-table-chart-generated。
配置文件名: non-table-chart-generated

是否已生成非表格图表。对于跟踪实例激活历程的分析是必需的。

`MB_NOT_BEHIND_PROXY`

类型：布尔值
默认值：false

指示 Metabase 是否在代理后面运行，该代理为传入请求设置了源地址头。

`MB_NOTIFICATION_LINK_BASE_URL`

类型：字符串
默认值：null

默认情况下，“站点 URL”用于通知链接，但可以覆盖。

仪表板通知链接将指向的基础 URL，而不是 Metabase 基础 URL。仅适用于使用交互式嵌入和订阅的用户。

`MB_NOTIFICATION_SYSTEM_EVENT_THREAD_POOL_SIZE`

类型：整数
默认值: 5

用于发送系统事件通知的线程池大小。

`MB_NOTIFICATION_THREAD_POOL_SIZE`

类型：整数
默认值: 3

用于发送通知的线程池大小。

如果 Metabase 停止发送警报等通知，可能是因为长时间运行的查询堵塞了通知队列。您可以通过增加通知专用线程池的大小来清除队列。

`MB_PERSISTED_MODEL_REFRESH_CRON_SCHEDULE`

类型：字符串
默认值: 0 0 0/6 * * ? *
配置文件名: persisted-model-refresh-cron-schedule

用于安排刷新持久化模型的 cron 语法字符串。

`MB_PERSISTED_MODELS_ENABLED`

类型：布尔值
默认值：false
导出为: persisted-models-enabled。
配置文件名: persisted-models-enabled

允许将模型持久化到源数据库。

`MB_PREMIUM_EMBEDDING_TOKEN`

类型：字符串
默认值：null
配置文件名: premium-embedding-token

高级功能的令牌。前往 MetaStore 获取您的令牌！

`MB_QUERY_ANALYSIS_ENABLED`

类型：布尔值
默认值：false
配置文件名: query-analysis-enabled

是否分析任何查询。

`MB_QUERY_CACHING_MAX_KB`

类型：整数
默认值: 2000
配置文件名: query-caching-max-kb

每份保存查询的缓存最大大小，单位为千字节。

`MB_QUERY_CACHING_MAX_TTL`

类型：双精度浮点数
默认值: 3024000.0
配置文件名: query-caching-max-ttl

保留任何缓存查询结果的绝对最大时间，单位为秒。

`MB_REDIRECT_ALL_REQUESTS_TO_HTTPS`

类型：布尔值
默认值：false
配置文件名: redirect-all-requests-to-https

如果站点 URL 为 HTTPS，则通过重定向强制所有流量使用 HTTPS。

`MB_REPORT_TIMEZONE`

类型：字符串
默认值：null
导出为: report-timezone。
配置文件名: report-timezone

执行查询时使用的连接时区。默认为系统时区。

`MB_RESET_TOKEN_TTL_HOURS`

类型：整数
默认值: 48

密码重置被视为有效的时数。

`MB_RETRY_INITIAL_INTERVAL`

类型：整数
默认值: 500
配置文件名: retry-initial-interval

初始重试延迟（毫秒）。

`MB_RETRY_MAX_ATTEMPTS`

类型：整数
默认值: 7
配置文件名: retry-max-attempts

事件的最大尝试次数。

`MB_RETRY_MAX_INTERVAL_MILLIS`

类型：整数
默认值: 30000
配置文件名: retry-max-interval-millis

尝试之间的最大延迟。

`MB_RETRY_MULTIPLIER`

类型：双精度浮点数
默认值: 2.0
配置文件名: retry-multiplier

尝试之间的延迟乘数。

`MB_RETRY_RANDOMIZATION_FACTOR`

类型：双精度浮点数
默认值: 0.1
配置文件名: retry-randomization-factor

重试延迟的随机化因子。

`MB_SAML_APPLICATION_NAME`

类型：字符串
默认值：Metabase
配置文件名: saml-application-name

此应用程序名称将用于向身份提供商发出的请求。

`MB_SAML_ATTRIBUTE_EMAIL`

类型：字符串
默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
配置文件名: saml-attribute-email

用于用户电子邮件地址的 SAML 属性。

`MB_SAML_ATTRIBUTE_FIRSTNAME`

类型：字符串
默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
配置文件名: saml-attribute-firstname

用于用户名字的 SAML 属性。

`MB_SAML_ATTRIBUTE_GROUP`

类型：字符串
默认值: member_of
配置文件名: saml-attribute-group

用于组同步的 SAML 属性。

`MB_SAML_ATTRIBUTE_LASTNAME`

类型：字符串
默认值: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
配置文件名: saml-attribute-lastname

用于用户姓氏的 SAML 属性。

`MB_SAML_ENABLED`

类型：布尔值
默认值：false
配置文件名: saml-enabled

SAML 身份验证是否已配置并启用？

`MB_SAML_GROUP_MAPPINGS`

类型：JSON
默认值：{}
配置文件名: saml-group-mappings

包含 SAML 到 Metabase 组映射的 JSON。

`MB_SAML_GROUP_SYNC`

类型：布尔值
默认值：false
配置文件名: saml-group-sync

启用与 SAML 的组成员身份同步。

`MB_SAML_IDENTITY_PROVIDER_CERTIFICATE`

类型：字符串
默认值：null
配置文件名: saml-identity-provider-certificate

身份提供商的编码证书。根据您的 IdP，您可能需要下载此证书，用文本编辑器打开它，然后复制并粘贴证书内容到此处。

`MB_SAML_IDENTITY_PROVIDER_ISSUER`

类型：字符串
默认值：null
配置文件名: saml-identity-provider-issuer

这是 IdP 的唯一标识符。通常被称为实体 ID 或简称为“颁发者”。根据您的 IdP，这通常类似于 http://www.example.com/141xkex604w0Q5PN724v。

`MB_SAML_IDENTITY_PROVIDER_SLO_URI`

类型：字符串
默认值：null
配置文件名: saml-identity-provider-slo-uri

这是您的用户退出身份提供商的 URL。根据您使用的 IdP，这通常类似于 https://your-org-name.example.com 或 https://example.com/app/my_saml_app/abc123/sso/slo。

`MB_SAML_IDENTITY_PROVIDER_URI`

类型：字符串
默认值：null
配置文件名: saml-identity-provider-uri

这是您的用户登录身份提供商的 URL。根据您使用的 IdP，这通常类似于 https://your-org-name.example.com 或 https://example.com/app/my_saml_app/abc123/sso/saml。

`MB_SAML_KEYSTORE_ALIAS`

类型：字符串
默认值: metabase
配置文件名: saml-keystore-alias

Metabase 用于签署 SAML 请求的密钥别名。

`MB_SAML_KEYSTORE_PASSWORD`

类型：字符串
默认值: changeit
配置文件名: saml-keystore-password

用于打开密钥库的密码。

`MB_SAML_KEYSTORE_PATH`

类型：字符串
默认值：null
配置文件名: saml-keystore-path

用于签署 SAML 请求的密钥库文件的绝对路径。

`MB_SAML_SLO_ENABLED`

类型：布尔值
默认值：false
配置文件名: saml-slo-enabled

是否启用 SAML 单点注销？

`MB_SAML_USER_PROVISIONING_ENABLED`

类型：布尔值
默认值：true
配置文件名: saml-user-provisioning-enabled

当我们启用 SAML 用户预配时，对于没有 Metabase 帐户的用户，我们会在 SAML 登录时自动为其创建 Metabase 帐户。

`MB_SCIM_ENABLED`

类型：布尔值
默认值：null
配置文件名: scim-enabled

SCIM 当前是否已启用？

`MB_SDK_ENCRYPTION_VALIDATION_KEY`

类型：字符串
默认值：null

用于加密和检查 SDK 请求是否已签名。

`MB_SEARCH_ENGINE`

类型: 关键字
默认值: :in-place

执行搜索时使用的引擎。支持的值为 :in-place 和 :appdb。

`MB_SEARCH_LANGUAGE`

类型：字符串
默认值：null

当对 postgresql 使用 appdb 引擎时，覆盖 to_tsvector 中用于词干提取的语言。值必须是数据库中有效的已配置语言选项，例如“english”或“simple”。

`MB_SEARCH_TYPEAHEAD_ENABLED`

类型：布尔值
默认值：true
导出为: search-typeahead-enabled。
配置文件名: search-typeahead-enabled

在 Metabase 导航栏中启用预输入搜索吗？

`MB_SEND_NEW_SSO_USER_ADMIN_EMAIL`

类型：布尔值
默认值：null
配置文件名: send-new-sso-user-admin-email

是否应向管理员发送所有新 SSO 用户的电子邮件通知？

`MB_SESSION_COOKIE_SAMESITE`

类型: 关键字
默认值: :lax
配置文件名: session-cookie-samesite

会话 Cookie 的 SameSite 指令值。

请参阅在不同域中嵌入 Metabase。了解更多关于交互式嵌入的信息。了解更多关于 SameSite cookies 的信息。

`MB_SESSION_COOKIES`

类型：布尔值
默认值：null
配置文件名: session-cookies

设置后，强制所有用户使用会话 Cookie，这些 Cookie 在浏览器关闭时过期。

用户登录会话将始终在 MAX_SESSION_AGE（默认 2 周）定义的时间后过期。这将覆盖登录时的“记住我”复选框。另请参阅更改会话过期文档页面。

`MB_SESSION_TIMEOUT`

类型：JSON
默认值：null
配置文件名: session-timeout

非活跃用户注销前的时间。默认情况下，会话无限期有效。

必须采用 JSON 格式 "{"amount":120,"unit":"minutes"}"，其中单位为“seconds”、“minutes”或“hours”之一。

`MB_SETUP_EMBEDDING_AUTOENABLED`

类型：布尔值
默认值：false
导出为: setup-embedding-autoenabled。
配置文件名: setup-embedding-autoenabled

指示在设置过程中，如果用户对嵌入感兴趣，嵌入是否已自动启用。

`MB_SETUP_LICENSE_ACTIVE_AT_SETUP`

类型：布尔值
默认值：false
导出为: setup-license-active-at-setup。
配置文件名: setup-license-active-at-setup

指示在设置结束时是否有有效许可证处于活动状态。

`MB_SHOW_DATABASE_SYNCING_MODAL`

类型：布尔值
默认值：null
配置文件名: show-database-syncing-modal

在添加下一个数据库连接后是否应显示介绍性模态框。如果此实例的任何非默认数据库已完成同步，则默认为 false。

`MB_SHOW_HOMEPAGE_DATA`

类型：布尔值
默认值：true
导出为: show-homepage-data。
配置文件名: show-homepage-data

是否在主页上显示数据。管理员可能会关闭此选项，以便引导用户访问比原始数据更好的内容。

`MB_SHOW_HOMEPAGE_XRAYS`

类型：布尔值
默认值：true
导出为: show-homepage-xrays。
配置文件名: show-homepage-xrays

是否在主页上显示 X 光探索建议。如果任何仪表板被置顶，它们也将被隐藏。管理员可能会隐藏此选项，以引导用户访问比原始数据更好的内容。

`MB_SHOW_METABASE_LINKS`

类型：布尔值
默认值：true
配置文件名: show-metabase-links

是否在管理员设置之外显示 Metabase 链接。

`MB_SHOW_METABOT`

类型：布尔值
默认值：true
导出为: show-metabot。
配置文件名: show-metabot

在主页上启用 Metabot 角色。

`MB_SHOW_STATIC_EMBED_TERMS`

类型：布尔值
默认值：true
导出为: show-static-embed-terms。
配置文件名: show-static-embed-terms

检查静态嵌入许可是否应在静态嵌入流程中隐藏。

`MB_SITE_LOCALE`

类型：字符串
默认值: en
导出为: site-locale。
配置文件名: site-locale

所有用户在 Metabase UI、系统电子邮件、脉冲和警报中的默认语言。用户可以从其自己的帐户设置中单独覆盖此默认语言。

`MB_SITE_NAME`

类型：字符串
默认值：Metabase
导出为: site-name。
配置文件名: site-name

此 Metabase 实例的名称。

`MB_SITE_URL`

类型：字符串
默认值：null
配置文件名: site-url

此 URL 用于在电子邮件中创建链接、身份验证重定向以及某些嵌入场景，因此更改它可能会破坏功能或导致您无法登录此实例。

此 URL 对于 SSO 身份验证、电子邮件链接、嵌入等功能至关重要。即使是 http:// 与 https:// 之间的差异也可能导致问题。请确保定义的地址是 Metabase 的访问方式。

`MB_SLACK_APP_TOKEN`

类型：字符串
默认值：null
配置文件名: slack-app-token

用于连接 Metabase Slack 应用程序的机器人用户 OAuth 令牌。从 Metabase v0.42.0 开始，所有新的 Slack 集成都应使用此令牌。

`MB_SLACK_BUG_REPORT_CHANNEL`

类型：字符串
默认值: metabase-bugs
配置文件名: slack-bug-report-channel

应发布 bug 报告的频道名称。

`MB_SLACK_FILES_CHANNEL [已弃用]`

类型：字符串
默认值: metabase_files
配置文件名: slack-files-channel

Metabase 文件应首次上传到的频道名称。

`MB_SOURCE_ADDRESS_HEADER`

类型：字符串
默认值: X-Forwarded-For
导出为: source-address-header。
配置文件名: source-address-header

通过此请求头的值而不是其远程地址来识别 HTTP 请求的来源。

`MB_SQL_JDBC_FETCH_SIZE`

类型：整数
默认值: 500

结果集的获取大小。我们希望确保 JDBC ResultSet 对象不会将整个结果加载到内存中。

`MB_SQL_PARSING_ENABLED`

类型：布尔值
默认值：true

SQL 解析已禁用。

`MB_SSH_HEARTBEAT_INTERVAL_SEC`

类型：整数
默认值: 180
配置文件名: ssh-heartbeat-interval-sec

控制建立 SSH 隧道时心跳发送的频率（秒）。

`MB_START_OF_WEEK`

类型: 关键字
默认值: :sunday
导出为: start-of-week。
配置文件名: start-of-week

这将影响按周分组或 GUI 查询中的筛选等。它不会影响大多数 SQL 查询，尽管它用于在 Snowflake 中设置 WEEK_START 会话变量。

`MB_SUBSCRIPTION_ALLOWED_DOMAINS`

类型：字符串
默认值：null
导出为: subscription-allowed-domains。
配置文件名: subscription-allowed-domains

新的仪表板订阅和警报允许的电子邮件地址域。要指定多个域，请用逗号分隔每个域，中间不要有空格。要允许所有域，请将字段留空。此设置不影响现有订阅。

`MB_SURVEYS_ENABLED`

类型：布尔值
默认值：true

启用或禁用调查。

`MB_SYNCHRONOUS_BATCH_UPDATES`

类型：布尔值
默认值：false
导出为: synchronous-batch-updates。
配置文件名: synchronous-batch-updates

同步处理批量更新。如果为 true，所有 submit! 调用都将立即处理。默认值为 false。

`MB_UNAGGREGATED_QUERY_ROW_LIMIT`

类型：整数
默认值: 2000
导出为: unaggregated-query-row-limit。
配置文件名: unaggregated-query-row-limit

通过 API，针对 :rows 类型查询返回的最大行数。

必须小于 1048575，并且小于 MB_AGGREGATED_QUERY_ROW_LIMIT 中配置的数字。另请参阅 MB_AGGREGATED_QUERY_ROW_LIMIT。

`MB_UPDATE_CHANNEL`

类型：字符串
默认值: latest
导出为: update-channel。
配置文件名: update-channel

当有此类型发布的新版本时，我们会在此通知您。

`MB_UPLOADS_DATABASE_ID [已弃用]`

类型：整数
默认值：null

上传的数据库 ID。

`MB_UPLOADS_ENABLED [已弃用]`

类型：布尔值
默认值：false

是否启用上传。

`MB_UPLOADS_SCHEMA_NAME [已弃用]`

类型：字符串
默认值：null

上传的模式名称。

`MB_UPLOADS_SETTINGS`

类型：JSON
默认值：null
配置文件名: uploads-settings

上传设置。

`MB_UPLOADS_TABLE_PREFIX [已弃用]`

类型：字符串
默认值：null

上传表名的前缀。

`MB_USE_TENANTS`

类型：布尔值
默认值：false
配置文件名: use-tenants

启用租户功能，允许将用户分配到特定租户。

`MB_USER_VISIBILITY`

类型: 关键字
默认值: :all
配置文件名: user-visibility

注意：沙盒用户永远不会看到建议。

其他环境变量

以下环境变量只能通过环境设置。它们不能通过配置文件设置。

`MAX_SESSION_AGE`

类型：整数
默认值: 20160

会话过期时间，以分钟为单位（默认 2 周），达到此期限后将注销用户并要求重新身份验证。

注意：此设置并非空闲/不活动超时。如果您将其设置为 15 分钟，您的用户每 15 分钟就必须再次登录（或重新身份验证）。使用 MB_SESSION_TIMEOUT 控制基于不活动的超时。

使用 MB_SESSION_COOKIES 在浏览器关闭时也使会话过期。

另请参阅更改会话过期文档页面。

`MB_APPLICATION_DB_MAX_CONNECTION_POOL_SIZE`

类型：整数
默认值: 15
始于: v35.0

Metabase 应用程序数据库的最大连接数。

如果您发现常规使用消耗了所有或几乎所有连接，请将其更改为更高的值。当所有连接都在使用中时，Metabase 在界面中点击时可能会感觉缓慢或无响应。

要查看正在使用的连接数，请检查 Metabase 日志并查找包含以下内容的行：… App DB connections: 12/15 …。在此示例中，15 个可用连接中有 12 个正在使用。

有关设置 Metabase 连接数据库的最大连接数，请参阅 MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE。

`MB_ASYNC_QUERY_THREAD_POOL_SIZE`

类型：整数
默认值: 50
始于: v35.0

Jetty 异步线程的最大数量。如果未设置，将使用 MB_JETTY_MAXTHREADS，否则将使用默认值。

`MB_ATTACHMENT_TABLE_ROW_LIMIT`

类型：整数
默认值：20

限制 Metabase 在仪表板订阅和警报中发送的表格中显示的行数。范围：1-100。要限制电子邮件仪表板订阅的文件附件中包含的总行数，请使用 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

`MB_AUDIT_MAX_RETENTION_DAYS`

仅适用于 Metabase 专业版和企业版计划。
类型：整数
默认值: 720 (Metabase 保留所有行)

设置 Metabase 为以下应用程序数据库表保留行的最大天数

query_execution
audit_log
view_log

Metabase 每天两次将删除早于此阈值的行。

最小值为 30 天（Metabase 将把输入的 1 到 29 的值视为与 30 相同）。如果设置为 0，Metabase 将保留所有行。

`MB_COLORIZE_LOGS`

类型：布尔值
默认值：true

日志行着色。设置为 false 时将禁用日志行颜色。在 Windows 上此功能已禁用。与 MB_EMOJI_IN_LOGS 相关。

`MB_CONFIG_FILE_PATH`

类型：字符串
默认值: config.yml

此功能需要您的令牌中具有 config-text-file 功能标志。

`MB_DB_AUTOMIGRATE`

类型：布尔值
默认值：true

当设置为 false 时，Metabase 将打印应用程序数据库中需要完成的迁移并退出。这些迁移需要手动应用。当为 true 时，Metabase 将自动更改应用程序数据库。这与从 H2 迁移无关。

`MB_DB_CONNECTION_URI`

类型：字符串
默认值：null

一个 JDBC 风格的连接 URI，可以用来替代大多数 MB_DB_*（例如 MB_DB_HOST）。在需要某些连接字符串参数时也使用。连接类型要求与 MB_DB_TYPE 相同。

示例

jdbc:postgresql://db.example.com:5432/mydb?user=dbuser&password=dbpassword

jdbc:postgresql://db.example.com:5432/mydb?user=dbuser&password=dbpassword&ssl=true&sslfactory=org.postgresql.ssl.NonValidatingFactory

jdbc:mysql://db.example.com:3306/mydb?user=dbuser&password=dbpassword

`MB_DB_DBNAME`

类型：字符串
默认值：null

与 MB_DB_HOST 一起使用的应用程序数据库的数据库名称。

`MB_DB_FILE`

类型：字符串
默认值: "metabase.db"

H2 数据库文件的位置。不应包含 .mv.db（或 .h2.db）文件扩展名。当 MB_DB_TYPE 设置为 "h2" 时使用。

也可以在从 H2 迁移时使用，以指定从何处读取现有数据。

`MB_DB_HOST`

类型：字符串
默认值：null

应用程序数据库的主机名或 IP 地址。当 MB_DB_TYPE 与 "h2" 不同时使用。

`MB_DB_IN_MEMORY`

类型：布尔值
默认值：null

用于与 MB_DB_FILE 进行测试。

`MB_DB_PASS`

类型：字符串
默认值：null

MB_DB_HOST 的密码。

`MB_DB_PORT`

类型：整数
默认值：null

MB_DB_HOST 的端口。

`MB_DB_TYPE`

类型: 字符串 ("h2", "postgres", "mysql")
默认值: "h2"

当为 "h2" 时，应用程序数据库从 MB_DB_FILE 加载，否则将使用 MB_DB_HOST 定义应用程序数据库。

`MB_DB_USER`

类型：字符串
默认值：null

MB_DB_HOST 的用户名。

`MB_DEV_ADDITIONAL_DRIVER_MANIFEST_PATHS`

类型：字符串
默认值：null

在第三方驱动程序开发期间使用。设置该值以在启动时加载该插件清单。通过逗号分隔来指定多个插件清单。

`MB_DISABLE_SCHEDULER`

类型：布尔值
默认值：false

当为 true 时，Metabase 将关闭 Metabase 的计划作业，包括同步、指纹识别和扫描，以及仪表板订阅、警报和模型缓存。

对于测试或设置基于 Git 的工作流程可能很有用。

`MB_DISABLE_SESSION_THROTTLE`

类型：布尔值
默认值：false

当为 true 时，这将禁用会话节流。警告：不建议禁用节流，因为它是防止暴力攻击的保护措施。

使用 MB_SOURCE_ADDRESS_HEADER 设置远程客户端的 IP 地址，例如来自反向代理。

`MB_EMOJI_IN_LOGS`

类型：布尔值
默认值：true

日志行上的表情符号。当设置为 false 时，将禁用日志行表情符号。在 Windows 上此功能已禁用。与 MB_COLORIZE_LOGS 相关。

`MB_ENABLE_TEST_ENDPOINTS`

类型：布尔值
默认值：null

当设置为 true 时，这将启用 /api/testing 端点。警告：此功能绝不应在生产系统上启用。

`MB_ENCRYPTION_SECRET_KEY`

类型：字符串
默认值：null

设置后，这将加密存储在应用程序数据库中的数据库凭据。要求：最小 16 个字符的 base64 编码字符串。

另请参阅文档页面静态加密数据库详细信息。

`MB_JDBC_DATA_WAREHOUSE_DEBUG_UNRETURNED_CONNECTION_STACK_TRACES`

类型：布尔值
默认值：false
始于: v51.3

如果为 true，则为因超出 MB_DB_QUERY_TIMEOUT_MINUTES 中指定的超时而终止的任何连接记录堆栈跟踪。

为了在日志中看到堆栈跟踪，您还需要通过自定义 log4j 配置将 com.mchange 日志级别更新为“INFO”或更高。有关配置日志级别的信息，请参阅 Metabase 日志配置。

`MB_JETTY_ASYNC_RESPONSE_TIMEOUT`

类型：整数
默认值: 600000
始于: v35.0

Jetty 异步线程的超时时间，以毫秒为单位。默认值为 10 分钟。很少有东西会达到此超时，因为它们在此之前会返回某种类型的数据，但像 CSV 下载之类的可能会。

`MB_JETTY_DAEMON`

类型：布尔值
默认值：false

使用守护线程。

`MB_JETTY_HOST`

类型：字符串
默认值: JAR 为 localhost, Docker 为 0.0.0.0

配置主机名或 IP 地址以标识要侦听的特定网络接口。如果设置为 "0.0.0.0"，Metabase 将侦听所有网络接口。它将侦听 MB_JETTY_PORT 中指定的端口。

`MB_JETTY_JOIN`

类型：布尔值
默认值：true

阻塞线程直到服务器结束。

`MB_JETTY_MAXIDLETIME`

类型：整数
默认值: 200000

连接的最大空闲时间，以毫秒为单位。

`MB_JETTY_MAXTHREADS`

类型：整数
默认值: 50

最大线程数。

如果您发现常规使用消耗了所有或几乎所有线程，请将其更改为更高的值。当所有线程都在使用中时，Metabase 在界面中点击时可能会感觉缓慢或无响应。

要查看正在使用的线程数，请检查 Metabase 日志并查找包含以下内容的行：… Jetty threads: 45/50 …，在此情况下表示 50 个可用线程中有 45 个正在使用。

相关 MB_ASYNC_QUERY_THREAD_POOL_SIZE。

`MB_JETTY_MINTHREADS`

类型：整数
默认值：8

最小线程数。

`MB_JETTY_PORT`

类型：整数
默认值: 3000

配置用于 HTTP 的端口。它将侦听 MB_JETTY_HOST 中指定的接口。

`MB_JETTY_REQUEST_HEADER_SIZE`

类型：整数
默认值: 8192
始于: v36.0

请求头的最大大小，以字节为单位。如果您遇到“请求头字段过大”之类的错误，请增加此值。

`MB_JETTY_SSL`

类型：布尔值
默认值：null

当设置为 true 时，将启用 HTTPS，并使用 MB_JETTY_SSL_* 变量中配置的选项。

另请参阅自定义 Jetty Web 服务器文档页面。

`MB_JETTY_SSL_CLIENT_AUTH`

类型：布尔值
默认值：null

配置 Java SSL 客户端身份验证。当设置为 true 时，需要客户端证书，并且由 TrustStore 中的证书颁发机构进行验证。

`MB_JETTY_SSL_KEYSTORE`

类型：字符串
默认值：null

Java KeyStore 文件的路径。

`MB_JETTY_SSL_KEYSTORE_PASSWORD`

类型：字符串
默认值：null

Java KeyStore 文件的密码。

`MB_JETTY_SSL_PORT`

类型：整数
默认值：null

配置用于 HTTPS 的端口。它将侦听 MB_JETTY_HOST 中指定的接口。

`MB_JETTY_SSL_TRUSTSTORE`

类型：字符串
默认值：null

Java TrustStore 文件的路径。

`MB_JETTY_SSL_TRUSTSTORE_PASSWORD`

类型：字符串
默认值：null

Java TrustStore 文件的密码。

`MB_LANDING_PAGE`

仅适用于 Metabase 专业版和企业版计划。
类型：字符串
默认值: ""

登录时向用户显示的默认页面。

`MB_LOAD_ANALYTICS_CONTENT`

类型: 布尔值
默认值: True

如果您想排除 Metabase 分析收集，您可以设置 MB_LOAD_ANALYTICS_CONTENT=false。将此环境变量设置为 false 在迁移环境时也很有用，因为它可以简化迁移过程。

`MB_LOAD_SAMPLE_CONTENT`

类型: 布尔值
默认值: True

是否在 Metabase 中包含示例数据库。要排除示例数据库，请设置 MB_LOAD_SAMPLE_CONTENT=false。

`MB_NO_SURVEYS`

类型：布尔值
默认值：false

Metabase 将向创建了大量问题和仪表板的用户发送一份情绪调查，以评估产品在方便创作者方面做得如何。

Metabase 只会将这些电子邮件发送给在过去 2 个月内符合以下条件的人：

总共创建了至少 10 个问题
创建了至少 2 个 SQL 问题
创建了至少 1 个仪表板

如果您正在对 Metabase 进行白标签化，这些调查电子邮件将只发送给符合该标准的实例管理员。

如果您不希望 Metabase 发送这些电子邮件，请设置 MB_NO_SURVEYS=true。

`MB_NS_TRACE`

类型：字符串
默认值: ""

逗号分隔的要追踪的命名空间。警告：可能记录敏感信息，例如数据库密码。

`MB_PASSWORD_COMPLEXITY`

类型: 字符串 ("weak", "normal", "strong")
默认值: "normal"

强制执行密码复杂性规则以增强常规登录的安全性。这仅适用于新用户或更改密码的用户。相关 MB_PASSWORD_LENGTH

weak 无字符限制
normal 至少 1 位数字
strong 至少 8 个字符，包含 2 个小写字母、2 个大写字母、1 个数字和 1 个特殊字符

`MB_PASSWORD_LENGTH`

类型：整数
默认值: 6

设置最小密码长度以提高常规登录的安全性。这仅适用于新用户或更改密码的用户。如果未设置，则使用 MB_PASSWORD_COMPLEXITY 的长度。

`MB_PLUGINS_DIR`

类型：字符串
默认值: "plugins"

“plugins”目录的路径，用于存储 Metabase 数据库驱动程序。运行 Metabase 的用户应具有写入该目录的权限。当运行 JAR 时，默认目录是与 JAR 文件相同位置创建的 plugins。当运行 Docker 时，默认目录是 /plugins。

此位置是添加自定义第三方驱动程序的地方。然后 Metabase 将在启动时加载驱动程序，这可以在日志中验证。

`MB_PREMIUM_EMBEDDING_TOKEN`

类型：字符串
默认值：null

用于 Pro 和 Enterprise 版本以启用高级功能的许可证令牌。它也用于 OSS 版本中已弃用的“高级嵌入”功能。

`MB_QP_CACHE_BACKEND`

类型：字符串
默认值: "db"

当前缓存后端。主要用于测试目的的动态重绑定。

`MB_SEARCH_TYPEAHEAD_ENABLED`

类型：布尔值
默认值：true
始于: v39.0

在顶部导航栏中使用全局搜索时显示自动建议。

`MB_SEND_EMAIL_ON_FIRST_LOGIN_FROM_NEW_DEVICE`

类型：布尔值
默认值：true
始于: v39.0

当用户从新设备登录时，向用户发送电子邮件通知。设置为 false 以停止向所有用户发送“我们注意到您的 Metabase 帐户有新登录”的电子邮件。

此外，此变量控制 Metabase 用于了解用户登录位置的地理编码服务。将此变量设置为 false 也会禁用此反向地理编码功能。

`MB_SEND_NEW_SSO_USER_ADMIN_EMAIL`

仅适用于 Metabase 专业版和企业版计划。
类型：布尔值
默认值：true

当 Metabase 上创建新 SSO 用户时，向管理员组中的用户发送电子邮件通知。

`MB_SETUP_TOKEN`

类型：字符串
默认值：null

一个 UUID 令牌，用于表示实例具有创建初始用户的权限。这在 Metabase 首次启动时由第一个实例创建；一旦使用，它将被清除，永不再次使用。

`MB_SHOW_LIGHTHOUSE_ILLUSTRATION`

仅适用于 Metabase 专业版和企业版计划。
类型：布尔值
默认值：true
始于: v44.0

在主页和登录页上显示灯塔插图。

`MB_JETTY_SKIP_SNI`

类型：字符串
默认值: "true"
始于: v48.4

将 MB_JETTY_SKIP_SNI=true（默认设置）设置为关闭 Jetty Web 服务器中的服务器名称指示 (SNI) 检查。通常您会保持此功能启用。但是，如果您在 Metabase 本身终止传输层安全 (TLS) 连接，并且遇到类似 HTTP ERROR 400 Invalid SNI 的错误，请考虑将 MB_JETTY_SKIP_SNI=false 设置，或使用与服务器域名完全匹配的另一个 SSL 证书。

`MB_SOURCE_ADDRESS_HEADER`

类型：字符串
默认值: X-Forwarded-For

通过此请求头的值而不是其远程地址来识别 HTTP 请求的来源。与 MB_DISABLE_SESSION_THROTTLE 相关。

`MB_SSL_CERTIFICATE_PUBLIC_KEY`

类型：字符串
默认值：null

此网站SSL证书的Base-64编码公钥。指定此项可启用HTTP公钥固定。不再推荐使用HPKP。欲了解更多信息，请参阅http://mzl.la/1EnfqBf。

阅读其他Metabase版本的文档。

商业智能

嵌入式分析

文档

学习

分析

嵌入

管理

其他资源

环境变量

如何设置环境变量

Metabase 云版上的环境变量

环境变量列表

MB_ADMIN_EMAIL

MB_AGGREGATED_QUERY_ROW_LIMIT

MB_AI_PROXY_BASE_URL

MB_ALLOWED_IFRAME_HOSTS

MB_ANON_TRACKING_ENABLED

MB_API_KEY

MB_APPLICATION_COLORS

MB_APPLICATION_FAVICON_URL

MB_APPLICATION_FONT

MB_APPLICATION_FONT_FILES

MB_APPLICATION_LOGO_URL

MB_APPLICATION_NAME

MB_ATTACHMENT_ROW_LIMIT

MB_ATTACHMENT_TABLE_ROW_LIMIT

MB_BCC_ENABLED

MB_BREAKOUT_BIN_WIDTH

MB_BREAKOUT_BINS_NUM

MB_CHECK_FOR_UPDATES

MB_CONFIG_FROM_FILE_SYNC_DATABASES

MB_CUSTOM_FORMATTING

MB_CUSTOM_GEOJSON

MB_CUSTOM_GEOJSON_ENABLED

MB_CUSTOM_HOMEPAGE

MB_CUSTOM_HOMEPAGE_DASHBOARD

MB_DB_CONNECTION_TIMEOUT_MS

MB_DB_QUERY_TIMEOUT_MINUTES

MB_DEFAULT_MAPS_ENABLED

MB_DOWNLOAD_ROW_LIMIT

MB_EE_AI_FEATURES_ENABLED

MB_EE_OPENAI_API_KEY

MB_EE_OPENAI_MODEL

MB_EMAIL_FROM_ADDRESS

MB_EMAIL_FROM_NAME

MB_EMAIL_MAX_RECIPIENTS_PER_SECOND

MB_EMAIL_REPLY_TO

MB_EMAIL_SMTP_HOST

MB_EMAIL_SMTP_PASSWORD

MB_EMAIL_SMTP_PORT

MB_EMAIL_SMTP_SECURITY

MB_EMAIL_SMTP_USERNAME

MB_EMBEDDING_APP_ORIGIN [已弃用]

MB_EMBEDDING_APP_ORIGINS_INTERACTIVE

MB_EMBEDDING_APP_ORIGINS_SDK

MB_EMBEDDING_HOMEPAGE

MB_EMBEDDING_SECRET_KEY

MB_ENABLE_EMBEDDING [已弃用]

MB_ENABLE_EMBEDDING_INTERACTIVE

MB_ENABLE_EMBEDDING_SDK

MB_ENABLE_EMBEDDING_STATIC

MB_ENABLE_PASSWORD_LOGIN

MB_ENABLE_PIVOTED_EXPORTS

MB_ENABLE_PUBLIC_SHARING

MB_ENABLE_QUERY_CACHING

MB_ENABLE_XRAYS

MB_FOLLOW_UP_EMAIL_SENT

MB_GOOGLE_AUTH_AUTO_CREATE_ACCOUNTS_DOMAIN

MB_GOOGLE_AUTH_CLIENT_ID

MB_GOOGLE_AUTH_ENABLED

MB_GSHEETS

MB_HEALTH_CHECK_LOGGING_ENABLED

MB_HELP_LINK

MB_HELP_LINK_CUSTOM_DESTINATION

MB_HUMANIZATION_STRATEGY

MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE

MB_JWT_ATTRIBUTE_EMAIL

MB_JWT_ATTRIBUTE_FIRSTNAME

MB_JWT_ATTRIBUTE_GROUPS

MB_JWT_ATTRIBUTE_LASTNAME

`MB_ADMIN_EMAIL`

`MB_AGGREGATED_QUERY_ROW_LIMIT`

`MB_AI_PROXY_BASE_URL`

`MB_ALLOWED_IFRAME_HOSTS`

`MB_ANON_TRACKING_ENABLED`

`MB_API_KEY`

`MB_APPLICATION_COLORS`

`MB_APPLICATION_FAVICON_URL`

`MB_APPLICATION_FONT`

`MB_APPLICATION_FONT_FILES`

`MB_APPLICATION_LOGO_URL`

`MB_APPLICATION_NAME`

`MB_ATTACHMENT_ROW_LIMIT`

`MB_ATTACHMENT_TABLE_ROW_LIMIT`

`MB_BCC_ENABLED`

`MB_BREAKOUT_BIN_WIDTH`

`MB_BREAKOUT_BINS_NUM`

`MB_CHECK_FOR_UPDATES`

`MB_CONFIG_FROM_FILE_SYNC_DATABASES`

`MB_CUSTOM_FORMATTING`

`MB_CUSTOM_GEOJSON`

`MB_CUSTOM_GEOJSON_ENABLED`

`MB_CUSTOM_HOMEPAGE`

`MB_CUSTOM_HOMEPAGE_DASHBOARD`

`MB_DB_CONNECTION_TIMEOUT_MS`

`MB_DB_QUERY_TIMEOUT_MINUTES`

`MB_DEFAULT_MAPS_ENABLED`

`MB_DOWNLOAD_ROW_LIMIT`

`MB_EE_AI_FEATURES_ENABLED`

`MB_EE_OPENAI_API_KEY`

`MB_EE_OPENAI_MODEL`

`MB_EMAIL_FROM_ADDRESS`

`MB_EMAIL_FROM_NAME`

`MB_EMAIL_MAX_RECIPIENTS_PER_SECOND`

`MB_EMAIL_REPLY_TO`

`MB_EMAIL_SMTP_HOST`

`MB_EMAIL_SMTP_PASSWORD`

`MB_EMAIL_SMTP_PORT`

`MB_EMAIL_SMTP_SECURITY`

`MB_EMAIL_SMTP_USERNAME`

`MB_EMBEDDING_APP_ORIGIN [已弃用]`

`MB_EMBEDDING_APP_ORIGINS_INTERACTIVE`

`MB_EMBEDDING_APP_ORIGINS_SDK`

`MB_EMBEDDING_HOMEPAGE`

`MB_EMBEDDING_SECRET_KEY`

`MB_ENABLE_EMBEDDING [已弃用]`

`MB_ENABLE_EMBEDDING_INTERACTIVE`

`MB_ENABLE_EMBEDDING_SDK`

`MB_ENABLE_EMBEDDING_STATIC`

`MB_ENABLE_PASSWORD_LOGIN`

`MB_ENABLE_PIVOTED_EXPORTS`

`MB_ENABLE_PUBLIC_SHARING`

`MB_ENABLE_QUERY_CACHING`

`MB_ENABLE_XRAYS`

`MB_FOLLOW_UP_EMAIL_SENT`

`MB_GOOGLE_AUTH_AUTO_CREATE_ACCOUNTS_DOMAIN`

`MB_GOOGLE_AUTH_CLIENT_ID`

`MB_GOOGLE_AUTH_ENABLED`

`MB_GSHEETS`

`MB_HEALTH_CHECK_LOGGING_ENABLED`

`MB_HELP_LINK`

`MB_HELP_LINK_CUSTOM_DESTINATION`

`MB_HUMANIZATION_STRATEGY`

`MB_JDBC_DATA_WAREHOUSE_MAX_CONNECTION_POOL_SIZE`

`MB_JWT_ATTRIBUTE_EMAIL`

`MB_JWT_ATTRIBUTE_FIRSTNAME`

`MB_JWT_ATTRIBUTE_GROUPS`

`MB_JWT_ATTRIBUTE_LASTNAME`

`MB_JWT_ENABLED`

`MB_JWT_GROUP_MAPPINGS`

`MB_JWT_GROUP_SYNC`

`MB_JWT_IDENTITY_PROVIDER_URI`

`MB_JWT_SHARED_SECRET`

`MB_JWT_USER_PROVISIONING_ENABLED`

`MB_LANDING_PAGE`

`MB_LANDING_PAGE_ILLUSTRATION`

`MB_LANDING_PAGE_ILLUSTRATION_CUSTOM`

`MB_LDAP_ATTRIBUTE_EMAIL`

`MB_LDAP_ATTRIBUTE_FIRSTNAME`

`MB_LDAP_ATTRIBUTE_LASTNAME`