環境變數
此文件是透過執行來源程式碼所產生
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
設定後,所有 API 請求都需要此 API 金鑰。
中介軟體,透過請求標頭 X-Metabase-Apikey 強制執行用戶端驗證。如果標頭可用,則會根據 MB_API_KEY 進行驗證。比對成功後,請求會繼續;否則會遭到封鎖,並傳回 403 Forbidden 回應。
MB_APPLICATION_COLORS
僅適用於 Metabase Pro 和 Enterprise 方案。
選擇在整個 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 Pro 和 Enterprise 方案。
上傳檔案以用作 Favicon。
MB_APPLICATION_FONT
僅適用於 Metabase Pro 和 Enterprise 方案。
將「Lato」取代為字型系列。
MB_APPLICATION_FONT_FILES
僅適用於 Metabase Pro 和 Enterprise 方案。
告訴我們在哪裡可以找到每個字型粗細的檔案。您不需要全部包含,但如果您這樣做,看起來會更好。
範例值
[
{
"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 Pro 和 Enterprise 方案。
上傳檔案以取代頂端列上的 Metabase 標誌。
不支援內嵌樣式和內嵌指令碼。
MB_APPLICATION_NAME
僅適用於 Metabase Pro 和 Enterprise 方案。
取代出現「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
是否啟用自訂 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
。
匯出列數限制,不包含標頭。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
每秒可以傳送的最大收件者數量,在電子郵件中加總。請注意,在達到限制之前傳送的最後一封電子郵件可能會超過限制(如果有多個收件者)。
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 Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
embedding-app-origins-interactive
允許這些以空格分隔的來源嵌入 Metabase 互動式內容。
MB_EMBEDDING_APP_ORIGINS_SDK
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
localhost:*
- 組態檔名:
embedding-app-origins-sdk
允許 Metabase SDK 存取這些以空格分隔的來源。
MB_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 Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
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_HEALTH_CHECK_LOGGING_ENABLED
- 類型:布林值
- 預設值:
true
是否記錄來自會話中間體的健康檢查請求。
MB_HELP_LINK
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:關鍵字
- 預設值:
:metabase
- 組態檔名:
help-link
用於控制說明連結白標化的關鍵字設定。有效值為 :metabase
、:hidden
和 :custom
。如果設定為 :custom
,說明連結將使用 help-link-custom-destination
中指定的 URL,如果未設定,則會隱藏。
MB_HELP_LINK_CUSTOM_DESTINATION
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
https://metabase.dev.org.tw/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
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
email
- 組態檔名:
jwt-attribute-email
用於檢索 JWT 使用者電子郵件地址的密鑰。
MB_JWT_ATTRIBUTE_FIRSTNAME
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
first_name
- 組態檔名:
jwt-attribute-firstname
用於檢索 JWT 使用者名字的密鑰。
MB_JWT_ATTRIBUTE_GROUPS
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
groups
- 組態檔名:
jwt-attribute-groups
用於檢索 JWT 使用者群組的密鑰。
MB_JWT_ATTRIBUTE_LASTNAME
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
last_name
- 組態檔名:
jwt-attribute-lastname
用於檢索 JWT 使用者姓氏的密鑰。
MB_JWT_ENABLED
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
false
- 組態檔名:
jwt-enabled
是否已配置並啟用 JWT 驗證?
設定為 true 時,將啟用 JWT 驗證,並使用 MB_JWT_* 變數中配置的選項。這適用於 JWT SSO 驗證,與靜態嵌入無關,靜態嵌入使用 MB_EMBEDDING_SECRET_KEY。
MB_JWT_GROUP_MAPPINGS
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:json
- 預設值:
{}
- 組態檔名:
jwt-group-mappings
包含 JWT 到 Metabase 群組對應的 JSON。
JSON 物件,包含 JWT 到 Metabase 群組的對應,其中鍵是 JWT 群組,值是 Metabase 群組 ID 的列表。
MB_JWT_GROUP_SYNC
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
false
- 組態檔名:
jwt-group-sync
啟用與 JWT 的群組成員資格同步。
MB_JWT_IDENTITY_PROVIDER_URI
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
jwt-identity-provider-uri
基於 JWT 的登入頁面的 URL。如果僅將 JWT SSO 與嵌入式分析 SDK 搭配使用,則為選填。
MB_JWT_SHARED_SECRET
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
jwt-shared-secret
用於為驗證 JWT 訊息的私密金鑰植入種子的字串。強烈建議使用十六進位編碼的 256 位元金鑰(即 64 個字元的字串)。
MB_JWT_USER_PROVISIONING_ENABLED
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
true
- 組態檔名:
jwt-user-provisioning-enabled
當我們啟用 JWT 使用者佈建時,我們會為沒有 Metabase 帳戶的使用者在 JWT 登入時自動建立一個帳戶。
MB_LANDING_PAGE
輸入要向使用者顯示的登陸頁面 URL。這會覆寫上面的自訂首頁設定。
MB_LANDING_PAGE_ILLUSTRATION
僅適用於 Metabase Pro 和 Enterprise 方案。
用於顯示在登陸頁面上的插圖的選項。
MB_LANDING_PAGE_ILLUSTRATION_CUSTOM
僅適用於 Metabase Pro 和 Enterprise 方案。
登陸頁面的自訂插圖。
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
- 類型:字串
- 預設值:
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 登入時自動建立一個帳戶。
MB_LOADING_MESSAGE
僅適用於 Metabase Pro 和 Enterprise 方案。
選擇在查詢執行時顯示的訊息。可能的值為 “doing-science”、“running-query” 或 “loading-results”。
MB_LOGIN_PAGE_ILLUSTRATION
僅適用於 Metabase Pro 和 Enterprise 方案。
用於顯示在登入頁面上的插圖的選項。
MB_LOGIN_PAGE_ILLUSTRATION_CUSTOM
僅適用於 Metabase Pro 和 Enterprise 方案。
登入頁面的自訂插圖。
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 Pro 和 Enterprise 方案。
在執行問題後沒有結果時,用於顯示插圖的選項。
MB_NO_DATA_ILLUSTRATION_CUSTOM
僅適用於 Metabase Pro 和 Enterprise 方案。
在執行問題後沒有結果時的自訂插圖。
MB_NO_OBJECT_ILLUSTRATION
僅適用於 Metabase Pro 和 Enterprise 方案。
在搜尋後沒有結果時,用於顯示插圖的選項。
MB_NO_OBJECT_ILLUSTRATION_CUSTOM
僅適用於 Metabase Pro 和 Enterprise 方案。
在搜尋後沒有結果時的自訂插圖。
MB_NOT_BEHIND_PROXY
- 類型:布林值
- 預設值:
false
指示 Metabase 是否在 Proxy 後方執行,Proxy 會為傳入的請求設定來源地址標頭。
MB_NOTIFICATION_LINK_BASE_URL
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
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
允許將模型持久化到來源資料庫中。
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 Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
Metabase
- 組態檔名:
saml-application-name
此應用程式名稱將用於對身分提供者的請求。
MB_SAML_ATTRIBUTE_EMAIL
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
- 組態檔名:
saml-attribute-email
使用者電子郵件地址的 SAML 屬性。
MB_SAML_ATTRIBUTE_FIRSTNAME
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
- 組態檔名:
saml-attribute-firstname
使用者名字的 SAML 屬性。
MB_SAML_ATTRIBUTE_GROUP
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
member_of
- 組態檔名:
saml-attribute-group
用於群組同步的 SAML 屬性。
MB_SAML_ATTRIBUTE_LASTNAME
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
- 組態檔名:
saml-attribute-lastname
使用者姓氏的 SAML 屬性。
MB_SAML_ENABLED
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
false
- 組態檔名:
saml-enabled
是否已配置並啟用 SAML 驗證?
MB_SAML_GROUP_MAPPINGS
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:json
- 預設值:
{}
- 組態檔名:
saml-group-mappings
包含 SAML 到 Metabase 群組對應的 JSON。
MB_SAML_GROUP_SYNC
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
false
- 組態檔名:
saml-group-sync
啟用與 SAML 的群組成員資格同步。
MB_SAML_IDENTITY_PROVIDER_CERTIFICATE
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
saml-identity-provider-certificate
身分提供者的編碼憑證。根據您的 IdP,您可能需要下載此憑證,在文字編輯器中開啟它,然後複製並貼上憑證內容到這裡。
MB_SAML_IDENTITY_PROVIDER_ISSUER
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
saml-identity-provider-issuer
這是 IdP 的唯一識別碼。通常稱為實體 ID 或僅稱為發行者。根據您的 IdP,這通常看起來像 http://www.example.com/141xkex604w0Q5PN724v
。
MB_SAML_IDENTITY_PROVIDER_URI
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
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 Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
metabase
- 組態檔名:
saml-keystore-alias
Metabase 應用於簽署 SAML 請求的金鑰別名。
MB_SAML_KEYSTORE_PASSWORD
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
changeit
- 組態檔名:
saml-keystore-password
用於開啟金鑰庫的密碼。
MB_SAML_KEYSTORE_PATH
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:字串
- 預設值:
null
- 組態檔名:
saml-keystore-path
用於簽署 SAML 請求的金鑰庫檔案的絕對路徑。
MB_SAML_SLO_ENABLED
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
false
- 組態檔名:
saml-slo-enabled
是否已啟用 SAML 單一登出?
MB_SAML_USER_PROVISIONING_ENABLED
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
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
在 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 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_HOMEPAGE_DATA
是否在首頁上顯示資料。管理員可能會關閉此功能,以便將使用者導向比原始資料更好的內容。
MB_SHOW_HOMEPAGE_XRAYS
是否在首頁上顯示 X 光建議。如果釘選任何儀表板,它們也會被隱藏。管理員可能會隱藏此功能,以便將使用者導向比原始資料更好的內容。
MB_SHOW_METABASE_LINKS
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:布林值
- 預設值:
true
- 組態檔名:
show-metabase-links
是否在管理員設定之外顯示 Metabase 連結。
MB_SHOW_METABOT
僅適用於 Metabase Pro 和 Enterprise 方案。
在首頁上啟用 Metabot 角色。
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
- 類型:字串
- 預設值:
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
僅適用於 Metabase Pro 和 Enterprise 方案。
允許用於新的儀表板訂閱和警示的電子郵件地址網域。若要指定多個網域,請用逗號分隔每個網域,中間不要有空格。若要允許所有網域,請將此欄位留空。此設定不會影響現有的訂閱。
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_SETTINGS
- 類型:json
- 預設值:
null
- 組態檔名:
uploads-settings
上傳設定。
MB_USER_VISIBILITY
僅適用於 Metabase Pro 和 Enterprise 方案。
- 類型:關鍵字
- 預設值:
: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 Pro 和 Enterprise 方案。
類型:整數
預設值: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_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 Pro 和 Enterprise 方案。
類型:字串
預設值:""
人們登入時要顯示的預設頁面。
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 Pro 和 Enterprise 方案。
類型:布林值
預設值:true
當在 Metabase 上建立新的 SSO 使用者時,向管理員群組中的使用者發送電子郵件通知。
MB_SETUP_TOKEN
類型:字串
預設值:null
UUID 權杖,用於表示執行個體具有建立初始使用者的權限。這是由第一個執行個體在 Metabase 首次啟動時建立的;一旦使用,它就會被清除,永遠不會再次使用。
MB_SHOW_LIGHTHOUSE_ILLUSTRATION
僅適用於 Metabase Pro 和 Enterprise 方案。
類型:布林值
預設值: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 版本的文件。