tsm configuration set 選項

以下是您可以使用 tsm configuration set 命令進行設定之組態選項或金鑰的清單。在許多情況下,您可以使用 tsm configuration get 命令找出組態金鑰目前的值。

此清單並非 Tableau Server 組態設定的完整清單。其中僅顯示伺服器管理員可設定的部分組態金鑰。最終,Tableau Server 內部使用的某些金鑰並未顯示在此清單中。

附註:組態金鑰區分大小寫。

tsm 組態金鑰的基本用途

設定組態金鑰

tsm configuration set -k <config.key> -v <config_value>

在某些情況下,必須加入 --force-keys 選項才能針對先前尚未設定之金鑰的組態值進行設定。有關詳情,請參閱「不明金鑰」回應

設定組態金鑰值之後,您必須使用 tsm pending-changes apply 套用待定組態變更。在您執行該操作之前,新值將不會由 Tableau 使用或顯示在 tsm configuration get 命令的結果中。您可以使用 tsm pending-changes list 檢視待定變更。有關詳情,請參閱 tsm pending-changes

將組態金鑰重設為預設值

若要將設定鍵重設回其預設值,請使用 -d 選項:

tsm configuration set -k <config.key> -d

檢視組態金鑰目前的值

若要檢視組態機碼目前的設定,請使用 configuration get 命令:

tsm configuration get -k <config.key>

在某些情況下,您無法獲得先前尚未設定之金鑰的組態值。系統會改以 tsm configuration get 命令傳回「不明金鑰」反應。有關詳情,請參閱「不明金鑰」回應

組態金鑰

adminviews.disabled

預設值:false

停用 Tableau 管理檢視存取。預設情況下,檢視存取為啟用狀態(此選項設定為「false」)。

api.server.enabled

預設值:true

允許存取 Tableau Server REST API(Link opens in a new window)。預設情況下,此功能已啟用。

auditing.enabled

預設值:true

允許存取 PostgreSQL(Tableau Server 自己的資料庫)歷史審計表。

backgrounder.externalquerycachewarmup.enabled

預設值:true

在排程的擷取重新整理任務之後控制工作簿查詢結果緩存。

backgrounder.externalquerycachewarmup.view_threshold

預設值:2.0

用於在排程擷取重新整理任務之後緩存工作簿查詢結果的閾值。此閾值等於工作簿在過去七天內收到的檢視數除以未來七天內排程的重新整理次數。

下列兩個 backgrounder 命令選項決定流程工作在取消流程背景工作之前可以執行的時間。這兩個命令共同決定流程工作的總逾時值。

backgrounder.extra_timeout_in_seconds

預設值:1800

取消幕後工作之前超出 backgrounder.querylimit 中的設定的秒數。此設定可確保任務停止後不妨礙後續作業。此設定適用於 backgrounder.timeout_tasks 中列出的處理序。1800 秒是 30 分鐘。

backgrounder.default_timeout.run_flow

預設值:14400

流程執行工作的秒數已取消。14,400 秒是 4 小時。

backgrounder.failure_threshold_for_run_prevention

預設值:5

工作掛起前訂閱、擷取或流程執行工作連續失敗的次數。掛起連續失敗的作業有助於為其他作業保留幕後程式資源。若要停用掛起失敗的幕後工作,請將其設定為 -1

backgrounder.log.level

附註:在版本 2020.3.0 新增

預設值:info

背景程式流程的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

backgrounder.querylimit

預設值:7200

完成一次擷取重新整理任務或訂閱任務允許的最長時間,以秒為單位。7200 秒 = 2小時。

附註: 如果幕後工作達到此時間限制,則在被取消的同時,它可以繼續額外執行幾分鐘。

backgrounder.notifications_enabled

預設值:true

控制是否為伺服器上的所有網站啟用擷取重新整理和流程執行警示。預設情況下啟用了通知。若要為伺服器上的所有網站禁用警示,請將此項設定為 false

網站管理員可以在網站設定中按網站或在使用者設定中的使用者層級啟用或禁用擷取通知。

backgrounder.sort_jobs_by_type_schedule_boundary_heuristics_milliSeconds

預設值:60000

控制時間視窗,此時間視窗標識被確定為具有相同排程開始時間的幕後程式作業。

幕後程式處理序會對按作業類型排程在同一時間執行的工作進行排序,首先執行最快類別的作業:訂閱,然後是增量擷取,最後是完整擷取。

系統會對作業進行批次處理以確定「同時」安排的作業。值 60,000 毫秒(預設值)表示在 1 分鐘時間視窗內啟動的排程作業應歸類為同一批,因此應在該批內按類型進行排序。

backgrounder.subscription_failure_threshold_for_run_prevention

預設值:5

決定在警示條件擱置前必須發生的連續訂閱失敗次數。設定為預設值 5 時,會在 5 次連續訂閱失敗後擱置警示。值 -1 將允許通知電子郵件無限期繼續。此閾值為全伺服器設定,因此適用於伺服器上定義的所有訂閱。

backgrounder.subscription_image_caching

預設值:true

控制幕後程式是否緩存為訂閱產生的影像。不必每次重新產生緩存的影像,因此緩存可提高訂閱性能。預設情況下已啟用影像緩存。若要為伺服器上的所有網站禁用影像緩存,請將此項設定為 false

backgrounder.timeout_tasks

預設值:refresh_extracts,
increment_extracts,
subscription_notify,
single_subscription_notify,
check_data_alert,
run_flow,
encrypt_extracts,
decrypt_extracts,
rekey_extracts,
extract_encryption_maintenance

執行時間比 backgrounder.querylimitbackgrounder.extra_timeout_in_seconds 中的組合值長時可取消的任務的清單。此任務清單用逗號分隔。預設清單表示此設定的所有可能的值。

basefilepath.backuprestore

預設值:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

tsm maintenance backup 命令建立備份的位置。這也是使用 tsm maintenance restore 命令或 tsm maintenance send-logs 命令還原時,備份檔案必須存在的位置。有關詳情,請參閱tsm File Paths

basefilepath.log_archive

預設值:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

tsm maintenance ziplogs 命令建立壓縮封存的位置。有關詳情,請參閱tsm File Paths

basefilepath.site_export.exports

預設值:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports\

tsm sites export 命令建立匯出檔案的位置。有關詳情,請參閱tsm File Paths

basefilepath.site_import.exports

預設值:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\

tsm sites import 命令希望匯入檔案所在的位置。有關詳情,請參閱tsm File Paths

clustercontroller.log.level

附註:在版本 2020.3.0 新增

預設值:info

「叢集控制器」的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

clustercontroller.zk_session_timeout_ms

預設值:300000

叢集控制器在確定需要容錯移轉之前將等待協調服務的時間長度(以毫秒為單位)。

dataAlerts.checkIntervalInMinutes

預設值:60

Tableau Server 進行檢查以判定資料警示條件是否為 True 的頻率,單位:分鐘。

(每當重新整理與資料警示相關的擷取時,伺服器也會進行檢查。)

dataAlerts.retryFailedAlertsAfterCheckInterval

預設值:true

決定 Tableau Server 重新檢查失敗資料警示的頻率。如果設定為 true,伺服器將按 dataAlerts.checkIntervalInMinutes 定義的頻率重新檢查失敗通知。如果設定為 false,伺服器將每隔五分鐘重新檢查失敗通知,從而能在資料狀況發生變更時更快地向通知收件人發出通知,但會降低伺服器性能。

(每當重新整理與資料警示相關的擷取時,伺服器也會進行檢查。)

dataAlerts.SuspendFailureThreshold

Default value: 350

判斷在條件擱置而發出警示前必須發生的連續資料警示失敗次數。預設值設為 350 時,警示大約會在為期 2 週的警示後擱置。此閾值為全伺服器設定,因此適用於伺服器上定義的所有資料警示。

dataserver.log.level

附註:在版本 2020.3.0 新增

預設值:info

「資料伺服器」的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

dataengine.port

預設值:27042

資料引擎在其中執行的埠。

dataserver.port

預設值:9700

Data Server 在其中執行的埠。

DataServerRefreshMetadataPerSession

預設值:false

當基礎架構結構發生變更時,確定 Tableau Server 是否將進行附加查詢來獲取已發佈資料來源的更新架構資料。出於性能原因,此參數預設情況下已禁用,並且在顯示架構變更時存在延遲。如果希望快速反映出即時已發佈資料來源中的架構變更,或者看到錯誤(例如,「與資料來源通訊時出錯:無效的列名。無法準備語句。」),請將此參數設定為 true。設定為 true 時,Tableau Server 將進行附加查詢來更新架構。

elasticserver.vmopts

預設值會因系統記憶體大小而有所不同。使用下表確定預設值:

系統記憶體 預設值
29 GB 以下 -Xmx256m -Xms256m (256 MB)
30 GB 到 45 GB -Xmx2g -Xms2g (2 GB)
46 GB 到 100 GB -Xmx4g -Xms4g (4 GB)
大於 100 GB -Xmx8g -Xms8g (8 GB)

控制彈性伺服器堆積大小。讓堆積大小超越預設值也許能改善「資料問答」(Ask Data) 效能。堆積大小通常小於整個機器記憶體的一半。將字母「k」附加到值表示 KB、附加「m」表示 MB,附加「g」表示 GB。一半情況下,將初始堆積大小 (-Xms) 設定為等於最大堆積大小 (-Xmx) 以最大程度地減小記憶體回收。

以下建議提供您根據資料來源數目和可用記憶體來配置多少記憶體的資訊。實際效能會因伺服器、資料來源中的欄位數目及其他因素而有所不同。

  • 1 至 100 個資料來源:256 MB(最小)
  • 100 至 1000 個資料來源:2 GB
  • 1,000 至 2,000 個資料來源:4 GB
  • 2,000 至 4,000 個資料來源:8 GB
  • 4,000 至 8,000 個資料來源:16 GB
  • 8,000 或更多資料來源:32 GB

Tableau Server 版本開始新增此選項:2019.1

excel.shadow_copy_all_remote.enabled

預設值:false

控制 Tableau Server是否會對用來做為即時資料來源的共用 Excel 試算表(.xlxs.xlxm),建立「陰影複製」。啟用時,這個選項會防止 Excel 使用者看到「共用違規錯誤」,以及檔案「目前正在使用中」的訊息。這個選項對於大型的 Excel 檔案可能會有效能上的影響。如果 Excel 使用者不需要編輯共用檔案,則不需要啟用這個選項。

附註:Tableau Server 一律會嘗試建立 .xls 檔案的陰影複製。此選項不會變更該行為。

這個選項已從下列 Tableau Server 版本開始加入:2019.1.5、2019.2.1。

功能。ActiveMQ

預設值:true

控制 Tableau Server 是否使用 Apache ActiveMQ 服務(Tableau Server 傳訊服務)作為內部傳訊機制。

從下列 Tableau Server 版本開始新增此選項:2019.4。

features.DesktopReporting

預設值:false

控制是否在伺服器上啟用桌面授權報告。設定為 false(預設值)時,則沒有與桌面授權相關的管理檢視可用。將此選項設定為 true 以啟用授權報告,並使授權使用量及過期管理檢視在「伺服器狀態」頁上可見。

功能。MessageBusEnabled

預設值:true

控制 Tableau Server 是否使用新的內部傳訊機制。

從下列 Tableau Server 版本開始新增此選項:2019.4。

features.PasswordlessBootstrapInit

預設值:true

控制 Tableau Server 是否允許在啟動程序檔案包含內嵌認證。啟用(預設值)時,除非您指定不應包含內嵌認證,否則內嵌認證包含在啟動程序檔案中。如果認證不應包含在您產生的任何啟動程序檔案中,請將此設定為 false。有關產生啟動程序檔案的詳情,請參閱 tsm topology nodes get-bootstrap-file

從 Tableau Server 2019.3 版本起已加入此選項。

features.PasswordReset

預設值:false

僅適用於使用本地驗證的伺服器。設定為 true 可讓使用者在登入頁面上使用「忘記密碼」選項重設密碼。

filestore.log.level

附註:在版本 2020.3.0 新增

預設值:info

「檔案存放區」的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

gateway.http.cachecontrol.updated

預設值:false

快取控制 HTTP 標頭指定用戶端瀏覽器是否應該快取從 Tableau Server 傳送的內容。若要停用用戶端上的 Tableau Server 資料快取,請將此選項設定為 true

gateway.http.hsts

預設值:false

HTTP 嚴格傳輸安全性 (HSTS) 頭強制瀏覽器在啟用它的域上使用 HTTPS。

gateway.http.hsts_options

預設值:"max-age=31536000"

預設情況下,會為一年(31536000 秒)期間設定 HSTS 原則。此時間段指定瀏覽器將透過 HTTPS 存取伺服器的時間量。

gateway.http.request_size_limit

預設值:16380

允許根據 HTTP 請求透過 Apache 閘道傳遞的標頭內容的大小上限(位元組)。標頭超過此選項上設定的值將導致瀏覽器錯誤,如 HTTP 錯誤 413(請求實體太大)或驗證失敗。

gateway.http.request_size_limit 的值較低可能會導致驗證錯誤。與 Active Directory(SAML 和 Kerberos)整合的單一登入解決方案在 HTTP 標頭中經常需要大型驗證權杖。一定要在部署到生產環境之前測試 HTTP 驗證方案。

我們建議將 tomcat.http.maxrequestsize 選項設定為您為此選項設定的相同值。

gateway.http.x_content_type_nosniff

預設值:true

X-Content-Type-Options 回應 HTTP 頭指定 Content-Type 頭中的 MIME 類型不應由瀏覽器變更。在某些情況下,如果未指定 MIME 類型,則瀏覽器可能會透過評估有效負載的特徵來嘗試確定 MIME 類型。然後瀏覽器將相應地顯示內容。這個過程被稱為「嗅探」。誤解 MIME 類型可能會導致安全性漏洞。預設情況下,系統使用此選項將 X-Content-Type-Options HTTP 頭設定為「nosniff」。

gateway.http.x_xss_protection

預設值:true

HTTP X-XSS-Protection 回應頭會傳送到瀏覽器以啟用跨網站指令碼 (XSS) 保護。在使用者在瀏覽器中停用XSS 保護的情況下,X-XSS-Protection 回應頭會覆蓋設定。預設情況下,系統使用此選項啟用了 X-XSS-Protection 回應頭。

gateway.log.level

附註:在版本 2020.3.0 新增

預設值:info

閘道的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

gateway.public.host

預設值:<hostname>

伺服器的名稱 (URL),用於對 Tableau Server 進行外部存取。如果將 Tableau Server 設定為使用 Proxy 伺服器或外部負載平衡器,則它是在瀏覽器位址欄中輸入的用於存取 Tableau Server 的名稱。例如,如果透過輸入 tableau.example.com 來存取 Tableau Server,則 gateway.public.host 的名稱是 tableau.example.com

gateway.public.port

預設值:80 (如果採用 SSL,則為 443

僅適用於 Proxy 伺服器環境。 Proxy 伺服器所偵聽的外部埠。

gateway.slow_post_protection.enabled

預設值:false

透過啟用此選項,將可使以極慢速率傳輸資料的 POST 請求超時,從而以防禦慢速 POST(拒絕服務)攻擊上提供一些幫助。

附註: 此選項無法消除此類攻擊的威脅,並且可能會有終止慢速連線的意外影響。

gateway.slow_post_protection.request_read_timeout

預設值:header=15-20,MinRate=500 body=10,MinRate=500

透過前面的選項 gateway.slow_post_protection.enabled 啟用後,此選項會設定 Apache httpd ReadRequestTimeout。httpd 指示詞會記錄在 Apache 模組 mod_reqtimeout(Link opens in a new window)。此選項的主要用途做為防禦 Slowloris 攻擊。請參閱 Wikipedia 條目 Slowloris (computer security)(Link opens in a new window)

gateway.timeout

預設值:1800

閘道在請求失敗前等待特定事件的最長時間,以秒為單位(1800 秒 = 30 分鐘)。

gateway.trusted

預設值:Proxy 伺服器機器的 IP 位址

僅適用於 Proxy 伺服器環境。 Proxy 伺服器的 IP 位址或主機名稱。

gateway.trusted_hosts

預設值: Proxy 伺服器的備用名稱

僅適用於 Proxy 伺服器環境。 Proxy 伺服器的任何備用主機名稱。

hyper.file_partition_size_limit

預設值:0

設為 0 時,大小會設為不限制並將使用所有可用的磁碟空間。

此選項用於設定多工緩衝處理至磁碟之查詢的磁碟空間限制。如果 spool.<id>.tmp 檔案的磁碟空間使用量大於環境所需使用量,則意味著查詢正在進行多工緩衝處理並佔用磁碟空間。使用此選項可限制任一查詢可使用的磁碟空間量。spool.<id>.tmp 檔案可在執行 Tableau Server 的使用者帳戶的 temp 資料夾中找到。您可以以 K(KB)、M(MB)、G(GB) 或 T(TB) 為單位指定此值。例如,當您要將磁碟空間使用量限制為 100 GB 時,可將大小限制指定為 100G。

有關多工緩衝處理的詳情,請參閱 Tableau Server 資料引擎中的〈記憶體與 CPU 使用量〉一節。

hyper.global_file_partition_size_limit

預設值:0

設為 0 時,大小會設為不限制並將使用所有可用的磁碟空間。

此選項用於設定多工緩衝處理至磁碟之所有查詢的磁碟空間限制。如果 spool.<id>.tmp 檔案的磁碟空間使用量大於環境所需使用量,則意味著查詢正在進行多工緩衝處理並佔用磁碟空間。spool.<id>.tmp 檔案可在執行 Tableau Server 的使用者帳戶的 temp 資料夾中找到。使用此選項可限制多工緩衝處理至磁碟時所使用的所有查詢總量。您可以以 K(KB)、M(MB)、G(GB) 或 T(TB) 為單位指定此值。例如,當您要將磁碟空間使用量限制為 100 GB 時,可將大小限制指定為 100G。Tableau 建議您在微調多工緩衝處理限制時啟動此設定。

有關多工緩衝處理的詳情,請參閱 Tableau Server 資料引擎中的〈記憶體與 CPU 使用量〉一節。

hyper.log_queries

預設值:true

設定為 true 時,會記錄查詢資訊。

預設情況下會記錄查詢資訊。但如果您發現記錄檔對於磁碟空間可用容量而言太大,可以將其設定為 false 以停用記錄查詢資訊。Tableau 建議將此組態集保留為 true

hyper.log_query_cpu

預設值:false

使用此設定可記錄每個查詢所需的時間及 CPU 使用量。

hyper.log_timing

預設值:false

此設定有助於深入了解查詢的詳細資訊,例如編譯和剖析時間。預設情況下,此設定為停用狀態。您可以透過將該值設定為 true 開啟此選項以收集更多有關查詢的詳細資料。但這樣會增加資料引擎記錄檔 (\logs\hyper) 的大小。

hyper.log_troublesome_query_plans

預設值:true

設為 true 時,會記錄標識為有問題的查詢之查詢計劃。已取消、執行速度慢於 10 秒的查詢或如果查詢多工緩衝處理至磁碟的查詢屬於此類別。記錄檔中的資訊可能有助於疑難排解問題查詢。如果您擔心記錄檔大小,可將該設定變更為 false

hyper.memory_limit

預設值:80%

控制 Hyper 使用的記憶體數量上限。指定位元組數量。將字母「k」附加到值表示 KB、附加「m」表示 MB、附加「g」表示 GB、附加「t」則表示 TB。例如,hyper.memory_limit='7g'。或者,也可以將記憶體限額指定為整體可用系統記憶體的百分比。例如,hyper.memory_limit='90%'

hyper.memtracker_hard_reclaim_threshold

預設值:80%

此設定僅適用於 Windows。Hyper 會將擷取中解壓縮和解密的部分保留在記憶體中,以便更快速進行後續存取。此設定會控制工作執行緒何時開始將此資料寫入磁片快取,以減少記憶體壓力。如果以百分比提供,該值將解讀為整體 hyper.memory_limit 設定的百分比。例如,hyper.memtracker_hard_reclaim_threshold='60%'。您可以將絕對值指定為「k」(KB)、「m」(MB)、「g」(GB) 或「t」(TB)。例如,hyper.memtracker_hard_reclaim_threshold='10g'。該值應大於 hyper.memtracker_soft_reclaim 閾值。

hyper.memtracker_soft_reclaim_threshold

預設值:50%

此設定僅適用於 Windows。與 Hyper 檔案互動時,Hyper 會寫出一些資料,以便快取或保存資料。Windows 具有將新寫入之資料鎖定到記憶體中的特殊行為。為了避免交換,我們會在 Hyper 達到為回收閾值設定的限額時強制剔除資料。達到柔性回收閾值時,Hyper 會嘗試在背景回收快取的資料,以嘗試維持在回收閾值之下。在其他會發生交換的情況下,在 Hyper 中觸發回收可能會產生更好的結果。因此,如果您的 Tableau Server 安裝發生大量交換,就可以使用此設定來嘗試減少記憶體壓力。

指定位元組數量。將字母「k」附加到值表示 KB、附加「m」表示 MB、附加「g」表示 GB、附加「t」則表示 TB。或者,也可將該值指定為針對 Hyper 整體設定之記憶體的百分比。例如,hyper.memtracker_soft_reclaim_threshold='20%'

hyper.network_threads

預設值:150%

控制 Hyper 使用的網路執行緒數量。指定網路執行緒數量(例如 hyper.network_threads=4)或指定與邏輯核心計數相關的執行緒百分比(例如 hyper.network_threads='300%')。

網路執行緒是用來接受新的連線,以及傳送或接收資料與查詢。Hyper 會使用非同步網路,因此可由單一執行緒提供多個連線。一般來說,在網路執行緒上完成的工作量非常低。有一個例外是在較慢的檔案系統上開啟資料庫;這可能會需要很長時間,而且會阻擋網路執行緒。您嘗試檢視或編輯使用擷取且有一段時間未使用的儀表板時,如果連線時間很慢,而且您在 Hyper 記錄中經常看到「asio-continuation-slow」訊息,且 Tableau 記錄中對 Hyper 的「construct-protocol」時間很長,請嘗試增加此值。

hyper.objectstore_validate_checksums

預設值:false

在 Hyper 中控制檔案完整性檢查的布林值設定。設定為 true 時,Hyper 會在首次存取時在擷取檔案中檢查資料。此設定可以偵測到無訊息損毀以及可能會讓 Hyper 當機的損毀。通常會建議開啟此設定,但磁碟速度很慢的安裝作業除外,因為這樣可能會導致效能退化。

hyper.query_total_time_limit

預設值:0(表示無限制)

設定可讓 Hyper 中個別查詢使用的總執行緒時間上限。將「s」附加到值表示秒,「min」表示分鐘,「h」則表示小時。例如,若要將所有查詢限制為總執行緒時間 300 秒的總時間使用量:hyper.query_total_time_limit='300s'

此設定可讓您自動控制失控的查詢,否則會使用過多的資源。Hyper 會並行執行查詢。例如,如果查詢執行了三秒鐘,而且此期間是在十個執行緒上執行,則總執行緒時間會是 30 秒。每個查詢的執行緒時間會報告在 Hyper 記錄中「total-time」欄位的「query-end」記錄項目中。

hyper.session_memory_limit

預設值:0(表示無限制)

控制個別查詢可以擁有的記憶體消耗量上限。指定位元組數量。將字母「k」附加到值表示 KB、附加「m」表示 MB、附加「g」表示 GB、附加「t」則表示 TB。例如,hyper.session_memory_limit='900m'。或者,也可以將工作階段記憶體限額指定為整體可用系統記憶體的百分比。例如,hyper.session_memory_limit='90%'

某個查詢使用過多的記憶體且使其他查詢長時間失敗時,降低此值能夠有所幫助。透過降低限額,單一大型查詢可能會失敗(如果多工緩衝處理並未關閉,則會採用多工緩衝處理),而且對其他查詢不會有負面影響。

hyper_standalone_consistent.hashing.enabled

預設值:true

提高已快取查詢的擷取機會。如果已快取擷取的節點無法支援額外負載,會將您路由至新節點,而且擷取將載入新節點上的快取。這會提升系統使用率,因為只有在真正需要負載時,才會將擷取載入記憶體。

hyper_standalone.health.enabled

預設值:true

將負載平衡指標從隨機選擇切換至根據目前 Hyper 活動和系統資源使用情況組成的健康情況分數選擇「資料引擎 (Hyper)」節點。根據這些值,負載平衡器將選擇最能處理擷取查詢的節點。

hyper.temp_disk_space_limit

預設值:100%

設定磁碟空間上限;Hyper 會在此上限停止為暫存檔案分配空間。此設定有助於防止硬碟填滿來自 Hyper 的暫存檔案且用盡磁碟空間的情形。如果磁碟空間達到此閾值,Hyper 會嘗試在沒有管理員介入的情況下自動復原。

請將其指定為要使用之整體可用磁碟空間的百分比。例如,hyper.temp_disk_space_limit='96%'。設定為 100% 時,可以使用所有可用的磁碟空間。

若要啟動資料引擎,已設定的磁碟空間必須可用。如果沒有足夠的磁碟空間,您就會看到一個資料引擎記錄項目顯示「已達到暫存檔案的磁碟空間限制。請釋出裝置上的磁碟空間。請參閱 Hyper 記錄以瞭解詳情:裝置上已無剩餘空間。」

hyper.hard_concurrent_query_thread_limit

預設值:150%

使用此選項可設定 Hyper 應用於執行查詢的執行緒數量上限。您要對 CPU 使用量設定硬性限制時,請使用此選項。請指定執行緒數量或指定與邏輯核心計數相關的執行緒百分比。Hyper 使用的資源不太可能會超過此設定所配置的數量,但 Hyper 背景和網路執行緒不會受到此設定的影響(雖然它們通常不會佔用 CPU 資源)。

請務必考慮到此設定會控制可以執行的並行查詢數量。因此,如果您減少此設定,則查詢需要等待目前執行之查詢完成的機率就會提高,因此會影響工作簿載入時間。

hyper.soft_concurrent_query_thread_limit

預設值:100%

使用此選項可以指定單一查詢可跨執行緒平行執行的執行緒數量(假設 hard_concurrent_query_thread_limit 設定有足夠的執行緒可使用)。請指定執行緒數量或指定與邏輯核心計數相關的執行緒百分比。

為了說明這一點,下面是一個簡化的例子:

假設您將此值設定為 10 個執行緒,這意味著查詢最多可在 10 個執行緒上平行執行。如果只有 2 個查詢正在執行,則其餘 8 個執行緒會用於平行執行 2 個查詢。

hyper. hard_concurrent_query_thread_limithyper.soft_concurrent_query_thread_limit 選項共同協作,為您提供一些管理 CPU 使用量的選項,可在最大程度增加可用 CPU 資源的同時更快完成查詢。如果您不希望資料引擎使用機器上的所有可用 CPU,請將其變更為最適合您的環境的小於 100% 的百分比。該柔性限制是您限制 CPU 使用量的一種方式,但同時又允許您在必要時超出柔性限制,達到硬性限制。

附註: hyper.hard_concurrent_query_thread_limithyper.soft_concurrent_query_thread_limit 取代 Tableau Server 版本 2018.3 和更早版本的中的可用 hyper.num_job_worker_threads 和 hyper.num_task_worker_thread 選項,並已在目前版本中棄用。有關 hyper.num_job_worker_threads 和hyper.num_task_worker_threads 的詳情,請參閱tsm configuration set 選項(Link opens in a new window)

hyper.use_spooling_fallback

預設值:true

設定為 true 時,其允許在查詢擷取超出設定 RAM 使用量(已安裝 RAM 的 80%)時多工緩衝處理至磁碟。換句話說,它會允許 Hyper 在超過 RAM 使用量時使用磁碟執行查詢。

Tableau 建議您使用預設設定。如果您擔心磁碟使用量,您可以透過將該值設定為 false 來關閉此設定。如果關閉此設定,將會取消使用超過已安裝 RAM 的 80% 的查詢。多工緩衝處理查詢通常需要相當長的時間才能完成。

有關多工緩衝處理的詳情,請參閱 Tableau Server 資料引擎中的〈記憶體與 CPU 使用量〉一節。

install.firewall.allowedprograms.manage

預設值:true

控制 Tableau Server 是否可新增防火牆規則。設定為 true(預設值)時,Tableau Server 會新增防火牆規則,以允許其處理序穿過 Windows 防火牆進行連線。如果您要自行管理所有防火牆規則,但是不希望 Tableau Server 新增規則,請將此設定變更為 false

java.heap.size

預設值:128m

Tomcat 堆(存放庫和 solr)的大小。除非 Tableau 建議這麼做,否則通常無需變更該值。

licensing.login_based_license_management.default_requested_duration_seconds

預設值:0

設定在系統提示使用者重新啟動 Tableau 前,其登入型授權應持續的時間(以秒為單位)。

licensing.login_based_license_management.enabled

預設值:false

設定為 True 可啟用 以登入為基礎的授權管理。設定為 False 可停用 以登入為基礎的授權管理

licensing.login_based_license_management.max_requested_duration_seconds

預設值:15552000

設定在系統提示使用者重新啟動 Tableau 前,其登入型授權應持續的最長時間(以秒為單位)。最大值是 15552000 秒(180天)。

maestro.input.allowed_paths

預設值:""

預設情況下,任意目錄的存取都將被拒絕,並且只允許發佈至具有 tflx 檔案中包含之內容的 Tableau Server。

流程輸入連線允許的網路目錄清單。您必須啟用 Tableau Prep Conductor 才能在 Tableau Server 上執行流程。如需詳細資訊,請參閱 Tableau Prep Conductor

設定此項設定時,套用且必須考慮下列規則:

  • Tableau Server 應該能夠存取路徑。這些路徑在伺服器啟動和流程執行期間進行驗證。

  • 網路目錄路徑必須為絕對,並且不能包含萬用字元或其他路徑遍歷符號。例如,\\myhost\myShare\*\\myhost\myShare* 為無效路徑並且將會導致所有路徑不受允許。安全列出 myShare 下的任何資料夾的正確方式是 \\myhost\myShare or \\myhost\\myShare\

    附註\\myhost\myShare 組態將不允許 \\myhost\myShare1。爲了安全列出這些資料夾,應將其安全列為 \\myhost\myShare; \\myhost\myShare1。

  • 此值可以是 *,以便允許任何網路目錄或網路目錄路徑清單由「;」分隔。

  • 即使值設定為 *,將不允許任何本機目錄路徑。

重要資訊:
此命令會覆寫現有的資訊,並以您提供的新資訊將其取代。如果您要新增新位置至現有的清單,則必須提供您要新增的所有位置、現有及新位置的清單。請使用下列命令查看目前的輸入及輸出位置清單:

tsm configuration get -k maestro.input.allowed_paths
tsm configuration get -k maestro.output.allowed_paths

有關設定流程輸入和輸出連線允許之目錄的詳情,請參閱輸入和輸出位置安全清單(Link opens in a new window)

maestro.output.allowed_paths

預設值:""

預設情況下,任何目錄存取都將被拒絕。

流程輸出連線允許的網路目錄清單。您必須啟用 Tableau Prep Conductor 才能在 Tableau Server 上執行流程。如需詳細資訊,請參閱 Tableau Prep Conductor

設定此項設定時,套用且必須考慮下列規則:

  • Tableau Server 應該能夠存取路徑。這些路徑在伺服器啟動和流程執行期間進行驗證。

  • 網路目錄路徑必須為絕對,並且不能包含萬用字元或其他路徑遍歷符號。例如,\\myhost\myShare\*\\myhost\myShare* 為無效路徑並且將會導致所有路徑不受允許。安全列出 myShare 下的任何資料夾的正確方式是 \\myhost\myShare or \\myhost\\myShare\

    附註\\myhost\myShare 組態將不允許 \\myhost\myShare1。爲了安全列出這些資料夾,應將其安全列為 \\myhost\myShare; \\myhost\myShare1。

  • 此值可以是 *,以便允許任何網路目錄或網路目錄路徑清單由「;」分隔。

  • 即使值設定為 *,將不允許任何本機目錄路徑。

  • 附註:如果路徑在流程允許的清單和 internal_disasslowed 清單上,internal_disallowed 會採取優先權。

有關設定流程輸入和輸出連線允許之目錄的詳情,請參閱輸入和輸出位置安全清單(Link opens in a new window)

metadata.query.limits.time

預設值:20

這是 Catalog 或 Metadata API 查詢在逾時發生和取消查詢之前可執行的最長時間(以秒為單位)。Tableau 建議使用以下命令逐步將逾時限制增加到不超過 60 秒:

tsm configuration set -k metadata.query.limits.time –v PT30S --force-keys

重要提示: 僅當您看到此處(已超過逾時限制和節點限制的訊息)描述的錯誤時,才應變更此選項。 增加逾時限制可以更長時間地利用更多 CPU,這可能會影響整個 Tableau Server 的工作的效能。增加逾時限制還會導致更高的記憶體使用率,這可能導致在並行執行查詢時交互式微服務容器出現問題。

metadata.query.limits.count

預設值:2000

這是 Catalog 在超出節點限制和取消查詢之前可以返回的物件數(可以大概對應到查詢結果數)。Tableau 建議使用以下命令逐步將逾時限制增加到不超過 100000:

tsm configuration set -k metadata.query.limits.count –v 3000 --force-keys

重要提示: 僅當您看到此處(已超過逾時限制和節點限制的訊息)描述的錯誤時,才應變更此選項。增加節點限制會導致更高的記憶體使用率,這可能導致在並行執行查詢時交互式微服務容器出現問題。

metricsservices.checkIntervalInMinutes

預設值:60

控制仰賴即時資料源之指標其重新整理之間的間隔(以分鐘為單位)。當伺服器通過指標的連接檢視檢查新資料時,指標隨即重新整理。

metricsservices.failureCountToWarnUser

預設值:10

控制在警告指標擁有者之前,必須發生的連續重新整理的失敗次數。當設定為預設值 10 時,指標重新整理必須連續失敗 10 次,然後系統才會向擁有者傳送有關故障的通知。

metricsservices.maxFailedRefreshAttempts

預設值:175

控制在指標重新整理暫停之前,必須發生的連續重新整理的失敗次數。

mobile.deep_linking.on_prem.enabled

預設值:true

使用 Tableau Mobile 應用控制連結到 Tableau Server 時是否設為深層連結。設定為 true 時,則會連結到在應用程式中開啟的支援內容類型。設定為 false 時,則會在行動瀏覽器中開啟連結。有關更多詳情,請見控制 Tableau Mobile 的深層連結

monitoring.dataengine.connection_timeout

預設值:30000

叢集控制器在確定發生連線逾時之前將等待資料引擎的時間長度(以毫秒為單位)。預設值為 30,000 毫秒(30 秒)。

native_api.connection.limit.<連線類>

設定指定資料來源(連線類)的並行查詢限制。此選項優先於資料來源的全域限制。

native_api.connection.globallimit

預設值:16

並行查詢的全域限制。除了 Amazon Redshift 的預設值為 8 之外,其他的預設值均為 16。

native_api.force_alternative_federation_engine

預設值:false

聯結單一檔案連線與單一 SQL 資料庫連線的資料時,覆寫操作限制。將這個選項設定為 True,強制 Tableau 使用即時資料庫連線處理聯結。

native_api.ProtocolTransitionLegacyFormat

預設值:false

為約束委派使用舊名稱格式。

版本 10.1 中的名稱格式已變更,以允許跨域協議轉換 (S4U)。如果這樣導致現有組態發生問題,而且您不需要跨網域通訊協定轉換,請將此參數設定為 true,以便將 Tableau Server 設定為使用舊行為。

nlp.concepts_shards_count

預設值:1

注意:對於大多數 Tableau Server 安裝而言,預設的分區計數值就足夠了。

控制存儲欄位名稱、欄位同義字和分析詞彙的「彈性搜尋概念」索引之資料分區數。分區計數對搜尋索引進行分割以縮減總索引大小,這可能會提升資料問答 (Ask Data) 的語意剖析器的效能。調整分區計數是您可以透過 elasticserver.vmopts 增加堆積大小而採取的另一種效能增強措施。

Tableau 建議每 50 GB 即將分區計數增加 1。要減少調整分區計數的次數,您可以將目前的索引大小增加 50%,並據此計算總索引大小。例如,如果總索引大小低於 50 GB,則 1 分區就足夠了。實際效能會因伺服器、索引大小增加的速率及其他因素而有所不同。

  • 0 到 50 GB:1
  • 50 GB 到 100 GB:2
  • 100 GB 到 150 GB:3

可以使用以下命令將「概念」索引分區計數從預設值增提高至 2:

tsm configuration set -k nlp.concepts_shards_count -v 2

nlp.values_shards_count

預設值:1

控制存儲欄位名稱、欄位同義字和別名的「彈性搜尋值」索引之資料分區數。分區計數對搜尋索引進行分割以縮減總索引大小,這可能會提升資料問答 (Ask Data) 的語意剖析器的效能。調整分區計數是您可以透過 elasticserver.vmopts 增加堆積大小而採取的另一種效能增強措施。

Tableau 建議每 50 GB 即將分區計數增加 1。要減少調整分區計數的次數,您可以將目前的索引大小增加 50%,並據此計算總索引大小。例如,如果總索引大小低於 50 GB,則 1 分區就足夠了。實際效能會因伺服器、索引大小增加的速率及其他因素而有所不同。

  • 0 到 50 GB:1
  • 50 GB 到 100 GB:2
  • 100 GB 到 150 GB:3

可以使用以下命令將「值」索引分區計數從預設值增提高至 2:

tsm configuration set -k nlp.values_shards_count -v 2

nlp.defaultNewSiteAskDataMode

預設值:enabled_by_default

建立站點後,使用本選項設定「資料問答模式」(Ask Data Mode) 的初始值。有關更多詳情,請參閱啟用或停用網站的資料問答 (Ask Data)

有效選項為 enabled_by_default(預設值)、disabled_by_defaultdisabled_always

這個選項已從下列 Tableau Server 版本開始加入:2019.4.5、2020.1.3。

noninteractivecontainer.vmopts

預設值:Xmx64m –Xms4g

使用此選項可增加 Tableau Catalog 擷取的 JVM 堆積大小。

可以使用以下命令將最大堆積大小從預設值增加到 16 GB:

tsm configuration set -k noninteractive.vmopts -v "-XX:+UseConcMarkSweepGC -Xmx16g -Xms64m -XX:+ExitOnOutOfMemoryError"

有關詳情,請參閱非互動式微服務容器的記憶體

pgsql.port

預設值:8060

PostgreSQL 所偵聽的埠。

pgsql.preferred_host

指定安裝了慣用存放庫的節點的電腦名稱。如果隨 tsm topology failover-repository 命令一起指定了 --preferred-r 選項,則使用此值。

範例:

tsm configuration set -k pgsql.preferred_host -v "<host_name>"

附註: host_name 區分大小寫,而且必須符合 tsm status -v 輸出中顯示的節點名稱。

pgsql.verify_restore.port

預設值:8061

用於驗證 PosgreSQL 資料庫完整性的埠。有關詳情,請參閱tsm maintenance backup

recommendations.enabled

預設值:true

控制建議功能,該功能為資料來源和資料表(針對 Tableau Desktop)的建議以及檢視的建議(針對 Tableau Server)提供支援。建議的提供以內容受歡迎的程度為準,或以經確認與目前使用者相似的其他使用者所使用的內容為準。

recommendations.vizrecs.enabled

預設值:true

控制針對 Tableau Server 使用者的檢視的建議。此選項是 recommendations.enabled 的子選項,如果父選項設定為 false,則該選項將不起作用。當父選項設定為 true 而此選項設定為 false 時,將仍向 Tableau Desktop 使用者推薦資料來源和資料表,但將停用 Tableau Server 上檢視的建議。

redis.max_memory_in_mb

預設值:1024

指定快取伺服器外部查詢快取的大小(單位:MB)。

refresh_token.absolute_expiry_in_seconds

預設值:31536000

指定重新整理和存取權杖的絕對過期秒數。用戶端(Tableau Mobile、Tableau Desktop、Tableau Prep 等)在首次登入後使用權杖驗證 Tableau Server。此組態金鑰也管理個人的權杖過期存取。所有重新整理和存取權杖都是一種 Oauth 權杖。若要刪除限制,設為 -1。若要停用 OAuth 權杖,請參閱停用自動用戶端驗證

refresh_token.idle_expiry_in_seconds

預設值:1209600

指定空閒 Oauth 權杖將過期時的秒數。在初始登入後,使用者端使用 Oauth 權杖向 Tableau Server 進行驗證。若要移除限制,請設定為 -1

refresh_token.max_count_per_user

預設值:24

指定可以為每個使用者頒發的重新整理權杖的最大數量。如果使用者會話比預期更早過期,則可以增加此值或將其設定為 -1 以完全移除權杖限制。

rsync.timeout

預設值:600

完成檔同步所允許的最長時間(以秒為單位)(600 秒 = 10 分鐘)。檔同步在設定高可用性或移動資料引擎和存放庫的過程中發生。

schedules.display_schedule_description_as_name

預設值:false

控制在建立訂閱或擷取重新整理時是顯示排程名稱(預設值),還是顯示描述排程的時間和頻率的「排程頻率說明」名稱。若要將 Tableau Server 設定為顯示排程的時區敏感名稱,請將該值設定為 true

設定為 true 時,也會在排程清單頁面上的排程名稱之後顯示「排程頻率說明」。

schedules.display_schedules_in_client_timezone

預設值:true

設定為 true 時,在使用者的時區中顯示「排程頻率說明」(使用使用者端瀏覽器時區計算「排程頻率說明」)。

searchserver.connection_timeout_milliseconds

在版本 2019.1 中新增。

預設值(單位:毫秒):100000

指定搜尋和流覽用戶端等待建立與搜尋和流覽伺服器之連線所需的時間(單位:毫秒)。

在特別繁忙的 Tableau Server 電腦上,或者如果您看到記錄檔錯誤訊息:「zookeeper 健康情況檢查失敗」。拒絕啟動 SOLR 會增加這個值。

有關詳情,請參閱用戶端工作階段逾時

searchserver.javamemopts

在版本 2020.1 中新增。

預設值:-Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

判別 SOLR 的 JVM 選項。

在所有可配置選項中,藉由 -Xmx 參數所設定的堆積記憶體上限,是調整搜尋伺服器時最重要的項目。在大多數情況下,應根據 Tableau Server 電腦上的可用實體記憶體,盡可能在設定中提高此值,最高為 24 GB。若僅僅要變更堆積記憶體上限,請指定整個預設字串,但僅變更 -Xmx 值。

-Xmx 的有效值取決於 Tableau Server 電腦上的可用記憶體,但不可大於 24 GB。有關詳細資訊,請參閱搜尋和瀏覽最大堆積記憶體

searchserver.startup.zookeeper_healthcheck_timeout_ms

在版本 2020.1 中新增。

預設值(單位:毫秒):300000

以毫秒為單位指定 Tableau Server 在啟動時,系統等待順利完成 Zookeeper 健康情況檢查的時間。

在特別繁忙的 Tableau Server 電腦上,或者如果您看到記錄檔錯誤訊息:「zookeeper 健康情況檢查失敗」。拒絕啟動 SOLR 會增加這個值。

有關詳情,請參閱 啟動時,Zookeeper 連線健康情況檢查逾時

searchserver.zookeeper_session_timeout_milliseconds

預設值(單位:毫秒):100000

指定搜尋和流覽用戶端等待建立與協調服務 (Zookeeper) 之連線所需的時間(單位:毫秒)。

有關詳情,請參閱用戶端工作階段逾時

service.jmx_enabled

預設值:false

設定為 true 則可將 JMX 埠用於可選的監視和故障排除。

service.max_procs

預設值:<number>

最大伺服器處理序數。

service.port_remapping.enabled

預設值:true

確定在預設的或設定的埠不可用時 Tableau Server 是否嘗試動態地重新對應埠。設定為 false 會停用動態埠重新對應。

session.ipsticky

預設值:false

使使用者端會話僅對用於登入的 IP 位址有效。如果發出請求的 IP 位址和與會話權杖關聯的 IP 位址不同,則將會話權杖視為無效。

在某些情況下(例如,當具有已知靜態 IP 位址的電腦存取 Tableau Server 時),此設定可提高安全性。

附註:請仔細考慮此設定是否能為您的伺服器安全帶來幫助。此設定要求使用者端具有唯一 IP 位址以及在會話持續時間內保持相同的 IP 地址。例如,處於 Proxy 後面的不同使用者看起來可能具有相同的 IP 位址(即 Proxy 的 IP 位址);在這種情況下,一個使用者可能能夠存取另一個使用者的會話。在另一種情況下,使用者可能具有動態 IP 位址,並且其位址可能會在會話過程中發生變化。如果是這樣,使用者必須要再次登入。

sheet_image.enabled

預設值:true

控制是否可以使用 REST API 獲取檢視的影像。有關詳情,請參閱 REST API 參考

solr.rebuild_index_timeout

預設值:7200

當升級 Tableau Server 或還原 .tsbak 檔時,幕後工作重新產生搜尋索引。此設定(單位:秒)會控制該工作的逾時設定(7200 秒 = 120 分鐘)。

storage.monitoring.email_enabled

預設值:false

控制是否啟用伺服器磁碟空間監控的電子郵件通知。預設情況下,系統會啟用電子郵件通知。若要啟用磁碟空間監控的通知,請將此設為 true

必須設定 SMTP,才能傳送通知。有關詳情,請參閱設定 SMTP 組態

storage.monitoring.warning_percent

預設值:20

剩餘磁碟空間的警告閾值,以總磁碟空間百分比表示。如果磁碟空間低於此閾值,則系統會傳送警告通知。

storage.monitoring.critical_percent

預設值:10

剩餘磁碟空間的嚴重閾值,以總磁碟空間百分比表示。如果磁碟空間低於此閾值,則系統會傳送嚴重通知。

storage.monitoring.email_interval_min

預設值:60

當磁碟空間監視功能啟用,且已超過閾值時,應該傳送電子郵件通知的頻率(以分鐘表示)。

storage.monitoring.record_history_enabled

預設值:true

判斷可用磁碟空間歷史記錄是否儲存,並可在管理檢視中查看。若要停用監控的歷史記錄儲存,請將 storage.monitoring.record_history_enabled 設定為 false

subscriptions.enabled

預設值:false

控制是否可在系統範圍內設定訂閱。請參閱 設定訂閱站點

subscriptions.timeout

預設值:1800

在工作簿訂閱工作逾時前,該工作的檢視呈現的時間長度,以秒為單位。如果在呈現檢視時達到此時間限制,則會繼續呈現,但不會呈現工作簿中任何後續檢視,而且作業會在錯誤中結束。在單一檢視工作簿的情況下,此值永遠不會造成因逾時而停止呈現。

svcmonitor.notification.smtp.enabled

預設值:false

控制是否啟用伺服器程序事件的電子郵件通知。預設情況下,當程序停止運作、容錯移轉或重新啟動時,系統會傳送通知。若要啟用伺服器程序通知,請將此設定為 true

必須設定 SMTP,才能傳送通知。有關詳情,請參閱設定 SMTP 組態

tabadmincontroller.auth.expiration.minutes

預設值:120

控制工作階段 Cookie 的有效時間長度。預設情況下,其設定為 120 分鐘。這個值也會決定內嵌認證在節點啟動程序檔案中的有效時間長度。有關詳情,請參閱 tsm topology nodes get-bootstrap-file

tdsservice.log.level

附註:在版本 2020.3.0 新增

預設值:info

資料來源屬性服務的記錄層級。這是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

tomcat.http.maxrequestsize

預設值:16380

允許根據 HTTP 請求透過 Apache 閘道傳遞的標頭內容的大小上限(位元組)。標頭超過此選項上設定的值將導致瀏覽器錯誤,如 HTTP 錯誤 413(請求實體太大)或驗證失敗。

tomcat.http.maxrequestsize 的值較低可能會導致驗證錯誤。與 Active Directory(SAML 和 Kerberos)整合的單一登入解決方案在 HTTP 標頭中經常需要大型驗證權杖。一定要在部署到生產環境之前測試 HTTP 驗證方案。

我們建議將 gateway.http.request_size_limit 選項設定為您為此選項設定的相同值。

tomcat.https.port

預設值:8443

Tomcat 的 SSL 埠(未使用)。

tomcat.server.port

預設值:8085

tomcat 偵聽關機訊息的埠。

tomcatcontainer.log.level

預設值:info

互動式微服務容器和非互動式微服務容器中的微服務紀錄層級。 有關詳情,請參閱變更記錄層級

tsm.log.level

預設值:info

TSM 服務的記錄層級這些記錄包括在 TSM 服務出現問題時,可提供幫助的資訊:管理代理程式、管理控制器、用戶端檔案服務、叢集控制器、服務管理員,以及授權服務。這個組態金鑰不會變更 Coordination Service 或維護程序的記錄層級。有關詳情,請參閱變更記錄層級Tableau Server 處理序

tsm.controlapp.log.level

預設值:info

control_<app> 服務的記錄層級。如果您在啟動或重新設定 TSM 或 Tableau Server 處理序時遇到問題,這些記錄包括的資訊可能有所幫助。有關詳情,請參閱變更記錄層級

vizportal.adsync.update_system_user

預設值:false

指定在 Tableau Server 中同步 Active Directory 組時使用者的電子郵寄地址和顯示名稱是否變更(即使在 Active Directory 中變更)。為了確保使用者電子郵寄地址和顯示名稱在同步過程中更新,請將 vizportal.adsync.update_system_user 設定為 true,然後重新啟動伺服器。

vizportal.commenting.delete_enabled

預設值:true

設定為 true 時,允許使用者刪除檢視上的注釋。如果您是注釋的建立者、內容所有人或具有相應網站角色的項目主管,或者是管理員,則可以刪除注釋。若要瞭解需要哪些網站角色才能獲得完全項目主管存取權限,請參閱專案級管理

vizportal.csv_user_mgmt.index_site_users

預設值:true

指定在使用 CSV 檔匯入或刪除使用者時是否逐個使用者地完成網站使用者索引。如果設定為 true(預設值),則會在新增或刪除每個使用者時完成索引編製。若要將網站使用者的索引延遲到處理完整個 CSV 檔之後,請將此項設定為 false

vizportal.log.level

預設值:info

vizportal Java 元件的記錄層級。記錄寫入 C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizportal\*.log

如需詳細資料,請設定為 debug。使用調試設定可能會顯著影響性能,因此您應該僅當 Tableau 支援部門指示時才使用此設定。

vizportal.openid.client_authentication

指定 OpenID Connect 的自訂用戶端驗證方法。

若要設定 Tableau Server 以使用需要 client_secret_post 的 IdP,請將此值設定為 client_secret_post

例如,連線至需要此設定的 Salesforce IDP。

vizportal.rest_api.cors.allow_origin

指定當 vizportal.rest_api.cors.enabled 設定為 true 時經允授權以存取 Tableau Server 上的 REST API 端點的源(網站)。您可以用逗號 (,) 分隔每個條目來指定多個源。

tsm configuration set vizportal.rest_api.cors.allow_origin https://mysite, https://yoursite

如果 vizportal.rest_api.cors.enabledfalse,則此選項列出的源會被忽略。有關詳情,請參閱在 Tableau Server 上啟用 CORS

附註: 您可以使用星號 (*) 作為萬用字元來相符所有網站。不建議這樣做,因為它允許從具有伺服器存取權限的任何源進行存取,並且可能存在安全風險。不要使用星號 (*),除非您完全瞭解您的網站的影響和風險。

vizportal.rest_api.cors.enabled

預設值:false

控制 Tableau Server 是否允許進行跨源資源分享 (CORS)。設定為 true 時,伺服器允許 Web 瀏覽器存取 Tableau REST API 端點。您可以使用此選項和 REST API 建立自訂門戶。預設情況下,此功能未啟用。若要指定具有存取權限的源(網站),請使用 vizportal.rest_api.cors.allow_origin 選項。只允許使用此選項指定的源向 Tableau Server REST API 發出請求。有關詳情,請參閱在 Tableau Server 上啟用 CORS

vizqlserver.allow_insecure_scripts

預設值:false

允許透過 Tableau Desktop 將工作簿發佈到伺服器,以及從伺服器中開啟工作簿,即使該工作簿包含可能不安全的 SQL 或 R 運算式(例如,可能允許 SQL 注入的 SQL 運算式)。如果此設定為 false(預設值),則發佈工作簿或從伺服器中開啟工作簿會導致出現錯誤訊息,並且工作將被阻止。在您將此值設定為 true 之前,請先檢閱知識庫文章:封鎖或允許 Tableau Server 中的 Insecure 指令碼(Link opens in a new window)

vizqlserver.browser.render

預設值:true

低於由 vizqlserver.browser.render_thresholdvizqlserver.browser.render_threshold_mobile 設定的閾值的檢視由使用者端 Web 瀏覽器(而非伺服器)呈現。有關詳情,請參閱 設定用戶端轉譯

vizqlserver.browser.render_threshold

預設值:100

預設值表示 PC 上顯示的檢視的高複雜度。複雜度因素包括標記數、標題數、參考線數和註解數。高於此複雜度的檢視由伺服器呈現,而不是在 PC 的 Web 瀏覽器中呈現。

vizqlserver.browser.render_threshold_mobile

預設值:60

預設值表示平板電腦上顯示的檢視的高複雜度。複雜度因素包括標記數、標題數、參考線數和註解數。高於此複雜度的檢視由伺服器呈現,而不是在平板電腦的 Web 瀏覽器中呈現。

vizqlserver.clear_session_on_unload

預設值:false

確定當使用者離開檢視或關閉其瀏覽器時是否將 VizQL 會話保留在記憶體中。預設值 (false) 會將會話保留在記憶體中。若在要離開檢視或關閉瀏覽器時關閉 VizQL 會話,請將此項設定為 true

vizqlserver.geosearch_cache_size

預設值:5

設定可同時載入到伺服器記憶體中的不同地理搜尋地區設定/語言資料集的最大數量。如果伺服器收到針對不在記憶體中的地區設定/語言資料集的地理搜尋請求,則會將該集載入到記憶體中。如果載入資料集會超出指定限額,則會從記憶體中清除最近使用的地區設定/語言資料集,以便可載入請求的地區設定/語言資料集。最小值為 1。每個緩存在記憶體中佔用大約 60 MB,因此,如果您將此項設定為 10,記憶體使用量將為 600 MB (60 * 10)。

vizqlserver.initialsql.disabled

預設值:false

指定是否忽略所有資料來源的初始 SQL 陳述式。將此設定為 true 以忽略初始 SQL:

tsm configuration set -k vizqlserver.initialsql.disabled -v true

vizqlserver.log.level

預設值:info

vizportal Java 元件的記錄層級。記錄寫入 C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizportal\*.log

如需詳細資料,請設定為 debug。使用調試設定可能會顯著影響效能,因此您應該僅當 Tableau 支援部門指示時才使用它。

附註:從 2020.3.0 版本起,這便是可動態設定的,因此,如果您只是加以變更,不必重新啟動 Tableau Server。有關詳情,請參閱變更記錄層級

vizqlserver.NumberOfWorkbookChangesBetweenAutoSaves

預設值:5

Web 製作自動復原設定。指定使用者必須執行變更以觸發自動儲存的次數。變更此值時請小心。自動復原功能可能會影響到 Tableau Server 上的 Web 製作和其他視覺效果相關操作的效能。我們建議隨時間進行增量調整來微調此值。

vizqlserver.port

預設值:9100

VizQL 伺服器的基本埠。

vizqlserver.protect_sessions

預設值:true

當設定為 true 時,可防止 VizQL 會話在原始使用者結束後被重用。

vizqlserver.querylimit

預設值:1800

更新檢視允許的最長時間,以秒為單位。1800 秒 = 30 分鐘。

vizqlserver.RecoveryAttemptLimitPerSession

預設值:3

Web 製作自動復原設定。復原相同工作階段的最大嘗試次數。變更此值時請小心。自動復原功能可能會影響到 Tableau Server 上的 Web 製作和其他視覺效果相關操作的效能。我們建議隨時間進行增量調整來微調此值。

vizqlserver.session.expiry.minimum

預設值:5

當 VizQL 處理序開始出現記憶體不足的情況時,允許丟棄 VizQL 會話前的閒置時間分鐘數。

vizqlserver.session.expiry.timeout

預設值:30

丟棄 VizQL 會話前的閒置時間分鐘數。

vizqlserver.sheet_image_api.max_age_floor

預設值:1

用於緩存由 REST API 的「查詢檢視影像」方法產生的影像的時間(以分鐘為單位)。有關詳情,請參閱 REST API 說明中的 REST API 參考(Link opens in a new window)

vizqlserver.showdownload

預設值:true

控制檢視中「下載」功能表的「Tableau 工作簿」選項的顯示。設定為 false 時,Tableau 工作簿選項不可用。

vizqlserver.showshare

預設值:true

控制檢視中「共用」選項的顯示。若要隱藏這些選項,請設定為「False」。

附註: 使用者可以覆蓋伺服器預設值,方法是設定「showShareOptions」JavaScript 或 URL 參數。

vizqlserver.url_scheme_whitelist

指定在檢視和儀表板上使用 URL 動作(Link opens in a new window)時要列入安全名單的一個或多個 URL 方案。預設情況下,httphttpsgophermailtonewssmsteltsctsl 方案會被列入安全名單。此命令可以包含多個逗號和空格分隔的值,如本範例中所示:

tsm configuration set -k vizqlserver.url_scheme_whitelist -v scheme1, scheme2

您指定的值將覆寫以前的設定。因此,您必須在 set 命令中包括完整的方案清單。(您無法透過重複執行 set 命令來修改方案清單。)

vizqlserver.WorkbookTooLargeToCheckpointSizeKiB

預設值:1024

Web 製作自動復原設定。自動儲存之工作簿的大小限制 (KB)。大於此值的工作簿將不會被自動儲存。變更此值時請小心。自動復原功能可能會影響到 Tableau Server 上的 Web 製作和其他視覺效果相關操作的效能。我們建議隨時間進行增量調整來微調此值。

webdataconnector.refresh.enabled

已棄用。請改用 tsm data-access web-data-connectors allow

確定是否在 Tableau Server 中為 Web 資料連接器 (WDC) 啟用擷取重新整理。要對所有 WDC 停用重新整理,請將此鍵的值設定為 false,如下所示:

tsm configuration set --key webdataconnector.refresh.enabled --value false

若要瞭解詳情,請參閱 Tableau Server 中的 Web 資料連接器

webdataconnector.whitelist.fixed

已棄用。請改用 tsm data-access web-data-connectors add

指定一個或多個可用於存取可透過 HTTP 或 HTTPS 存取的資料連線的 Web 資料連接器 (WDC)。該命令在單行上格式化為 JSON 資料,所有雙引號 (") 都使用反斜線 (\) 轉義。

例如,將三藩市影業地點 WDC 新增到安全清單中:

tsm configuration set --key webdataconnector.whitelist.fixed --value "'{\"https://tableau.data.world:443\": {\"properties\": { \"secondary_whitelist\": [\"(https://data.world/)(.*)\"] } } }'"

若要瞭解詳情,請參閱 Tableau Server 中的 Web 資料連接器

webdataconnector.enabled

已棄用。請改用 tsm data-access web-data-connectors allow

預設值:true

設定為 true 後,可以使用 tsm 命令來管理伺服器上的 Web 資料連接器。

webdataconnector.whitelist.mode

預設值:mixed

確定 Tableau Server 如何執行 Web 資料連接器。支援的模式為:

  • mixed。使用者可以執行在 URL 的許可清單(安全名單)上的連接器。此模式最初也允許使用者運行已匯入的 WDC。不再支援匯入WDC。
  • fixed。使用者可以執行在 URL 的許可清單(安全名單)上的連接器。
  • insecure。使用者可以執行任何連接器。

重要資訊: insecure 選項用於開發和測試。因為連接器會執行自訂代碼,因此執行尚未審核的連接器可以會對安全構成威脅。

wgserver.audit_history_expiration_days

預設值:183

指定歷史事件記錄從 PostgreSQL 資料庫(Tableau Server 資料庫)刪除後的天數。

wgserver.change_owner.enabled

預設值:true

控制工作簿、資料來源或專案的所有權能否變更。其他選項包括 falseadminonly

wgserver.clickjack_defense.enabled

預設值:true

設定為 true 時,可幫助阻止惡意人員「Clickjacking」Tableau Server 使用者。在 Clickjack 攻擊中,目標頁面以透明方式顯示在另一個頁面之上,攻擊者將誘使使用者在目標頁面中按一下或輸入資訊,而使用者會認為自己在與另一個頁面交互。

有關詳情,請參閱Clickjack 保護

wgserver.domain.fqdn

預設值:%USERDOMAIN% 的值

要使用的 Active Directory 伺服器的完全限定功能變數名稱。

wgserver.domain.whitelist

預設值:Null

允許從 Tableau Server 連線至次要 Active Directory 網域。次要網域是 Tableau Server 連線的目的地,藉此進行使用者同步作業,不過卻是尚未安裝 Tableau Server 的網域。Tableau Server 將嘗試連線至次要網域以進行使用者和群組同步作業。在某些情況下,Tableau Server 可能無法連線至次要網域,因而導致出現錯誤訊息:「網域不在白名單中(錯誤代碼 = 101015)」。

設定 wgserver.domain.whitelist 選項是安全性漏洞修正程式的必要項目,[重要] ADV-2020-003:Tableau Server 強制執行身份驗證(Link opens in a new window)。自 2020 年 2 月起,此漏洞的修正程式包含在 Tableau Server 的所有最新版本和維護版本中。

要設定此選項,請輸入用雙引號括起來的次要網域。多個網域必須用逗號和空格分隔。例如,"example.org, domain.com"

不支援萬用字元功能。例如,如果 Tableau 連線至 sub1.example.orgsub2.example.org,則必須新增這兩個網域。

更新 wgserver.domain.whitelist 選項將覆寫現有值。因此,如果要將新網域加入至存儲在值中的一組現有網域,請在設定選項時,將新網域連同所有現有網域一併加入。您可以藉由執行 tsm configuration get –k wgserver.domain.whitelist 擷取現有網域的完整清單。

wgserver.extended_trusted_ip_checking

預設值:false

為受信任的票證請求強制實施 IP 使用者端相符。

wgserver.restrict_options_method

預設值:true

控制 Tableau Server 是否接受 HTTP OPTIONS 請求。如果此選項設定為 true,則伺服器將為 HTTP OPTIONS 請求返回 HTTP 405(不允許的方法)。

wgserver.saml.idpattribute.username

指定 SAML IdP 儲存使用者名稱的屬性名稱。預設情況下,其設定為 username。如果 IdP 使用的屬性名稱包含空格,請用引號將其括起。有關詳情,請參閱設定全伺服器的 SAML設定特定於網站的 SAML

wgserver.saml.iframed_idp.enabled

預設值:false

預設值為 false,這意味著當使用者選取嵌入檢視上的登入按鈕時,IdP 的登入表單將在快顯視窗中打開。

當您將其設定為 true 時,已經登入的伺服器 SAML 使用者將導航到具有嵌入檢視的網頁,使用者將無需登入即可查看該檢視。

如果 IdP 支援在 iframe 內登入,則可以將其設定為 true。iframe 選項沒有使用快顯視窗安全,所以並不是所有 IdP 都支援它。如果 IdP 登入頁面實現點擊劫持保護,大多數情況下,登入頁面無法顯示在 iframe 中,並且使用者無法登入。

如果您的 IdP 確實支援透過 iframe 登入,您可能需要顯式啟用它。但是,即使您可以使用此選項,它也會針對 SAML 停用 Tableau Server 點擊劫持保護,因此它仍然有安全風險。

wgserver.saml.maxassertiontime

預設值:3000

指定自建立後 SAML 判斷提示可用的最大秒數。

wgserver.saml.responseskew

預設值:180

設定仍允許處理訊息的 Tableau Server 時間與判斷提示建立時間(基於 IdP 伺服器時間)之間的最大秒數差。

wgserver.session.apply_lifetime_limit

預設值:false

控制伺服器會話是否存在會話生命週期。將此值設定為 true可以設定伺服器工作階段生命週期。

wgserver.session.idle_limit

預設值:240

登入 Web 應用程式發生超時前的閒置時間分鐘數。

wgserver.session.lifetime_limit

預設值:1440

伺服器會話持續的分鐘數(如果設定了會話生命週期)。預設值為 1440 分鐘(24 小時)。如果 wgserver.session.apply_lifetime_limitfalse(預設值),則會忽略此項。

wgserver.unrestricted_ticket

預設值:false

指定是否為透過受信任票證進行驗證的使用者將存取權限擴展到伺服器資源。預設行為僅允許使用者存取檢視。將此項設定為 true 可允許具有有效受信任票證的使用者存取伺服器資源(專案、工作簿等),就好像他們已使用自己的認證登入一樣。

workerX.gateway.port

預設值:80 (如果採用 SSL,則為 443

Apache 偵聽 workerX 所在的外部埠(其中「worker」是用於叢集中後續伺服器節點的術語)。worker0.gateway.port 是 Tableau Server 的外部埠。在分散式環境中,worker0 是初始 Tableau Server 節點。

workerX.vizqlserver.procs

預設值:<number>

VizQL 伺服器數。

zookeeper.config.snapCount

指定導致協調服務建立記錄快照集所必需的事務數。預設情況下,此值為 100,000 個事務。如果協調服務未寫入足夠的事務來產生快照集,則不會自動清理超過 5 天的快照集,並且您可能需要額外的磁碟空間來存儲事務記錄。預設情況下,會在 Tableau 資料目錄中建立事務記錄和快照集。

感謝您的意見回饋! 提交意見回饋時發生錯誤。重試或傳送訊息給我們