环境变量
本文档通过运行以下命令从源代码生成
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
通过 API 为聚合查询返回的最大行数。
必须小于 1048575。另请参阅 MB_UNAGGREGATED_QUERY_ROW_LIMIT。
MB_AI_PROXY_BASE_URL
- 类型:字符串
- 默认值:
http://localhost: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
选择 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
上传文件作为网站图标。
MB_APPLICATION_FONT
将字体系列替换为“Lato”。
MB_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
上传文件以替换顶部栏上的 Metabase 标志。
不支持内联样式和内联脚本。
MB_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
当使用默认分箱策略且未提供分箱数量时,此数字将用作默认值。
MB_CHECK_FOR_UPDATES
- 类型:布尔值
- 默认值:
true
- 配置文件名:
check-for-updates
识别 Metabase 新版本何时可用。
MB_CONFIG_FROM_FILE_SYNC_DATABASES
- 类型:布尔值
- 默认值:
true
在配置文件初始化期间是否(异步)同步新创建的数据库。默认情况下为 true,但如果您想手动同步或使用 SerDes 填充其数据模型,则可以禁用此行为。
MB_CUSTOM_FORMATTING
按类型键控的对象,包含格式设置。
MB_CUSTOM_GEOJSON
包含自定义 GeoJSON 文件信息的 JSON,用于地图可视化,而不是默认的美国州或世界 GeoJSON。
MB_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
是否启用默认的 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
每秒发送的收件人总数上限(跨所有电子邮件)。请注意,如果最后一封发送的电子邮件有多个收件人,它可能会超出此限制。
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 [已弃用]
已弃用: 0.51.0
- 类型:字符串
- 默认值:
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
嵌入式主页状态,指示其是否可见、隐藏或已被关闭。
MB_EMBEDDING_SECRET_KEY
- 类型:字符串
- 默认值:
null
- 配置文件名:
embedding-secret-key
用于为 /api/embed
端点请求签名 JSON Web 令牌的密钥。
MB_ENABLE_EMBEDDING [已弃用]
已弃用: 0.51.0
允许管理员将问题和仪表板安全地嵌入到其他应用程序中吗?
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
启用旋转导出和旋转订阅。
MB_ENABLE_PUBLIC_SHARING
- 类型:布尔值
- 默认值:
true
- 配置文件名:
enable-public-sharing
允许管理员为问题和仪表板创建公开可见的链接(和可嵌入的 iframe)吗?
MB_ENABLE_QUERY_CACHING
- 类型:布尔值
- 默认值:
true
- 配置文件名:
enable-query-caching
允许缓存长时间运行的查询结果。
MB_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
有关 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
为了使表格和字段名称更具人性化,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
输入要显示给用户的着陆页 URL。这将覆盖上面的自定义主页设置。
MB_LANDING_PAGE_ILLUSTRATION
着陆页插图的显示选项。
MB_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”、“running-query”或“loading-results”。
MB_LOGIN_PAGE_ILLUSTRATION
登录页插图的显示选项。
MB_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
运行问题后没有结果时显示插图的选项。
MB_NO_DATA_ILLUSTRATION_CUSTOM
运行问题后没有结果时的自定义插图。
MB_NO_OBJECT_ILLUSTRATION
搜索后没有结果时显示插图的选项。
MB_NO_OBJECT_ILLUSTRATION_CUSTOM
搜索后没有结果时的自定义插图。
MB_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
允许将模型持久化到源数据库。
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
执行查询时使用的连接时区。默认为系统时区。
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
在 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
指示在设置过程中,如果用户对嵌入感兴趣,嵌入是否已自动启用。
MB_SETUP_LICENSE_ACTIVE_AT_SETUP
指示在设置结束时是否有有效许可证处于活动状态。
MB_SHOW_DATABASE_SYNCING_MODAL
- 类型:布尔值
- 默认值:
null
- 配置文件名:
show-database-syncing-modal
在添加下一个数据库连接后是否应显示介绍性模态框。如果此实例的任何非默认数据库已完成同步,则默认为 false。
MB_SHOW_HOMEPAGE_DATA
是否在主页上显示数据。管理员可能会关闭此选项,以便引导用户访问比原始数据更好的内容。
MB_SHOW_HOMEPAGE_XRAYS
是否在主页上显示 X 光探索建议。如果任何仪表板被置顶,它们也将被隐藏。管理员可能会隐藏此选项,以引导用户访问比原始数据更好的内容。
MB_SHOW_METABASE_LINKS
- 类型:布尔值
- 默认值:
true
- 配置文件名:
show-metabase-links
是否在管理员设置之外显示 Metabase 链接。
MB_SHOW_METABOT
在主页上启用 Metabot 角色。
MB_SHOW_STATIC_EMBED_TERMS
检查静态嵌入许可是否应在静态嵌入流程中隐藏。
MB_SITE_LOCALE
所有用户在 Metabase UI、系统电子邮件、脉冲和警报中的默认语言。用户可以从其自己的帐户设置中单独覆盖此默认语言。
MB_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 [已弃用]
已弃用: 0.54.0
- 类型:字符串
- 默认值:
metabase_files
- 配置文件名:
slack-files-channel
Metabase 文件应首次上传到的频道名称。
MB_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
这将影响按周分组或 GUI 查询中的筛选等。它不会影响大多数 SQL 查询,尽管它用于在 Snowflake 中设置 WEEK_START 会话变量。
MB_SUBSCRIPTION_ALLOWED_DOMAINS
新的仪表板订阅和警报允许的电子邮件地址域。要指定多个域,请用逗号分隔每个域,中间不要有空格。要允许所有域,请将字段留空。此设置不影响现有订阅。
MB_SURVEYS_ENABLED
- 类型:布尔值
- 默认值:
true
启用或禁用调查。
MB_SYNCHRONOUS_BATCH_UPDATES
同步处理批量更新。如果为 true,所有 submit!
调用都将立即处理。默认值为 false。
MB_UNAGGREGATED_QUERY_ROW_LIMIT
通过 API,针对 :rows 类型查询返回的最大行数。
必须小于 1048575,并且小于 MB_AGGREGATED_QUERY_ROW_LIMIT 中配置的数字。另请参阅 MB_AGGREGATED_QUERY_ROW_LIMIT。
MB_UPDATE_CHANNEL
当有此类型发布的新版本时,我们会在此通知您。
MB_UPLOADS_DATABASE_ID [已弃用]
已弃用: 0.50.0
- 类型:整数
- 默认值:
null
上传的数据库 ID。
MB_UPLOADS_ENABLED [已弃用]
已弃用: 0.50.0
- 类型:布尔值
- 默认值:
false
是否启用上传。
MB_UPLOADS_SCHEMA_NAME [已弃用]
已弃用: 0.50.0
- 类型:字符串
- 默认值:
null
上传的模式名称。
MB_UPLOADS_SETTINGS
- 类型:JSON
- 默认值:
null
- 配置文件名:
uploads-settings
上传设置。
MB_UPLOADS_TABLE_PREFIX [已弃用]
已弃用: 0.50.0
- 类型:字符串
- 默认值:
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版本的文档。