环境变量
本文档由以下来源生成
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 Cloud 上的环境变量
如果您正在运行 Metabase Cloud,您可以联系支持以调整您的 Metabase 环境变量。
环境变量列表
MB_ADMIN_EMAIL
- 类型:字符串
- 默认值:
null
- 配置文件名:
admin-email
如果用户遇到问题,应将他们转介到的电子邮件地址。
MB_AGGREGATED_QUERY_ROW_LIMIT
通过 API 返回的聚合查询的最大行数。
必须小于 1048575。另请参阅 MB_UNAGGREGATED_QUERY_ROW_LIMIT。
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_ATTACHMENT_ROW_LIMIT。
MB_AUDIT_MAX_RETENTION_DAYS
- 类型:字符串
- 默认值:
null
审核相关表中数据保留的天数。最小值为 30;设置为 0 则无限期保留数据。
设置 Metabase 保留以下应用程序数据库表行数据的最长天数
查询执行
审计日志
查看日志
Metabase 每天两次删除超出此阈值的行。最小值为 30 天(Metabase 会将输入值 1 到 29 视为与 30 相同)。如果设置为 0,Metabase 将保留所有行。
MB_BCC_ENABLED
- 类型:布尔值
- 默认值:
true
- 配置文件名:
bcc-enabled
是否启用密送电子邮件,默认行为是启用。
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_DASHBOARDS_SAVE_LAST_USED_PARAMETERS
- 类型:布尔值
- 默认值:
true
- 导出为:
dashboards-save-last-used-parameters
。
仪表板是否应在加载时默认为用户上次使用的参数。
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_EMAIL_FROM_ADDRESS
- 类型:字符串
- 默认值:
notifications@metabase.com
- 配置文件名:
email-from-address
您希望用于电子邮件发件人的电子邮件地址。
MB_EMAIL_FROM_ADDRESS_OVERRIDE
- 类型:字符串
- 默认值:
notifications@metabase.com
- 配置文件名:
email-from-address-override
您希望用于自定义 SMTP 服务器发送的电子邮件发件人的电子邮件地址。
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_HOST_OVERRIDE
- 类型:字符串
- 默认值:
null
- 配置文件名:
email-smtp-host-override
处理您的电子邮件的自定义 SMTP 服务器地址。
MB_EMAIL_SMTP_PASSWORD
- 类型:字符串
- 默认值:
null
- 配置文件名:
email-smtp-password
SMTP 密码。
MB_EMAIL_SMTP_PASSWORD_OVERRIDE
- 类型:字符串
- 默认值:
null
- 配置文件名:
email-smtp-password-override
自定义 SMTP 服务器密码。
MB_EMAIL_SMTP_PORT
- 类型:整数
- 默认值:
null
- 配置文件名:
email-smtp-port
您的 SMTP 服务器用于发送电子邮件的端口。
MB_EMAIL_SMTP_PORT_OVERRIDE
- 类型:整数
- 默认值:
null
- 配置文件名:
email-smtp-port-override
您的自定义 SMTP 服务器用于发送电子邮件的端口。仅支持端口 465、587 和 2525。
MB_EMAIL_SMTP_SECURITY
- 类型:关键字
- 默认值:
none
- 配置文件名:
email-smtp-security
SMTP 安全连接协议。(tls、ssl、starttls 或 none)。
MB_EMAIL_SMTP_SECURITY_OVERRIDE
- 类型:关键字
- 默认值:
ssl
- 配置文件名:
email-smtp-security-override
您的自定义服务器的 SMTP 安全连接协议。(tls、ssl 或 starttls)。
MB_EMAIL_SMTP_USERNAME
- 类型:字符串
- 默认值:
null
- 配置文件名:
email-smtp-username
SMTP 用户名。
MB_EMAIL_SMTP_USERNAME_OVERRIDE
- 类型:字符串
- 默认值:
null
- 配置文件名:
email-smtp-username-override
自定义 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_SIMPLE
- 类型:布尔值
- 默认值:
false
- 配置文件名:
enable-embedding-simple
允许管理员通过嵌入式分析 JS 嵌入 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_HTTP_CHANNEL_HOST_STRATEGY
- 类型:关键字
- 默认值:
external-only
控制允许作为HTTP通道目标的宿主类型。选项:
- 仅外部(默认 - 仅外部宿主)
- 允许私有(外部 + 私有网络,但不是本地主机)
- 允许所有(无限制,包括本地主机)。
MB_HUMANIZATION_STRATEGY
为了使表和字段名称更易于理解,Metabase将用空格替换其中的短划线和下划线。我们还会将每个单词大写,因此“last_visited_at”将变为“Last Visited At”。
MB_INSTALL_ANALYTICS_DATABASE
- 类型:布尔值
- 默认值:
true
是否应在启动时安装Metabase分析数据库。默认为true,但可以通过环境变量禁用。
将此环境变量设置为false将阻止安装分析数据库,这在与传入数据库冲突的迁移用例中非常有用。
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,将使用MB_JWT_*变量中配置的选项启用JWT身份验证。这用于JWT SSO身份验证,与静态嵌入无关,静态嵌入是MB_EMBEDDING_SECRET_KEY。
MB_JWT_GROUP_MAPPINGS
- 类型:json
- 默认值:
{}
- 配置文件名:
jwt-group-mappings
包含JWT到Metabase组映射的JSON。
JSON对象包含JWT到Metabase组映射,其中键是JWT组,值是Metabase组ID列表。
MB_JWT_GROUP_SYNC
- 类型:布尔值
- 默认值:
false
- 配置文件名:
jwt-group-sync
启用与JWT的组成员资格同步。
MB_JWT_IDENTITY_PROVIDER_URI
- 类型:字符串
- 默认值:
null
- 配置文件名:
jwt-identity-provider-uri
基于JWT的登录页面的URL。
MB_JWT_SHARED_SECRET
- 类型:字符串
- 默认值:
null
- 配置文件名:
jwt-shared-secret
用于验证JWT消息的私钥的字符串。强烈建议使用十六进制编码的256位密钥(即64个字符的字符串)。
MB_JWT_USER_PROVISIONING_ENABLED
- 类型:布尔值
- 默认值:
true
- 配置文件名:
jwt-user-provisioning-enabled
当用户通过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
服务器端口,通常为389或636(如果使用SSL)。
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_LICENSE_TOKEN_MISSING_BANNER_DISMISSAL_TIMESTAMP
- 类型:csv
- 默认值:
[]
- 配置文件名:
license-token-missing-banner-dismissal-timestamp
管理员关闭许可证令牌缺失横幅的最后两个ISO8601日期数组。
MB_LOAD_ANALYTICS_CONTENT
- 类型:布尔值
- 默认值:
true
是否应在启动时加载Metabase分析内容。默认为与install-analytics-database
匹配,后者默认为true,但可以通过环境变量禁用。
将此环境变量设置为false在迁移环境时也很有用,因为它可以简化迁移过程。
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”。大型实例在使用substring匹配时可能会出现性能问题,因此可以使用prefix匹配或关闭自动完成。
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_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
- 类型:字符串
- 默认值:
null
- 配置文件名:
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
- 类型:字符串
- 默认值:
null
- 配置文件名:
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
- 类型:关键字
- 默认值:
appdb
执行搜索时使用的引擎。支持的值为:in-place和:appdb。
MB_SEARCH_LANGUAGE
- 类型:字符串
- 默认值:
null
在使用appdb引擎对postgresql进行操作时,覆盖用于to_tsvector中词干提取的语言。值必须是数据库中有效的已配置语言选项,例如“english”或“simple”。
MB_SEARCH_TYPEAHEAD_ENABLED
在Metabase导航栏中启用预输入搜索?
MB_SEND_EMAIL_ON_FIRST_LOGIN_FROM_NEW_DEVICE
- 类型:布尔值
- 默认值:
true
当用户首次从新设备登录时,我们是否应该向他们发送通知电子邮件?(默认值:true)。目前只能通过环境变量进行配置,因此获得管理员凭据的用户无法禁用此设置并在不知情的情况下访问其帐户。
此变量还控制Metabase用于了解已登录用户位置的地理编码服务。将此变量设置为false也会禁用此逆地理编码功能。
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 Cookie的更多信息。
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_GOOGLE_SHEETS_INTEGRATION
- 类型:布尔值
- 默认值:
null
- 配置文件名:
show-google-sheets-integration
是否向用户显示设置Google表格集成的按钮。
启用后,我们会向用户显示一个按钮,用于使用Google进行身份验证以从Google表格导入数据。
MB_SHOW_HOMEPAGE_DATA
是否在主页上显示数据。管理员可能会关闭此功能,以便引导用户访问比原始数据更好的内容。
MB_SHOW_HOMEPAGE_XRAYS
是否在主页上显示X射线建议。如果固定了任何仪表板,它们也将被隐藏。管理员可能会隐藏此功能,以引导用户访问比原始数据更好的内容。
MB_SHOW_METABASE_LINKS
- 类型:布尔值
- 默认值:
true
- 配置文件名:
show-metabase-links
是否在管理员设置之外显示Metabase链接。
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
应发布错误报告的频道名称。
MB_SLACK_FILES_CHANNEL [已弃用]
已弃用:0.54.0
- 类型:字符串
- 默认值:
metabase_files
- 配置文件名:
slack-files-channel
Metabase文件最初应上传到的频道名称。
MB_SMTP_OVERRIDE_ENABLED
- 类型:布尔值
- 默认值:
false
- 配置文件名:
smtp-override-enabled
是否使用自定义SMTP服务器而不是标准设置。
MB_SOURCE_ADDRESS_HEADER
通过此头的名称而非其远程地址来识别HTTP请求的来源。
MB_SQL_JDBC_FETCH_SIZE
- 类型:整数
- 默认值:
500
结果集的获取大小。我们希望确保jdbc ResultSet对象不会在内存中实现整个结果。
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_SYNC_LEAF_FIELDS_LIMIT
- 类型:整数
- 默认值:
1000
- 导出为:
sync-leaf-fields-limit
。
每个文档数据库集合同步的叶字段的最大数量。目前与Mongo相关。不要与同步字段的总数混淆。对于每个选定的叶字段,从根到叶的所有中间字段也都会同步。
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_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 保留以下应用程序数据库表行数据的最长天数
查询执行
审计日志
查看日志
每天两次,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
请求头的最大大小(以字节为单位)。如果遇到“Request Header Fields Too Large”之类的错误,请增加此值。
MB_JETTY_SSL
类型:布尔值
默认值:null
设置为true
时,将使用MB_JETTY_SSL_*
变量中配置的选项启用HTTPS。
另请参阅自定义Jetty Web服务器文档页面。
MB_JETTY_SSL_CLIENT_AUTH
类型:布尔值
默认值:null
配置Java SSL客户端身份验证。设置为true
时,客户端证书是必需的,并由信任库中的证书颁发机构进行验证。
MB_JETTY_SSL_KEYSTORE
类型:字符串
默认值:null
Java密钥库文件的路径。
MB_JETTY_SSL_KEYSTORE_PASSWORD
类型:字符串
默认值:null
Java密钥库文件的密码。
MB_JETTY_SSL_PORT
类型:整数
默认值:null
配置用于HTTPS的端口。它将侦听MB_JETTY_HOST中指定的接口。
MB_JETTY_SSL_TRUSTSTORE
类型:字符串
默认值:null
Java信任库文件的路径。
MB_JETTY_SSL_TRUSTSTORE_PASSWORD
类型:字符串
默认值:null
Java信任库文件的密码。
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以在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 的文档。