tsm configuration set 选项

相关文章推荐

直爽的黄花菜 · Excel - Tableau· 4 月前 ·

有爱心的回锅肉 · Microsoft SQL Server ...· 2 月前 ·

体贴的水煮肉 · 在断开连接（无网络连接）的环境中安装 ...· 1 周前 ·

风度翩翩的芹菜 · 如何管理文件访问权限_对象存储(OSS)-阿 ...· 9 月前 ·

瘦瘦的鸡蛋面 · 在swift语言中实现网络请求至少四百字 ...· 1 年前 ·

慈祥的萝卜 · vue3 ...· 2 年前 ·

冷静的勺子 · 命令注入漏洞介绍（上篇） - ...· 2 年前 ·

喝醉的鸡蛋面 · laravel 多对多关联 attach ...· 2 年前 ·

</noscript><div id="app" class="wrapper"><header id="tableau-help-article-header" class="container--full-width quick-help-header"><div class="container--centered"><div class="header__back-button"><back-button title="Go back"/></div><div class="header__mobile-menu quick-help-hidden"><menu-tree-toggle/></div><div class="header__logo quick-help-hidden"><a href="https://www.tableau.com/zh-cn/"><img src="./Resources/tableau-logo.png" class="header__logo__img" alt="Tableau"/></a></div><div class="header__search"><search-header-help placeholder="搜索"/></div><div class="header__home-button"><home-button title="Go home"/></div></div></header><div class="container--navigation-top quick-help-hidden content-only-hidden"><div id="help-subheader" class="subheader print-hidden"><div class="container--centered"><h4 class="heading--subheader">Windows 版 Tableau Server 帮助</h4></div></div><div class="container--top-links"><div class="container--centered container--breadcrumbs"><div><breadcrumb-links-help/></div></div><div id="help-container-menu-headings" class="container--menu-headings"><nav class="nav-medium-screen"><menu-heading-links-static-help menu-title="本文内容" :disabled="false" :headings="pageHeadings"/></nav></div></div></div><div class="section--main container--full-width"><div class="container--centered"><nav class="nav-side nav-side--left" role="navigation"><menu-tree-help menu-title="内容"/></nav><article role="main"><h1 id="contentH1"/><div class="caption article__tags content-only-hidden quick-help-hidden"><span class="article__tags--applies-to"> </span><br/><span class="article__tags--role"> </span></div><div xmlns:madcap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" id="content-body">&#13; <div role="main" id="mc-main-content"><p>下面是可以使用 <code><a href="cli_configuration_tsm.htm#TSMSet" class="MCXref xref" xrefformat="{paratext}">tsm configuration set</a></code> 命令设置的配置选项或键的列表。在许多情况下，您可以使用 <code>tsm configuration get</code> 命令找出配置键的当前值。</p><p>此列表并非 Tableau Server 配置设置的详尽列表。它表示可由服务器管理员设置的配置键的子集。最后，Tableau Server 内部使用的某些键不会出现在此列表中。</p><p class="note"><strong>注意：</strong>配置键区分大小写。</p><h2 is="heading-item" :level="2" id="使用-tsm-cli">使用 tsm CLI</h2><div><p>可以在初始节点（安装 TSM 的节点）或群集中的任何附加节点上运行 tsm 命令。</p><p data-mc-conditions="Product.serverwindows">若要运行 tsm 命令，您需要打开 Windows 命令提示符。请勿使用 PowerShell 运行 tsm 命令。使用 PowerShell 可能会导致意外行为。</p><ol><li value="1" data-mc-conditions="Product.serverwindows"><p>使用作为群集中某个节点上的管理员组成员的帐户打开 Windows 命令提示符。</p></li><li value="2"><p>运行所需命令。如果从不是初始节点的某个节点中运行命令，请包括 <code>-s</code> 选项，按名称（而非 IP 地址）指定初始节点的 URL，并包括 TSM 端口 8850。</p><p>从初始节点中查看 TSM 和 Tableau Server 的版本：</p><p><code>tsm version</code></p><p>从附加节点中查看 TSM 和 Tableau Server 的版本：</p><p><code>tsm version -s https://&lt;inital_node_name&gt;:8850</code></p><p>例如：</p><p><code>tsm version -s https://myTableauHost:8850</code></p></li></ol></div><h2 is="heading-item" :level="2" id="tsm-configuration-keys-的基本用法">tsm configuration keys 的基本用法</h2><h3 is="heading-item" :level="3" id="设置配置键">设置配置键</h3><p><code>tsm configuration set -k &lt;config.key&gt; -v &lt;config_value&gt;</code></p><p>在某些情况下，必须包括 <code>--force-keys</code> 选项以便为之前未设置的键设置配置值。有关详细信息，请参见<a href="cli_configuration_tsm.htm#configGetNote" class="MCXref xref" xrefformat="{paratext}">“未知键”响应</a>。</p><p>设置配置键值之后，您必须使用 <code><a href="cli_pending-changes.htm#pending-changes-apply" class="MCXref xref" xrefformat="{paratext}">tsm pending-changes apply</a></code> 应用待定配置更改。在您执行该操作之前，新值将不会由 Tableau 使用或显示在 <code>tsm configuration get</code> 命令的结果中。您可以使用 <code>tsm pending-changes list</code> 查看待定更改。有关详细信息，请参阅<a href="cli_pending-changes.htm" class="MCXref xref" xrefformat="{paratext}">tsm pending-changes</a>。</p><h3 is="heading-item" :level="3" id="将配置键重置为默认值"><a name="Reset2Default"/>将配置键重置为默认值</h3><p>若要将配置键重置回其默认值，请使用 <code>-d</code> 选项：</p><p><code>tsm configuration set -k &lt;config.key&gt; -d</code></p><h3 is="heading-item" :level="3" id="查看配置键的当前值">查看配置键的当前值</h3><p>若要查看当前为某个配置键设置的值，请使用 <code>configuration get</code> 命令：</p><p><code><a href="cli_configuration_tsm.htm#TSMGet" class="MCXref xref" xrefformat="{paratext}">tsm configuration get</a> -k &lt;config.key&gt;</code></p><p>有两种特殊情况不会为键返回有用的当前值：</p><ul><li value="1"><p>在某些情况下，您无法获得未明确设置的键的配置值。作业替代，<code>tsm configuration get</code> 命令将返回“未知键”响应。有关详细信息，请参见<a href="cli_configuration_tsm.htm#configGetNote" class="MCXref xref" xrefformat="{paratext}">“未知键”响应</a>。</p></li><li value="2"><p>对于具有预定义默认值的某些键，<code> tsm configuration get</code> 命令将返回“Null”响应。有关详细信息，请参见<a href="cli_configuration_tsm.htm#configGetNullDefault" class="MCXref xref" xrefformat="{paratext}">“Null”值响应</a>。</p></li></ul><h2 is="heading-item" :level="2" id="配置键">配置键</h2><h3 is="heading-item" :level="3" id="adminviewsdisabled">adminviews.disabled</h3><p>默认值：<code>false</code></p><p>禁用对 Tableau 管理视图的访问权限。默认情况，已启用对视图的访问权限（此选项设置为“false”）。</p><h3 is="heading-item" :level="3" id="apiserverenabled"><a name="rest_api_enabled"/>api.server.enabled</h3><p>默认值：<code>true</code></p><p>允许访问 <a href="https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api.htm" target="_blank">Tableau Server REST API<span class="sr-only">(链接在新窗口中打开)</span></a>。</p><p>默认情况下，此功能已启用。我们强烈建议您保持此设置。禁用 REST API 将会破坏大量 Tableau 特性的功能。它不会提高性能或增强安全性。如果您选择在 Tableau Server 安装上禁用 REST API，请仔细测试您需要的功能。</p><p>禁用 REST API 所影响的功能包括：</p><ul><li value="1">搜索</li><li value="2">收藏夹</li><li value="3">集合</li><li value="4">内容管理工具 (CMT)</li><li value="5">Resource Monitoring Tool (RMT)</li><li value="6">个人空间</li></ul><h3 is="heading-item" :level="3" id="auditingenabled"><a name="auditing"/>auditing.enabled</h3><p>默认值：<code>true</code></p><p>允许访问 PostgreSQL（Tableau Server 自己的数据库）历史审计表。</p><h3 is="heading-item" :level="3" id="backgrounderdefaultrunnowpriority">backgrounder.default_run_now_priority</h3><p>默认值（整数）：0</p><p>此设置控制为立即运行作业分配的优先级，0 为最高优先级。应指定的值应在 0 – 100 范围内。</p><h3 is="heading-item" :level="3" id="backgrounderenableparalleladsync">backgrounder.enable_parallel_adsync</h3><p><strong>版本：</strong>版本 2018.3.6 中新增</p><p>默认值：<code>false</code></p><p>控制在有多个后台程序时是否允许并行处理外部目录组同步作业。默认情况下，外部目录组计划同步由单个后台程序串行处理。将此项设置为 <code>true </code> 以在多个后台实例上启用并行处理。</p><h3 is="heading-item" :level="3" id="backgrounderexternalquerycachewarmupenabled">backgrounder.externalquerycachewarmup.enabled</h3><p>默认值：<code>true</code></p><p>在计划的数据提取刷新任务之后控制工作簿查询结果缓存。</p><h3 is="heading-item" :level="3" id="backgrounderexternalquerycachewarmupviewthreshold">backgrounder.externalquerycachewarmup.view_threshold</h3><p>默认值：<code>2.0</code></p><p>用于在计划数据提取刷新任务之后缓存工作簿查询结果的阈值。此阈值等于工作簿在过去七天内收到的视图数除以未来七天内计划的刷新次数。</p><p>以下两个 <i>backgrounder</i> 命令选项确定在取消流程后台任务之前流程任务可运行多长时间。这两个命令共同确定流程任务的总超时值。</p><h3 is="heading-item" :level="3" id="backgrounderextratimeoutinseconds">backgrounder.extra_timeout_in_seconds</h3><p>默认值：<code>1800</code></p><p>取消后台作业之前超出 <code>backgrounder.querylimit</code> 中的设置的秒数。此设置可确保停止的作业不会阻止后续作业。此设置适用于 <code>backgrounder.timeout_tasks</code> 中列出的进程。1800 秒为 30 分钟。</p><h3 is="heading-item" :level="3" id="backgrounderdefaulttimeoutrunflow">backgrounder.default_timeout.run_flow</h3><p>默认值：<code>14400 </code></p><p>已取消流程运行任务之前的秒数。14,400 秒为 4 小时。</p><div><h3 is="heading-item" :level="3" id="backgrounderfailurethresholdforrunprevention">backgrounder.failure_threshold_for_run_prevention</h3><p>默认值：<code>5</code></p><p>订阅、数据提取或流程运行作业挂起前连续失败的次数。挂起连续失败的作业有助于为其他作业保留后台程序资源。若要禁止挂起失败的后台任务，请将其设置为 <code>-1</code>。</p></div><div><h3 is="heading-item" :level="3" id="backgrounderloglevel">backgrounder.log.level</h3><p><strong>版本：</strong>版本 2020.3.0 中新增。</p><p>默认值：<code>info</code></p><p>后台程序进程日志记录级别。此设置是动态配置的，因此，如果您只是更改此设置，则不必重新启动 Tableau Server。有关详细信息，请参见<a href="logs_debug_level.htm" class="MCXref xref" xrefformat="{paratext}">更改日志记录级别</a>。</p></div><h3 is="heading-item" :level="3" id="backgrounderquerylimit">backgrounder.querylimit</h3><p>默认值：<code>7200</code></p><p>完成一次数据提取刷新作业允许的最长时间，以秒为单位。7200 秒 = 2小时。</p><p class="note"><strong>注意：</strong>如果后台作业达到此时间限制，则在被取消的同时，它可以继续额外运行几分钟。</p><div><h3 is="heading-item" :level="3" id="backgrounderrestrictserialcollectionstositelevel">backgrounder.restrict_serial_collections_to_site_level</h3><p>默认值：<code>false</code></p><p>在 Tableau Server 中，您可以计划定期运行数据提取刷新、订阅或流程。这些计划项称为任务。后台程序进程启动这些任务的唯一实例，以在计划时间运行它们。作为结果启动的任务的唯一实例称为作业。</p><p>此设置会影响配置为串行运行的计划。默认情况下，当计划配置为串行运行时，使用该计划的所有作业都将串行运行。当此设置设为 <code>true</code> 时，在不同站点上运行的作业可以并行运行。同一站点上计划任务的作业将继续串行运行。</p><p>下面的示例说明了这种情况：</p><p>Tableau Server 包含一个名为“每日”的计划，用于每天早上 7 点运行作业。“每日”计划配置为串行运行。站点“HR”和站点“Payroll”各有多个使用计划“每日”的计划任务。当此设置设为 <code>true</code> 时，站点“HR”上这些计划任务的作业可以与站点“Payroll”上的作业并行运行，而同一站点上的作业仍然只会串行运行。</p></div><h3 is="heading-item" :level="3" id="backgroundernotificationsenabled">backgrounder.notifications_enabled</h3><p>默认值：<code>true</code></p><p>控制是否为服务器上的所有站点启用数据提取刷新和流程运行通知。默认情况下启用了通知。若要为服务器上的所有站点禁用通知，请将此项设置为 <code>false</code>。</p><p>站点管理员可以在站点设置中按站点或在用户设置中的用户级别启用或禁用数据提取通知。</p><h3 is="heading-item" :level="3" id="backgroundersortjobsbytypescheduleboundaryheuristicsmilliseconds">backgrounder.sort_jobs_by_type_schedule_boundary_heuristics_milliSeconds</h3><p>默认值：<code>60000 </code></p><p>控制时间窗口，此时间窗口标识被确定为具有相同计划开始时间的后台程序作业。</p><p>后台程序进程会对按作业类型计划在同一时间执行的工作进行排序，首先运行最快类别的作业：订阅，然后是增量数据提取，最后是完整数据提取。</p><p>系统会对作业进行批处理以确定“同时”安排的作业。值 60,000 毫秒（默认值）表示在 1 分钟时间窗口内启动的计划作业应归类为同一批，因此应在该批内按类型进行排序。</p><h3 is="heading-item" :level="3" id="backgroundersubscriptionfailurethresholdforrunprevention">backgrounder.subscription_failure_threshold_for_run_prevention</h3><p/><p>默认值：<code>5</code></p><p>确定在某个条件的通知挂起之前必须发生的订阅连续失败次数。设置为默认值 <code>5</code> 时，通知会在订阅连续失败五次后挂起。值 <code>-1 </code> 将允许通知电子邮件无限期继续。此阈值是服务器范围设置，因此适用于服务器上定义的所有订阅。</p><h3 is="heading-item" :level="3" id="backgroundersubscriptionimagecaching">backgrounder.subscription_image_caching</h3><p>默认值：<code>true</code></p><p>控制后台程序是否缓存为订阅生成的图像。不必每次重新生成缓存的图像，因此缓存可提高订阅性能。默认情况下已启用图像缓存。若要为服务器上的所有站点禁用图像缓存，请将此项设置为 <code>false</code>。</p><h3 is="heading-item" :level="3" id="backgroundertimeouttasks">backgrounder.timeout_tasks</h3><p>默认值：默认值可能会有所不同，具体取决于您的 <span class="VariablesProductName">Tableau Server</span> 版本。若要查看您的 Tableau 版本的默认值列表，请运行 <code>tsm configuration get</code> 命令：</p><pre>tsm configuration get -k backgrounder.timeout_tasks</pre><p>运行时间比 <code>backgrounder.querylimit</code> 和 <code>backgrounder.extra_timeout_in_seconds</code> 中的组合值长时可取消的任务的列表。此任务列表用逗号分隔。默认列表表示此设置的所有可能的值。</p><div><h3 is="heading-item" :level="3" id="backgroundertimeoutsinglesubscriptionnotify"><a name="backgrounder_timeout_single_job"/>backgrounder.timeout.single_subscription_notify</h3><p><strong>版本</strong>：版本 2021.2 中新增。</p><p>默认值：<code>1800</code> 秒（30 分钟）</p><p>这是完成单个订阅作业的最长允许时间（以秒为单位）。</p></div><div><h3 is="heading-item" :level="3" id="backgroundertimeoutsyncadgroup"><a name="backgrounder_timeout_ad_group_sync"/>backgrounder.timeout.sync_ad_group</h3><p><strong>版本：</strong>版本 2021.1.23、2021.2.21、2021.3.20、2021.4.15、2022.1.11、2022.3.3、2023.1 新增。</p><p>默认值：<code>14400</code> 秒（4 小时）</p><p>这是完成 Active Directory 组同步的最长允许时间（以秒为单位）。这适用于由后台程序服务完成的<em>计划</em>组同步，并防止长时间运行的同步无限期运行。这不会影响使用 Tableau Server UI 或 REST API 完成的组同步。</p></div><div><h3 is="heading-item" :level="3" id="backgroundervinstancesmaxoverflowqueuesize"><a name="backgrounder-overflow-queue"/>backgrounder.vInstances_max_overflow_queue_size</h3><p><strong>版本：</strong>在版本 20221.2 中新增。</p><p>默认值：<code>1000</code></p><p>可位于辅助队列中的最大作业数。当运行的作业数量达到设置的并发限制时，将创建辅助队列。默认最大值设置为 1000 个作业 - 这意味着如果在达到并发限制时有超过 1000 个作业，则任何超过 1000 个作业的作业都不会排队。使用 backgrounder.vInstance_max_overflow_queue_size tsm 命令更改溢出最大队列大小。</p><p>这些值应以整数形式指定。</p></div><div><h3 is="heading-item" :level="3" id="backupzstdthreadcount"><a name="backup_threads"/>backup.zstd.thread_count</h3><p><strong>版本：</strong>版本 2021.1.0 中新增。此键可动态配置。有关详细信息，请参见<a href="server_process_hot_topo.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 动态拓扑更改</a></p><p>默认值：2</p><p>创建备份时应使用的线程数。</p><p>增加此数量可以提高备份性能，但我们建议线程数量不要超过 Tableau Server 计算机上的逻辑处理器数量，最多四个。</p></div><div><h3 is="heading-item" :level="3" id="basefilepathbackuprestore">basefilepath.backuprestore</h3><p>默认值：<code data-mc-conditions="Product.serverwindows"><code>C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\</code></code></p><p><code> tsm maintenance backup</code> 命令在其中创建备份的位置。这也是使用 <code>tsm maintenance restore</code> 命令或<code> tsm maintenance send-logs</code> 命令还原时备份文件时必须位于的位置。设置后，您应该运行 <a href="cli_maintenance_tsm.htm#tsmValidateBackupBasefilepath" class="MCXref xref" xrefformat="{paratext}">tsm maintenance validate-backup-basefilepath</a> 命令（在 2022.1 及更高版本中可用）以验证是否为该位置正确设置了权限。有关详细信息，请参见<a href="cli_default_filepaths_tsm.htm" class="MCXref xref" xrefformat="{paratext}">tsm File Paths</a>。</p></div><div><h3 is="heading-item" :level="3" id="basefilepathlogarchive">basefilepath.log_archive</h3><p>默认值：<code data-mc-conditions="Product.serverwindows">C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\</code></p><p><code> tsm maintenance ziplogs</code> 命令在其中创建压缩存档的位置。有关详细信息，请参见<a href="cli_default_filepaths_tsm.htm" class="MCXref xref" xrefformat="{paratext}">tsm File Paths</a>。</p></div><div><h3 is="heading-item" :level="3" id="basefilepathsiteexportexports">basefilepath.site_export.exports</h3><p>默认值：<code data-mc-conditions="Product.serverwindows">C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports\</code></p><p><code> tsm sites export</code> 命令在其中创建导出文件的位置。有关详细信息，请参见<a href="cli_default_filepaths_tsm.htm" class="MCXref xref" xrefformat="{paratext}">tsm File Paths</a>。</p></div><div><h3 is="heading-item" :level="3" id="basefilepathsiteimportexports">basefilepath.site_import.exports</h3><p>默认值：<code data-mc-conditions="Product.serverwindows">C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\</code></p><p><code> tsm sites import</code> 命令希望导入文件所在的位置。有关详细信息，请参见<a href="cli_default_filepaths_tsm.htm" class="MCXref xref" xrefformat="{paratext}">tsm File Paths</a>。</p></div><div><h3 is="heading-item" :level="3" id="clustercontrollerloglevel">clustercontroller.log.level</h3><p><strong>版本：</strong>版本 2020.3.0 中新增。</p><p>默认值：<code>info</code></p><p>群集控制器的日志记录级别。此设置是动态配置的，因此，如果您只是更改此设置，则不必重新启动 Tableau Server。有关详细信息，请参见<a href="logs_debug_level.htm" class="MCXref xref" xrefformat="{paratext}">更改日志记录级别</a>。</p></div><h3 is="heading-item" :level="3" id="clustercontrollerzksessiontimeoutms">clustercontroller.zk_session_timeout_ms</h3><p>默认值：<code>300000</code></p><p>群集控制器在确定需要故障转移之前将等待协调服务的时间长度（以毫秒为单位）。</p><h3 is="heading-item" :level="3" id="dataalertscheckintervalinminutes">dataAlerts.checkIntervalInMinutes</h3><p>默认值：<code>60 </code></p><p><span class="VariablesProductName">Tableau Server</span> 进行检查以确定数据通知条件是否为真的频率（分钟）。</p><p>（每当刷新与数据通知相关的数据提取时，服务器也会进行检查。）</p><h3 is="heading-item" :level="3" id="dataalertsretryfailedalertsaftercheckinterval">dataAlerts.retryFailedAlertsAfterCheckInterval</h3><p>默认值：<code>true </code></p><p>确定 <span class="VariablesProductName">Tableau Server</span> 重新检查失败数据通知的频率。如果设置为 <code>true</code>，服务器将按 <code>dataAlerts.checkIntervalInMinutes</code> 定义的频率重新检查失败通知。如果设置为 <code>false</code>，服务器将每隔五分钟重新检查失败通知，从而能在数据状况发生更改时更快地向通知收件人发出通知，但会降低服务器性能。</p><p>（每当刷新与数据通知相关的数据提取时，服务器也会进行检查。）</p><h3 is="heading-item" :level="3" id="dataalertssuspendfailurethreshold">dataAlerts.SuspendFailureThreshold</h3><p>Default value: <code>350</code></p><p>确定在某个条件的通知挂起之前必须发生的数据通知连续失败次数。设置为默认值 350 时，通知操作显示大约两周的通知后挂起。此阈值是服务器范围设置，因此适用于服务器上定义的任何数据通知。</p><div><h3 is="heading-item" :level="3" id="databaseservicemaxdatabasedeletesperrun"><a name="metadata_orphanembedded_maxnumber"/>databaseservice.max_database_deletes_per_run</h3><p>默认值：null</p><p>使用此选项可调整每次后台程序处理时可删除的嵌入式外部资产（数据库和表）的最大数量，通过 <code>features.DeleteOrphanedEmbeddedDatabaseAsset</code> 控制。如果将此选项留空，则可删除的嵌入式外部资产的默认最大数量为 100。</p><p>有关详细信息，请参见<a href="#metadata_orphanembedded" class="MCXref xref" xrefformat="{paratext}">features.DeleteOrphanedEmbeddedDatabaseAsset</a>。</p><p>此选项是从以下 Tableau Server 版本开始添加的：2021.2。</p></div><div><h3 is="heading-item" :level="3" id="dataserverloglevel">dataserver.log.level</h3><p><strong>版本：</strong>版本 2020.3.0 中新增。</p><p>默认值：<code>info</code></p><p>数据服务器的日志记录级别。此设置是动态配置的，因此，如果您只是更改此设置，则不必重新启动 Tableau Server。有关详细信息，请参见<a href="logs_debug_level.htm" class="MCXref xref" xrefformat="{paratext}">更改日志记录级别</a>。</p></div><div data-mc-conditions="Product.serverwindows"><h3 is="heading-item" :level="3" id="dataservernport">dataserver_&lt;n&gt;.port</h3><p>数据服务器实例在其中运行的端口（通过“&lt;n&gt;”指定）。</p></div><h3 is="heading-item" :level="3" id="elasticservervmopts"><a name="elasticservervmopts"/>elasticserver.vmopts</h3><p><strong>版本：</strong>版本 :2019.1 中新增。移除：2022.1</p><p><b>此配置选项对于 Tableau Server 版本 2022.1 及更高版本无效。</b>对于 Tableau Server 版本 2022.1 及更高版本，请使用 <a href="#indexsearchserver"><code>indexandsearchserver.vmopts</code></a> 配置选项</p><p/><p>默认值：“<code>-Xmx&lt;default_value&gt; -Xms&lt;default_value&gt;</code>”</p><p>默认值因系统内存量而异。JVM 最大堆大小扩展为总系统 RAM 的 3.125%。</p><p>控制弹性服务器堆大小。由于默认值会自动缩放，因此仅在绝对必要时才使用此选项覆盖默认值。将字母“k”附加到值以指明千字节，附加“m”以指明兆字节，附加“g”以指明千兆字节。一般情况下，将初始堆大小 (<code>-Xms</code>) 设置为等于最大堆大小 (<code>-Xmx</code>)，以最大限度地减少垃圾回收。</p><div><h3 is="heading-item" :level="3" id="excelshadowcopyallremoteenabled">excel.shadow_copy_all_remote.enabled</h3><p><strong>版本：</strong>2019.1.5、2019.2.1 版本中新增。</p><p>默认值：<code>false</code></p><p>控制 Tableau Server 是否创建用作实时数据源的共享 Excel 电子表格spreadsheet（<code>.xlxs</code> 或 <code>.xlxm</code>）的“卷影副本”。如果启用，此选项将防止 Excel 用户查看“共享验证错误”和指明文件“当前已正使用”的消息。对于大型 Excel 文件，此选项可能会对性能产生影响。如果 Excel 用户不需要编辑共享文件，则无需启用此选项。</p><p class="note"><strong>注意：</strong>Tableau Server 会始终尝试创建 <code>.xls</code> 文件的卷影副本。此选项不会更改该行为。</p></div><div><h3 is="heading-item" :level="3" id="featuresactivemq">features.ActiveMQ</h3><p><strong>版本：</strong>版本 2019.4 中新增。</p><p>默认值：<code>true</code></p><p>控制 Tableau Server 是否使用 Apache ActiveMQ 服务（Tableau Server 消息服务）作为内部消息机制。</p></div><div><h3 is="heading-item" :level="3" id="featuresdeleteorphanedembeddeddatabaseasset"><a name="metadata_orphanembedded"/>features.DeleteOrphanedEmbeddedDatabaseAsset</h3><p><strong>版本：</strong>版本 2021.2 中新增。</p><p>默认值：<code>true</code></p><p>控制 Tableau Catalog（或 Tableau 元数据 API）的后台程序进程，该进程删除不再与下游 Tableau 内容关联的嵌入式外部资产（数据库和表）。此进程每天在 22:00:00 UTC（协调世界时）运行，并且每天最多可以删除 100 个外部资产，直到没有与下游 Tableau 内容没有连接的剩余外部资产。您可以将此选项设置为 <code>false</code> 来阻止此进程运行。或者，您还可以使用 <a href="#metadata_orphanembedded_maxnumber" class="MCXref xref" xrefformat="{paratext}">databaseservice.max_database_deletes_per_run</a> 调整可以删除的外部嵌入式资产的最大数量。</p><p>有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/dm_catalog_enable.htm#troubleshoot_orphanembedded">缺少内容疑难解答</a>。</p></div><h3 is="heading-item" :level="3" id="featuresdesktopreporting">features.DesktopReporting</h3><p>默认值：<code>false</code></p><p>控制是否在服务器上启用桌面许可证报告。设置为 <code>false</code>（默认值）时，与桌面许可证相关的管理视图不可用。将此选项设置为 <code>true</code> 以启用许可证报告，并使许可证使用情况及过期管理视图在“服务器状态”页上可见。<strong>注意</strong>：必须在客户端 (Tableau Desktop) 上启用 Desktop 许可证报告，以便向 Tableau Server 报告信息。</p><div><h3 is="heading-item" :level="3" id="featuresmessagebusenabled">features.MessageBusEnabled</h3><p><strong>版本：</strong>版本 2019.4 中新增。</p><p>默认值：<code>true</code></p><p>控制 Tableau Server 是否使用新的内部消息机制。</p></div><div><h3 is="heading-item" :level="3" id="featurespasswordlessbootstrapinit"><a name="pwdlessbootstrap"/>features.PasswordlessBootstrapInit</h3><p>默认值：<code>true</code></p><p>控制 Tableau Server 是否允许引导文件中的嵌入式凭据。如果启用（默认值），引导文件中将包括嵌入式凭据，除非您指定不应包括它们。如果决不应在生成的任何引导程序文件中包括凭据，请将此选项设置为 <code>false</code>。有关生成引导程序文件的详细信息，请参见<a href="cli_topology_tsm.htm#TSMGetBootstrap" class="MCXref xref" xrefformat="{paratext}">tsm topology nodes get-bootstrap-file</a>。</p><p>此选项是从以下 Tableau Server 版本 2019.3 开始添加的。</p></div><h3 is="heading-item" :level="3" id="featurespasswordreset">features.PasswordReset</h3><p>默认值：<code>false</code></p><p>仅适用于使用本地身份验证的服务器。设置为 <code>true</code> 可让用户在登录页面上使用“忘记密码”选项重置密码。</p><div><h3 is="heading-item" :level="3" id="filestoreemptyfoldersreaperenabled">filestore.empty_folders_reaper.enabled</h3><p><strong>版本：</strong>2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）和 2021.1.x 中新增。在 2021.2 中，默认值已更改为 <code>true</code>。</p><p>默认值：<code>true</code></p><p>启用“去除”（移除）空 Filestore 文件夹的作业。</p></div><div><h3 is="heading-item" :level="3" id="filestoreemptyfoldersreapfrequency">filestore_empty_folders_reap.frequency</h3><p><strong>版本：</strong>2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）中新增。此选项在 2021.1 中尚不可用。</p><p>默认值：<code>86400</code>（24 小时）</p><p>以分钟为单位指定运行移除空 Filestore 文件夹的作业的频率。</p></div><div><h3 is="heading-item" :level="3" id="filestoreloglevel">filestore.log.level</h3><p><strong>版本：</strong>版本 2020.3.0 中新增</p><p>默认值：<code>info</code></p><p>文件存储的日志记录级别。此设置是动态配置的，因此，如果您只是更改此设置，则不必重新启动 Tableau Server。有关详细信息，请参见<a href="logs_debug_level.htm" class="MCXref xref" xrefformat="{paratext}">更改日志记录级别</a>。</p></div><div><h3 is="heading-item" :level="3" id="filestorereapemptyfoldersholdoffms">filestore.reapemptyfoldersholdoffms</h3><p><strong>版本：</strong>2020.x（2020.1.14、2020.2.11、2020.3.6、2020.4.2）中新增。此选项在 2021.1 中尚不可用。</p><p>默认值：<code>300000</code> （5 分钟）</p><p>以毫秒为单位指定移除空 Filestore 文件夹之前等待的时间。</p></div><div><h3 is="heading-item" :level="3" id="floweditormaxdatafileuploadsizeinkb">floweditor.max_datafile_upload_size_in_kb</h3><p><strong>版本：</strong>版本 2020.4 中新增</p><p>默认值：<code>1048576</code></p><p>对于 Tableau Prep 流程 Web 制作，可以上载到 Tableau Server 的定界文本文件（例如 CSV 或 TXT）的最大大小。</p></div><h3 is="heading-item" :level="3" id="gatewayhttpcachecontrolupdated">gateway.http.cachecontrol.updated</h3><p>默认值：<code>false</code></p><p>Cache-Control HTTP 标头指定客户端浏览器是否应缓存从 Tableau Server 发送的内容。若要在客户端上禁用 Tableau Server 数据缓存，请将此项设置为 <code>true</code>。</p><div><h3 is="heading-item" :level="3" id="gatewayhttphsts">gateway.http.hsts</h3><p>默认值：<code>false</code></p><p>HTTP 严格传输安全性 (HSTS) 头强制浏览器在启用它的域上使用 HTTPS。</p></div><h3 is="heading-item" :level="3" id="gatewayhttphstsoptions">gateway.http.hsts_options</h3><p>默认值：<code>"max-age=31536000"</code></p><p>默认情况下，会为一年（31536000 秒）期间设置 HSTS 策略。此时间段指定浏览器将通过 HTTPS 访问服务器的时间量。</p><div><h3 is="heading-item" :level="3" id="gatewayhttpdloglevel"><a name="gatewayHttpdLoglevel"/>gateway.httpd.loglevel</h3><p><strong>版本：</strong>2021.3.0 中新增。</p><p>默认值：<code>notice</code></p><p>指定网关（Apache HTTPD 服务器）的日志记录级别。默认情况下这设置为 <code>notice</code>。其他选项包括 <code>debug</code>、<code>info</code>、 <code>warning</code>、<code>error</code>。如果更改日志记录级别，请注意对磁盘空间使用和性能的潜在影响。作为最佳实践，在收集到所需信息后，将日志记录级别恢复为默认值。有关 Apache 日志记录的详细信息，请参见 <a href="https://httpd.apache.org/docs/2.4/mod/core.html#loglevel" target="_blank">Apache HTTP 文档<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></div><div><h3 is="heading-item" :level="3" id="gatewayhttpdshmcbsize"><a name="gateway-httpd-shmcb-size"/>gateway.httpd.shmcb.size</h3><p><b>版本：</b>2021.4 中新增</p><p>默认值：<code>2048000</code></p><p>使用 <code>shmcb</code>存储类型时，指定循环缓冲区的内存量（以字节为单位）。使用 <code>dbm</code> 存储类型时，此配置键不适用。</p></div><div><h3 is="heading-item" :level="3" id="gatewayhttpdsocache"><a name="gateway-httpd-socache"/>gateway.httpd.socache</h3><p><b>版本：</b>2021.4 中新增</p><p>默认值：<code>shmcb</code></p><p>指定全局/进程间 SSL 会话缓存的存储类型。默认情况下，此项设置为 <code>shmcb</code>，带有另一个可配置的选项 <code>dbm</code>。有关<code>shmcb</code> 和 <code>dbm</code> 存储类型的详细信息，请参见 Apache 网站上的 <a href="https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslsessioncache" target="_blank">SSLSessionCache 指令<span class="sr-only">(链接在新窗口中打开)</span></a>。</p></div><h3 is="heading-item" :level="3" id="gatewayhttprequestsizelimit">gateway.http.request_size_limit</h3><p>默认值：<code>16380 </code></p><p>允许根据 HTTP 请求通过 Apache 网关传递的标头内容的最大大小（字节）。标头超过此选项上设置的值将导致浏览器错误，如 HTTP 错误 413（请求实体太大）或身份验证失败。</p><p><code>gateway.http.request_size_limit</code> 的值较低可能会导致身份验证错误。与 Active Directory（SAML 和 Kerberos）集成的单点登录解决方案在 HTTP 标头中经常需要大型身份验证令牌。一定要在部署到生产环境之前测试 HTTP 身份验证方案。</p><p>我们建议将 <code>tomcat.http.maxrequestsize</code> 选项设置为您为此选项设置的相同值。</p><h3 is="heading-item" :level="3" id="gatewayhttpxcontenttypenosniff">gateway.http.x_content_type_nosniff</h3><p>默认值：<code>true</code></p><p>X-Content-Type-Options 响应 HTTP 头指定 Content-Type 头中的 MIME 类型不应由浏览器更改。在某些情况下，如果未指定 MIME 类型，则浏览器可能会通过评估有效负载的特征来尝试确定 MIME 类型。然后浏览器将相应地显示内容。这个过程被称为“嗅探”。误解 MIME 类型可能会导致安全漏洞。默认情况下，系统使用此选项将 X-Content-Type-Options HTTP 头设置为“nosniff”。</p><h3 is="heading-item" :level="3" id="gatewayhttpxxssprotection">gateway.http.x_xss_protection</h3><p>默认值：<code>true</code></p><p>HTTP X-XSS-Protection 响应头会发送到浏览器以启用跨站点脚本 (XSS) 保护。在用户在浏览器中禁用 XSS 保护的情况下，X-XSS-Protection 响应头会覆盖配置。默认情况下，系统使用此选项启用了 X-XSS-Protection 响应头。</p><div><h3 is="heading-item" :level="3" id="gatewayloglevel">gateway.log.level</h3><p><strong>版本：</strong>版本 2020.3.0 中新增。</p><p>默认值：<code>info</code></p><p>网关的日志记录级别。此设置是动态配置的，因此，如果您只是更改此设置，则不必重新启动 Tableau Server。有关详细信息，请参见<a href="logs_debug_level.htm" class="MCXref xref" xrefformat="{paratext}">更改日志记录级别</a>。</p></div><h3 is="heading-item" :level="3" id="gatewaypublichost">gateway.public.host</h3><p>默认值：&lt;hostname&gt;</p><p>服务器的名称 (URL)，用于对 Tableau Server 进行外部访问。如果将 Tableau Server 配置为使用代理服务器或外部负载平衡器，则它是在浏览器地址栏中输入的用于访问 Tableau Server 的名称。例如，如果通过输入 <code>tableau.example.com</code> 来访问 Tableau Server，则 gateway.public.host 的名称是 <code>tableau.example.com</code>。</p><h3 is="heading-item" :level="3" id="gatewaypublicport">gateway.public.port</h3><p>默认值：<code>80 </code>（如果采用 SSL，则为 <code>443 </code>）</p><p>仅适用于代理服务器环境。代理服务器所侦听的外部端口。</p><h3 is="heading-item" :level="3" id="gatewayslowpostprotectionenabled">gateway.slow_post_protection.enabled</h3><p>默认值：<code>false</code></p><p>通过启用此选项，将可使以极慢速率传输数据的 POST 请求超时，从而以防御慢速 POST（拒绝服务）攻击上提供一些帮助。</p><p class="note"><strong>注意：</strong> 此选项无法消除此类攻击的威胁，并且可能会有终止慢速连接的意外影响。</p><h3 is="heading-item" :level="3" id="gatewayslowpostprotectionrequestreadtimeout">gateway.slow_post_protection.request_read_timeout</h3><p>默认值：<code>header=15-20,MinRate=500 body=10,MinRate=500</code></p><p>当由前面的选项 <code>gateway.slow_post_protection.enabled</code> 启用时，此选项将设置 Apache httpd ReadRequestTimeout。关于 httpd 指令的相关信息可在 <a href="https://httpd.apache.org/docs/2.4/mod/mod_reqtimeout.html" target="_blank">Apache Module mod_reqtimeout<span class="sr-only">(链接在新窗口中打开)</span></a> 中找到。此选项的主要用途是防御 Slowloris 攻击。请参阅维基百科条目 <a href="https://en.wikipedia.org/wiki/Slowloris_(computer_security)" target="_blank">Slowloris（计算机安全）<span class="sr-only">(链接在新窗口中打开)</span></a>。</p><h3 is="heading-item" :level="3" id="gatewaytimeout">gateway.timeout</h3><p>默认值：<code>7200</code></p><p>网关在请求失败前等待特定事件的最长时间，以秒为单位（7200 秒 = 2 小时）。</p><h3 is="heading-item" :level="3" id="gatewaytrusted">gateway.trusted</h3><p>默认值：代理服务器计算机的 IP 地址</p><p>仅适用于代理服务器环境。代理服务器的 IP 地址或主机名。</p><h3 is="heading-item" :level="3" id="gatewaytrustedhosts">gateway.trusted_hosts</h3><p>默认值：代理服务器的备用名称</p><p>仅适用于代理服务器环境。代理服务器的任何备用主机名。</p><h3 is="heading-item" :level="3" id="indexandsearchservervmopts"><a name="indexandsearchserver"/>indexandsearchserver.vmopts</h3><p><strong>版本：</strong>版本 2022.1 中新增。</p><p/><p>默认值：“<code>-Xmx&lt;default_value&gt; -Xms&lt;default_value&gt;</code>”</p><p>默认值基于系统内存量，为系统总 RAM 的 3.125%。</p><p>控制索引和搜索服务器堆大小。由于默认值会自动缩放，因此仅在绝对必要时才使用此选项覆盖默认值。将字母“k”附加到值以指明千字节，附加“m”以指明兆字节，附加“g”以指明千兆字节。一般情况下，将初始堆大小 (<code>-Xms</code>) 设置为等于最大堆大小 (<code>-Xmx</code>)，以最大限度地减少垃圾回收。</p><h3 is="heading-item" :level="3" id="hyperfilepartitionsizelimit">hyper.file_partition_size_limit</h3><p>默认值：<code>0</code></p><p>设置为 0 时，大小设置为无限，并将使用所有可用磁盘空间。</p><p>此选项用于为假脱机到磁盘的查询设置磁盘空间限制。如果 spool.&lt;id&gt;.tmp 文件使用的磁盘空间高于对于您的环境它所需的空间，则意味着查询已假脱机并占用磁盘空间。使用此选项来限制任何一个查询可使用的磁盘空间量。spool.&lt;id&gt;.tmp 文件可在运行 Tableau Server 的用户帐户的 temp 文件夹中找到。您能以 K(KB)、M(MB)、G(GB) 或 T(TB) 为单位指定此值。例如，如果要将磁盘空间使用量限制为 100 GB，您可以将大小限制指定为 100G。</p><p>有关假脱机的详细信息，请参见<a href="data_engine2_intro.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 数据引擎</a>中的“内存和 CPU 使用率”部分。</p><h3 is="heading-item" :level="3" id="hyperglobalfilepartitionsizelimit">hyper.global_file_partition_size_limit</h3><p>默认值：<code>0</code></p><p>设置为 0 时，大小设置为无限，并将使用所有可用磁盘空间。</p><p>此选项用于为假脱机到磁盘的所有查询设置磁盘空间限制。如果 spool.&lt;id&gt;.tmp 文件使用的磁盘空间高于对于您的环境它所需的空间，则意味着查询已假脱机并占用磁盘空间。spool.&lt;id&gt;.tmp 文件可在运行 Tableau Server 的用户帐户的 temp 文件夹中找到。使用此选项来限制所有查询在假脱机到磁盘时使用的磁盘空间总量。您能以 K(KB)、M(MB)、G(GB) 或 T(TB) 为单位指定此值。例如，如果要将磁盘空间使用量限制为 100 GB，您可以将大小限制指定为 100G。Tableau 建议您在调整假脱机限制时首先配置此选项。</p><p>有关假脱机的详细信息，请参见<a href="data_engine2_intro.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 数据引擎</a>中的“内存和 CPU 使用率”部分。</p><h3 is="heading-item" :level="3" id="hyperlogqueries">hyper.log_queries</h3><p>默认值：<code>true</code></p><p>设置为 true 时，将记录查询信息。</p><p>默认情况下会记录查询信息。但如果您发现日志文件对于可用磁盘空间量而言太大，您可以将其设置为 <code>false</code> 来禁用查询信息日志记录。Tableau 建议将此配置保持设置为 <code>true</code>。</p><h3 is="heading-item" :level="3" id="hyperenableaccesspathssymboliccanonicalization">hyper.enable_accesspaths_symbolic_canonicalization</h3><p>默认值：<code>false</code></p><p>在 Windows 操作系统上，为了解析符号链接，Hyper 需要能够访问存储提取的目录及其所有父目录。如果不是这种情况，您可能会在 Hyper 日志中看到一条错误消息，内容为：<b>Unable to get canonical path for</b><code>//dirA/subdir/myextract.hyper ... Access is denied</code>。</p><p>在这种情况下，您可以将其设置为 <code>true</code>，因此数据引擎 (Hyper) 在使用规范路径时不会尝试解析符号链接。</p><p class="note"><b>注意：</b>将值设置为 <code>true</code> 也意味着 Hyper 不能再保证防范潜在的攻击者，他们设法放置符号链接来逃避 Hyper 配置为允许访问的允许目录集。</p><h3 is="heading-item" :level="3" id="hyperlogquerycpu">hyper.log_query_cpu</h3><p>默认值：<code>false</code></p><p>使用此设置来记录每个查询占用的时间量以及 CPU 使用率。</p><h3 is="heading-item" :level="3" id="hyperlogtiming">hyper.log_timing</h3><p>默认值：<code>false</code></p><p/><p>若要了解查询的详细信息，比如编译和解析时间，此设置非常有用。默认情况下此设置已禁用。您可以通过将值设置为 <code>true</code> 来启用此项以收集有关查询的更多详细信息。但是请注意，这将会增加数据引擎日志文件 (\logs\hyper) 的大小。</p><h3 is="heading-item" :level="3" id="hyperlogtroublesomequeryplans">hyper.log_troublesome_query_plans</h3><p>默认值：<code>true</code></p><p>设置为 <code>true</code> 时，将记录标识为存在问题的查询的查询计划。被取消的查询、运行速度慢于 10 秒的查询或者查询假脱机到磁盘的情况都属于此类别。日志中的信息对于排查存在问题的查询可能很有用。如果担心日志的大小，您可以将设置更改为 <code>false</code>。</p><h3 is="heading-item" :level="3" id="hypermemorylimit">hyper.memory_limit</h3><p>默认值：<code>80%</code></p><p>控制 Hyper 使用的最大内存量。指定字节数。将字母“k”附加到值以指明千字节，附加“m”以指明兆字节，附加“g”以指明千兆字节，附加“t”以指明太字节。例如，<code>hyper.memory_limit='7g'</code>。或者，将内存限制指定为可用系统总内存的百分比。例如，<code>hyper.memory_limit='90%'</code>。</p><h3 is="heading-item" :level="3" id="hypermemtrackerhardreclaimthreshold">hyper.memtracker_hard_reclaim_threshold</h3><p>默认值：<code>80%</code></p><p>此设置仅适用于 Windows。Hyper 将数据提取的已解压缩和解密部分保存在内存中，以便更快地进行后续访问。此设置控制工作线程何时开始将此数据写入磁盘缓存以降低内存压力。如果以百分比形式给出，则该值将解读为整个 <code>hyper.memory_limit</code> 设置的百分比。例如，<code>hyper.memtracker_hard_reclaim_threshold='60%'</code>。绝对值可以指定为“k”（千字节）、“m”（兆字节）、“g”（千兆字节）或“t”（太字节）。例如，<code>hyper.memtracker_hard_reclaim_threshold='10g'</code>。该值应大于 <code>hyper.memtracker_soft_reclaim</code> 阈值。</p><h3 is="heading-item" :level="3" id="hypermemtrackersoftreclaimthreshold">hyper.memtracker_soft_reclaim_threshold</h3><p>默认值：<code>50%</code></p><p>此设置仅适用于 Windows。与 Hyper 文件交互时，Hyper 会写出一些用于缓存或保留数据的数据。Windows 具有将新写入的数据锁定到内存中的特殊行为。为了避免交换，当 Hyper 达到回收阈值的配置限制时，我们会强制退出数据。当达到软回收阈值时，Hyper 将尝试在后台回收缓存的数据，以尝试保持在回收阈值以下。在可能会发生交换的情况下，在 Hyper 中触发回收可以带来更好的结果。因此，如果您的 Tableau Server 安装遇到大量交换，此设置可用于尝试降低内存压力。</p><p>指定字节数。将字母“k”附加到值以指明千字节，附加“m”以指明兆字节，附加“g”以指明千兆字节，附加“t”以指明太字节。或者，将该值指定为 Hyper 的总配置内存的百分比。例如，<code>hyper.memtracker_soft_reclaim_threshold='20%'</code>。</p><h3 is="heading-item" :level="3" id="hypernetworkthreads">hyper.network_threads</h3><p>默认值：<code>150%</code></p><p>控制 Hyper 使用的网络线程数。指定网络线程数（例如 <code>hyper.network_threads=4</code>），或指定与逻辑内核计数相关的线程百分比（例如 <code>hyper.network_threads='300%'</code>）。</p><p>网络线程用于接受新连接以及发送或接收数据和查询。Hyper 使用异步网络，因此单个线程可为多个连接提供服务。通常，在网络线程上完成的工作量非常低。一个例外是在慢速文件系统上打开数据库，这可能需要很长时间并阻止网络线程。如果尝试查看或编辑使用数据提取且有一段时间未使用的仪表板时连接时间很慢，并且经常在 Hyper 日志中看到“asio-continuation-slow”消息，并在 Tableau 日志中看到很长的“construct-protocol”到 Hyper 时间，请尝试增加此值。</p><h3 is="heading-item" :level="3" id="hyperobjectstorevalidatechecksums">hyper.objectstore_validate_checksums</h3><p>默认值：<code>false</code></p><p>在 Hyper 中控制文件完整性检查的布尔设置。设置为 <code>true</code> 时，Hyper 将在首次访问数据提取文件中检查数据。这样将可检测到无提示损坏和将导致 Hyper 崩溃的损坏。通常，建议打开此设置，但对于极慢磁盘速度的安装除外，因为这些安装可能会导致性能退化。</p><h3 is="heading-item" :level="3" id="hyperquerytotaltimelimit">hyper.query_total_time_limit</h3><p>默认值：<code>0</code>（表示无限制）</p><p>设置总线程时间上限，Hyper 中的单个查询可以使用该上限。将“s”附加到值以指明秒，附加“min”以指明分钟，或附加“h”以指明小时。</p><p>例如，若要将所有查询限制为总线程时间的总时间用量 1500 秒，请运行以下命令：</p><p><code>tsm configuration set -k hyper.query_total_time_limit -v 1500s</code></p><p>如果查询运行时间超过指定的限制，则查询将失败并返回错误。此设置允许您自动控制失控的查询，后者会使用过多的资源。</p><p>Hyper 会并行执行查询。举例来说，如果查询执行 100 秒，并且在此期间在 30 个线程上运行，则总线程时间将为 3000 秒。Hyper 日志的“query-end”日志条目中的“total-time”字段中报告了每个查询的线程时间。</p><h3 is="heading-item" :level="3" id="hypersessionmemorylimit">hyper.session_memory_limit</h3><p>默认值：<code>0</code>（表示无限制）</p><p>控制单个查询可以具有的最大内存消耗。指定字节数。将字母“k”附加到值以指明千字节，附加“m”以指明兆字节，附加“g”以指明千兆字节，附加“t”以指明太字节。</p><p>例如，若要将内存限制设置为 900 MB，请运行以下命令：</p><p><code>tsm configuration set -k hyper.session_memory_limit -v 900m</code>。</p><p>或者，若将会话内存限制指定为可用系统总内存的百分比，请运行以下命令：</p><p><code>tsm configuration set -k hyper.session_memory_limit -v 90%</code>。</p><p>当查询使用过多的内存并使其他查询长时间失败时，降低此值可能会有所帮助。通过降低限制，单个大型查询将失败（或采用假脱机，如果假脱机未关闭），并且对其他查询没有负面影响。</p><h3 is="heading-item" :level="3" id="hyperstandaloneconsistenthashingenabled">hyper_standalone.consistent_hashing.enabled</h3><p>默认值：<code>true</code></p><p>提高了查询的数据提取已被缓存的可能性。如果缓存了数据提取的节点不支持额外的负载，则会将您路由到新节点，并且数据提取将加载到新节点上的缓存中。这可以改善系统利用率，因为只有在负载证明需要时，才会将数据提取加载到内存中。</p><h3 is="heading-item" :level="3" id="hyperstandalonehealthenabled">hyper_standalone.health.enabled</h3><p>默认值：<code>true</code></p><p>根据由当前 Hyper 活动和系统资源使用情况组合组成的运行状况分数，将负载平衡指标从随机选择切换到选取数据引擎 (Hyper) 节点。根据这些值，负载均衡器将选取最有能力处理数据提取查询的节点。</p><h3 is="heading-item" :level="3" id="hypertempdiskspacelimit">hyper.temp_disk_space_limit</h3><p>默认值：<code>100%</code></p><p>设置 Hyper 将停止为临时文件分配空间的磁盘空间上限。此设置可帮助防止硬盘填充来自 Hyper 的临时文件并耗尽磁盘空间。如果磁盘空间达到此阈值，Hyper 将尝试自动恢复，而无需管理员干预。</p><p>将其指定为要使用的可用磁盘总空间的百分比。例如，<code>hyper.temp_disk_space_limit="96%"</code>。设置为 100% 时，可以使用所有可用的磁盘空间。</p><p>若要启动数据引擎，必须提供配置的磁盘空间量。如果没有足够的磁盘空间，您将看到一个指明“Disk limit for temporary files has been reached”（已达到临时文件的磁盘限制）的数据引擎日志条目。请在设备上释放磁盘空间。有关“No space left on device”（设备上没有剩余空间）的详细信息，请参见 Hyper 日志。</p><h3 is="heading-item" :level="3" id="hyperhardconcurrentquerythreadlimit">hyper.hard_concurrent_query_thread_limit</h3><p>默认值：150%</p><p>使用此选项可以设置 Hyper 在运行查询时应使用的最大线程数。在您希望为 CPU 使用率设置硬限制时，请使用此选项。指定线程数或指定与逻辑内核计数相关的线程百分比。Hyper 很可能不会使用比此设置配置的更多资源，但 Hyper 后台和网络线程不受此设置的影响（尽管它们往往不是 CPU 密集型线程）。</p><p>此设置会控制可执行的并发查询数，请务必考虑这一点。因此，如果减少此设置，则查询需要等待当前运行的查询完成的机率会增加，从而可能影响工作簿加载时间。</p><h3 is="heading-item" :level="3" id="hypersoftconcurrentquerythreadlimit">hyper.soft_concurrent_query_thread_limit</h3><p>默认值：100%</p><p>使用此选项指定如果 <code>hard_concurrent_query_thread_limit</code> 设置有足够多的线程可用，则单个查询可以并行处理的线程数。指定线程数或指定与逻辑内核计数相关的线程百分比。</p><p>为了说明这一点，下面是一个简化的示例：</p><p>假设您将此值设置为 10 个线程，这意味着最多可跨 10 个线程并行处理查询。如果只有 2 个查询正在运行，则其余 8 个线程将用于对这 2 个线程进行并行处理。</p><p class="note"><i>hyper. hard_concurrent_query_thread_limit</i> 和 <i>hyper.soft_concurrent_query_thread_limit</i> 选项协同工作，为您提供了一些用于管理 CPU 使用率的选项，同时最大限度地提高可用 CPU 资源以便更快完成查询。如果您不希望数据引擎使用计算机上的所有可用 CPU，请将其更改最适合于您的环境的百分比（小于 100%）。软限制是一种限制 CPU 使用率的方法，但在必要时允许 CPU 使用率超过软限制（上限为硬限制）。</p><p class="note"><b>注意：</b><i>hyper.hard_concurrent_query_thread_limit</i> 和 <i>hyper.soft_concurrent_query_thread_limit</i> 选项替代了 Tableau Server 2018.3 及更低版本中提供的 hyper.num_job_worker_threads 和 hyper.num_task_worker_threads 选项，后者在当前版本中已弃用。<conditionaltext data-mc-conditions="Product.serverwindows">有关 hyper.num_job_worker_threads 和 hyper.num_task_worker_threads 的信息，请参见 <a href="https://help.tableau.com/current/server/zh-cn/cli_configuration-set_tsm.htm" target="_blank">tsm configuration set 选项。<span class="sr-only">(链接在新窗口中打开)</span></a></conditionaltext></p><h3 is="heading-item" :level="3" id="hyperusespoolingfallback">hyper.use_spooling_fallback</h3><p>默认值：<code>true</code></p><p>设置为 <code>true</code> 时，它允许在查询数据操作使用的 RAM 超过设定的使用量（已安装 RAM 的 80%）时假脱机到磁盘。换句话说，它允许 Hyper 在超过 RAM 使用量时使用磁盘执行查询。</p><p>Tableau 建议您使用默认设置。如果担心磁盘使用量，您可以通过将值设置为 <code>false</code> 来禁用此项。如果禁用此设置，使用了超过 80% 已安装 RAM 的查询将被取消。假脱机查询通常需要相当长的时间才能完成。</p><p>有关假脱机的详细信息，请参见<a href="data_engine2_intro.htm" class="MCXref xref" xrefformat="{paratext}">Tableau Server 数据引擎</a>中的“内存和 CPU 使用率”部分。</p><div><h3 is="heading-item" :level="3" id="jmxsecurityenabled">jmx.security.enabled</h3><p><strong>版本：</strong>版本 :2022.1 中新增。</p><p>默认值：<code>false</code></p><p>JMX 默认情况下已禁用，因此也禁用了安全 JMX。如果您要启用 JMX，我们强烈建议您启用安全 JMX。</p><p>此项设置为 <code>true</code>，并在您运行 <code>tsm maintenance jmx enable</code>命令，且在系统提示为 JMX 启用安全功能时回答 <code>y</code> 时，使用 SSL 和基本用户名/密码身份验证启用安全 JMX：</p><pre xml:space="preserve">tsm maintenance jmx enable&#13; We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?&#13; (y/n): y</pre><h3 is="heading-item" :level="3" id="jmxsslenabled">jmx.ssl.enabled</h3><p><strong>版本：</strong>版本 :2022.1 中新增。</p><p>默认值：<code>true</code></p><p>为 JMX 强制使用 SSL。此选项默认为 <code>true</code>，但除非 <code>jmx.security.enabled</code> 也设置为 <code>true</code>，否则不起作用。若要启用 JMX 安全性，请运行 <code>tsm maintenance jmx enable</code> 命令。当系统提示启用 SSL 时，回答 <code>y</code>，或回答 <code>n</code> 禁用 SSL：</p><pre xml:space="preserve">tsm maintenance jmx enable&#13; Would you like to enable SSL?&#13; (y/n): n</pre><h3 is="heading-item" :level="3" id="jmxsslrequireclientauth">jmx.ssl.require_client_auth</h3><p><strong>版本：</strong>版本 :2022.1 中新增。</p><p>默认值：<code>false</code></p><p>当您运行 <code>tsm maintenance jmx enable</code> 命令，且在系统提示需要客户端身份验证 (mTLS) 时回答 <code>y</code> 时，此项设置为 <code>true</code>：</p><pre xml:space="preserve">tsm maintenance jmx enable&#13;