Options tsm configuration set

Voici une liste d’options ou de clés de configuration que vous pouvez définir avec la commande tsm configuration set. Dans de nombreux cas, vous pouvez connaître la valeur actuelle d’une clé de configuration avec la commande tsm configuration get.

Cette liste n’a pas vocation à être une liste exhaustive des paramètres de configuration de Tableau Server. Elle représente un sous-ensemble des clés de configuration qui peuvent être définies par les administrateurs de serveur. Enfin, certaines clés utilisées en interne par Tableau Server n’apparaissent pas dans cette liste.

Remarque : vous devez respecter la casse des clés de configuration.

Utilisation de l’interface en ligne de commande tsm

Vous pouvez exécuter des commandes tsm sur le nœud initial (le nœud où TSM est installé), ou sur tout autre nœud du cluster.

Pour exécuter des commandes tsm, vous devez ouvrir l’invite de commande Windows. N’utilisez pas PowerShell pour exécuter les commandes tsm. L’utilisation de PowerShell peut provoquer un comportement inattendu.

Ouvrez l’invite de commande Windows avec un compte membre du groupe Administrateurs sur un nœud du cluster.
Exécutez la commande souhaitée. Si vous exécutez la commande à partir d’un nœud autre que le nœud initial, incluez l’option -s permettant de spécifier l’URL du nœud initial par son nom (pas son adresse IP), et incluez le port TSM, 8850.
Pour voir la version de TSM et de Tableau Server à partir du nœud initial :
tsm version
Pour voir la version de TSM et de Tableau Server à partir d’un nœud supplémentaire :
tsm version -s https://<inital_node_name>:8850
Par exemple :
tsm version -s https://myTableauHost:8850

Utilisation de base des clés tsm configuration

Définition d’une clé de configuration

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

Dans certains cas, vous devez inclure l’option --force-keys pour définir la valeur de configuration d’une clé qui n’a pas été définie auparavant. Pour plus d’informations, consultez Réponses « clé inconnue ».

Après avoir configuré une valeur de clé de configuration, vous devez appliquer les modifications de configuration en attente à l’aide de tsm pending-changes apply. Jusqu’à ce que vous fassiez cette opération, la nouvelle valeur ne sera pas utilisée par Tableau ou ne s’affichera pas dans les résultats de la commande tsm configuration get. Vous pouvez afficher les modifications en attente à l’aide de tsm pending-changes list. Pour plus d’informations, consultez tsm pending-changes.

Réinitialisation d’une clé de configuration aux valeurs par défaut

Pour réinitialiser une clé de configuration à sa valeur par défaut, utilisez l’option -d :

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

Affichage de la valeur actuelle d’une clé de configuration

Pour connaître le paramétrage actuel d’une clé de configuration, utilisez la commande configuration get :

tsm configuration get -k <config.key>

Il existe deux cas particuliers qui ne renvoient pas de valeur actuelle utile pour une clé :

Dans certains cas, vous ne pouvez pas obtenir une valeur de configuration pour une clé qui n’a pas été définie explicitement. Au lieu de cela, la commande tsm configuration get retournera une réponse « Clé inconnue ». Pour plus d’informations, consultez Réponses « clé inconnue ».
Pour certaines clés comportant des valeurs par défaut prédéfinies, la commande tsm configuration get renverra une réponse « Null ». Pour plus d’informations, consultez Valeurs « Null » retournées.

Clés de configuration

adminviews.disabled

Valeur par défaut : false

Désactive l’accès aux vues administratives de Tableau. Par défaut, l’accès aux vues est activé (cette option est définie sur « false »).

api.server.enabled

Version : obsolète dans la version 2023.1. Vous ne pouvez pas désactiver l’API REST dans la version 2023.1 et versions ultérieures.

Valeur par défaut : true

Autorise l’accès à l’API REST de Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).

Par défaut, cette fonctionnalité est activée. Nous vous recommandons vivement de conserver ce paramètre. La désactivation de l’API REST perturbera le fonctionnement d’un large éventail de fonctionnalités de Tableau. Cela n’améliorera ni les performances ni la sécurité. Si vous choisissez de désactiver l’API REST sur votre installation Tableau Server, testez soigneusement la fonctionnalité dont vous avez besoin.

Les fonctionnalités impactées par la désactivation de l’API REST incluent :

Recherche
Favoris
Collections
Content Management Tool (CMT)
Resource Monitoring Tool (RMT)
Espaces personnels

auditing.enabled

Valeur par défaut : true

Autorise l’accès aux tables d’audit de l’historique de PostgreSQL (la propre base de données de Tableau Server).

backgrounder.default_run_now_priority

Valeur par défaut (entier) : 0

Ce paramètre contrôle la priorité attribuée à l’exécution immédiate des travaux, 0 étant la priorité la plus élevée. Les valeurs spécifiées doivent être comprises entre 0 et 100.

backgrounder.enable_parallel_adsync

Version : ajouté dans la version 2018.3.6

Valeur par défaut : false

Contrôle si le traitement parallèle des travaux de synchronisation de groupes de répertoires externes est autorisé lorsqu’il existe plusieurs backgrounders. Par défaut, une synchronisation planifiée des groupes de répertoires externes est gérée en série par un seul backgrounder. Définissez cette option sur true pour activer le traitement parallèle sur plusieurs instances de backgrounder.

backgrounder.externalquerycachewarmup.enabled

Version : obsolète dans la version 2023.1. Pour améliorer les temps de chargement des vues pour les classeurs, pensez plutôt à autoriser l’Accélération des vues sur votre site.

Valeur par défaut : false

Contrôle la mise en cache des résultats des requêtes de classeur après des tâches d’actualisation d’extraits programmées.

backgrounder.externalquerycachewarmup.view_threshold

Version : obsolète dans la version 2023.1. Pour améliorer les temps de chargement des vues pour les classeurs, pensez plutôt à autoriser l’Accélération des vues sur votre site.

Valeur par défaut : 2.0

Le seuil de mise en cache des résultats des requêtes de classeur après des tâches d’actualisation d’extraits programmées. Le seuil est égal au nombre de vues qu’un classeur a reçues au cours des sept derniers jours divisées par le nombre d’actualisations programmées dans les sept jours suivants.

Les deux options de commande backgrounder suivantes déterminent la durée d’exécution d’une tâche de flux avant l’annulation de la tâche d’arrière-plan de flux. Ces deux commandes déterminent ensemble la valeur totale du délai d’expiration pour les tâches de flux.

backgrounder.extra_timeout_in_seconds

Valeur par défaut : 1800

Le nombre de secondes excédant le paramètre dans backgrounder.querylimit avant qu’une tâche d’arrière-plan soit annulée. Ce paramètre garantit qu’un travail bloqué ne retarde pas les travaux suivants. Le paramètre s’applique aux processus énumérés dans backgrounder.timeout_tasks. 1800 secondes = 30 minutes.

backgrounder.default_timeout.run_flow

Valeur par défaut : 14400

Le nombre de secondes avant qu’une tâche d’exécution de flux soit annulée. 14 400 secondes = 4 heures.

backgrounder.failure_threshold_for_run_prevention

Valeur par défaut : 5

Nombre d’échecs consécutifs d’une tâche d’exécution d’abonnement, d’extrait ou de flux avant que cette tâche soit suspendue. Suspendre systématiquement les tâches en échec permet de garder des ressources de backgrounder pour les autres tâches. Pour désactiver la suspension des tâches d’arrière-plan qui échouent, définissez cette valeur sur -1.

backgrounder.log.level

Version : ajouté dans la version 2020.3.0.

Valeur par défaut : info

Niveau d’enregistrement pour le processus Backgrounder. Ce paramètre peut être configuré de manière dynamique, donc si n’effectuez pas d’autres modifications, vous n’avez pas à redémarrer Tableau Server. Pour plus d’informations, consultez Modifier les niveaux d’enregistrement.

backgrounder.querylimit

Valeur par défaut : 7200

La durée autorisée la plus longue, en secondes, pour terminer un seul travail d’actualisation d’extrait. 7200 secondes = 2 heures.

Remarque : s’il atteint sa limite de temps, un travail peut continuer à s’exécuter quelques minutes durant son annulation.

backgrounder.restrict_serial_collections_to_site_level

Valeur par défaut : false

Dans Tableau Server, les utilisateurs peuvent programmer l’exécution périodique d’actualisations d’extraits, d’abonnements ou de flux. Ces éléments programmés sont appelés des tâches. Le processus Backgrounder lance des instances uniques de ces tâches pour les exécuter à l’heure prévue. Les instances uniques des tâches qui sont initiées en conséquence sont appelées des travaux.

Ce paramètre affecte les planifications configurées pour s’exécuter en série. Par défaut, lorsqu’une planification est configurée pour s’exécuter en série, tous les travaux utilisant cette planification s’exécuteront en série. Lorsque ce paramètre est défini sur true, les travaux exécutés sur différents sites peuvent s’exécuter en parallèle. Les travaux pour les tâches planifiées sur le même site continueront de s’exécuter en série.

L’exemple ci-dessous illustre ce scénario :

Tableau Server inclut une programmation appelée « Quotidien » pour exécuter les travaux tous les jours à 7h00. La planification quotidienne est configurée pour s’exécuter en série. Le site « RH » et le site « Paie » ont chacun plusieurs tâches planifiées qui utilisent la programmation « Quotidien ». Lorsque ce paramètre est défini true, les travaux correspondant à ces tâches programmées sur le site « RH » peuvent s’exécuter en parallèle avec les travaux sur le site « Paie », tandis que les travaux sur le même site ne s’exécuteront toujours qu’en série.

backgrounder.notifications_enabled

Valeur par défaut : true

Contrôle si les alertes d’actualisation d’extrait et d’exécution de flux sont activées pour tous les sites du serveur. Par défaut, toutes les alertes sont activées. Pour désactiver les alertes pour tous les sites sur un serveur, définissez sur false.

Les alertes d’extraction peuvent être activées ou désactivées pour chaque site par les administrateurs de site dans les paramètres du site, ou au niveau utilisateur dans les paramètres utilisateur.

backgrounder.sort_jobs_by_type_schedule_boundary_heuristics_milliSeconds

Valeur par défaut : 60000

Contrôle la fenêtre temporelle qui identifie les tâches backgrounder programmées pour démarrer à la même heure.

Le processus backgrounder organise le travail programmé en même temps pour une exécution par type de tâche, lançant l’exécution de la catégorie des tâches les plus rapides d’abord : abonnements, puis extraits par incréments, puis extraits complets.

Les tâches sont regroupées en lots afin de déterminer lesquelles sont programmées « en même temps ». Une valeur de 60 000 millisecondes (par défaut) indique que les tâches programmées pour commencer dans une fenêtre de 1 minute doivent être classées dans le même lot et sont donc organisées par type dans ce même lot.

backgrounder.subscription_failure_threshold_for_run_prevention

Valeur par défaut : 5

Détermine le nombre d’échecs d’abonnement consécutifs qui doivent se produire avant la suspension de l’alerte pour une condition. Lorsque ce paramètre est défini sur la valeur par défaut de 5, l’alerte est suspendue après 5 échecs d’abonnement consécutifs. Une valeur de -1 permettra à l’e-mail de notification de continuer indéfiniment. Ce seuil s’applique à l’échelle du serveur, et s’applique à tous les abonnements définis sur le serveur.

backgrounder.subscription_image_caching

Valeur par défaut : true

Contrôle si le backgrounder met en cache les images générées pour les abonnements. Pour que la mise en cache améliore les performances d’abonnement, les images mises en cache n’ont pas à être générées de nouveau à chaque fois. Par défaut, la mise en cache des images est activée. Pour désactiver la mise en cache des images pour tous les sites sur un serveur, sélectionnez false.

backgrounder.timeout_tasks

Valeur par défaut : la valeur par défaut peut être différente selon votre version de Tableau Server. Pour voir la liste des valeurs par défaut pour votre version de Tableau, exécutez la commande tsm configuration get :

tsm configuration get -k backgrounder.timeout_tasks

La liste des tâches pouvant être annulées si elles s’exécutent plus longtemps que les valeurs combinées dans backgrounder.querylimit et backgrounder.extra_timeout_in_seconds. La liste des tâches est délimitée par des virgules. La liste par défaut représente toutes les valeurs possibles pour ce paramètre.

backgrounder.timeout.single_subscription_notify

Version : ajouté dans la version 2021.2.

Valeur par défaut : 1800 secondes (30 minutes)

Il s’agit de la durée maximale autorisée, en secondes, pour l’exécution d’un seul travail d’abonnement.

backgrounder.timeout.sync_ad_group

Version : ajouté dans les versions 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1.

Valeur par défaut : 14400 secondes (4 heures)

Il s’agit de la durée maximale autorisée, en secondes, pour l’exécution d’une synchronisation de groupe Active Directory. Ce paramètre s’applique aux synchronisations de groupe programmées effectuées par le service backgrounder et empêche les synchronisations de longue durée de s’exécuter indéfiniment. Il n’a aucune incidence sur les synchronisations de groupe effectuées à l’aide de l’interface utilisateur de Tableau Server ou de l’API REST.

backgrounder.vInstances_max_overflow_queue_size

Version : ajouté dans la version 20221.2.

Valeur par défaut : 1000

Nombre maximal de travaux pouvant se trouver dans la file d’attente secondaire. Une file d’attente secondaire est créée lorsque le nombre de travaux en cours d’exécution atteint la limite de simultanéité définie. Le maximum par défaut est défini sur 1000 travaux, ce qui signifie que s’il y a plus de 1000 travaux lorsque la limite de simultanéité est atteinte, tout ce qui dépasse 1000 travaux ne sera pas mis en file d’attente. Utilisez la commande tsm backgrounder.vInstance_max_overflow_queue_size pour apporter des modifications à la taille maximale de la file d’attente de débordement.

Les valeurs doivent être spécifiées en nombres entiers.

backup.zstd.thread_count

Version : ajouté dans la version 2021.1.0. Cette clé est configurable de manière dynamique. Pour plus d’informations, consultez Modifications de topologie dynamique Tableau Server

Valeur par défaut : 2

Nombre de threads qui doivent être utilisés lors de la création d’une sauvegarde.

L’augmentation de ce nombre peut améliorer les performances de sauvegarde, mais nous recommandons que le nombre de threads ne dépasse pas le nombre de processeurs logiques sur l’ordinateur Tableau Server, jusqu’à quatre.

basefilepath.backuprestore

Valeur par défaut : C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

L’emplacement dans lequel la commande tsm maintenance backup crée la sauvegarde. C’est également l’emplacement où le fichier de sauvegarde doit être restauré à l’aide de la commande tsm maintenance restore ou de la commande tsm maintenance send-logs. Après avoir défini ce paramètre, vous devez exécuter la tsm maintenance validate-backup-basefilepath (disponible à partir de la version 2022.1) pour vérifier que les autorisations sont correctement définies pour l’emplacement. Pour plus d’informations, consultez Chemins d’accès des fichiers tsm.

basefilepath.log_archive

Valeur par défaut : C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

L’emplacement dans lequel la commande tsm maintenance ziplogs crée l’archive compressée. Pour plus d’informations, consultez Chemins d’accès des fichiers tsm.

basefilepath.site_export.exports

Valeur par défaut : C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports\

L’emplacement dans lequel la commande tsm sites export crée le fichier d’exportation. Pour plus d’informations, consultez Chemins d’accès des fichiers tsm.

basefilepath.site_import.exports

Valeur par défaut : C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\

L’emplacement où la commande tsm sites import s’attend à ce que le fichier d’importation soit localisé. Pour plus d’informations, consultez Chemins d’accès des fichiers tsm.

clustercontroller.log.level

Version : ajouté dans la version 2020.3.0.

Valeur par défaut : info

Niveau d’enregistrement pour le contrôleur de cluster. Ce paramètre peut être configuré de manière dynamique, donc si n’effectuez pas d’autres modifications, vous n’avez pas à redémarrer Tableau Server. Pour plus d’informations, consultez Modifier les niveaux d’enregistrement.

clustercontroller.zk_session_timeout_ms

Valeur par défaut : 300000

La durée, en millisecondes, pendant laquelle le contrôleur de cluster attend le service de coordination (ZooKeeper), avant de déterminer qu’un basculement est nécessaire.

dataAlerts.checkIntervalInMinutes

Valeur par défaut : 60

La fréquence, en minutes, selon laquelle Tableau Server vérifie pour déterminer si les conditions liées aux alertes de données sont vraies.

(Le serveur vérifie également dès que les extraits liés à des alertes de données sont actualisés.)

dataAlerts.retryFailedAlertsAfterCheckInterval

Valeur par défaut : true

Détermine la fréquence selon laquelle Tableau Server revérifie les alertes d’échec des données. Si l’option est définie sur true, le serveur revérifie les alertes d’échec à la fréquence définie par dataAlerts.checkIntervalInMinutes. Si l’option est définie sur false, le serveur revérifie les alertes d’échec toutes les cinq minutes, en notifiant plus rapidement les destinataires d’alerte si les conditions de données ont changé, mais en diminuant les performances du serveur.

(Le serveur vérifie également dès que les extraits liés à des alertes de données sont actualisés.)

dataAlerts.SuspendFailureThreshold

Valeur par défaut : 350

Détermine le nombre d’échecs consécutifs d’alertes basées sur les données avant la suspension de l’alerte pour une condition. Lorsque ce paramètre est défini sur la valeur par défaut de 350, l’alerte est suspendue après deux semaines d’alertes environ. Ce seuil est défini à l’échelle du serveur et s’applique donc à toutes les alertes définies sur le serveur.

databaseservice.max_database_deletes_per_run

Version : ajouté dans la version 2021.2.

Valeur par défaut : null

Utilisez cette option pour ajuster le nombre maximum de ressources externes intégrées (bases de données et tables) qui peuvent être supprimées à chaque exécution du processus du backgrounder, contrôlé par features.DeleteOrphanedEmbeddedDatabaseAsset. Si cette option est laissée vide, le nombre maximal par défaut de ressources externes intégrées pouvant être supprimées est de 100.

Pour plus d’informations, consultez features.DeleteOrphanedEmbeddedDatabaseAsset.

dataserver.log.level

Version : ajouté dans la version 2020.3.0.

Valeur par défaut : info

Niveau d’enregistrement pour le serveur de données. Ce paramètre peut être configuré de manière dynamique, donc si n’effectuez pas d’autres modifications, vous n’avez pas à redémarrer Tableau Server. Pour plus d’informations, consultez Modifier les niveaux d’enregistrement.

dataserver_<n>.port

Port sur lequel s’exécute l’instance du serveur de données (spécifié par « <n> »).

elasticserver.vmopts

Version : ajouté dans la version 2019.1. Supprimé dans la version 2022.1

Cette option de configuration n’est pas valide pour les versions 2022.1 et ultérieures de Tableau Server. Pour les versions 2022.1 et ultérieures de Tableau Server, utilisez l’option de configuration indexandsearchserver.vmopts

Valeur par défaut : -Xmx<default_value> -Xms<default_value>

La valeur par défaut varie en fonction de la quantité de mémoire système. La taille maximum du tas JVM est réduite à 3,125 % de la RAM totale du système.

Contrôle la taille du segment de mémoire du serveur flexible. Étant donné que la valeur par défaut s’ajuste automatiquement, utilisez cette option pour remplacer la valeur par défaut uniquement lorsque cela est absolument nécessaire. Ajoutez la lettre « k » à la valeur pour indiquer des kilo-octets, « m » pour indiquer des mégaoctets, et « g » pour indiquer des gigaoctets. En règle générale, définissez une taille du segment de mémoire initial (-Xms) égale à la taille de segment de mémoire maximal (-Xmx) afin de minimiser les nettoyages de mémoire.

excel.shadow_copy_all_remote.enabled

Version : ajouté dans les versions 2019.1.5, 2019.2.1.

Valeur par défaut : false

Contrôle si Tableau Server crée une « copie cachée » d’une feuille de calcul Excel partagée (.xlxs ou .xlxm) qui est utilisée comme source de données en direct. Lorsqu’elle est activée, cette option empêche les utilisateurs Excel de voir une « Erreur de violation de partage » et un message indiquant que le fichier est « en cours d’utilisation ». Cette option peut avoir un impact sur les performances en cas de fichiers Excel volumineux. Si les utilisateurs Excel n’ont pas besoin de modifier le fichier partagé, vous n’avez pas besoin d’activer cette option.

Remarque : Tableau Server tente toujours de créer une copie cachée d’un fichier .xls. Cette option ne modifie pas le comportement.

extractservice.command.execution.timeout

Version : ajouté dans la version 2021.4.

Valeur par défaut : 7200 secondes

Définit la valeur du délai d’expiration pour l’exécution de l’actualisation d’extrait VConn.

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

Remarque : vous devez utiliser l’option --force-keys pour modifier cette valeur.

features.ActiveMQ

Version : ajouté dans la version 2021.4.

Valeur par défaut : true

Contrôle si Tableau Server utilise le service Apache ActiveMQ (Service de messagerie Tableau Server) pour le mécanisme de messagerie interne.

features.DeleteOrphanedEmbeddedDatabaseAsset

Version : ajouté dans la version 2021.2.

Valeur par défaut : true

Contrôle un processus d’arrière-plan, pour Tableau Catalog (ou l’API Tableau Metadata), qui supprime les ressources externes intégrées (bases de données et tables) qui ne sont plus associées au contenu Tableau en aval. Ce processus s’exécute tous les jours à 22:00:00 UTC (heure universelle coordonnée) et peut supprimer 100 ressources externes au maximum chaque jour jusqu’à ce qu’il ne reste plus aucune ressource externe sans connexion au contenu Tableau en aval. Vous pouvez définir cette option sur false pour arrêter l’exécution de ce processus. Vous pouvez également ajuster le nombre maximal de ressources externes intégrées pouvant être supprimées à l’aide de databaseservice.max_database_deletes_per_run.

Pour plus d’informations, consultez Résoudre les problèmes de contenu manquant.

features.DesktopReporting

Valeur par défaut : false

Contrôle si la fonction Rapports sur les licences Tableau Desktop est activée sur le serveur. Lorsque la valeur est définie sur false (par défaut), aucune vue administrative associée aux licences Desktop n’est disponible. Définissez-la sur true pour activer les rapports sur les licences et rendre visibles les vues administratives d’utilisation et d’expiration des licences dans la page État du serveur. Remarque : les rapports sur les licences Desktop doivent être activés sur le client (Tableau Desktop) pour que les informations soient communiquées à Tableau Server.

features.IdentityMigrationBackgroundJob

Version : ajouté dans la version 2022.1. La valeur par défaut a été modifiée en false dans les versions 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 et 2023.3.

Valeur par défaut : false

Contrôle le processus responsable de la migration d’identité. Lorsque cette valeur est définie sur true, la migration d’identité s’exécute dans les déploiements existants immédiatement après la mise à niveau de Tableau Server vers la version 2022.1 (ou ultérieure) et la restauration d’une sauvegarde de Tableau Server version 2021.4 (ou antérieure). Elle est définie sur false (par défaut) pour désactiver la migration d’identité.

Par exemple, pour démarrer la migration d’identité, exécutez la commande suivante :

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

Pour plus d’informations, consultez À propos de la migration d’identité.

Remarque : si la migration d’identité est désactivée, Tableau Server ne peut pas utiliser le Service d’identité pour stocker et gérer les informations d’identité des utilisateurs. L’utilisation du Service d’identité est une condition préalable pour certaines fonctionnalités telles que les pools d’identités.

features.IdentityPools

Version : ajouté dans la version 2023.1

Valeur par défaut : false

Un composant de la fonctionnalité des pools d’identités qui doit être activé si vous effectuez une nouvelle installation de Tableau Server. Exige que feature.NewIdentityMode et wgserver.authentication.legacy_identity_mode.enabled soient définis sur true pour activer les pools d’identités. Définissez sur false (par défaut) pour désactiver les pools d’identité.

Par exemple, pour activer les pools d’identité, exécutez la commande suivante :

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

Pour plus d’informations, consultez Dépanner les pools d’identités.

features.MessageBusEnabled

Version : ajouté dans la version 2019.4

Valeur par défaut : true

Contrôle si Tableau Server utilise le nouveau mécanisme de messagerie interne.

features.NewIdentityMode

Version : ajouté dans la version 2022.1

Valeur par défaut : false La valeur par défaut a été modifiée de true en false dans la version 2023.1.6.

Un prérequis pour la capacité Pools d’identités. Exige que wgserver.authentication.legacy_identity_mode.enabled soit définis sur false pour désactiver les pools d’identités. Définissez sur true pour activer les pools d’identité.

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

Pour plus d’informations, consultez Dépanner les pools d’identités.

features.PasswordlessBootstrapInit

Valeur par défaut : true

Contrôle si Tableau Server autorise les informations d’identification intégrées dans les fichiers bootstrap. Lorsque cette option est activée (par défaut), les informations d’identification intégrées sont incluses dans le fichier bootstrap, sauf spécification contraire. Définissez cette option sur false si les informations d’identification ne doivent jamais être incluses dans un fichier bootstrap que vous générez. Pour plus d’informations sur la génération de fichiers bootstrap, reportez-vous à la section tsm topology nodes get-bootstrap-file.

Cette option a été ajoutée à partir de Tableau Server version 2019.3.

features.PasswordReset

Valeur par défaut : false

S’applique uniquement aux serveurs utilisant l’authentification locale. Définissez sur truepour que les utilisateurs puissent réinitialiser leurs mots de passe avec l’option « Vous avez oublié votre mot de passe » dans la page de connexion.

filestore.empty_folders_reaper.enabled

Version : ajouté dans les versions 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) et 2021.1.x. La valeur par défaut a été modifiée sur true dans la version 2021.2.

Valeur par défaut : true

Active le travail qui « récolte » (supprime) les dossiers vides du répertoire de fichiers.

filestore_empty_folders_reap.frequency_s

Version : ajouté dans la version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2).

Valeur par défaut : 86400 (24 heures)

Spécifie en minutes, la fréquence d’exécution du travail qui supprime les dossiers vides du magasin de fichiers.

features.Hyper_DisallowTDEPublishing

Version : par défaut défini sur true à partir de la version 2023.1.0

Valeur par défaut : true

Spécifie si les utilisateurs peuvent télécharger des fichiers au format .tde. Ce format a été remplacé par le format .hyper à partir de la version 10.5 de Tableau Server mais n’a pas été bloqué pour le téléchargement. Les fichiers étaient automatiquement convertis au format .hyper en cas d’exécution d’une action parmi plusieurs. Pour plus d’informations, consultez Mise à niveau d’extraits vers le format .hyper.

filestore.log.level

features.Hyper_DisallowTDEPublishing

Version : ajouté dans la version 2020.3.0.

Valeur par défaut : info

Niveau d’enregistrement pour le répertoire de fichiers. Ce paramètre peut être configuré de manière dynamique, donc si n’effectuez pas d’autres modifications, vous n’avez pas à redémarrer Tableau Server. Pour plus d’informations, consultez Modifier les niveaux d’enregistrement.

filestore.reapemptyfoldersholdoffms

Version : ajouté dans la version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2). Non encore disponible dans la version 2021.1.

Valeur par défaut : 300000 (5 minutes)

Spécifie, en millisecondes, le temps d’attente avant de supprimer les dossiers vides du magasin de fichiers.

floweditor.max_datafile_upload_size_in_kb

Version : ajouté dans la version 2020.4

Valeur par défaut : 1048576

Pour la création Web de flux Tableau Prep, la taille maximale des fichiers texte délimités (par exemple CSV ou TXT) pouvant être téléchargés sur Tableau Server.

gateway.external_url

Version : ajouté dans la version 2023.1

Valeur par défaut : null

Requis lorsque l’authentification OpenID Connect (OIDC) est configurée dans TSM lors de la configuration de Tableau Server ou avec des pools d’identités. Spécifie l’URL Tableau Server utilisée par le fournisseur d’identité (IdP) pour rediriger les utilisateurs qui s’authentifient dans Tableau. L’URL externe de la passerelle est la même URL que celle que vous avez spécifiée comme URL de redirection avec votre IdP, qui est utilisée à des fins de correspondance.

Par exemple, pour rediriger l’IdP associé à la configuration de l’authentification OIDC vers votre Tableau Server, http://myco, exécutez la commande suivante :

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

gateway.http.cachecontrol.updated

Valeur par défaut : false

L’en-tête Contrôle de cache HTTP spécifie si le navigateur du client doit ou non mettre en cache le contenu envoyé depuis Tableau Server. Pour désactiver la mise en cache des données Tableau Server sur le client, définissez cette option sur true.

gateway.http.hsts

Valeur par défaut : false

L’en-tête HTTP Strict Transport Security (HSTS) force les navigateurs à utiliser HTTPS sur le domaine où il est activé.

gateway.http.hsts_options

Valeur par défaut : "max-age=31536000"

Par défaut, la stratégie HSTS est configurée pour une année (31 536 000 secondes). Cette période spécifie la durée pendant laquelle le navigateur accédera au serveur via HTTPS.

gateway.httpd.loglevel

Version : ajouté dans la version 2021.3.0.

Valeur par défaut : notice

Spécifie le niveau d’enregistrement pour la passerelle (serveur Apache HTTPD). Défini par défaut sur notice. Les autres options incluent debug, info, warning et error. Si vous modifiez le niveau d’enregistrement, tenez compte de l’impact potentiel sur l’utilisation de l’espace disque et les performances. La meilleure pratique consiste à rétablir le niveau d’enregistrement par défaut après avoir collecté les informations dont vous avez besoin. Pour des informations détaillées sur l’enregistrement Apache, consultez la documentation Apache HTTP(Le lien s’ouvre dans une nouvelle fenêtre).

gateway.httpd.shmcb.size

Version : ajouté dans la version 2021.4

Valeur par défaut : 2048000

Spécifie la quantité de mémoire en octets pour le tampon circulaire lors de l’utilisation du type de stockage shmcb. Cette clé de configuration ne s’applique pas lors de l’utilisation du type de stockage dbm.

gateway.httpd.socache

Version : ajouté dans la version 2021.4

Valeur par défaut : shmcb

Spécifie le type de stockage du cache de session SSL global/inter-processus. Par défaut, celui-ci est défini sur shmcb, avec une autre option configurable dbm. Pour plus d’informations sur les types de stockage shmcb et dbm, consultez la Directive SSLSessionCache(Le lien s’ouvre dans une nouvelle fenêtre) sur le site Web d’Apache.

gateway.http.request_size_limit

Valeur par défaut : 16380

Taille maximale (en octets) du contenu d’en-tête autorisé à passer par la passerelle Apache lors de requêtes HTTP. Les en-têtes qui dépassent la valeur définie pour cette option entraînent des erreurs du navigateur telles que l’erreur HTTP 413 (Entité de demande trop grande) ou des échecs d’authentification.

Une valeur basse pour gateway.http.request_size_limit peut entraîner des erreurs d’authentification. Les solutions de connexion unique qui s’intègrent à Active Directory (SAML et Kerberos) exigent souvent de grands jetons d’authentification dans les en-têtes HTTP. Veillez à tester les scénarios d’authentification HTTP avant le déploiement en production.

Nous recommandons de définir l’option tomcat.http.maxrequestsize sur la même valeur que celle définie pour cette option.

gateway.http.x_content_type_nosniff

Valeur par défaut : true

L’en-tête HTTP de réponse X-Content-Type-Options spécifie que le type MIME dans l’en-tête Content-Type ne devrait pas être modifié par le navigateur. Dans certains cas où le type MIME n’est pas spécifié, un navigateur peut tenter de déterminer le type MIME en évaluant les caractéristiques de la charge active. Le navigateur affiche alors le contenu en conséquence. Ce processus est appelé « sniffing » (détection). L’interprétation erronée du type MIME peut générer des vulnérabilités de sécurité. L’en-tête HTTP X-Content-Type-Options est défini par défaut sur « nosniff » avec cette option.

gateway.http.x_xss_protection

Valeur par défaut : true

L’en-tête de réponse HTTP X-XSS-Protection est envoyé au navigateur afin d’activer la protection XSS (scripts inter-sites). L’en-tête de réponse X-XSS-Protection écrase les configurations dans les cas où les utilisateurs ont désactivé la protection XSS dans le navigateur. L’en-tête de réponse X-XSS-Protection est activé par défaut avec cette option.

gateway.log.level

Version : ajouté dans la version 2020.3.0.

Valeur par défaut : info

Niveau d’enregistrement pour la passerelle. Ce paramètre peut être configuré de manière dynamique, donc si n’effectuez pas d’autres modifications, vous n’avez pas à redémarrer Tableau Server. Pour plus d’informations, consultez Modifier les niveaux d’enregistrement.

gateway.public.host

Valeur par défaut : <hostname>

Nom (URL) du serveur utilisé pour l’accès externe à Tableau Server. Si Tableau Server est configuré pour utiliser un serveur proxy ou un équilibreur de charge externe, il s’agit du nom saisi dans la barre d’adresse du navigateur pour accéder à Tableau Server. Par exemple, si l’on accède à Tableau Server en saisissant tableau.example.com, le nom de gateway.public.host est tableau.example.com.

gateway.public.port

Valeur par défaut : 80 (443 si SSL)

S’applique aux environnements de serveur proxy uniquement. Port externe utilisé pour l’écoute par le serveur proxy.

gateway.slow_post_protection.enabled

Valeur par défaut : true

Lorsqu’elle est activée, cette option assure la protection contre les attaques Slow POST (déni de service) par l’expiration des requêtes POST qui transfèrent des données à des vitesses extrêmement lentes.

Remarque : ceci n’élimine pas la menace de ces attaques et peut avoir l’effet inattendu d’interrompre les connexions lentes.

gateway.slow_post_protection.request_read_timeout

Valeur par défaut : header=10-30,MinRate=500 body=30,MinRate=500

Lorsqu’elle est activée par l’option précédente, gateway.slow_post_protection.enabled, cette option définit le paramètre ReadRequestTimeout d’Apache httpd. La directive httpd est documentée dans le module Apache mod_reqtimeout(Le lien s’ouvre dans une nouvelle fenêtre). Cette option sert en premier lieu de défense contre l’attaque de type Slowloris. Voir l’entrée Wikipédia, Slowloris (sécurité informatique)(Le lien s’ouvre dans une nouvelle fenêtre).

Remarque : les anciennes versions utilisent une valeur par défaut header=15-20,MinRate=500 body=10,MinRate=500

gateway.timeout

Valeur par défaut : 7200

Temps d’attente maximal, en secondes, au terme duquel la passerelle, après avoir attendu certains événements, affiche une erreur (7200 secondes = 2 heures).

gateway.trusted

Valeur par défaut : Adresse IP de l’ordinateur hébergeant le serveur proxy

S’applique aux environnements de serveur proxy uniquement. Adresse(s) IP ou nom(s) d’hôte du serveur proxy.

gateway.trusted_hosts

Valeur par défaut : Noms alternatifs du serveur proxy

S’applique aux environnements de serveur proxy uniquement. Nom(s) d’hôte alternatif(s) pour le serveur proxy.

hyper.file_partition_size_limit

Valeur par défaut : 0

Lorsque cette valeur est définie sur 0, la taille est configurée comme étant illimitée et utilise tout l’espace disque disponible.

Cette option est utilisée pour configurer la limite d’espace disque pour une requête mise en file d’attente sur le disque. Si l’espace disque utilisé par le fichier spool.<id>.tmp est supérieur à ce qu’il devrait être pour votre environnement, cela signifie que les requêtes sont mises en file d’attente et prennent de l’espace disque. Utilisez cette option pour limiter la quantité d’espace disque utilisée par une requête. Le fichier spool.<id>.tmp se trouve dans le dossier temp du compte utilisateur utilisant Tableau Server. Vous pouvez spécifier cette valeur en unités de K(Ko), M(Mo), G(Go) ou T(To). Par exemple, vous pouvez spécifier une limite de taille de 100G lorsque vous souhaitez limiter l’utilisation de l’espace disque à 100 Go.

Pour plus d’informations sur la mise en file d’attente, consultez la section consacrée à l’utilisation de la mémoire et du processeur dans Moteur de données Tableau Server.

hyper.global_file_partition_size_limit

Valeur par défaut : 0

Lorsque cette valeur est définie sur 0, la taille est configurée comme étant illimitée et utilise tout l’espace disque disponible.

Cette option est utilisée pour configurer la limite d’espace disque pour toutes les requêtes mises en file d’attente sur le disque. Si l’espace disque utilisé par le fichier spool.<id>.tmp est supérieur à ce qu’il devrait être pour votre environnement, cela signifie que les requêtes sont mises en file d’attente et prennent de l’espace disque. Le fichier spool.<id>.tmp se trouve dans le dossier temp du compte utilisateur utilisant Tableau Server. Utilisez cette option pour limiter l’espace disque en somme totale que toutes les requêtes utilisent lors de la mise en file d’attente sur le disque. Vous pouvez spécifier cette valeur en unités de K(Ko), M(Mo), G(Go) ou T(To). Par exemple, vous pouvez spécifier une limite de taille de 100G lorsque vous souhaitez limiter l’utilisation de l’espace disque à 100 Go. Tableau vous recommande de commencer avec cette configuration lors de l’ajustement des limites de mise en file d’attente.

Pour plus d’informations sur la mise en file d’attente, consultez la section consacrée à l’utilisation de la mémoire et du processeur dans Moteur de données Tableau Server.

hyper.enable_accesspaths_symbolic_canonicalization

Valeur par défaut : false

Sur les systèmes d’exploitation Windows, afin de résoudre les liens symboliques, Hyper doit avoir accès au répertoire dans lequel les extraits sont stockés et à tous ses répertoires parents. Si ce n’est pas le cas, vous pouvez voir un message d’erreur dans le journal Hyper indiquant : Impossible d’obtenir le chemin canonique pour //dirA/subdir/myextract.hyper ... Access is denied.

Dans ce cas, vous pouvez le définir sur true afin que le moteur de données (Hyper) ne tente pas de résoudre les liens symboliques lors de l’utilisation de chemins canoniques.

Remarque : si vous définissez la valeur sur true, cela implique également qu’Hyper ne peut plus garantir la protection contre un attaquant potentiel. Ce dernier peut parvenir à placer un lien symbolique pour échapper à l’ensemble autorisé de répertoires auxquels Hyper autorise l’accès dans sa configuration.

hyper.log_queries

Valeur par défaut : true

Lorsque la valeur est définie sur true, les informations relatives à la requête sont enregistrées.

Par défaut, les informations relatives à la requête sont enregistrées. Si toutefois vous estimez que les fichiers journaux sont trop volumineux pour la quantité d’espace disque disponible, vous pouvez la configurer sur false pour désactiver l’enregistrement des informations sur la requête. Tableau vous recommande de laisser cette configuration définie sur true.

hyper.log_query_cpu

Valeur par défaut : false

Utilisez ce paramètre pour enregistrer la durée que prend chaque requête et l’utilisation du processeur.

hyper.log_timing

Valeur par défaut : false

Ce paramètre est utile pour trouver des informations supplémentaires sur les requêtes, par exemple les durées de compilation et d’analyse. Par défaut, ce paramètre est désactivé. Vous pouvez l’activer en réglant la valeur sur true pour collecter des détails supplémentaires sur vos requêtes. Notez toutefois que cela augmentera la taille des fichiers journaux de votre moteur de données (\logs\hyper).

hyper.log_troublesome_query_plans

Valeur par défaut : true

Lorsque la valeur est définie sur true, enregistre les plans de requête qui sont identifiés comme problématiques. Les requêtes qui sont annulées, qui s’exécutent plus lentement que 10 secondes ou qui sont mises en file d’attente relèvent de cette catégorie. Les informations contenues dans les journaux peuvent être utiles pour résoudre les problèmes de requêtes difficiles. Vous pouvez modifier le paramètre sur false si la taille des journaux vous préoccupe.

hyper.memory_limit

Valeur par défaut : 80%

Contrôle la quantité maximale de mémoire utilisée par Hyper. Spécifiez le nombre d’octets. Ajoutez la lettre « k » à la valeur pour indiquer des kilo-octets, « m » pour indiquer des mégaoctets, « g » pour indiquer des gigaoctets et « t » pour indiquer des téraoctets. Par exemple, hyper.memory_limit="7g". Vous pouvez également spécifier la limite de mémoire sous forme de pourcentage de la mémoire système globale disponible. Par exemple, hyper.memory_limit="90%".

hyper.memtracker_hard_reclaim_threshold

Valeur par défaut : 80%

Ce paramètre s’applique uniquement à Windows. Hyper conserve en mémoire les parties décompressées et décryptées de l’extrait pour accélérer les accès ultérieurs. Ce paramètre contrôle le moment où les threads de travail commencent à écrire ces données dans un cache de disque afin de moins solliciter la mémoire. Si elle est indiquée sous forme de pourcentage, la valeur est interprétée comme un pourcentage du paramètre hyper.memory_limit global. Par exemple, hyper.memtracker_hard_reclaim_threshold="60%". Les valeurs absolues peuvent être spécifiées comme « k » (kilooctets), « m » (mégaoctets), « g » (gigaoctets) ou « t » (téraoctets). Par exemple, hyper.memtracker_hard_reclaim_threshold="10g". La valeur doit être supérieure au seuil hyper.memtracker_soft_reclaim.

hyper.memtracker_soft_reclaim_threshold

Valeur par défaut : 50%

Ce paramètre s’applique uniquement à Windows. Lorsqu’il interagit avec un fichier Hyper, Hyper écrit certaines données pour les mettre en cache ou les conserver. Le comportement spécial Windows consiste à verrouiller les données récemment écrites dans la mémoire. Pour éviter l’échange, nous excluons les données lorsque Hyper atteint la limite configurée pour le seuil de récupération. Lorsque le seuil de récupération doux est atteint, Hyper tente de récupérer les données mises en cache en arrière-plan pour rester en dessous du seuil de récupération. Dans les situations où l’échange se produirait autrement, le déclenchement de la récupération dans Hyper peut entraîner un meilleur résultat. Par conséquent, si un grand nombre d’échanges a lieu dans votre installation Tableau Server, ce paramètre peut être utilisé pour tenter de moins solliciter la mémoire.

Spécifiez le nombre d’octets. Ajoutez la lettre « k » à la valeur pour indiquer des kilo-octets, « m » pour indiquer des mégaoctets, « g » pour indiquer des gigaoctets et « t » pour indiquer des téraoctets. Vous pouvez également spécifier la valeur sous forme de pourcentage de la mémoire globale configurée pour Hyper. Par exemple, hyper.memtracker_soft_reclaim_threshold="20%".

hyper.network_threads

Valeur par défaut : 150%

Contrôle le nombre de threads réseau utilisés par Hyper. Spécifiez soit le nombre de threads réseau (par exemple, hyper.network_threads=4) ou spécifiez le pourcentage de threads en relation avec le nombre de cœurs logiques (par exemple, hyper.network_threads="300%").

Les threads réseau sont utilisés pour accepter de nouvelles connexions et pour envoyer ou recevoir des données et des requêtes. Hyper utilise un réseau asynchrone, de sorte que de nombreuses connexions peuvent être desservies par un seul thread. Normalement, la quantité de travail effectuée sur les threads du réseau est très faible. La seule exception est l’ouverture de bases de données sur des systèmes de fichiers lents, qui peut prendre beaucoup de temps et bloquer le thread réseau. Si les temps de connexion sont lents lorsque vous essayez d’afficher ou de modifier des tableaux de bord basés sur des extraits et qui n’ont pas été utilisés depuis un certain temps et que vous voyez fréquemment des messages « asio-continuation-slow » dans le journal Hyper et constatez des durées « construct-protocol » longues vers Hyper dans le journal Tableau, essayez d’augmenter cette valeur.

hyper.objectstore_validate_checksums

Valeur par défaut : false

Paramètre booléen qui contrôle les vérifications d’intégrité des fichiers dans Hyper. Lorsqu’il est défini sur true, Hyper vérifie les données d’un fichier d’extrait lors du premier accès. Cela permet de détecter la corruption silencieuse et la corruption qui entraînerait une panne d’Hyper. En général, il est conseillé d’activer ce paramètre sauf pour les installations avec des disques très lents, où il pourrait générer des baisses de performances.

hyper.query_total_time_limit

Valeur par défaut : 0 (ce qui signifie illimité)

Définit une limite supérieure pour le temps total du thread qui peut être utilisé par des requêtes individuelles dans Hyper. Ajoutez « s » à la valeur pour indiquer les secondes, « min » pour indiquer les minutes, ou « h » pour indiquer les heures.

Par exemple, pour restreindre toutes les requêtes à une durée totale de 1500 secondes de temps total de thread, exécutez la commande suivante :

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

Si une requête s’exécute plus longtemps que la limite spécifiée, la requête échouera et une erreur sera renvoyée. Ce paramètre vous permet de contrôler automatiquement les requêtes d’échappement qui, autrement, utiliseraient trop de ressources.

Hyper exécute les requêtes en parallèle. Par exemple, si une requête s’exécute pendant 100 secondes et que, pendant ce temps, elle est exécutée sur 30 threads, la durée totale du thread serait de 3000 secondes. Le temps de thread de chaque requête est indiqué dans le journal Hyper dans les entrées du journal « query-end » dans le champ « total-time ».

hyper.session_memory_limit

Valeur par défaut : 0 (ce qui signifie illimité)

Contrôle la consommation maximale de mémoire d’une requête individuelle. Spécifiez le nombre d’octets. Ajoutez la lettre « k » à la valeur pour indiquer des kilo-octets, « m » pour indiquer des mégaoctets, « g » pour indiquer des gigaoctets et « t » pour indiquer des téraoctets.

Par exemple, pour fixer la limite de mémoire sur 900 Mo, exécutez la commande suivante :

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

Sinon, pour spécifier la limite de mémoire de session sous forme de pourcentage de la mémoire système globale disponible, exécutez la commande suivante :

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

Réduire cette valeur peut être utile lorsqu’une requête utilise une quantité excessive de mémoire et fait échouer d’autres requêtes sur une longue période. En abaissant la limite, la requête unique volumineuse échouerait (ou aurait recours au spooling si cette option n’est pas désactivée) et n’aurait pas d’impact négatif sur les autres requêtes.

hyper.srm_cpu_limit_percentage

Valeur par défaut( en millisecondes) : 75

Spécifie l’utilisation horaire moyenne maximale du processeur autorisée par Hyper. En cas de dépassement, le moteur de données redémarre de lui-même pour minimiser l’impact sur les autres processus de l’ordinateur.

Par défaut, le moteur de données redémarre s’il utilise en moyenne plus de 75 % du processeur sur une heure. Cette valeur ne doit pas être modifiée, sauf lorsque vous travaillez avec l’assistance Tableau ou si vous exécutez le moteur de données sur un nœud de serveur dédié. Si le moteur de données s’exécute sur un nœud dédié, vous pouvez augmenter cette valeur à 95 % en toute sécurité pour tirer pleinement parti du matériel informatique disponible. Pour plus d’informations sur l’exécution du moteur de données sur un nœud dédié, consultez Optimisation pour les environnements soumis à une forte charge de requêtes d’extraits.

Pour augmenter la valeur à 95 % :

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

tsm pending-changes apply

Pour réinitialiser à la valeur par défaut de 75 % :

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

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

Valeur par défaut : true

Améliore les chances que l’extrait d’une requête soit déjà mis en cache. Si le nœud contenant l’extrait mis en cache ne peut pas gérer la charge supplémentaire, vous serez dirigé vers un nouveau nœud et l’extrait sera chargé dans le cache sur le nouveau nœud. Il en résulte une meilleure utilisation du système parce que les extraits ne sont chargés dans la mémoire que s’il y a une charge qui justifie le besoin.

hyper_standalone.health.enabled

Valeur par défaut : true

Change la métrique d’équilibrage de la charge depuis la sélection aléatoire sur le nœud Moteur de données (Hyper). Se base sur un score d’intégrité qui est composé d’une combinaison de l’activité Hyper actuelle et de l’utilisation des ressources du système. Sur la base de ces valeurs, l’équilibreur de charge choisit le nœud qui est le plus capable de gérer une requête d’extrait.

hyper.temp_disk_space_limit

Valeur par défaut : 100%

Définit la limite supérieure de l’espace disque à laquelle Hyper cessera d’allouer de l’espace pour les fichiers temporaires. Ce paramètre aide à éviter que le disque dur se remplisse de fichiers temporaires provenant d’Hyper et vienne à manquer d’espace disque. Si l’espace disque atteint ce seuil, Hyper tente de récupérer automatiquement sans intervention de l’administrateur.

Indiquez-le sous forme de pourcentage de l’espace disque total disponible à utiliser. Par exemple, hyper.temp_disk_space_limit="96%". Lorsqu’il est défini sur 100 %, tout l’espace disque disponible peut être utilisé.

Pour que le moteur de données puisse démarrer, la quantité d’espace disque configurée doit être disponible. Si l’espace disque disponible n’est pas suffisant, vous verrez cette entrée dans le journal du moteur de données : « La limite de disque pour les fichiers temporaires a été atteinte. Veuillez libérer de l’espace disque sur l’appareil. Consultez le journal Hyper pour plus d’informations : il ne reste plus d’espace sur l’appareil ».

hyper.hard_concurrent_query_thread_limit

Valeur par défaut : 150 %

Utilisez cette option pour définir le nombre maximal de threads que le moteur de données doit utiliser pour exécuter des requêtes. Utilisez ce paramètre pour définir une limite stricte sur l’utilisation du processeur. Spécifiez soit le nombre de threads, soit le pourcentage de threads par rapport au nombre de nœuds logiques. Hyper n’utilisera probablement pas plus de ressources que celles configurées par ce paramètre mais les threads d’arrière-plan et réseau Hyper ne sont pas affectés par ce paramètre (bien qu’ils aient tendance à ne pas être gourmands en CPU).

Gardez à l’esprit que ce paramètre contrôle le nombre de requêtes pouvant être exécutées simultanément. Par conséquent, si vous diminuez ce paramètre, les requêtes sont plus susceptibles d’être placées dans une file d’attente et de patienter jusqu’à la fin des requêtes en cours d’exécution, ce qui peut affecter les temps de chargement des classeurs.

hyper.soft_concurrent_query_thread_limit

Valeur par défaut : 100%

Utilisez cette option pour spécifier le nombre de threads sur lesquels une seule requête peut être exécutée en parallèle si suffisamment de threads sont disponibles compte tenu du paramètre hard_concurrent_query_thread_limit. Spécifiez soit le nombre de threads, soit le pourcentage de threads par rapport au nombre de nœuds logiques.

En voici un exemple simplifié :

Supposons que vous définissiez cette valeur sur 10 threads, ce qui signifie que les requêtes peuvent être exécutées en parallèle sur 10 threads au maximum. Si seulement 2 requêtes sont exécutées, les 8 threads restants sont utilisés pour exécuter les 2 requêtes en parallèle.

Les options hyper. hard_concurrent_query_thread_limit et hyper.soft_concurrent_query_thread_limit fonctionnent conjointement pour vous permettre de gérer votre utilisation du processeur tout en maximisant les ressources processeur disponibles pour accélérer les requêtes. Si vous ne souhaitez pas que le moteur de données utilise tous les processeurs disponibles sur l’ordinateur, remplacez-le par moins de 100 % à un pourcentage optimal pour votre environnement. La limite souple vous permet de limiter l’utilisation du processeur, mais elle permet de dépasser la limite souple jusqu’à la limite stricte si nécessaire.

Remarque : les options hyper.hard_concurrent_query_thread_limit et hyper.soft_concurrent_query_thread_limit remplacent les options hyper.num_job_worker_threads et hyper.num_task_worker_threads qui étaient disponibles dans dans Tableau Server 2018.3 et versions antérieures. Elles ont été supprimées et ne sont plus disponibles. Pour plus d’informations sur les threads hyper.num_job_worker_threads et hyper.num_task_worker_threads, consultez Options tsm configuration set(Le lien s’ouvre dans une nouvelle fenêtre).

hyper.use_spooling_fallback

Valeur par défaut : true

Si cette valeur est définie sur true, elle permet la mise en file d’attente sur le disque si l’interrogation d’extraits excède l’utilisation de la RAM (80% de la RAM installée). En d’autres termes, il permet à Hyper d’exécuter une requête en utilisant le disque s’il dépasse l’utilisation de la RAM.

Tableau recommande d’utiliser le paramètre par défaut. Vous pouvez le désactiver en réglant la valeur sur false si vous êtes préoccupé par l’utilisation du disque. Si vous désactivez ce paramètre, les requêtes utilisant plus de 80% de la RAM installée seront annulées. Les requêtes de spooling demandent généralement beaucoup plus de temps.

Pour plus d’informations sur la mise en file d’attente, consultez la section consacrée à l’utilisation de la mémoire et du processeur dans Moteur de données Tableau Server.