tsm configuration set-Optionen

Im Folgenden finden Sie eine Liste der Konfigurationsoptionen oder -schlüssel, die Sie mit dem Befehl tsm configuration set festlegen können. In vielen Fällen können Sie den aktuellen Wert eines Konfigurationsschlüssels mit dem tsm configuration get-Befehl herausfinden.

Diese Liste ist nicht als vollständige Liste der Tableau Server-Konfigurationseinstellungen gedacht. Sie stellt eine Teilmenge von Konfigurationsschlüsseln dar, die von Serveradministratoren festgelegt werden können. Darüber hinaus werden einige der Schlüssel, die intern von Tableau Server verwendet werden, nicht in dieser Liste angezeigt.

Hinweis: Bei Konfigurationsschlüsseln wird die Groß-/Kleinschreibung beachtet.

Verwenden der tsm CLI

Sie können tsm-Befehle auf dem Einstiegsknoten (dem Knoten, auf dem TSM installiert ist) oder auf jedem weiteren Knoten im Cluster ausführen.

Zum Ausführen von tsm-Befehlen müssen Sie eine Eingabeaufforderung öffnen.

Öffnen Sie eine Eingabeaufforderung mit einem Konto, das Mitglied der Gruppe tsmadmin auf einem Knoten im Cluster ist.
Führen Sie den gewünschten Befehl aus. Wenn Sie den Befehl von einem anderen Knoten als dem anfänglichen Knoten aus ausführen, schließen Sie die Option -s ein, um die URL des anfänglichen Knotens namentlich (nicht die IP-Adresse) anzugeben, und schließen Sie den TSM-Port 8850 ein.
Um die Version von TSM und Tableau Server vom Einstiegsknoten aus anzuzeigen:
tsm version
Um die Version von TSM und Tableau Server von einem zusätzlichen Knoten aus anzuzeigen:
tsm version -s https://<inital_node_name>:8850
Beispiel:
tsm version -s https://myTableauHost:8850

Grundlegende Verwendung von tsm-Konfigurationsschlüsseln

Festlegen eines Konfigurationsschlüssels

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

In einigen Fällen müssen Sie die --force-keys-Option zum Festlegen eines Konfigurationswerts für einen Schlüssel einschließen, falls dieser vorher noch nicht festgelegt wurde. Weitere Informationen finden Sie unter "Unbekannter Schlüssel"-Antworten.

Nach dem Festlegen eines Schlüsselwerts für die Konfiguration müssen Sie die ausstehenden Konfigurationsänderungen mithilfe von tsm pending-changes apply anwenden. Bis dahin wird der neue Wert nicht von Tableau verwendet und nicht in den Ergebnissen eines tsm configuration get-Befehls angezeigt. Sie können ausstehende Änderungen mithilfe von tsm pending-changes list anzeigen. Weitere Informationen finden Sie unter tsm pending-changes.

Zurücksetzen eines Konfigurationsschlüssels auf den Standardwert

Verwenden Sie zum Zurücksetzen eines Konfigurationsschlüssel auf den Standardwert die -d-Option:

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

Anzeigen des aktuellen Werts eines Konfigurationsschlüssels

Um zu sehen, auf was ein Konfigurationsschlüssel aktuell festgelegt ist, verwenden Sie den Befehl configuration get:

tsm configuration get -k <config.key>

Es gibt zwei Sonderfälle, in denen kein brauchbarer aktueller Wert für einen Schlüssel zurückgegeben wird:

In bestimmten Fällen können Sie keinen Konfigurationswert für einen Schlüssel erhalten, der nicht explizit festgelegt wurde. Stattdessen gibt der tsm configuration get-Befehl die Antwort "Unbekannter Schlüssel" zurück. Weitere Informationen finden Sie unter "Unbekannter Schlüssel"-Antworten.
Für bestimmte Schlüssel mit vordefinierten Standardwerten gibt der Befehl tsm configuration get die Antwort "Null" zurück. Weitere Informationen finden Sie unter Antworten mit "Null"-Wert.

Konfigurationsschlüssel

adminviews.disabled

Standardwert: false

Deaktiviert den Zugriff auf die Tableau-Verwaltungsansichten. Standardmäßig ist der Zugriff auf Ansichten aktiviert (diese Option ist auf "false" festgelegt).

api.server.enabled

Version: In Version 2023.1 veraltet. Sie können die REST API in Version 2023.1 und höher nicht deaktivieren.

Standardwert: true

Erlaubt den Zugriff auf die Tableau Server REST API(Link wird in neuem Fenster geöffnet).

Diese Funktion ist standardmäßig aktiviert. Wir empfehlen dringend, diese Einstellung beizubehalten. Durch das Deaktivieren der REST-API wird die Funktionalität einer breiten Palette von Tableau-Funktionen beeinträchtigt. Es verbessert weder die Leistung noch erhöht es die Sicherheit. Wenn Sie die REST-API in Ihrer Tableau Server-Installation deaktivieren möchten, testen Sie die benötigte Funktionalität sorgfältig.

Zu den Funktionen, die durch das Deaktivieren der REST-API beeinträchtigt werden, gehören:

Suche
Favoriten
Sammlungen
Content Management Tool (CMT)
Resource Monitoring Tool (RMT)
Persönliche Bereiche

auditing.enabled

Standardwert: true

Der Zugriff auf die PostgreSQL-Überwachungsverlaufstabellen (systemeigene Datenbank von Tableau Server) ist möglich.

backgrounder.default_run_now_priority

Standardwert (Ganzzahl): 0

Über diese Einstellung wird gesteuert, welche Priorität für die Ausführung von Aufträgen jetzt zugewiesen wird. 0 ist dabei die höchste Priorität. Die angegebenen Werte sollten im Bereich von 0 bis 100 liegen.

backgrounder.enable_parallel_adsync

Version: Hinzugefügt in Version 2018.3.6

Standardwert: false

Steuert, ob die parallele Verarbeitung von Synchronisationsaufträgen der External Directory-Gruppen zulässig ist, wenn mehrere Hintergründe vorhanden sind. Standardmäßig wird eine geplante Synchronisierung von External Directory-Gruppen seriell von einer einzelnen Hintergrundprozesskomponente verarbeitet. Legen Sie für diese Option true fest, damit die parallele Verarbeitung auf mehreren Hintergrundprozesskomponenten-Instanzen aktiviert wird.

backgrounder.externalquerycachewarmup.enabled

Version: In Version 2023.1 veraltet. Um die Ladezeiten für Arbeitsmappen zu verbessern, aktivieren Sie stattdessen die Ansichtsbeschleunigung auf Ihrer Site.

Standardwert: false

Steuert die Zwischenspeicherung von Abfrageergebnissen für Arbeitsmappen nach geplanten Extraktaktualisierungsaufgaben.

backgrounder.externalquerycachewarmup.view_threshold

Version: In Version 2023.1 veraltet. Um die Ladezeiten für Arbeitsmappen zu verbessern, aktivieren Sie stattdessen die Ansichtsbeschleunigung auf Ihrer Site.

Standardwert: 2.0

Der Schwellenwert für die Zwischenspeicherung von Abfrageergebnissen für Arbeitsmappen nach geplanten Extraktaktualisierungsaufgaben. Der Schwellenwert entspricht dem Wert, wie häufig die Arbeitsmappe in den vergangenen sieben Tagen angezeigt wurde, geteilt durch die Anzahl der innerhalb der nächsten sieben Tage geplanten Aktualisierungen.

Die folgenden beiden Befehlsoptionen der Hintergrundprozesskomponente bestimmen, wie lange eine Schemaaufgabe ausgeführt werden kann, bevor die Hintergrundaufgabe des Schemas abgebrochen wird. Diese beiden Befehle bestimmen zusammen den gesamten Timeout-Wert für Schemaaufgaben.

backgrounder.extra_timeout_in_seconds

Standardwert: 1800

Die Anzahl von Sekunden über den Wert von backgrounder.querylimit hinaus, nach der eine Hintergrundaufgabe abgebrochen wird. Diese Einstellung stellt sicher, dass ein angehaltener Auftrag nachfolgende Aufträge nicht aufhält. Diese Einstellung ist für die in backgrounder.timeout_tasks aufgeführten Prozesse wirksam. 1800 Sekunden sind 30 Minuten.

backgrounder.default_timeout.run_flow

Standardwert: 14400

Die Anzahl der Sekunden, bevor eine Schemaausführungsaufgabe abgebrochen wird. 14.400 Sekunden sind 4 Stunden.

backgrounder.failure_threshold_for_run_prevention

Standardwert: 5

Die Anzahl der aufeinanderfolgenden Fehler einer Subscription, eines Extrakts oder einer Schema-Ausführung vor dieser Aufgabe wird angehalten. Durch Anhalten von Aufträgen, die fortlaufend fehlschlagen, stehen die Ressourcen der Hintergrundprozesskomponente für andere Aufträge zur Verfügung. Um das Aussetzen fehlgeschlagener im Hintergrund ausgeführter Aufgaben zu deaktivieren, legen Sie hierfür den Wert -1 fest.

backgrounder.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollierungsebene für den Prozess der Hintergrundprozesskomponente. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

backgrounder.querylimit

Standardwert: 7200

Längster zulässiger Zeitraum, in Sekunden, zum Fertigstellen einer einzelnen Extraktaktualisierung. 7.200 Sekunden = 2 Stunden

Hinweis: Wenn eine Hintergrundaufgabe dieses Zeitlimit erreicht, kann sie für einige weitere Minuten ausgeführt werden, bis sie abgebrochen wird.

backgrounder.restrict_serial_collections_to_site_level

Standardwert: false

In Tableau Server können Sie Extraktaktualisierungen, Abonnements oder Schemata für die regelmäßige Ausführung planen. Diese geplanten Elemente werden als Aufgaben bezeichnet. Der Hintergrundprozess initiiert eindeutige Instanzen dieser Aufgaben, um sie zum geplanten Zeitpunkt auszuführen. Die eindeutigen Instanzen der Aufgaben, die dadurch initiiert werden, werden als Aufträge bezeichnet.

Diese Einstellung wirkt sich auf Zeitpläne aus, die für die serielle Ausführung konfiguriert sind. Wenn ein Zeitplan für die serielle Ausführung konfiguriert ist, werden standardmäßig alle Aufträge, die diesen Zeitplan verwenden, seriell ausgeführt. Wenn diese Einstellung auf true eingestellt ist, können Aufträge, die auf verschiedenen Sites ausgeführt werden, parallel ausgeführt werden. Aufträge für geplante Aufgaben auf derselben Site werden weiterhin seriell ausgeführt.

Das folgende Beispiel veranschaulicht dieses Szenario:

Tableau Server enthält einen Zeitplan namens "Täglich", um Aufträge täglich um 7:00 Uhr auszuführen. Der Zeitplan "Täglich" ist so konfiguriert, dass er seriell ausgeführt wird. Die Site "HR" und die Site "Gehaltsabrechnung" haben jeweils mehrere geplante Aufgaben, die den Zeitplan "Täglich" verwenden. Wenn diese Einstellung auf true eingestellt ist, können Aufträge für diese geplanten Aufgaben auf der Site "HR" parallel zu Aufträgen auf der Site "Gehaltsabrechnung" ausgeführt werden, während Aufträge auf derselben Site weiterhin nur seriell ausgeführt werden.

backgrounder.notifications_enabled

Standardwert: true

Steuert, ob Extraktaktualisierungen und Schema-Ausführungs-Warnungen für alle Sites auf dem Server aktiviert sind. Standardmäßig sind alle Warnungen aktiviert. Um die Warnungen für alle Sites auf einem Server zu deaktivieren, legen Sie hierfür false fest.

Extraktwarnungen können aktiviert oder deaktiviert werden, entweder auf Site-Basis durch den Site-Administrator in den Site-Einstellungen oder auf Benutzerebene in den Benutzereinstellungen.

backgrounder.sort_jobs_by_type_schedule_boundary_heuristics_milliSeconds

Standardwert: 60000

Steuert das Zeitfenster, in dem Aufträge der Hintergrundprozesskomponente identifiziert werden, die den gleichen geplanten Startzeitpunkt haben.

Der Prozess der Hintergrundprozesskomponente sortiert Aufgaben, die gleichzeitig ausgeführt werden sollen, nach Auftragstyp, sodass die schnellste Kategorie von Aufträgen zuerst ausgeführt wird: Abonnements, dann inkrementelle Extrakte und dann vollständige Extrakte.

Aufträge werden in Batches gruppiert, um zu bestimmen, welche Aufträge "gleichzeitig" geplant sind. Der Wert 60.000 Millisekunden (Standard) gibt Aufträge für Zeitpläne an, die innerhalb eines Zeitfensters von 1 Minute beginnen und im selben Batch gruppiert werden sollten, sodass sie innerhalb dieses Batches nach dem Typ sortiert werden können.

backgrounder.subscription_failure_threshold_for_run_prevention

Standardwert: 5

Legt die Anzahl der aufeinanderfolgenden Abonnementfehler fest, die auftreten müssen, bevor die Bedingung für eine Warnung ausgesetzt wird. Wenn der Standardwert 5 festgelegt wird, werden Warnungen nach 5 aufeinanderfolgenden Abonnementfehlern ausgesetzt. Mit dem Wert -1 sind Benachrichtigungs-E-Mails auf unbestimmte Zeit zulässig. Diese Schwelle gilt serverweit, also gilt sie für alle auf dem Server definierten Abonnements.

backgrounder.subscription_image_caching

Standardwert: true

Legt fest, ob eine Hintergrundprozesskomponente für Abonnements generierte Abbilder zwischenspeichert. Zwischengespeicherte Abbilder müssen nicht jedes Mal neu generiert werden, sodass die Abonnementleistung durch das Zwischenspeichern verbessert wird. Standardmäßig ist das Zwischenspeichern von Abbildern aktiviert. Um das Zwischenspeichern von Abbildern für alle Sites auf einem Server zu deaktivieren, legen Sie hierfür false fest.

backgrounder.timeout_tasks

Standardwert: Der Standardwert kann je nach Ihrer Version von Tableau Server abweichen. Um eine Liste der Standardwerte für Ihre Version von Tableau anzuzeigen, führen Sie den Befehl tsm configuration get aus:

tsm configuration get -k backgrounder.timeout_tasks

Die Liste der Aufgaben, die abgebrochen werden dürfen, wenn sie länger laufen als die in backgrounder.querylimit und backgrounder.extra_timeout_in_seconds angegebenen Werte zusammen. Die Liste der Aufgaben ist durch Kommas getrennt. Die Standardliste stellt alle für diese Einstellung möglichen Werte dar.

backgrounder.timeout.single_subscription_notify

Version: Hinzugefügt in Version 2021.2.

Standardwert: 1800 Sekunden (30 Minuten)

Dies ist die maximal zulässige Zeit in Sekunden für die Ausführung eines einzelnen Abonnementauftrags.

backgrounder.timeout.sync_ad_group

Version: Hinzugefügt in Version 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1.

Standardwert: 14400 Sekunden (4 Stunden)

Dies ist die maximal zulässige Zeit in Sekunden für die Ausführung einer Active Directory-Gruppensynchronisierung. Dies gilt für geplante Gruppensynchronisierungen, die von der Hintergrundprozesskomponente durchgeführt werden, und verhindert, dass lang andauernde Synchronisierungen auf unbestimmte Zeit ausgeführt werden. Dies wirkt sich nicht auf Gruppensynchronisierungen aus, die über die Tableau Server-Benutzeroberfläche oder die REST-API durchgeführt werden.

backgrounder.vInstances_max_overflow_queue_size

Version: Hinzugefügt in Version 2022.1.2.

Standardwert: 1000

Die maximale Anzahl von Aufträgen, die sich in der sekundären Warteschlange befinden dürfen. Eine sekundäre Warteschlange wird erstellt, wenn die Anzahl der ausgeführten Aufträge das festgelegte Limit für parallel ausgeführte Aufträge erreicht. Der standardmäßige Maximalwert ist auf 1000 Aufträge festgelegt. Wenn also mehr als 1000 Aufträge vorhanden sind und somit das Limit für parallel ausgeführte Aufträge erreicht wird, wird alles über den 1000 Aufträgen nicht in die Warteschlange gestellt. Verwenden Sie den tsm-Befehl backgrounder.vInstance_max_overflow_queue_size, um Änderungen an der maximalen Überlaufgröße für Warteschlangen vorzunehmen.

Die Werte sind in ganzen Zahlen anzugeben.

backup.zstd.thread_count

Version: Hinzugefügt in Version 2021.1.0 Dieser Schlüssel ist dynamisch konfigurierbar. Weitere Informationen finden unter Änderungen der dynamischen Topologie von Tableau Server

Standardwert: 2

Anzahl der Threads, die beim Erstellen einer Sicherung verwendet werden sollen.

Eine Erhöhung dieser Anzahl kann die Backup-Leistung verbessern, aber wir empfehlen maximal vier, da die Thread-Anzahl die Anzahl der logischen Prozessoren auf dem Tableau Server-Computer nicht übersteigen sollte.

basefilepath.backuprestore

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

Der Speicherort, an dem der Befehl tsm maintenance backup die Sicherung erstellt. An diesem Speicherort muss sich auch die Sicherungsdatei befinden, wenn sie mit dem Befehl tsm maintenance restore oder dem Befehl tsm maintenance send-logs wiederhergestellt wird. Nachdem Sie dies festgelegt haben, sollten Sie den Befehl tsm maintenance validate-backup-basefilepath (ab Version 2022.1 verfügbar) ausführen, um zu überprüfen, dass die Berechtigungen für den Speicherort ordnungsgemäß festgelegt sind. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.log_archive

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

Der Speicherort, an dem der Befehl tsm maintenance ziplogs das ZIP-Archiv erstellt. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.site_export.exports

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports/

Der Speicherort, an dem der Befehl tsm sites export die Exportdatei erstellt. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.site_import.exports

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/

Der Speicherort, an dem der Befehl tsm sites import die Importdatei erwartet. Weitere Informationen finden Sie unter tsm-Dateipfade.

clustercontroller.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Cluster-Controller. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

clustercontroller.zk_session_timeout_ms

Standardwert: 300000

Zeitraum (in Millisekunden), den der Clustercontroller auf den Koordinationsdienst (ZooKeeper) wartet, bevor festgelegt wird, dass ein Failover erforderlich ist.

dataAlerts.checkIntervalInMinutes

Standardwert: 60

Das Intervall in Minuten, in dem Tableau Server überprüft, ob die Bedingungen für Datenwarnungen zutreffen.

(Der Server überprüft dies zudem jedes Mal, wenn mit Datenwarnungen verbundene Extrakte aktualisiert werden.)

dataAlerts.retryFailedAlertsAfterCheckInterval

Standardwert: true

Legt fest, wie oft Tableau Server fehlerhafte Datenwarnungen erneut überprüft. Wenn der Wert auf true festgelegt ist, überprüft der Server fehlerhafte Warnungen entsprechend der durch dataAlerts.checkIntervalInMinutes festgelegten Häufigkeit. Wenn der Wert auf false festgelegt ist, überprüft der Server die fehlerhaften Warnungen alle fünf Minuten erneut und benachrichtigt die Warnungsempfänger schneller bei geänderten Datenbedingungen. Dadurch wird jedoch die Serverleistung reduziert.

(Der Server überprüft dies zudem jedes Mal, wenn mit Datenwarnungen verbundene Extrakte aktualisiert werden.)

dataAlerts.SuspendFailureThreshold

Standardwert: 350

Legt die Anzahl der aufeinanderfolgenden Datenwarnungsfehler fest, die auftreten müssen, bevor die Warnmeldungen für eine Bedingung ausgesetzt werden. Wenn auf die Standardeinstellung 350 eingestellt, wird das Warnen nach etwa zwei Wochen ausgesetzt. Dieser Schwellenwert ist serverweit, gilt also für jeden auf dem Server definierten Datenalarm.

databaseservice.max_database_deletes_per_run

Version: Hinzugefügt in Version 2021.2.

Standardwert: null

Verwenden Sie diese Option, um die maximale Anzahl eingebetteter externer Assets (Datenbanken und Tabellen) anzupassen, die bei jedem durch features.DeleteOrphanedEmbeddedDatabaseAsset gesteuerten Hintergrundprozess gelöscht werden können. Wird diese Option leer gelassen, beträgt die standardmäßige maximale Anzahl eingebetteter externer Assets, die gelöscht werden können, 100.

Weitere Informationen finden Sie unter features.DeleteOrphanedEmbeddedDatabaseAsset.

dataserver.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Datenserver. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

elasticserver.vmopts

Version: Hinzugefügt in Version 2019.1. Entfernt: 2022.1

Diese Konfigurationsoption gilt nicht für Tableau Server, Version 2022.1 und höher. Verwenden Sie für Tableau Server ab der Version 2022.1 die Konfigurationsoption indexandsearchserver.vmopts

Standardwert: "-Xmx<default_value> -Xms<default_value>"

Der Standardwert variiert je nach Größe des Arbeitsspeichers. Die maximale JVM-Heapgröße wird auf 3,125 % des gesamten System-RAM skaliert.

Steuert die Heap-Größe des Elastic Server. Da der Standardwert automatisch skaliert wird, können Sie mithilfe dieser Option den Standardwert nur dann überschreiben, wenn dies unbedingt erforderlich ist. Fügen Sie an den Wert den Buchstaben 'k' an, um "Kilobyte" anzugeben, "m", um Megabyte anzugeben, oder "g", um Gigabyte anzugeben. Setzen Sie als allgemeine Regel die anfängliche Heap-Größe (-Xms) gleich mit der maximalen Heap-Größe (-Xmx), um die Sammlung von unbrauchbaren Dateien zu minimieren.

excel.shadow_copy_all_remote.enabled

Version: Hinzugefügt in den Versionen 2019.1.5, 2019.2.1.

Standardwert: false

Steuert, ob Tableau Server eine "Schattenkopie" eines gemeinsamen Excel-Arbeitsblatts (.xlxs oder.xlxm) erstellt, die als Live-Datenquelle verwendet wird. Wenn diese Option aktiviert ist, verhindert sie, dass Excel-Benutzer einen "Sharing Violation Error" und eine Meldung sehen, dass die Datei "aktuell verwendet wird". Diese Option kann bei großen Excel-Dateien Auswirkungen auf die Leistung haben. Wenn Excel-Benutzer nicht die gemeinsame Datei bearbeiten müssen, brauchen Sie diese Option nicht zu aktivieren.

Hinweis: Tableau Server versucht immer, eine Schattenkopie einer .xls-Datei zu erstellen. Diese Option ändert dieses Verhalten nicht.

extractservice.command.execution.timeout

Version: In Version 2021.4 hinzugefügt.

Standardwert: 7200 Sekunden

Legt den Timeout-Wert für die Laufzeit der VConn-Extraktaktualisierung fest.

Beispiel: tsm configuration set -k extractservice.command.execution.timeout -v <timeout_in_seconds> --force-keys

Hinweis: Sie müssen die Option --force-keys verwenden, um diesen Wert zu ändern.

features.ActiveMQ

Version: In Version 2021.4 hinzugefügt.

Standardwert: true

Legt fest, ob Tableau Server den Apache ActiveMQ-Dienst (Tableau Server-Messaging-Dienst) als internes Messaging-Instrument verwendet.

features.DeleteOrphanedEmbeddedDatabaseAsset

Version: Hinzugefügt in Version 2021.2.

Standardwert: true

Steuert einen Hintergrundprozess für Tableau Catalog (oder Tableau Metadaten-API), der eingebettete externe Assets (Datenbanken und Tabellen) löscht, die nicht mehr mit nachgelagerten Tableau-Inhalten verknüpft sind. Dieser Prozess wird täglich um 22:00:00 UTC (koordinierte Weltzeit) ausgeführt und kann täglich maximal 100 externe Assets löschen, bis keine externen Assets ohne Verbindungen zu nachgelagerten Inhalten von Tableau mehr vorhanden sind. Sie können diese Option auf false einstellen, um die Ausführung dieses Prozesses zu stoppen. Alternativ können Sie auch die maximale Anzahl externer eingebetteter Assets, die gelöscht werden können, mit databaseservice.max_database_deletes_per_run anpassen.

Weitere Informationen finden Sie im Abschnitt Beheben von Problemen mit fehlenden Inhalten.

features.DesktopReporting

Standardwert: false

Steuert, ob die Desktop-Lizenzberichterstattung auf dem Server aktiviert ist. Mit der Einstellung false(Standard) sind keine Verwaltungsansichten für Desktop-Lizenzen verfügbar. Ändern Sie die Einstellung in true, um die Lizenzberichterstattung zu aktivieren und die Verwaltungsansichten zu Lizenznutzung und -ablauf auf der Seite "Server-Status" bereitzustellen. Hinweis: Die Desktop-Lizenzberichterstattung muss auf dem Client (Tableau Desktop) aktiviert sein, damit Informationen an Tableau Server gemeldet werden können.

Features.IdentityMigrationBackgroundJob

Version: Hinzugefügt in Version 2022.1. Der Standardwert wurde in den Versionen 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 und 2023.3 in false geändert.

Standardwert: false

Steuert den Prozess, der die Identitätsmigration durchführt. Wenn auf true eingestellt, wird die Identitätsmigration in vorhandenen Bereitstellungen unmittelbar nach dem Upgrade von Tableau Server auf Version 2022.1 (oder höher) und der Wiederherstellung einer Sicherung von Tableau Server Version 2021.4 (oder früher) ausgeführt. Stellen Sie ihn auf false (Standard), um die Identitätsmigration zu deaktivieren.

Um beispielsweise die Identitätsmigration zu starten, führen Sie Folgendes aus:

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

Weitere Informationen finden Sie unter Über die Identitätsmigration.

Hinweis: Wenn die Identitätsmigration deaktiviert ist, kann Tableau Server den Identitätsdienst nicht zum Speichern und Verwalten von Benutzeridentitätsinformationen verwenden. Die Verwendung des Identity Service ist eine Voraussetzung für bestimmte Funktionen wie Identitätspools.

Features.IdentityPools

Version: Hinzugefügt in Version 2023.1

Standardwert: false

Eine Komponente der Identitätspoolfunktion, die aktiviert werden muss, wenn Sie eine neue Tableau Server-Installation durchführen. Erfordert feature.NewIdentityMode und wgserver.authentication.legacy_identity_mode.enabled. Stellen Sie dies auf true, um Identitätspools zu aktivieren. Stellen Sie dies auf false (Standard), um Identitätspools zu deaktivieren.

Um beispielsweise Identitätspools zu aktivieren, führen Sie Folgendes aus:

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

Weitere Informationen finden Sie unter Fehlerbehebung bei Identitätspools.

features.MessageBusEnabled

Version: Hinzugefügt in Version 2019.4.

Standardwert: true

Legt fest, ob Tableau Server das neue interne Messaging-Instrument verwendet.

Features.NewIdentityMode

Version: Hinzugefügt in Version 2022.1

Standardwert: false. Der Standardwert wurde in 2023.1.6 von true in false geändert.

Ist eine Voraussetzung für die Identitätspoolfunktion. Erfordert, dass wgserver.authentication.legacy_identity_mode.enabled auf false festgelegt wird, um Identitätspools zu deaktivieren. Muss auf true festgelegt werden, um Identitätspools zu verwenden.

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

Weitere Informationen finden Sie unter Fehlerbehebung bei Identitätspools.

features.PasswordlessBootstrapInit

Standardwert: true

Steuert, ob der Tableau Server eingebettete Anmeldeinformationen in Bootstrap-Dateien zulässt. Wenn aktiviert (Standard), werden eingebettete Anmeldeinformationen in der Bootstrap-Datei mit eingeschlossen, es sei denn, Sie geben an, dass sie nicht enthalten sein sollen. Setzen Sie dies auf false, wenn Anmeldeinformationen niemals in einer von Ihnen erzeugten Bootstrap-Datei enthalten sein sollen. Für weitere Informationen zum Erzeugen von Bootstrap-Dateien, siehe tsm topology nodes get-bootstrap-file.

Diese Option wurde ab Tableau Server-Version 2019.3 hinzugefügt.

features.PasswordReset

Standardwert: false

Gilt nur für Server, die lokale Authentifizierung verwenden. Stellen Sie trueein, um Benutzern das Zurücksetzen ihrer Kennwörter mit einer Option "Kennwort vergessen" auf der Anmeldeseite zu ermöglichen.

filestore.empty_folders_reaper.enabled

Version: Hinzugefügt in den Versionen 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) und 2021.1.x. Der Standardwert wurde in 2021.2 in true geändert.

Standardwert: true

Aktiviert den Auftrag, der leere Filestore-Ordner "erntet" (entfernt).

filestore_empty_folders_reap.frequenz_s

Version: Hinzugefügt in Version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2).

Standardwert: 86400 (24 Stunden)

Gibt in Minuten an, wie oft der Auftrag ausgeführt werden soll, der leere Filestore-Ordner entfernt.

features.Hyper_DisallowTDEPublishing

Version: Verwendet ab Version 2023.1.0 standardmäßig true

Standardwert: true

Gibt an, ob Benutzer Dateien im .tde-Format hochladen können. Dieses Format wurde ab Version 10.5 von Tableau Server durch das .hyper-Format ersetzt, das Hochladen wurde jedoch nicht blockiert. Ab Version 2024.3 sind Dateien im TDE-Format nicht mehr verwendbar. Die Dateien wurden automatisch in das .hyper-Format konvertiert, wenn eine von mehreren Aktionen ausgeführt wurde. Weitere Informationen finden Sie unter Extrahieren des Upgrades in das .hyper-Format.

filestore.log.level

features.Hyper_DisallowTDEPublishing

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Dateispeicher. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

filestore.reapemptyfoldersholdoffms

Version: Hinzugefügt in Version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2). Diese ist in 2021.1 noch nicht verfügbar.

Standardwert:300000 (5 Minuten)

Gibt die Wartezeit in Millisekunden an, bevor leere Filestore-Ordner entfernt werden.

floweditor.max_datafile_upload_size_in_kb

Version: Hinzugefügt in Version 2020.4

Standardwert: 1048576

Für die Tableau Prep-Schema-Webdokumenterstellung die maximale Größe von abgegrenzten Textdateien (z. B. CSV oder TXT), die auf Tableau Server hochgeladen werden können.

gateway.external_url

Version: Hinzugefügt in Version 2023.1

Standardwert: null

Erforderlich, wenn die OpenID Connect-Authentifizierung (OIDC) in TSM während der Einrichtung von Tableau Server oder mit Identitätspools konfiguriert wird. Gibt die Tableau Server-URL an, die vom Identitätsanbieter (IdP) verwendet wird, um Benutzer umzuleiten, die sich bei Tableau authentifizieren. Die externe Gateway-URL ist dieselbe URL, die Sie als Umleitungs-URL bei Ihrem IdP angegeben haben und die zum Abgleich verwendet wird.

Um beispielsweise den mit der OIDC-Authentifizierungskonfiguration verknüpften IdP an Ihren Tableau Server http://myco umzuleiten, führen Sie den folgenden Befehl aus:

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

gateway.http.cachecontrol.updated

Standardwert: false

Der Cache-Control HTTP-Header legt fest, ob der Client-Browser von Tableau Server gesendete Inhalte im Zwischenspeicher ablegen soll. Um die Zwischenspeicherung von Tableau Server-Daten auf dem Client zu deaktivieren, setzen Sie diese Option auf true.

gateway.http.hsts

Standardwert: false

Wenn aktiviert, zwingt der HTTP-Header "Strict Transport Security (HSTS)" Browser dazu, HTTPS für die Domäne zu verwenden.

gateway.http.hsts_options

Standardwert: "max-age=31536000"

Standardmäßig ist die HSTS-Richtlinie auf ein Jahr (31.536.000 Sekunden) festgelegt. Dieser Zeitraum legt die Zeit fest, in der der Browser über HTTPS auf den Server zugreift.

gateway.httpd.loglevel

Version: Hinzugefügt in 2021.3.0.

Standardwert: notice

Gibt die Protokollierungsebene für den Gateway (Apache-HTTPD-Server) an. Die Standardeinstellung ist notice. Andere Optionen umfassen debug, info, warning, error. Wenn Sie die Protokollierungsebene ändern, sollten Sie sich der möglichen Auswirkungen auf den Speicherplatzbedarf und die Leistung bewusst sein. Setzen Sie die Protokollierungsebene am besten wieder auf die Standardeinstellung zurück, nachdem Sie die benötigten Informationen gesammelt haben. Ausführliche Informationen zur Apache-Protokollierung finden Sie in der HTTP-Dokumentation von Apache(Link wird in neuem Fenster geöffnet).

gateway.httpd.shmcb.size

Version: Hinzugefügt in Version 2021.4

Standardwert: 2048000

Gibt die Speichergröße (in Byte) für den Ringpuffer an, wenn der Speichertyp shmcb verwendet wird. Bei Verwendung des Speichertyps dbm gilt dieser Konfigurationsschlüssel nicht.

gateway.httpd.socache

Version: Hinzugefügt in Version 2021.4

Standardwert: shmcb

Gibt den Speichertyp des globalen/prozessübergreifenden SSL-Sitzungscaches an. In der Standardeinstellung ist dieser auf shmcb festgelegt und kann optional alsdbm konfiguriert werden. Weitere Informationen zu den Speichertypen shmcb und dbm finden Sie unter SSLSessionCache Directive(Link wird in neuem Fenster geöffnet) auf der Apache-Website.

gateway.http.request_size_limit

Standardwert: 16380

Der maximale Umfang (in Byte) des Header-Inhalts, der bei HTTP-Anforderungen über das Apache-Gateway übergeben werden darf. Header, die den für diese Option festgelegten Wert überschreiten, führen zu Browserfehlern, wie beispielsweise HTTP-Fehler 413 (Request Entity Too Large – Anforderung zu groß), oder Authentifizierungsfehlern.

Ein niedriger Wert für gateway.http.request_size_limit kann zu Authentifizierungsfehlern führen. Single Sign-on-Lösungen, die in Active Directory integriert sind (SAML und Kerberos), erfordern oft umfangreiche Authentifizierungstoken in einem HTTP-Header. Sie sollten HTTP-Authentifizierungsszenarien unbedingt vor der Bereitstellung in der Produktionsumgebung testen.

Es wird empfohlen, für die Option tomcat.http.maxrequestsize den gleichen Wert einzustellen, den Sie für diese Option festlegen.

gateway.http.x_content_type_nosniff

Standardwert: true

Der HTTP-Antwortheader "X-Content-Type-Options" legt fest, dass der MIME-Typ im Header "Content-Type" vom Browser nicht geändert werden darf. In manchen Fällen, wenn kein MIME-Typ festgelegt ist, versucht ein Browser unter Umständen, den MIME-Typ durch Auswertung der Eigenschaften der Nutzlast zu bestimmen. Anschließend zeigt der Browser den Inhalt entsprechend an. Diesen Vorgang nennt man "Sniffing". Eine Fehlinterpretation des MIME-Typs kann zu Sicherheitslücken führen. Standardmäßig ist der HTTP-Header "X-Content-Type-Options" mit dieser Option auf "nosniff" festgelegt.

gateway.http.x_xss_protection

Standardwert: true

Der HTTP-Antwortheader "X-XSS-Protection" wird an den Browser gesendet, um Schutz vor Cross-Site Scripting (XSS) zu gewährleisten. Der Antwortheader "X-XSS-Protection" überschreibt Konfigurationen in Fällen, in denen Benutzer XSS-Schutz im Browser deaktiviert haben. Der Antwortheader "X-XSS-Protection" ist mit dieser Option standardmäßig aktiviert.

gateway.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollstufe für Gateway. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

gateway.public.host

Standardwert: <hostname>

Der Name (die URL) des Servers, der für den externen Zugriff auf Tableau Server verwendet wird. Wenn Tableau Server für die Verwendung eines Proxyservers oder eines externen Lastenausgleichsmoduls konfiguriert ist, müssen Sie diesen Namen in die Adressleiste eines Browsers eingeben, um Tableau Server zu erreichen. Wenn Tableau Server beispielsweise durch Eingabe von tableau.example.com erreicht wird, lautet der Name für gateway.public.host tableau.example.com.

gateway.public.port

Standardwert: 80 (443 bei SSL)

Gilt nur für Proxyserver-Umgebungen. Der externe Port, der vom Proxyserver überwacht wird.

gateway.slow_post_protection.enabled

Standardwert: true

Die Aktivierung dieser Einstellung kann als Schutz gegen langsame POST-Angriffe (Denial-of-Service) hilfreich sein, die zur Zeitüberschreitung von POST-Anfragen mit einer extrem langsamen Datenübertragung führen.

Hinweis: Dies beseitigt die Bedrohung durch derartige Angriffe allerdings nicht. Eine unerwünschte Nebenwirkung könnte sein, dass langsame Verbindungen getrennt werden.

gateway.slow_post_protection.request_read_timeout

Standardwert: header=10-30,MinRate=500 body=30,MinRate=500

Wenn diese Option durch die vorherige Option gateway.slow_post_protection.enabled aktiviert ist, legt sie die httpd-Funktion ReadRequestTimeout von Apache fest. Die httpd-Anweisung ist unter Apache-Modul mod_reqtimeout(Link wird in neuem Fenster geöffnet) dokumentiert. Die primäre Verwendung dieser Option ist die Verteidigung gegen Slowloris-Angriffe. Siehe Wikipedia-Eintrag Slowloris (Computersicherheit)(Link wird in neuem Fenster geöffnet).

Hinweis: Ältere Versionen verwenden einen Standardwert: header=15-20,MinRate=500 body=10,MinRate=500

gateway.timeout

Standardwert: 7200

Längste Zeitdauer in Sekunden, die das Gateway auf bestimmte Ereignisse wartet, bevor eine Anforderung fehlschlägt (7200 Sekunden = 2 Stunden).

gateway.trusted

Standardwert: IP-Adresse des Proxyserver-Computers

Gilt nur für Proxyserver-Umgebungen. Die IP-Adresse(n) oder der Hostname/die Hostnamen des Proxyservers.

gateway.trusted_hosts

Standardwert: Alternative Namen des Proxyservers

Gilt nur für Proxyserver-Umgebungen. Alternative Hostnamen für den Proxyserver.

hyper.file_partition_size_limit

Standardwert: 0

Wenn der Wert 0 festgelegt ist, ist die Größe unbegrenzt, und es wird der gesamte verfügbare Festplattenspeicherplatz verwendet.

Diese Option wird zum Festlegen des Festplattenspeicherplatz-Limits für eine Abfrage verwendet, für die ein Spoolvorgang auf dem Datenträger erfolgt. Wenn Ihre Festplattenspeicherplatz-Nutzung durch die Datei "spool.<id>.tmp" höher ist als für Ihre Umgebung nötig, werden für Abfragen Spoolvorgänge ausgeführt, und sie beanspruchen Festplattenspeicherplatz. Mithilfe dieser Option können Sie den Festplattenspeicherplatz beschränken, der von einer einzelnen Abfrage belegt werden kann. Die Datei "spool.<id>.tmp" befindet sich im temp-Ordner des Benutzerkontos, unter dem Tableau Server ausgeführt wird. Sie können diesen Wert in K(KB), M(MB), G(GB) oder T(TB) angeben. Beispielsweise können Sie für die Größenbeschränkung 100G angeben, wenn Sie die Festplattenspeicherplatz-Nutzung auf 100 GB begrenzen möchten.

Weitere Informationen zu Spoolvorgängen finden Sie im Abschnitt "Arbeitsspeicher- und CPU-Auslastung" unter Tableau Server-Daten-Engine.

hyper.global_file_partition_size_limit

Standardwert: 0

Wenn der Wert 0 festgelegt ist, ist die Größe unbegrenzt, und es wird der gesamte verfügbare Festplattenspeicherplatz verwendet.

Diese Option wird zum Festlegen des Festplattenspeicherplatz-Limits für alle Abfragen verwendet, für die ein Spoolvorgang auf dem Datenträger erfolgt. Wenn Ihre Festplattenspeicherplatz-Nutzung durch die Datei "spool.<id>.tmp" höher ist als für Ihre Umgebung nötig, werden für Abfragen Spoolvorgänge ausgeführt, und sie beanspruchen Festplattenspeicherplatz. Die Datei "spool.<id>.tmp" befindet sich im temp-Ordner des Benutzerkontos, unter dem Tableau Server ausgeführt wird. Mithilfe dieser Option können Sie den Gesamtwert des Festplattenspeicherplatzes begrenzen, der von sämtlichen Abfragen bei Spoolvorgängen auf dem Datenträger verwendet wird. Sie können diesen Wert in K(KB), M(MB), G(GB) oder T(TB) angeben. Beispielsweise können Sie für die Größenbeschränkung 100G angeben, wenn Sie die Festplattenspeicherplatz-Nutzung auf 100 GB begrenzen möchten. Tableau empfiehlt, bei der Feinabstimmung der Spooling-Limits mit dieser Konfiguration zu beginnen.

Weitere Informationen zu Spoolvorgängen finden Sie im Abschnitt "Arbeitsspeicher- und CPU-Auslastung" unter Tableau Server-Daten-Engine.

hyper.enable_accesspaths_symbolic_canonicalization

Standardwert: false

Auf Windows-Betriebssystemen benötigt Hyper zum Auflösen von Symlinks Zugriff auf das Verzeichnis, in dem die Extrakte gespeichert sind, sowie auf alle übergeordneten Verzeichnisse. Wenn dies nicht der Fall ist, wird im Hyper-Protokoll möglicherweise eine Fehlermeldung angezeigt, die wie folgt lautet: Kanonischer Pfad kann nicht abgerufen werden für //dirA/subdir/myextract.hyper ... Access is denied.

In solchen Fällen können Sie dies auf true setzen, damit die Daten-Engine (Hyper) nicht versucht, Symlinks aufzulösen, wenn sie kanonische Pfade verwendet.

Hinweis: Das Setzen des Wertes auf true bedeutet auch, dass Hyper nicht mehr garantieren kann, einen potentiellen Angreifer abzuwehren, der es schafft, einen Symlink zu platzieren, um die erlaubte Gruppe von Verzeichnissen zu umgehen, auf die Hyper den Zugriff erlaubt.

hyper.log_queries

Standardwert: true

Wenn Sie diese Einstellung auf "true" festlegen, werden Abfrageinformationen protokolliert.

Standardmäßig werden Abfrageinformationen protokolliert. Wenn sich jedoch herausstellt, dass die Protokolldateien für den verfügbaren Festplattenspeicherplatz zu groß sind, können Sie die Einstellung auf false festlegen, um das Protokollieren von Abfrageinformationen zu deaktivieren. Tableau empfiehlt, für diese Konfiguration die Einstellung true beizubehalten.

hyper.log_query_cpu

Standardwert: false

Mithilfe dieser Einstellung können Sie zusätzlich zur CPU-Auslastung protokollieren, wie lange die einzelnen Abfragen dauern.

hyper.log_timing

Standardwert: false

Diese Einstellung ist hilfreich, um weitere Informationen zu den Abfragen zu erhalten, beispielsweise zur Kompilierung und zu den Analysezeiten. Standardmäßig ist diese Einstellung deaktiviert. Sie können sie aktivieren, indem Sie den Wert auf true festlegen, um mehr Details zu Ihren Abfragen zu sammeln. Beachten Sie jedoch, dass dadurch die Größe Ihrer Daten-Engine-Protokolldateien (\logs\hyper) zunimmt.

hyper.log_troublesome_query_plans

Standardwert: true

Wenn diese Einstellung auf true festgelegt ist, werden Abfragepläne für Abfragen protokolliert, die als problematisch identifiziert werden. In diese Kategorie fallen Abfragen, die abgebrochen werden, deren Ausführung länger als 10 Sekunden dauert oder Abfragen, für die ein Spoolvorgang auf dem Datenträger erfolgt. Die Informationen in den Protokollen können für die Fehlerbehebung problematischer Abfragen hilfreich sein. Sie können die Einstellung in false ändern, wenn Ihnen die Größe der Protokolle Sorgen bereitet.

hyper.memory_limit

Standardwert: 80%

Steuert die maximale Speichermenge, die von Hyper verwendet wird. Geben Sie die Anzahl Bytes an. Fügen Sie den Buchstaben "k" oder "K" an den Wert an, um "Kilobyte" anzugeben. Fügen Sie "m" an, um Megabyte anzugeben, "g" um Gigabyte anzugeben, oder "t", um Terrabyte anzugeben. Beispiel: hyper.memory_limit="7g". Alternativ können Sie den Speichergrenzwert als Prozentsatz des gesamten verfügbaren Systemspeichers angeben. Beispiel: hyper.memory_limit="90%".

hyper.memtracker_hard_reclaim_threshold

Standardwert: 80%

Diese Einstellung gilt nur für Windows. Hyper hält dekomprimierte und entschlüsselte Teile des Extrakts im Speicher, um nachfolgende Zugriffe zu beschleunigen. Diese Einstellung legt fest, wann Arbeitsthreads damit beginnen, diese Daten in einen Datenträger-Cache zu schreiben, um den Speicherdruck zu verringern. Ist der Wert als Prozentsatz angegeben, wird er als Prozentsatz der hyper.memory_limit-Gesamteinstellung interpretiert. Beispiel: hyper.memtracker_hard_reclaim_threshold="60%". Absolute Werte können als "k" (Kilobyte), "m" (Megabyte), "g" (Gigabyte) oder "t" (Terabytes) angegeben werden. Beispiel: hyper.memtracker_hard_reclaim_threshold="10g". Der Wert sollte größer als der hyper.memtracker_soft_reclaim-Schwellenwert sein.

hyper.memtracker_soft_reclaim_threshold

Standardwert: 50%

Diese Einstellung gilt nur für Windows. Beim Interagieren mit einer Hyper-Datei schreibt Hyper einige Daten zum Zwischenspeichern oder Beibehalten der Daten aus. Windows hat das besondere Verhalten, dass frisch in den Speicher geschriebene Daten gesperrt werden. Um einen Austausch zu vermeiden, zwingen wir die Daten heraus, wenn Hyper den konfigurierten Grenzwert für den Rückgewinnungsschwellenwert erreicht. Wenn der Schwellenwert für die weiche Rückgewinnung erreicht ist, versucht Hyper, zwischengespeicherte Daten im Hintergrund freizugeben, um zu versuchen, unter dem Rückgewinnungsschwellenwert zu bleiben. In Situationen, in denen das Tauschen anderweitig stattfinden würde, kann das Auslösen der Freigabe in Hyper zu einem besseren Ergebnis führen. Wenn bei Ihrer Tableau Server-Installation viele Austausche auftreten, kann diese Einstellung daher verwendet werden, um zu versuchen, den Speicherdruck zu verringern.

Geben Sie die Anzahl Bytes an. Fügen Sie den Buchstaben "k" oder "K" an den Wert an, um "Kilobyte" anzugeben. Fügen Sie "m" an, um Megabyte anzugeben, "g" um Gigabyte anzugeben, oder "t", um Terrabyte anzugeben. Geben Sie alternativ den Wert als Prozentsatz des konfigurierten Gesamtspeichers für Hyper an. Beispiel: hyper.memtracker_soft_reclaim_threshold="20%".

hyper.network_threads

Standardwert: 150%

Steuert die Anzahl der von Hyper verwendeten Netzwerkthreads. Geben Sie entweder die Anzahl der Netzwerkthreads (z. B. hyper.network_threads=4) oder den Prozentsatz der Threads in Bezug auf die Anzahl logischer Kerne an (z. B. hyper.network_threads="300%").

Netzwerkthreads werden zum Akzeptieren neuer Verbindungen und zum Senden oder Empfangen von Daten und Abfragen verwendet. Hyper verwendet asynchrone Netzwerke, sodass viele Verbindungen von einem einzelnen Thread bedient werden können. Normalerweise ist der Arbeitsaufwand in Netzwerkthreads sehr gering. Die einzige Ausnahme ist das Öffnen von Datenbanken auf langsamen Dateisystemen, was lange dauern und den Netzwerkthread blockieren kann. Wenn die Verbindungszeiten langsam sind, während Sie versuchen, Dashboards anzuzeigen oder zu bearbeiten, die Extrakte verwenden und seit einiger Zeit nicht mehr verwendet wurden, und im Hyper-Protokoll häufig Meldungen vom Typ "asio-continuation-slow" und lange "Construct-Protocol"-Zeiten für Hyper im Tableau-Protokoll angezeigt werden, versuchen Sie, diesen Wert zu erhöhen.

hyper.objectstore_validate_checksums

Standardwert: false

Eine boolesche Einstellung, die Dateiintegritätsprüfungen in Hyper steuert. Wenn sie auf true festgelegt ist, überprüft Hyper die Daten in einer Extraktdatei, wenn auf sie zum ersten Mal zugegriffen wird. Dadurch können stille Korruption und Korruption, die Hyper zum Absturz bringen würde, erkannt werden. Im Allgemeinen ist es ratsam, diese Einstellung zu aktivieren. Eine Ausnahme sind Installationen mit sehr langsamen Datenträgern, bei denen es zu Leistungsregressionen kommen könnte.

hyper.query_total_time_limit

Standardwert: 0 (d. h. unbegrenzt)

Legt eine Obergrenze für die gesamte Threadzeit fest, die von einzelnen Abfragen in Hyper verwendet werden kann. Fügen Sie "s" an den Wert an, um Sekunden anzugeben. Fügen Sie "min" an, um Minuten anzuzeigen oder "h", um Stunden anzugeben.

Um zum Beispiel alle Abfragen auf eine Gesamtzeit von 1.500 Sekunden der gesamten Thread-Zeit zu beschränken, führen Sie den folgenden Befehl aus:

tsm configuration set -k hyper.query_total_time_limit -v 1500s

Wenn eine Abfrage länger als das angegebene Limit dauert, schlägt die Abfrage fehl und es wird ein Fehler zurückgegeben. Mit dieser Einstellung können Sie automatisch Rückrufabfragen steuern, die andernfalls zu viele Ressourcen verwenden würden.

Hyper führt Abfragen parallel aus. Wenn eine Abfrage beispielsweise 100 Sekunden lang und währenddessen für 30 Threads ausgeführt wird, beträgt die Thread-Gesamtzeit 3.000 Sekunden. Die Thread-Zeit der einzelnen Abfragen wird im Hyper-Protokoll unter den Protokolleinträgen vom Typ "query-end" im Feld "total-time" angegeben.

hyper.session_memory_limit

Standardwert: 0 (d. h. unbegrenzt)

Steuert den maximalen Speicherkonsum einer einzelnen Abfrage. Geben Sie die Anzahl Bytes an. Fügen Sie den Buchstaben "k" oder "K" an den Wert an, um "Kilobyte" anzugeben. Fügen Sie "m" an, um Megabyte anzugeben, "g" um Gigabyte anzugeben, oder "t", um Terrabyte anzugeben.

Um zum Beispiel das Arbeitsspeicherlimit auf 900 Megabyte zu setzen, führen Sie den folgenden Befehl aus:

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

Alternativ können Sie das Sitzungsarbeitsspeicherlimit als Prozentsatz des gesamten verfügbaren Systemarbeitsspeichers angeben, indem Sie den folgenden Befehl ausführen:

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

Das Senken dieses Werts kann hilfreich sein, wenn eine Abfrage übermäßig viel Arbeitsspeicher verwendet und andere Abfragen über einen langen Zeitraum fehlschlagen. Durch das Verringern des Grenzwerts schlägt die einzelne große Abfrage fehl (oder greift auf Spooling zurück, wenn das Spooling nicht deaktiviert ist) und sie hat keine negativen Auswirkungen auf andere Abfragen.

hyper.srm_cpu_limit_percentage

Standardwert (in Prozent): 75

Gibt die maximale stündliche durchschnittliche CPU-Auslastung an, die von Hyper zugelassen wird. Wird dieser Wert überschritten, startet die Daten-Engine sich selbst neu, um die Auswirkungen auf andere Prozesse auf dem Computer zu minimieren.

In der Standardeinstellung erfolgt der Neustart der Daten-Engine, wenn diese im Verlauf einer Stunde durchschnittlich mehr als 75 % der CPU auslastet. Dieser Wert sollte nicht geändert werden, außer wenn Sie mit dem Tableau-Support arbeiten oder wenn Sie die Daten-Engine auf einem dedizierten Serverknoten ausführen. Wird die Daten-Engine auf einem dedizierten Knoten ausgeführt, können Sie diesen Wert problemlos auf 95 Prozent erhöhen, um die verfügbare Computerhardware voll auszunutzen. Einzelheiten über das Ausführen der Daten-Engine auf einem dedizierten Knoten finden Sie unter Optimieren für extraktabfragelastige Umgebungen.

So wird dieser Wert auf 95 % erhöht:

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

tsm pending-changes apply

So wird dieser Wert wieder auf die Standardeinstellung von 75 % zurückgesetzt:

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

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

Standardwert: true

Verbessert die Chance, dass der Extrakt für eine Abfrage bereits zwischengespeichert ist. Wenn der Knotenpunkt mit dem zwischengespeicherten Extrakt keine zusätzliche Last unterstützen kann, werden Sie an einen neuen Knotenpunkt weitergeleitet, und der Extrakt wird auf dem neuen Knotenpunkt in den Cache geladen. Dies führt zu einer besseren Systemauslastung, da Extrakte nur dann in den Arbeitsspeicher geladen werden, wenn eine Auslastung besteht, die den Bedarf rechtfertigt.

hyper_standalone.health.enabled

Standardwert: true

Schaltet basierend auf einer Zustandsbewertung, die auf einer Kombination der aktuellen Hyper-Aktivität und der Nutzung der Systemressourcen besteht, die Lastausgleichsmetrik von Zufallsauswahl auf Auswahl des Daten-Engine-Knotenpunkts (Hyper) um. Basierend auf diesen Werten wählt der Lastenausgleich den Knotenpunkt aus, der am besten in der Lage ist, eine Extraktabfrage zu verarbeiten.

hyper.temp_disk_space_limit

Standardwert: 100%

Legt die Obergrenze des Speicherplatzes fest, bei der Hyper die Zuweisung von Speicherplatz für temporäre Dateien beendet. Diese Einstellung kann dazu beitragen, dass die Festplatte nicht mehr mit temporären Dateien von Hyper gefüllt wird, und verhindern, dass nicht mehr genügend Speicherplatz zur Verfügung steht. Wenn der Speicherplatz diesen Schwellenwert erreicht, versucht Hyper eine automatische Wiederherstellung ohne Administratoreingriff.

Geben Sie ihn als Prozentsatz des gesamten verfügbaren Speicherplatzes an, der verwendet werden soll. Beispiel: hyper.temp_disk_space_limit="96%". Bei einer Festlegung auf 100 % kann der gesamte verfügbare Speicherplatz verwendet werden.

Damit Daten-Engine gestartet werden kann, muss der konfigurierte Speicherplatz verfügbar sein. Wenn nicht genügend Speicherplatz verfügbar ist, wird ein Protokolleintrag bezüglich der Daten-Engine angezeigt, der Folgendes besagt: "Disk limit for temporary files has been reached. Please free up disk space on the device." (Das Limit für temporäre Dateien auf dem Datenträger wurde erreicht. Geben Sie Speicherplatz auf dem Gerät frei.) Weitere Informationen finden Sie im Hyper-Protokoll unter: "No space left on device" (Kein Speicherplatz auf dem Gerät mehr frei).

hyper.hard_concurrent_query_thread_limit

Standardwert: 150 %

Verwenden Sie diese Option, um die maximale Anzahl Threads festzulegen, die Hyper für die Ausführung von Abfragen verwenden sollte. Verwenden Sie diese Option, wenn Sie eine harte Grenze für die CPU-Auslastung festlegen möchten. Geben Sie entweder die Anzahl Threads oder den Prozentsatz der Threads in Bezug auf die Anzahl logischer Kerne an. Hyper wird höchstwahrscheinlich nicht mehr Ressourcen verwenden, als durch diese Einstellung konfiguriert sind. Hyper-Hintergrund- und -Netzwerkthreads sind von dieser Einstellung jedoch nicht betroffen (obwohl sie in der Regel nicht CPU-intensiv sind).

Beachten Sie, dass diese Einstellung die Anzahl der gleichzeitigen Abfragen steuert, die ausgeführt werden können. Wenn Sie also diese Einstellung verringern, steigt die Gefahr, dass Abfragen warten müssen, bis momentan ausgeführte Abfragen abgeschlossen werden. Dies kann sich auf die Ladezeiten für Arbeitsmappen auswirken.

hyper.soft_concurrent_query_thread_limit

Standardwert: 100 %

Verwenden Sie diese Option, um die Anzahl Threads anzugeben, für die eine einzelne Abfrage parallelisiert werden kann, wenn aufgrund der Einstellung hard_concurrent_query_thread_limit ausreichend viele Threads verfügbar sind. Geben Sie entweder die Anzahl Threads oder den Prozentsatz der Threads in Bezug auf die Anzahl logischer Kerne an.

Hier ein vereinfachtes Beispiel:

Angenommen, Sie legen diesen Wert auf 10 Threads fest. Dies bedeutet, dass Abfragen bis zu 10 Threads parallelisiert werden können. Wenn nur 2 Abfragen ausgeführt werden, werden die verbleibenden 8 Threads zum Parallelisieren der 2 Abfragen verwendet.

Die Optionen hyper. Hard_concurrent_query_thread_limit und hyper.soft_concurrent_query_thread_limit arbeiten zusammen, um Ihnen einige Optionen zum Verwalten der CPU-Auslastung zu bieten und gleichzeitig die verfügbaren CPU-Ressourcen zu maximieren, um Abfragen schneller abzuschließen. Wenn die Daten-Engine nicht alle verfügbaren CPUs auf dem Computer verwenden soll, ändern Sie sie in weniger als 100 % in einen Prozentsatz, der für Ihre Umgebung optimal ist. Die weiche Grenze ist eine Möglichkeit, die CPU-Auslastung zu beschränken, sie kann jedoch über die weiche Grenze hinausgehen, bis hin zur harten Grenze und darüber hinaus.

Hinweis: Die Optionen hyper.hard_concurrent_query_thread_limit und hyper.soft_concurrent_query_thread_limit ersetzen die Optionen hyper.num_job_worker_threads und hyper.num_task_worker_threads, die in den Tableau Server-Versionen 2018.3 und früher verfügbar waren, und sind jetzt eingestellt und nicht mehr verfügbar. Informationen zu den Threads hyper.num_job_worker_threads und hyper.num_task_worker_threads finden Sie unter tsm-Konfigurationssatz-Optionen.(Link wird in neuem Fenster geöffnet)

hyper.use_spooling_fallback

Standardwert: true

Wenn die Einstellung auf true festgelegt ist und beim Abfragen von Extrakten die festgelegte RAM-Auslastung überschritten wird (80 % des installierten Arbeitsspeichers), sind Spoolvorgänge auf dem Datenträger zulässig. Mit anderen Worten ermöglicht sie Hyper, eine Abfrage mit dem Datenträger auszuführen, wenn er die RAM-Nutzung überschreitet.

Tableau empfiehlt, die Standardeinstellung zu verwenden. Sie können sie deaktivieren, indem Sie den Wert auf false festlegen, wenn Ihnen die Datenträgerauslastung Sorgen bereitet. Wenn Sie diese Einstellung deaktivieren, werden Abfragen, für die mehr als 80 % des installierten Arbeitsspeichers verwendet werden, abgebrochen. Spoolingabfragen dauern in der Regel wesentlich länger.

Weitere Informationen zu Spoolvorgängen finden Sie im Abschnitt "Arbeitsspeicher- und CPU-Auslastung" unter Tableau Server-Daten-Engine.

indexandsearchserver.vmopts

Version: Hinzugefügt in Version 2022.1.

Standardwert: "-Xmx<default_value> -Xms<default_value>"

Der Standardwert basiert auf der Größe des Systemspeichers und beträgt 3,125 % des gesamten System-RAMs.

Steuert die Heap-Größe für den Indizierungs- und Suchserver. Da der Standardwert automatisch skaliert wird, können Sie mithilfe dieser Option den Standardwert nur dann überschreiben, wenn dies unbedingt erforderlich ist. Fügen Sie an den Wert den Buchstaben 'k' an, um "Kilobyte" anzugeben, "m", um Megabyte anzugeben, oder "g", um Gigabyte anzugeben. Setzen Sie als allgemeine Regel die anfängliche Heap-Größe (-Xms) gleich mit der maximalen Heap-Größe (-Xmx), um die Sammlung von unbrauchbaren Dateien zu minimieren.