Windows 版 Tableau Server 說明

您可在初始節點（安裝 TSM 的所在節點），或是叢集中的任何其他節點上執行 tsm 命令。

若要執行 tsm 命令，您必須開啟 Windows 命令提示字元。請勿使用 PowerShell 執行 tsm 命令。使用 PowerShell 可能會出現非預期的行為。

1. 使用屬於叢集中節點上的「管理員」群組成員的帳戶開啟 Windows 命令提示字元。

2. 執行您要的命令。如果您透過非初始節點執行命令，請加入 -s 選項以按照名稱（而非 IP 位址）指定初始節點的 URL，以及加入 TSM 連接埠 8850。

   若要從初始節點查看 TSM 和 Tableau Server 的版本：

   tsm version

   若要從其他節點查看 TSM 和 Tableau Server 的版本：

   tsm version -s https://<inital_node_name>:8850

   例如：

   tsm version -s https://myTableauHost:8850

backgrounder.failure_threshold_for_run_prevention

預設值：5

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

backgrounder.log.level

版本：在版本 2020.3.0 中新增。

預設值：info

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

backgrounder.restrict_serial_collections_to_site_level

預設值：false

在 Tableau Server 中，可以將擷取重新整理、訂閱或流程排程為定期執行。這些排程項目稱為「工作」。背景程式處理序會在排定的時間啟動這些工作的唯一執行個體以執行它們。因此，所啟動工作的唯一執行個體稱為「作業」。

此設定會影響設定為串列執行的排程。預設情況下，當排程設定為串列執行時，使用該排程的所有工作都將串列執行。當此設定設為true，在不同站台上執行的工作可以並行執行。同一站台上排程任務的工作將繼續串列執行。

下面的範例說明了這種情況：

Tableau Server 包含一個名為「每日」的排程，用於每天早上七點執行工作。「每日」排程設定為串列執行。站台「人資」和站台「工資單」各有多個使用排程「每日」的排程任務。當此設定設為true，站台「人資」上這些排程任務的工作可以與站台「工資單」上的工作並列執行，而同一站台上的工作依然只能串列執行。

backgrounder.timeout.single_subscription_notify

版本：在版本 2021.2 中新增。

預設值：1800 秒（30 分鐘）

這是完成單個訂閱工作的最長允許時間（以秒為單位）。

backgrounder.timeout.sync_ad_group

版本： 在版本 2021.1.23、2021.2.21、2021.3.20、2021.4.15、2022.1.11、2022.3.3、2023.1 中新增。

預設值：14400 秒（4 小時）

這是完成 Active Directory 群組同步的最長允許時間（以秒為單位）。這適用於由後台程序服務完成對排程群組同步，防止長期執行的同步無限期執行。這不會影響使用 Tableau Server UI 或 REST API 完成的群組同步。

backgrounder.vInstances_max_overflow_queue_size

版本：在版本 20221.2 中新增。

預設值：1000

可以在從屬隊列中的最大作業數。執行的作業數量達到設定的並發限制後，將建立從屬隊列。預設最大值為 1000 個作業 - 這意味著如果在達到並發限制時有超過 1000 個作業，則任何超過 1000 個作業都不會排隊。使用 backgrounder.vInstance_max_overflow_queue_size tsm 命令變更溢出最大隊列大小。

這些值應以整數指定。

backup.zstd.thread_count

版本：在版本 2021.1.0 中新增。此金鑰可動態設定。有關詳情，請參閱 Tableau Server 動態拓撲變更

預設值： 2

建立備份時應使用的執行緒數。

增加此數字可以提高備份效能，但建議執行緒數不超過 Tableau Server 電腦上的邏輯處理器數字（最多四個）。

basefilepath.backuprestore

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

tsm maintenance backup 命令建立備份的位置。這也是使用 tsm maintenance restore 命令或 tsm maintenance send-logs 命令還原時，備份檔案必須存在的位置。設定後，應該執行tsm maintenance validate-backup-basefilepath命令（在 2022.1 及更高版本中可用），驗證是否為該位置正確設定了權限。有關詳情，請參閱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。有關詳情，請參閱變更記錄層級。

databaseservice.max_database_deletes_per_run

版本：在版本 2021.2 中新增。

預設值：Null

使用此選項可調整每次後台過程執行時可刪除的內嵌外部資產（資料庫和表格）的最大數量，由features.DeleteOrphanedEmbeddedDatabaseAsset控制。如果此選項空白，則可刪除的內嵌外部資產的預設最大數量為 100。

有關詳情，請參閱 features.DeleteOrphanedEmbeddedDatabaseAsset。

dataserver.log.level

版本：在版本 2020.3.0 中新增。

預設值：info

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

dataserver_<n>.port

執行資料伺服器執行個體（由「<n>」指定）的連接埠。

excel.shadow_copy_all_remote.enabled

版本：在 2019.1.5、2019.2.1 版本中增加。

預設值：false

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

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

extractservice.command.execution.timeout

版本：在版本 2021.4 中新增。

預設值：7200 秒

設定 VConn 資料擷取重新整理執行時間的逾時值。

範例： tsm configuration set -k extractservice.command.execution.timeout -v <timeout_in_seconds> --force-keys

請注意： 您必須使用 --force-keys 選項變更此值。

功能。ActiveMQ

版本：在版本 2021.4 中新增。

預設值：true

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

features.DeleteOrphanedEmbeddedDatabaseAsset

版本：版本 2021.2 中新增。

預設值：true

控制 Tableau Catalog（或 Tableau 中繼資料 API）的後台過程，該拓程刪除不再與下游 Tableau 內容關聯的內嵌外部資產（資料庫和表格）。此過程每天在 22:00:00 UTC（國際標準時間）執行，並且每天最多可以刪除 100 個外部資產，直到沒有與下游 Tableau 內容沒有連線的剩餘外部資產。可以將此選項設定為false以阻止此過程執行。databaseservice.max_database_deletes_per_run 調整可刪除的外部內嵌資產的最大數量。

有關詳情，請參閱缺少內容疑難排解。

features.IdentityMigrationBackgroundJob

版本：在版本 2022.1 中新增。在版本 2021.4.22、2022.1.18、2022.3.10、2023.1.6 和 2023.3 中，預設值變更為 false。

預設值：false

控制執行身分移轉的處理序。設定為 true 後，將 Tableau Server 升級至版本 2022.1（或更高版本）並還原 Tableau Server 版本 2021.4（或更早版本）的備份後，立即在現有部署中執行身分移轉。設定為 false （預設）停用身分移轉。

例如，要開始身分移轉，請執行以下命令：

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

有關詳情，請參閱關於身份識別遷移。

附註： 如果停用身分移轉，Tableau Server 將無法使用身分服務儲存與管理使用者身分資訊。使用身分服務是某些功能的先決條件，例如 身分集區。

features.IdentityPools

版本：在版本 2023.1 中新增。

預設值：false

如果執行全新 Tableau Server 安裝，則需要啟用身分集區功能的元件。需要 feature.NewIdentityMode 和 wgserver.authentication.legacy_identity_mode.enabled。設定為 true （預設）停用身分集區。設定為 false （預設）停用身分集區。

例如，要啟用身分集區，請執行以下命令：

tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply

有關詳情，請參閱身分集區疑難排解。

功能。MessageBusEnabled

版本：在版本 2019.4 中新增。

預設值：true

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

features.NewIdentityMode

版本：在版本 2022.1 中新增。

預設值：false。在 2023.1.6 中，預設值已從 true 變更為 false。

身分集區功能的先決條件。需要將 wgserver.authentication.legacy_identity_mode.enabled 設定為 false 以啟用身份集區。設定為 true 以停用身分集區。

tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply

有關詳情，請參閱身分集區疑難排解。

features.PasswordlessBootstrapInit

預設值：true

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

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

features.PasswordReset

版本：已在版本 2024.2 中淘汰。對於版本 2024.2 及更高版本，請使用 vizportal.password_reset。

預設值：false

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

filestore.empty_folders_reaper.enabled

版本：在 2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）和 2021.1.x 中新增。在 2021.2 中，預設值已變更為 true。

預設值：true

啟用「收穫」（移除）清空檔案存儲資料夾的工作。

filestore_empty_folders_reap.frequency_s

版本：在 2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）中新增。

預設值： 86400（24 小時）

以分鐘為單位，指定執行刪除空檔案存儲資料工作的頻率。

features.Hyper_DisallowTDEPublishing

版本：從版本 2023.1.0 開始預設為 true 。已在 Tableau Server 2024.2 中棄用。

預設值：true

指定使用者是否可以上傳 .tde 格式檔案。從 Tableau Server 10.5 版本開始，此格式已被 .hyper 格式取代，但未阻止上傳。從版本 2024.3 開始，.tde 格式檔案不再可用。若執行了多個動作之一，檔案會自動轉換為 .hyper 格式。有關詳情，請參閱擷取升級為 .hyper 格式。

filestore.log.level

版本：在版本 2020.3.0 中新增。

預設值：info

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

filestore.reapemptyfoldersholdoffms

版本：在 2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）中新增。這在 2021.1 中尚不可用。

預設值：300000 （5分鐘）

以毫秒為單位，指定刪除空檔案存儲資料夾之前等待的時間。

floweditor.max_datafile_upload_size_in_kb

版本：在版本 2020.4 中新增

預設值：1048576

對於 Tableau Prep 流程 Web 製作，可以上傳到 Tableau Server 的分隔文字檔（例如 CSV 或 TXT）的最大大小。

gateway.external_url

版本：版本 2023.1 中新增

預設值：Null

在 Tableau Server 設定期間在 TSM 中設定或使用身分識別集區設定 OpenID Connect (OIDC) 驗證時需要。指定身分識別提供者 (IdP) 使用的 Tableau Server URL，以將經過驗證的使用者重新導向到 Tableau。閘道外部 URL 與您指定為 IdP 的重新導向 URL 相同，用於比對目的。

例如，要將與 OIDC 驗證設定關聯的 IdP 重新導向到您的 Tableau Server http://myco，請執行以下命令：

tsm configuration set -k gateway.external_url -v http://myco

gateway.http.hsts

預設值：false

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

gateway.httpd.loglevel

版本：在 2021.3.0 中新增。

預設值：notice

指定「閘道」（Apache HTTPD 伺服器）的記錄層級。預設情況下其設定為 notice。其他選項包括 debug、info、warning 和 error。如果變更記錄層級，請注意對磁碟空間使用和效能的潛在影響。最佳做法是，在收集到所需資訊後，將記錄層級恢復為預設值。有關 Apache 記錄的詳細資訊，請參閱Apache HTTP 文件(連結在新視窗開啟)。

gateway.httpd.shmcb.size

版本： 在 2021.4 中新增

預設值：2048000

指定使用時循環緩衝區的內存量（以位元為單位）shmcb存儲類型。此組態金輪在使用時dbm存儲類型時不可套用。

gateway.httpd.socache

版本： 在 2021.4 中新增

預設值：shmcb

指定全域/處理程序內部 SSL 工作階段快取的存儲類型。預設情況下，將其設定為shmcb，附帶另一個可設定選項dbm.有關 shmcb 和 dbm儲存類型的詳細資訊，請參閱 Apache 網站中的SSLSessionCache 指令(連結在新視窗開啟)。

gateway.log.level

版本：在版本 2020.3.0 中新增。

預設值：info

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

hyper.log_queries

預設值：true

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

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

hyper.session_memory_limit

預設值：0（表示無限制）

控制個別查詢可以擁有的記憶體消耗量上限。指定位元組數量。將字母「k」附加到值表示 KB、附加「m」表示 MB、附加「g」表示 GB、附加「t」則表示 TB。

例如，將內存限制上限設定為 900 MB，請執行以下命令：

tsm configuration set -k hyper.session_memory_limit -v 900m。

或者，將工作階段記憶體上限指定為總可用系統記憶體的百分比，請執行以下命令：

tsm configuration set -k hyper.session_memory_limit -v 90%。

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

hyper.srm_cpu_limit_percentage

預設值（百分比）：75

指定 Hyper 允許的最大每小時平均 CPU 使用率。若超出，資料引擎將自行重新啟動，以盡量減少對電腦上其他流程的影響。

預設情況下，若在一小時內的平均 CPU 使用率超過 75%，資料引擎將自行重新啟動。除非與 Tableau 支援合作，或者若在專用伺服器節點上執行資料引擎，否則不應變更此值。若資料引擎在專用節點上執行，可以安全地將此值增加到 95%，以充分利用可用的電腦硬體。有關在專用節點上執行資料引擎的詳細資訊，請參閱對擷取查詢密集型環境進行最佳化。

要將其增加到 95%：

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 95 --force-keys

tsm pending-changes apply

要將其重設為預設值 75%：

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 75 --force-keys

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

預設值：true

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

indexandsearchserver.vmopts

版本：在版本 2022.1 中新增。

預設值：「-Xmx<default_value> -Xms<default_value>」

預設值基於系統記憶體量，為系統總 RAM 的 3.125%。

控制索引和搜尋伺服器堆積大小。由於預設值會自動調整，因此僅在絕對必要時使用此選項覆寫預設值。將字母「k」附加到值表示 KB、附加「m」表示 MB，附加「g」表示 GB。一半情況下，將初始堆積大小 (-Xms) 設定為等於最大堆積大小 (-Xmx) 以最大程度地減小記憶體回收。

jmx.security.enabled

版本：在版本 2022.1 中新增。

預設值：false

預設情況下停用 JMX，因此也停用了安全 JMX。如果要啟用 JMX，我們強烈建議啟用安全 JMX。

將其設定為true，並在執行tsm maintenance jmx enable命令時使用 SSL 和基本使用者名稱/密碼驗證唯讀存取時開啟安全 JMX，並在提示是否為 JMX 啟用安全功能時回答y：

tsm maintenance jmx enable
We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
(y/n): y

jmx.ssl.enabled

版本：在版本 2022.1 中新增。

預設值：true

為 JMX 強制執行 SSL。此選項預設為 true 但除非 jmx.security.enabled 也設定為 true，否則沒有效果。要啟用 JMX 安全性，請執行 tsm maintenance jmx enable 命令。系統提示啟用 SSL 時回答 y，或回答 n 停用 SSL：

tsm maintenance jmx enable
...
Would you like to enable SSL?
(y/n): n

jmx.ssl.require_client_auth

版本：在版本 2022.1 中新增。

預設值：false

執行tsm maintenance jmx enable命令時將其設定為 true，並在提示要求客戶端身份驗證 (mTLS) 時回答y：

tsm maintenance jmx enable
...
Would you like to require client authentication (mTLS)?
(y/n): y

要完成設定，必須具有用戶端憑證，並將其放置在用戶端電腦上的正確位置。

jmx.ssl.user.name

版本：在版本 2022.1 中新增。

預設值：tsmjmxuser

在安裝或升級Tableau Server時設置。

jmx.ssl.user.password

版本：在版本 2022.1 中新增。

預設值：<generated>

在安裝或升級Tableau Server時設置。

jmx.user.access

版本：在版本 2022.1 中新增。

預設值：readonly

執行tsm maintenance jmx enable命令時將其變更為 readwrite，並在提示新增readwrite 存取時回答y：

tsm maintenance jmx enable
...
JMX access is readonly by default. Would you like to add readwrite access?
(y/n): y

licensing.login_based_license_management.default_requested_duration_seconds

預設值：0

設定在系統提示使用者重新啟動前，其登入型授權可為離線且不連線至 Tableau Server 應持續的時間（以秒為單位）。Tableau Desktop 正在使用中並且可以連線到 Tableau Server 時，此持續時間始終會重新整理。

licensing.login_based_license_management.enabled

預設值：true

設定為 true 以啟用 以登入為基礎的授權管理。設定為 false 以停用 以登入為基礎的授權管理。

附註：若要使用 以登入為基礎的授權管理，必須啟用已為 以登入為基礎的授權管理 啟用的產品金鑰。可以使用 tsm licenses list 查看 以登入為基礎的授權管理 已啟用的產品金鑰。

licensing.login_based_license_management.max_requested_duration_seconds

預設值：7776000

設定在系統提示使用者重新啟動 Tableau 前，其登入型授權可為離線且不連線至 Tableau Server 應持續的最長時間（以秒為單位）。最大值是 7776000 秒（90天）。Tableau Desktop 正在使用中並且可以連線到 Tableau Server 時，此持續時間始終會重新整理。

metadata.ingestor.blocklist

預設值：Null

設定後，Tableau Catalog 會封鎖擷取指定的內容。若要指定要封鎖的內容，必須識別伺服器「noninteractive」記錄檔中的封鎖清單值，這些值是網站 ID、內容類型和要封鎖內容的內容 ID 的組合。封鎖清單值必須用逗號分隔。

重要提示：僅當 Tableau 支援人員指示使用此選項時，才應使用此選項。

例如，可以使用 tsm configuration set --force-keys -k metadata.ingestor.blocklist 封鎖擷取使用以下命令的資料來源、工作簿和流程組合：

tsm configuration set --force-keys -k metadata.ingestor.blocklist -v "sites/1/datasources/289, sites/2/datasources/111, sites/1/workbooks/32, sites/3/workbooks/15, sites/1/flows/13, sites/1/flows/18”

若要驗證被封鎖的內容，請檢閱伺服器「noninteractive」記錄檔中的以下事件：

• Skipping ingestion for
• Successfully updated blocklist to

例如：

Skipping ingestion for contentType [Workbook], contentId [sites/1/datasources/289], siteDisabled [false], swallowEvent [false], contentBlocked [true]

Skipping ingestion for contentType [Workbook], contentId [sites/3/workbooks/15], siteDisabled [false], swallowEvent [false], contentBlocked [true]

和

Successfully updated blocklist to: [sites/1/datasources/289, sites/1/workbooks/32, sites/2/datasources/111]

metadata.ingestor.pipeline.throttleEventsEnable

預設值：false

控制新內容和更新內容（也稱為事件）的索引編製是否在伺服器上跨所有網站進行監管。預設情況下，事件節流處於關閉狀態。若要開啟事件節流，請使用以下命令將此設定變更為 true： 

tsm configuration set -k metadata.ingestor.pipeline.throttleEventsEnable -v true --force-keys

有關事件節流的詳情，請參閱啟用 Tableau Catalog。

metadata.ingestor.pipeline.throttleLimit

預設值：20

啟用事件節流後，這是可在指定時段內編製索引的新內容和更新內容項目的最大數量。特定項目達到指定的限制後，會延遲 編製索引。

預設情況下，限制會設定為 20 且設定不得低於 2。可以使用以下指令變更上限： 

tsm configuration set -k metadata.ingestor.pipeline.throttleLimit -v 25 --force-keys

在伺服器「noninteractive」記錄檔中，已節流事件可識別為 ingestor event flagged for removal by throttle filter。

metadata.ingestor.pipeline.throttlePeriodLength

預設值：20

啟用事件節流後，這是可以為指定的最大數量的新內容和更新內容項目編製索引的時段（以分鐘為單位）。達到指定時間後，將延遲任何其他新內容和更新內容的索引編製。

預設情況下，限制設定為 30 分鐘。您可以使用以下指令變更時間：

tsm configuration set -k metadata.ingestor.pipeline.throttlePeriodLength -v PT45M --force-keys

metadata.query.limits.time

預設值：20

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

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

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

metadata.query.limits.count

預設值：20000

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

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

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

metadata.query.throttling.enabled

版本：新增至版本 2023.3

預設值：true

控制是否已啟用 中繼資料 API(連結在新視窗開啟) 查詢限制。中繼資料 API 查詢限制是一項旨在防止伺服器的 API 回應對整體效能產生負面影響的功能。設定為 true （預設）後，如果對中繼資料 API 的請求超過定義的閾值，將返回 RATE_EXCEEDED 錯誤。

如果中繼資料 API 使用者經常看到 RATE_EXCEEDED 錯誤，管理員可以嘗試使用 metadata.query.throttling.tokenRefilledPerSecond 與 metadata.query.throttling.queryCostCapacity 設定調整限制。管理員也可以透過將 metadata.query.throttling.enabled 值設定為 false 完全停用限制。但這樣做會妨礙該功能的效能保護優勢。

metadata.query.throttling.queryCostCapacity

版本：新增至版本 2023.3

預設值：20000000

代表中繼資料 API(連結在新視窗開啟) 可以回答查詢的容量數字。每個中繼資料 API 請求都有計算成本，在執行時會從該數字中減去該成本。（使用權杖貯體模型，這是貯體中可以容納的最大權杖數量。）

如果中繼資料 API 使用者經常看到 RATE_EXCEEDED 錯誤，管理員可以調整該限制設定。他們應該調整 metadata.query.throttling.tokenRefilledPerSecond，並在嘗試調整 metadata.query.throttling.queryCostCapacity 之前測試結果。管理員也可以透過將 metadata.query.throttling.enabled 設定為 false 完全停用限制。但這樣做會妨礙該功能的效能保護優勢。

metadata.query.throttling.tokenRefilledPerSecond

版本：新增至版本 2023.3

預設值：5555

代表中繼資料 API(連結在新視窗開啟) 每秒重新產生的查詢容量數。（使用權杖貯體模型，這是每秒放入貯體中的權杖數。）

如果中繼資料 API 使用者經常看到 RATE_EXCEEDED 錯誤，管理員可以調整該限制設定。他們應該調整 metadata.query.throttling.tokenRefilledPerSecond，並在嘗試調整 metadata.query.throttling.queryCostCapacity 之前測試結果。管理員也可以透過將 metadata.query.throttling.enabled 設定為 false 完全停用限制。但這樣做會妨礙該功能的效能保護優勢。

native_api.allowed_paths

預設值：""

附註：在 2023 年 10 月之前的 Tableau Server 版本（包括維護版本）中，此設定配置為預設允許存取所有路徑。

使用此設定可以指定存取儲存在 Tableau 或遠端共用上的檔案的允許清單。此情境允許獲授權的 Tableau Server 使用者建立使用伺服器上的檔案作為基於檔案資料來源的工作簿（如試算表）。

此設定可讓您將存取權限制為僅可存取您指定的目錄。因此，執行身分服務帳戶存取權僅限於託管資料檔案的目錄路徑。

重要事項：確保您在此設定中指定的檔案路徑存在並且可由系統帳戶存取。

native_api.ExplainDataEnabled

預設值：true

此選項控制伺服器啟用還是停用「資料詮釋」。有關「資料詮釋」的詳細資訊，請參見 Tableau 說明中的開始使用「資料詮釋」(連結在新視窗開啟)。

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

nlp.concepts_shards_count

預設值：1

附註：對於大多數 Tableau Server 安裝而言，預設的分區計數值就足夠了。

控制為資料問答、欄位名稱、欄位同義字和分析詞彙的「概念」索引之資料碎片數：

• 2022.1 及更高版本的索引和搜尋伺服器。
• 2019.1 - 2021 的索引和搜尋伺服器。4

分區計數對搜尋索引進行分割以縮減總索引大小，這可能會提升資料問答 (Ask Data) 的語意剖析器的效能。調整分區計數是您可以透過 elasticserver.vmopts 或 indexandsearchserver.vmopts 增加堆積大小而採取的另一種效能增強措施，取決於執行的 Tableau Server 版本。

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

控制為資料問答、欄位名稱、欄位同義字和分析詞彙的「概念」索引之資料碎片數：

• 2022.1 及更高版本的索引和搜尋伺服器。
• 2019.1 - 2021 的索引和搜尋伺服器。4

分區計數對搜尋索引進行分割以縮減總索引大小，這可能會提升資料問答 (Ask Data) 的語意剖析器的效能。調整分區計數是您可以透過 elasticserver.vmopts 或 indexandsearchserver.vmopts 增加堆積大小而採取的另一種效能增強措施，取決於執行的 Tableau Server 版本。

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

預設值：disabled_by_default

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

有效選項是 disabled_by_default 和 disabled_always。

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

noninteractive.vmopts

pgsql.port

預設值：8060

PostgreSQL 所偵聽的埠。

pgsql.preferred_host

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

範例：

pgsql.ssl.ciphersuite

預設值：HIGH:MEDIUM:!aNULL:!MD5:!RC4

為存放庫指定 SSL 允許的密碼演算法。

有關可接受的值和格式要求，請參閱 Postgres 網站上的 ssl 加密(連結在新視窗開啟)。

pgsql.ssl.max_protocol_version

預設值：TLSv1.3

設定透過 SSL 連線到存放庫時要使用的最高 SSL/TLS 通訊協定版本。

有效值：TLSv1、TLSv1.1、TLSv1.2、TLSv1.3

pgsql.ssl.min_protocol_version

預設值：TLSv1.2

設定透過 SSL 連線到存放庫時要使用的最低 SSL/TLS 通訊協定版本。

有效值：TLSv1、TLSv1.1、TLSv1.2、TLSv1.3

pgsql.verify_restore.port

預設值：8061

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

ports.blocklist

版本：在版本 2021.1 中新增

預設值：在用於自動指派連接埠的範圍內沒有連接埠被封鎖。

用於指定連接埠指派範圍內 Tableau 在動態指派連接埠時不應使用的連接埠。當您知道另一個應用程式正在使用該範圍內的連接埠時，此選項很有用。請以逗號分隔多個連接埠，例如：

tsm configuration set -k ports.blocklist -v 8000,8089, 8090

有關使用 ports.blocklist 金鑰的詳情，請參閱封鎖範圍內的特定連接埠

recommendations.enabled

預設值：true

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

searchserver.connection_timeout_milliseconds

版本：在版本 2019.1 中新增。在版本 2022.3 中已棄用。於版本 2023.3 中已淘汰。

預設值（單位：毫秒）：100000

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

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

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

searchserver.index.bulk_query_user_groups

版本：在版本 2022.3 中已淘汰。

預設值：true

指定在使用 CSV 檔匯入或刪除使用者時是否大量查詢站點使用者。如果設定為 true（預設值），索引是大量完成的。

searchserver.javamemopts

版本：在版本 2019.1 中新增。於版本 2023.3 中停用

預設值：-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 中新增。於版本 2023.3 中已淘汰。

預設值（單位：毫秒）：300000

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

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

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

searchserver.zookeeper_session_timeout_milliseconds

版本：在版本 2022.3 中已淘汰。

預設值（單位：毫秒）：100000

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

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

ServerExportCSVMaxRowsByCols

版本：在版本 2020.3 中新增。

預設值：0（無限制）

指定可以從檢視資料下載到 CSV 檔中的資料儲存格數量上限。預設情況下，沒有上限。指定儲存格數目。例如：將上限設定為 300 萬： 

tsm configuration set -k ServerExportCSVMaxRowsByCols -v 3000000 

tsm pending-changes apply

ssl.ciphersuite

預設值：HIGH:MEDIUM:!EXP:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED

為閘道指定 SSL 允許的密碼演算法。

有關可接受的值和格式要求，請參閱 Apache 網站上的 SSLCipherSuite(連結在新視窗開啟)。

ssl.client_certificate_login.blocklisted_signature_algorithms

預設值：

• 版本 2020.4.0： 

  sha1withrsaencryption,
sha1withrsa

• 版本 2020.4.1 和更高版本：

  sha1withrsaencryption,
sha1withrsa,
sha1withrsaandmgf1,
sha1withdsa,
sha1withecdsa

預設值會封鎖使用 SHA-1 簽名演算法的憑證。指定 SSL 封鎖的用戶端簽名演算法。若要停用所有簽名演算法的封鎖設定，請使用空引號集執行此金鑰。

有關此金鑰的資訊，請參閱知識庫文章若憑證使用 SHA-1 簽署，升級後相互 SSL 失敗(連結在新視窗開啟)。

ssl.client_certificate_login.min_allowed.elliptic_curve_size

預設值：256

指定透過相互 SSL 向 Tableau Server 進行驗證的 ECDSA 用戶端憑證所需的最小橢圓曲線大小。若用戶端提供的 ECDSA 用戶端憑證不符合此最小曲線大小，則驗證請求將失敗。

此選項已在 Tableau Server 版本 2021.1 中引入。

ssl.client_certificate_login.min_allowed.rsa_key_size

預設值：2048

指定透過相互 SSL 向 Tableau Server 進行驗證的 RSA 用戶端憑證的最小金鑰大小。若用戶端提供的 RSA 用戶端憑證不符合此最小金鑰大小，則驗證請求將失敗。

此選項已在 Tableau Server 版本 2021.1 中引入。

ssl.protocols

預設值：all +TLSv1.2 -SSLv2 -SSLv3 -TLSv1.3

為閘道的 TLS 連線指定 Tableau Server 支援的 SSL。可接受的值來自Apache SSLProtocol Directive(連結在新視窗開啟) 。我們建議遵循安全強化檢查清單中所述的 SSL 協定設定。

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。

svcmonitor.notification.smtp.enabled

預設值：false

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

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

svcmonitor.notification.smtp.mime_use_multipart_mixed

版本：在版本 2020.1.8、2020.2.5 、2020.3.1 中新增

預設值：false

控制訂閱 HTML MIME 附件以 multipart/related（預設）方式傳送，還是以 multipart/mixed 方式傳送。

在極少數情況下，電子郵件用戶端可能無法正確解析 Tableau Server 傳送的電子郵件。很多時候，可以將此屬性設定為 true 來解決此問題。已知的用戶端包括 iOS Mail 和 Microsoft Outlook（與 Exchange S/MIME 加密配對時）。

tabadmincontroller.auth.expiration.minutes

預設值：120

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

tdsservice.log.level

版本：在版本 2020.3.0 中新增。

預設值：info

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

tomcat.useSystemProxies

預設值：false

指定 tomcat 組件 (OpenID) 是否需要存取本機 Windows 作業系統中的正向 Proxy。參看為 OpenID Connect 設定 Tableau Server。

tomcatcontainer.log.level

預設值：info

互動式微服務容器和非互動式微服務容器中的微服務紀錄層級。從版本 2020.4 開始，這是可動態設定的，因此，若僅變更此內容，則不必重新啟動 Tableau Server。有關詳情，請參閱變更記錄層級。

tsm.log.level

預設值：info

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

tsm.controlapp.log.level

預設值：info

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

usernotifications.reap_after_days

預設值：30

多少天後將使用者通知從伺服器中刪除。

vizportal.adsync.update_system_user

預設值：false

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

vizportal.alwaysUseEmbeddedShareLinks

版本：在版本 2021.3.0 中新增

預設值：false

指定「複製連結」選項是否應包含「embed=y」參數。從 2019.4 版本開始，預設情況下不包含此參數。將此組態金鑰設定為 true 會變更行為，以便包含「embed=y」參數。有關使用「複製連結」選項共用連結以內嵌網頁的詳細資訊，請參見 Tableau Desktop 和 Web 製作說明中的將檢視內嵌網頁。(連結在新視窗開啟)

vizportal.art_skip_list

版本：在版本 2024.2 中新增。

預設值：null

可使用此組態金輪指定 Tableau Server 功能中不使用活動與資源追蹤 (ART) 且在啟用 ART 時會產生大量不必要資料的方面。

該金輪與 vizportal.log_art_java 和 vizportal.enable_art 配合使用，用於解決應用程式伺服器 (VizPortal) 的問題。當設定為[此處需要有關其設定內容的資訊。]要了解如何使用此組態設定，請參閱 疑難排解應用程式伺服器問題。

vizportal.csv_user_mgmt.index_site_users

版本：在版本 2022.3 中已棄用。在版本 2023.3 中已淘汰（完全移除）。

預設值：true

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

vizportal.csv_user_mgmt.bulk_index_users

版本：在版本 2022.3 中已棄用。在版本 2023.3 中已淘汰（完全移除）。

預設值：false

指定在使用 CSV 檔匯入或刪除使用者時是否大量索引站點使用者。當設定為 false（預設值），索引是單獨完成的。若要將站點使用者的索引延遲到處理完整個 CSV 檔之後，請將此項設定為 true。

vizportal.enable_art

版本：在版本 2024.2 中新增。

預設值：false

此組態金輪與 vizportal.log_art_java 和 vizportal.art_skip_list 配合使用，用於使用應用程式伺服器 (VizPortal) 解決問題。設定為 true 時，將啟用應用程式伺服器中的活動與資源追蹤。要了解如何使用此組態設定，請參閱 疑難排解應用程式伺服器問題。

vizportal.log_art_java

版本：在版本 2024.2 中新增。

預設值：false

此組態金輪與 vizportal.enable_art 和 vizportal.art_skip_list 配合使用，用於使用應用程式伺服器 (VizPortal) 解決問題。設定為 true 時，將啟用應用程式伺服器中的活動與資源追蹤。要了解如何使用此組態設定，請參閱 疑難排解應用程式伺服器問題。

vizportal.oauth.connected_apps.max_expiration_period_in_minutes

版本：在版本 2021.4 中新增。

預設值：10

JSON Web 權杖 (JWT) 有效的最長時間段（以分鐘為單位）。在驗證 JWT 時，Tableau Server 會檢查 JWT 中指定的時間段是否不超過此預設值。使用 Tableau REST API(連結在新視窗開啟) 在 Tableau Server 上設定 Tableau 已連線應用程式時，會使用此設定。

例如，要將最長時間段變更為 5 分鐘，請執行以下命令：

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.oauth.external_authorization.enabled

版本：在版本 2021.4 中新增。

預設值：false

在 Tableau Server 2024.2 及更高版本中，已為 Tableau Server 啟用「啟用已連線應用程式」選項。在 Tableau Server 2023.2 及更早版本中，指定是否為 Tableau Server 啟用「為內嵌內容啟用 OAuth 存取」選項。

使用此選項可向 Tableau Server 註冊外部授權伺服器 (EAS)，以便您可以啟用應用程式整合。有關詳細資訊，請參閱使用 OAuth 2.0 信任設定已連線應用程式。

要啟用此選項，請執行以下命令：

tsm configuration set -k vizportal.oauth.external_authorization.enabled -v true

vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms

版本：在版本 2021.4 中新增。

預設值：ES256K

註冊外部授權伺服器 (EAS) 或設定已連線應用程式後，可以使用此命令指定 JSON Web 權杖 (JWT) 標頭中使用的簽署演算法。有關詳細資訊，請參看使用 OAuth 2.0 信任設定已連線應用程式 或 使用 Tableau 已連線應用程式進行應用程式整合。

例如，若需要，可以執行以下命令來移除演算法：

tsm configuration set - k vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms -v

重要提示：上面的範例命令允許使用不安全的簽署演算法，並且只能用於對錯誤進行疑難排解。

vizportal.oauth.external_authorization_server.issuer

版本：在版本 2021.4 中新增。

預設值：null

必需。使用此命令可指定簽發者 URL。需要簽發者 URL 才能向 Tableau Server 註冊外部授權伺服器 (EAS)。有關詳細資訊，請參閱使用 OAuth 2.0 信任設定已連線應用程式。

例如，若 EAS 為 Okta，可能會執行類似於以下內容的命令：

tsm configuration set -k vizportal.oauth.external_authorization_server.issuer -v "https://dev-12345678.okta.com/oauth2/abcdefg9abc8eFghi76j5"

vizportal.oauth.external_authorization_server.jwks

版本：在版本 2021.4 中新增。

預設值：null

註冊外部授權伺服器 (EAS) 後，可以使用此命令指定 JSON Web 金鑰集 (JWKS) URL。若身分識別提供者 (IdP) 不公開外部授權伺服器中繼資料端點，則需要 JWKS URL。

例如，若 IdP 為 Amazon Cognito，可能會執行類似於以下內容的命令：

tsm configuration set -k vizportal.oauth.external_authorization_server.jwks -v "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_Ab129faBb/.well-known/jwks.json"

vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes

版本：在版本 2021.4 中新增。

預設值：10

JSON Web 權杖 (JWT) 有效的最長時間段（以分鐘為單位）。在驗證 JWT 時，Tableau Server 會檢查 JWT 中指定的時間段是否不超過此預設值。EAS 已註冊到 Tableau Server 時，會使用此設定。有關詳細資訊，請參閱使用 OAuth 2.0 信任設定已連線應用程式。

例如，要將最長時間段變更為 5 分鐘，請執行以下命令：

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.openid.full_server_request_logging_enabled

預設值：false

指定是否對 OpenID 活動進行完整記錄。

在對 OpenID Connect 問題進行故疑難排解時，將此設定為true ，收集更詳細的記錄並讓您更好地進行疑難排解。

與所有與記錄相關的設定一樣，我們建議在完成疑難排解並收集記錄後，將此鍵重設為預設值 (false)。這會限制記錄的資訊量，並將記錄檔案的大小保持在最低限度。

vizportal.password_reset

版本：在版本 2024.2 中取代 features.PasswordReset。

預設值：false

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

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。

vizportal.site_user_group_count_enabled

版本： 在 2022.3.5 及更高版本、2023.1.0 及更高版本中新增。

預設值：false

控制「站台使用者」頁面是否包含顯示每個使用者分組計數的欄。

vizqlserver.force_maps_to_offline

版本：在版本 2020.4.0 中新增。

預設值：false

確定 Tableau Server 是否以離線模式執行地圖。這在網路和地圖伺服器存取受限的斷開連線環境中很實用。若要啟用地圖離線模式，請將此值設定為 true。有關在無法存取網路的環境中安裝與設定 Tableau Server 的詳細資訊，請參閱在斷開連線（無網路連線）的環境中安裝 Tableau Server。

wgserver.authentication.legacy_identity_mode.enabled

版本：版本 2022.1 中的新增功能

預設值：在 Tableau Server 2022.1 及更高版本中設定為 false。如果升級到 2022.1 或更高版本的 2022.1 之前的 Tableau Server 部署，預設值為 true。

設定 false 使用身份集區。

有關詳情，請參閱身分集區疑難排解。

wgserver.authentication.identity_pools.default_pool_description

版本：版本 2023.1 中新增

預設值：Null

或者，可以將初始集區（已設定 TSM）的描述新增到 Tableau Server 登陸頁面，並且對所有使用者可見。建立一個或多個身分識別集區時，此描述會新增到主要登入選項下方，可用於幫助引導屬於初始集區（已設定 TSM）的使用者使用正確的登入選項。

例如，要新增「正式員工在此處登入」描述，可以使用以下命令：

tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v “Regular employees sign in here"

附註：初始集區（已設定 TSM）描述不同於自訂登入說明。登入自訂說明顯示在 Tableau Server 登陸頁面上所有登入選項下方，以及初始集區（已設定 TSM）使用者輸入使用者名稱和密碼的頁面上。

wgserver.domain.accept_list

版本：從版本 2020.4.0 開始新增此金鑰，並取代 wgserver.domain.whitelist。

預設值：Null

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

設定 wgserver.domain.accept_list 選項是安全性漏洞修正程式的必要項目，[重要] ADV-2020-003：Tableau Server 強制執行身份驗證(連結在新視窗開啟)。自 2020 年 2 月起，此漏洞的修正程式包含在 Tableau Server 的所有最新版本和維護版本中。

要設定此選項，請輸入用雙引號括起來的從屬網域。多個網域必須用逗號和空格分隔。例如，tsm configuration set -k wgserver.domain.accept_list -v "example.org, domain.com"。

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

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

wgserver.domain.allow_insecure_connection

預設值：False

此設定僅適用於 Windows。此選項指定 Tableau Server 是否將使用未加密的通道連線到 Active Directory。預設值False將強制執行加密通道。如果 LDAP 通道未加密，則 Tableau Server 將不會連線到 Active Directory。

Active Directory 基礎架構應管理憑證，並信任加入網域的電腦。因此，Tableau Server 和 Active Directory 資源之間的通道通訊應進行加密。建議不要允許與 Active Directory 進行未加密的通訊，因為此組態容易受到中間人攻擊。

如果要升級到 Tableau Server 2021.2 或更高版本，而您的 LDAP 通道未加密，則升級將失敗。升級前，可以執行此命令以允許較舊版本的 Tableau Server 的不安全連線。如果在 2021.2 之前的版本上執行此命令，則必須在命令中包含--force-keys選項。

wgserver.domain.fqdn

預設值：%USERDOMAIN% 的值

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

wgserver.domain.password

預設值：Null

指定用於 LDAP 連線的使用者帳戶密碼。請參閱外部識別身分存放區設定參考資料。

wgserver.domain.username

預設值：Null

指定用於 LDAP 連線的使用者帳戶名稱。請參閱外部識別身分存放區設定參考資料。

wgserver.domain.whitelist

重要資訊：自版本 2020.4.0 起，此金鑰已棄用。請改用 wgserver.domain.accept_list 。

預設值：Null

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

wgserver.ignore_domain_in_username_for_matching

版本：在版本 2021.4.21、2022.1.17、2022.3.9 和 2023.1.5 中新增

預設值：false

啟用 SAML 後，可以將 Tableau Server 設定為在將識別提供者 (IdP) 使用者名稱與 Tableau Server 上的使用者帳戶配對時忽略 SAML 使用者名稱屬性的網域部分。當您已在 Tableau Server 中定義與使用者名稱屬性的前置部分配對，但不與使用者名稱屬性的網域部分配對的使用者時，可能會忽略使用者名稱屬性的網域部分。有關詳情，請參閱 SAML 要求主題中的配對 SAML 使用者名稱屬性時忽略網域區段。

例如，要忽略 SAML 使用者名稱屬性中的網域名稱，請執行以下命令：

tsm configuration set -k wgserver.ignore_domain_in_username_for_matching -v true

重要資訊：

• 在未採取預防措施的情況下，我們不建議忽略網域名稱。具體來說，請驗證使用者名在您在 IdP 中建立的已設定域中是否唯一。
• 此命令僅適用於 legacy-identity-mode 中的 Tableau Server 部署，或尚未透過身分移轉(連結在新視窗開啟)更新為使用身分服務的部署。

wgserver.saml.blocklisted_digest_algorithms

版本：在版本 2021.1 中新增。

預設值：SHA1

指定任何相關 SAML 憑證簽章、SAML 判斷提示摘要方法，或簽章方法不允許的雜湊演算法。設定後，使用已列入封鎖清單演算法來簽章和雜湊的憑證或判斷提示將遭到拒絕，並且失敗。

在 Tableau 和 IdP 端都可以在多處使用SHA-1。例如：

• Tableau Server 使用 TSM 上傳的憑證對傳送到 IdP 的請求進行簽章。
• IdP 中繼資料中用於驗證從 IdP 接收的 AuthNResponse （簽章）的憑證，會使用憑證中的公開金鑰。
• 使用 SHA-1 對傳入的判斷提示進行簽彰和雜湊處理（DigestMethod 設定為 SHA-1，SignatureMethod 設定為 SHA-1）。

在 Tableau Server 2021.2 中，預設值已變更為（SHA1。有關升級到 2021.2 並設定 SAML 的更多資訊，請參閱知識庫文章使用 SAML 身份驗證的 Tableau Server 在升級到 Tableau Server 2021.2 後無法啟動或拒絕登入 。

wgserver.saml.forceauthn

版本：在版本 2019.3 中新增。

預設值：false

當設定為true，如果 Tableau 使用者工作階段過期，Tableau Server 將使用 IdP 重新對使用者進行身份驗證。此選項還可用於要求 IdP 提示使用者重新進行身份驗證，即使使用者具有使用中的 IdP 工作階段。

wgserver.saml.min_allowed.elliptic_curve_size

預設值：256

版本：在版本 2021.1 中添加，但不包含預設值。在 2021.2 中，預設值設定為256。

此選項指定用於 SAML 身份驗證憑證的最小允許 ECDSA 曲線大小。如果上傳憑證的 ECDSA 曲線小於 256，則在套用變更時，TSM 將記錄錯誤。

如果升級到 Tableau Server 2021.2 或更高版本，但 SAML 憑證使用的 ECDSA 曲線小於 256，則升級後 Tableau Server 將不會啟動。我們建議在升級之前上傳具有 256（或更大）ECDSA 曲線大小的新憑證。或者，您可以執行此命令，以在升級之前在 Tableau Server 的舊版本（2021.1 之前）上設定較小的 ECDSA 曲線大小。如果您在 2021.1 之前的版本上執行此命令，則必須在命令中包含--force-keys選項。有關升級到 2021.2 並設定 SAML 的更多資訊，請參閱知識庫文章使用 SAML 身份驗證的 Tableau Server 在升級到 Tableau Server 2021.2 後無法啟動或拒絕登入 。

wgserver.saml.min_allowed.rsa_key_size

預設值：2048

版本：在版本 2021.1 中添加，但不包含預設值。在 2021.2 中，預設值設定為2048。

此選項指定用於 SAML 身份驗證的憑證允許的最小 RSA 金鑰長度。如果上傳的憑證 RSA 金鑰長度小於 2048，則在套用變更時，TSM 將記錄錯誤。

要使用長度為 1024 的 RSA 金鑰執行 SAML 身分驗證（不建議），請將此值設定為 1024。

如果要升級到 Tableau Server 2021.2 或更高版本，並且 SAML 憑證使用的金鑰長度小於 2048，則升級後 Tableau Server 將不會啟動。我們建議您在升級之前上傳金鑰長度為 2048（或更長）的新憑證。或者，您可以在升級之前執行此命令，以在 Tableau Server 的舊版本（2021.1之前）上設定較低的金鑰強度。如果您在 2021.1 之前的版本上執行此命令，則必須在命令中包含--force-keys選項。有關升級到 2021.2 並設定 SAML 的更多資訊，請參閱知識庫文章使用 SAML 身份驗證的 Tableau Server 在升級到 Tableau Server 2021.2 後無法啟動或拒絕登入 。