環境變數

此文件是透過執行來源程式碼所產生

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

  • 類型:整數
  • 預設值:10000
  • 匯出為aggregated-query-row-limit
  • 組態檔名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

設定後,所有 API 請求都需要此 API 金鑰。

中介軟體,透過請求標頭 X-Metabase-Apikey 強制執行用戶端驗證。如果標頭可用,則會根據 MB_API_KEY 進行驗證。比對成功後,請求會繼續;否則會遭到封鎖,並傳回 403 Forbidden 回應。

MB_APPLICATION_COLORS

僅適用於 Metabase ProEnterprise 方案。

選擇在整個 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

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:app/assets/img/favicon.ico
  • 匯出為application-favicon-url
  • 組態檔名application-favicon-url

上傳檔案以用作 Favicon。

MB_APPLICATION_FONT

僅適用於 Metabase ProEnterprise 方案。

將「Lato」取代為字型系列。

MB_APPLICATION_FONT_FILES

僅適用於 Metabase ProEnterprise 方案。

  • 類型: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

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:app/assets/img/logo.svg
  • 匯出為application-logo-url
  • 組態檔名application-logo-url

上傳檔案以取代頂端列上的 Metabase 標誌。

不支援內嵌樣式和內嵌指令碼。

MB_APPLICATION_NAME

僅適用於 Metabase ProEnterprise 方案。

取代出現「Metabase」一詞的所有地方。

MB_ATTACHMENT_TABLE_ROW_LIMIT

  • 類型:正整數
  • 預設值:20

在警示或訂閱影像中呈現的最大列數。

範圍:1-100。若要限制電子郵件儀表板訂閱檔案附件中包含的總列數,請使用 MB_UNAGGREGATED_QUERY_ROW_LIMIT。

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

JSON,其中包含有關自訂 GeoJSON 檔案的資訊,以用於地圖視覺化,而不是預設的美國州或世界 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

匯出列數限制,不包含標頭。xlsx 下載限制為 1048575 列,即使此限制更高。

MB_EE_AI_FEATURES_ENABLED

  • 類型:布林值
  • 預設值:false
  • 組態檔名ee-ai-features-enabled

啟用 AI 功能。

此功能為實驗性功能。

MB_EE_OPENAI_API_KEY

  • 類型:字串
  • 預設值:null
  • 組態檔名ee-openai-api-key

Metabase Enterprise 中使用的 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_ORIGINS_INTERACTIVE

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名embedding-app-origins-interactive

允許這些以空格分隔的來源嵌入 Metabase 互動式內容。

MB_EMBEDDING_APP_ORIGINS_SDK

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:localhost:*
  • 組態檔名embedding-app-origins-sdk

允許 Metabase SDK 存取這些以空格分隔的來源。

MB_EMBEDDING_HOMEPAGE

  • 類型:關鍵字
  • 預設值::hidden
  • 匯出為embedding-homepage
  • 組態檔名embedding-homepage

嵌入首頁狀態,指示其為可見、隱藏或已關閉。

MB_EMBEDDING_SECRET_KEY

  • 類型:字串
  • 預設值:null
  • 組態檔名embedding-secret-key

用於簽署 JSON Web Tokens 的密鑰,用於對 /api/embed 端點的請求。

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_FIELD_USAGE_ANALYSIS

  • 類型:布林值
  • 預設值:false
  • 組態檔名enable-field-usage-analysis

啟用查詢的欄位使用分析。這將分析查詢中使用的欄位,並將其儲存在應用程式資料庫中。

Turn off by default since we havent had an user-facing feature that uses this data yet.

MB_ENABLE_PASSWORD_LOGIN

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值: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

允許使用者使用 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_HEALTH_CHECK_LOGGING_ENABLED

  • 類型:布林值
  • 預設值:true

是否記錄來自會話中間體的健康檢查請求。

僅適用於 Metabase ProEnterprise 方案。

  • 類型:關鍵字
  • 預設值::metabase
  • 組態檔名help-link

用於控制說明連結白標化的關鍵字設定。有效值為 :metabase:hidden:custom。如果設定為 :custom,說明連結將使用 help-link-custom-destination 中指定的 URL,如果未設定,則會隱藏。

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:https://metabase.dev.org.tw/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

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:email
  • 組態檔名jwt-attribute-email

用於檢索 JWT 使用者電子郵件地址的密鑰。

MB_JWT_ATTRIBUTE_FIRSTNAME

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:first_name
  • 組態檔名jwt-attribute-firstname

用於檢索 JWT 使用者名字的密鑰。

MB_JWT_ATTRIBUTE_GROUPS

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:groups
  • 組態檔名jwt-attribute-groups

用於檢索 JWT 使用者群組的密鑰。

MB_JWT_ATTRIBUTE_LASTNAME

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:last_name
  • 組態檔名jwt-attribute-lastname

用於檢索 JWT 使用者姓氏的密鑰。

MB_JWT_ENABLED

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:false
  • 組態檔名jwt-enabled

是否已配置並啟用 JWT 驗證?

設定為 true 時,將啟用 JWT 驗證,並使用 MB_JWT_* 變數中配置的選項。這適用於 JWT SSO 驗證,與靜態嵌入無關,靜態嵌入使用 MB_EMBEDDING_SECRET_KEY。

MB_JWT_GROUP_MAPPINGS

僅適用於 Metabase ProEnterprise 方案。

  • 類型:json
  • 預設值:{}
  • 組態檔名jwt-group-mappings

包含 JWT 到 Metabase 群組對應的 JSON。

JSON 物件,包含 JWT 到 Metabase 群組的對應,其中鍵是 JWT 群組,值是 Metabase 群組 ID 的列表。

MB_JWT_GROUP_SYNC

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:false
  • 組態檔名jwt-group-sync

啟用與 JWT 的群組成員資格同步。

MB_JWT_IDENTITY_PROVIDER_URI

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名jwt-identity-provider-uri

基於 JWT 的登入頁面的 URL。如果僅將 JWT SSO 與嵌入式分析 SDK 搭配使用,則為選填。

MB_JWT_SHARED_SECRET

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名jwt-shared-secret

用於為驗證 JWT 訊息的私密金鑰植入種子的字串。強烈建議使用十六進位編碼的 256 位元金鑰(即 64 個字元的字串)。

MB_JWT_USER_PROVISIONING_ENABLED

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:true
  • 組態檔名jwt-user-provisioning-enabled

當我們啟用 JWT 使用者佈建時,我們會為沒有 Metabase 帳戶的使用者在 JWT 登入時自動建立一個帳戶。

MB_LANDING_PAGE

輸入要向使用者顯示的登陸頁面 URL。這會覆寫上面的自訂首頁設定。

MB_LANDING_PAGE_ILLUSTRATION

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:default
  • 匯出為landing-page-illustration
  • 組態檔名landing-page-illustration

用於顯示在登陸頁面上的插圖的選項。

MB_LANDING_PAGE_ILLUSTRATION_CUSTOM

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值: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

要綁定的辨別名稱 (Distinguished Name)(如果有的話),此使用者將用於查詢其他使用者的資訊。

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

伺服器主機名稱。

MB_LDAP_PASSWORD

  • 類型:字串
  • 預設值:null
  • 組態檔名ldap-password

用於查詢使用者的綁定密碼。

MB_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 登入時自動建立一個帳戶。

MB_LOADING_MESSAGE

僅適用於 Metabase ProEnterprise 方案。

  • 類型:關鍵字
  • 預設值::doing-science
  • 匯出為loading-message
  • 組態檔名loading-message

選擇在查詢執行時顯示的訊息。可能的值為 “doing-science”、“running-query” 或 “loading-results”。

MB_LOGIN_PAGE_ILLUSTRATION

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:default
  • 匯出為login-page-illustration
  • 組態檔名login-page-illustration

用於顯示在登入頁面上的插圖的選項。

MB_LOGIN_PAGE_ILLUSTRATION_CUSTOM

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值: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

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:default
  • 匯出為no-data-illustration
  • 組態檔名no-data-illustration

在執行問題後沒有結果時,用於顯示插圖的選項。

MB_NO_DATA_ILLUSTRATION_CUSTOM

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 匯出為no-data-illustration-custom
  • 組態檔名no-data-illustration-custom

在執行問題後沒有結果時的自訂插圖。

MB_NO_OBJECT_ILLUSTRATION

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:default
  • 匯出為no-object-illustration
  • 組態檔名no-object-illustration

在搜尋後沒有結果時,用於顯示插圖的選項。

MB_NO_OBJECT_ILLUSTRATION_CUSTOM

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 匯出為no-object-illustration-custom
  • 組態檔名no-object-illustration-custom

在搜尋後沒有結果時的自訂插圖。

MB_NOT_BEHIND_PROXY

  • 類型:布林值
  • 預設值:false

指示 Metabase 是否在 Proxy 後方執行,Proxy 會為傳入的請求設定來源地址標頭。

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null

預設情況下,通知連結中使用「網站 URL」,但可以覆寫。

儀表板通知連結將指向的基準 URL,而不是 Metabase 基準 URL。僅適用於使用互動式嵌入和訂閱的使用者。

MB_NOTIFICATION_THREAD_POOL_SIZE

  • 類型:整數
  • 預設值:3

用於發送通知的執行緒池大小。

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

快取的最大大小(以 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 ProEnterprise 方案。

  • 類型:字串
  • 預設值:Metabase
  • 組態檔名saml-application-name

此應用程式名稱將用於對身分提供者的請求。

MB_SAML_ATTRIBUTE_EMAIL

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • 組態檔名saml-attribute-email

使用者電子郵件地址的 SAML 屬性。

MB_SAML_ATTRIBUTE_FIRSTNAME

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
  • 組態檔名saml-attribute-firstname

使用者名字的 SAML 屬性。

MB_SAML_ATTRIBUTE_GROUP

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:member_of
  • 組態檔名saml-attribute-group

用於群組同步的 SAML 屬性。

MB_SAML_ATTRIBUTE_LASTNAME

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
  • 組態檔名saml-attribute-lastname

使用者姓氏的 SAML 屬性。

MB_SAML_ENABLED

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:false
  • 組態檔名saml-enabled

是否已配置並啟用 SAML 驗證?

MB_SAML_GROUP_MAPPINGS

僅適用於 Metabase ProEnterprise 方案。

  • 類型:json
  • 預設值:{}
  • 組態檔名saml-group-mappings

包含 SAML 到 Metabase 群組對應的 JSON。

MB_SAML_GROUP_SYNC

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:false
  • 組態檔名saml-group-sync

啟用與 SAML 的群組成員資格同步。

MB_SAML_IDENTITY_PROVIDER_CERTIFICATE

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名saml-identity-provider-certificate

身分提供者的編碼憑證。根據您的 IdP,您可能需要下載此憑證,在文字編輯器中開啟它,然後複製並貼上憑證內容到這裡。

MB_SAML_IDENTITY_PROVIDER_ISSUER

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名saml-identity-provider-issuer

這是 IdP 的唯一識別碼。通常稱為實體 ID 或僅稱為發行者。根據您的 IdP,這通常看起來像 http://www.example.com/141xkex604w0Q5PN724v

MB_SAML_IDENTITY_PROVIDER_URI

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名saml-identity-provider-uri

這是您的使用者前往登入身分提供者的 URL。根據您使用的 IdP,這通常看起來像 https://your-org-name.example.comhttps://example.com/app/my_saml_app/abc123/sso/saml

MB_SAML_KEYSTORE_ALIAS

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:metabase
  • 組態檔名saml-keystore-alias

Metabase 應用於簽署 SAML 請求的金鑰別名。

MB_SAML_KEYSTORE_PASSWORD

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:changeit
  • 組態檔名saml-keystore-password

用於開啟金鑰庫的密碼。

MB_SAML_KEYSTORE_PATH

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值:null
  • 組態檔名saml-keystore-path

用於簽署 SAML 請求的金鑰庫檔案的絕對路徑。

MB_SAML_SLO_ENABLED

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:false
  • 組態檔名saml-slo-enabled

是否已啟用 SAML 單一登出?

MB_SAML_USER_PROVISIONING_ENABLED

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:true
  • 組態檔名saml-user-provisioning-enabled

當我們啟用 SAML 使用者佈建時,我們會為沒有 Metabase 帳戶的使用者在 SAML 登入時自動建立一個帳戶。

MB_SCIM_ENABLED

  • 類型:布林值
  • 預設值:null
  • 組態檔名scim-enabled

目前是否已啟用 SCIM?

MB_SEARCH_ENGINE

  • 類型:關鍵字
  • 預設值::in-place

執行搜尋時要使用的引擎。支援的值為 :in-place 和 :appdb。

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 使用者向管理員發送新的電子郵件通知?

  • 類型:關鍵字
  • 預設值::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

  • 類型:布林值
  • 預設值: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 光建議。如果釘選任何儀表板,它們也會被隱藏。管理員可能會隱藏此功能,以便將使用者導向比原始資料更好的內容。

僅適用於 Metabase ProEnterprise 方案。

  • 類型:布林值
  • 預設值:true
  • 組態檔名show-metabase-links

是否在管理員設定之外顯示 Metabase 連結。

MB_SHOW_METABOT

僅適用於 Metabase ProEnterprise 方案。

在首頁上啟用 Metabot 角色。

MB_SITE_LOCALE

整個 Metabase UI、系統電子郵件、脈衝和警示的所有使用者的預設語言。使用者可以從自己的帳戶設定中個別覆寫此預設語言。

MB_SITE_NAME

用於此 Metabase 執行個體的名稱。

MB_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

  • 類型:字串
  • 預設值: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

這將影響諸如按週分組或在 GUI 查詢中篩選等功能。它不會影響大多數 SQL 查詢,儘管它用於在 Snowflake 中設定 WEEK_START 工作階段變數。

MB_SUBSCRIPTION_ALLOWED_DOMAINS

僅適用於 Metabase ProEnterprise 方案。

  • 類型:字串
  • 預設值: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

當有此類發行版本的新版本時,我們會在此通知您。

MB_UPLOADS_SETTINGS

  • 類型:json
  • 預設值:null
  • 組態檔名uploads-settings

上傳設定。

MB_USER_VISIBILITY

僅適用於 Metabase ProEnterprise 方案。

  • 類型:關鍵字
  • 預設值::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 ProEnterprise 方案。
類型:整數
預設值:720(Metabase 保留所有列)

設定 Metabase 為以下應用程式資料庫表格保留列的最大天數

  • query_execution
  • audit_log
  • view_log

Metabase 每天會刪除兩次早於此閾值的列。

最小值為 30 天(Metabase 將輸入的 129 值視為與 30 相同)。如果設定為 0,Metabase 將保留所有列。

MB_COLORIZE_LOGS

類型:布林值
預設值:true

為日誌行著色。當設定為 false 時,它將停用日誌行顏色。這在 Windows 上已停用。與 MB_EMOJI_IN_LOGS 相關。

MB_CONFIG_FILE_PATH

類型:字串
預設值:config.yml

此功能需要您權杖上的 config-text-file 功能旗標。

MB_CUSTOM_GEOJSON_ENABLED

類型:布林值
預設值:true

是否啟用自訂 GeoJSON 的使用。

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 從反向 Proxy 等設定遠端用戶端的 IP 位址。

MB_EMOJI_IN_LOGS

類型:布林值
預設值:true

日誌行上的表情符號。當設定為 false 時,它將停用日誌行表情符號。這在 Windows 上已停用。與 MB_COLORIZE_LOGS 相關。

MB_ENABLE_TEST_ENDPOINTS

類型:布林值
預設值:null

true 時,這將啟用 /api/testing 端點。警告:絕不應在生產系統中啟用此功能。

MB_ENABLE_XRAYS

類型:布林值
預設值:true

允許使用者使用 X 光探索資料。

MB_ENCRYPTION_SECRET_KEY

類型:字串
預設值:null

設定後,這將加密儲存在應用程式資料庫中的資料庫憑證。需求:最少 16 個字元的 base64 編碼字串。

另請參閱文件頁面加密靜態資料庫詳細資訊

MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS

類型:整數
預設值:1200
自:v47.4 起

Metabase 的查詢處理器通常會在查詢逾時時終止連線,但在實務上,某些連線可能會被切斷且 Metabase 無法偵測到,即使在查詢傳回或逾時後仍保持活動狀態。此環境變數告知 Metabase 在未從連線收到回應的情況下等待多久才終止連線。

此變數會影響被 Metabase 切斷且無法偵測到的連線(也就是說,在 Metabase 永遠不會收到連線關閉訊號,且將非活動連線視為活動連線的情況下)。如果您的連線不可靠,或是 SSH 通道後面的動態連線(其中從 SSH 通道主機到資料庫的連線可能在從 SSH 通道主機到您的資料庫的連線切斷後仍保持活動狀態),您可能需要調整此變數的值。

除非另行設定,否則 metabase.query-processor.query-timeout-ms 的預設生產值為 1,200,000 毫秒(即 1,200 秒或 20 分鐘)。

MB_JDBC_DATA_WAREHOUSE_DEBUG_UNRETURNED_CONNECTION_STACK_TRACES

類型:布林值
預設值:false
自:v51.3 起

如果 true,則針對因超出 MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS 中指定的逾時而終止的任何連線記錄堆疊追蹤。

為了在日誌中查看堆疊追蹤,您還需要透過自訂 log4j 組態將 com.mchange 日誌層級更新為「INFO」或更高。如需組態日誌層級,請參閱Metabase 日誌組態

若要設定 Metabase 在終止未傳回的連線之前應等待多久的逾時,請參閱 MB_JDBC_DATA_WAREHOUSE_UNRETURNED_CONNECTION_TIMEOUT_SECONDS

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 ProEnterprise 方案。
類型:字串
預設值:""

人們登入時要顯示的預設頁面。

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 時,預設目錄為 plugins,在與 JAR 檔案相同的位置建立。執行 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 ProEnterprise 方案。
類型:布林值
預設值:true

當在 Metabase 上建立新的 SSO 使用者時,向管理員群組中的使用者發送電子郵件通知。

MB_SETUP_TOKEN

類型:字串
預設值:null

UUID 權杖,用於表示執行個體具有建立初始使用者的權限。這是由第一個執行個體在 Metabase 首次啟動時建立的;一旦使用,它就會被清除,永遠不會再次使用。

MB_SHOW_LIGHTHOUSE_ILLUSTRATION

僅適用於 Metabase ProEnterprise 方案。
類型:布林值
預設值: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 憑證的 Base64 編碼公鑰。指定此項以啟用 HTTP 公鑰釘選。不再建議使用 HPKP。如需詳細資訊,請參閱 http://mzl.la/1EnfqBf。

閱讀其他Metabase 版本的文件。