Configuration de requêtes parallèles dans Tableau Server

Le format permettant de définir des limites de requêtes parallèles en utilisant tabadmin set est le suivant :

tabadmin set native_api.connection.limit.<connection class> <n>

Par exemple, pour définir une limite globale :

tabadmin set native_api.connection.globallimit 8

Ou pour définir une limite sur un type spécifique de source de données :

tabadmin set native_api.connection.limit.sqlserver 5

Pour limiter le nombre de requêtes parallèles pour une jointure entre des bases de données :

tabadmin set native_api.federated_evaluator_degree_of_parallelism 4

Pour consulter la liste des chaînes de classe de connexion, reportez-vous à « Chaînes de classe » dans les Informations supplémentaires ci-dessous.

Le format permettant de définir des limites de requêtes parallèles en utilisant tsm configuration set est le suivant :

configuration set -k native_api.connection.limit.<connection class> -v <n>

Par exemple, pour définir une limite globale :

tsm configuration set -k native_api.connection.globallimit -v 8

Pour définir une limite sur un type spécifique de source de données :

tsm configuration set -k native_api.connection.limit.sqlserver -v 5

Pour limiter le nombre de requêtes parallèles pour une jointure entre des bases de données :

tsm configuration set -k native_api.federated_evaluator_degree_of_parallelism -v 4

Pour consulter la liste des chaînes de classe de connexion, reportez-vous à « Chaînes de classe » dans les Informations supplémentaires ci-dessous.

Un fichier connection-configs.xml est créé par vous et enregistré dans le dossier vizqlserver du répertoire config. Le répertoire config correct dépend de la version de Tableau Server et du système d'exploitation sur lequel il est installé.

• Windows (Tableau Server 2018.1 et antérieur) :

• Windows (Tableau Server 2018.2 et ultérieur) :

• Linux : 

Vous devez copier ce fichier de configuration dans tous les répertoires de configuration vizqlserver sur tous les ordinateurs utilisateur.

Consultez le fichier d'exemple connection-configs.xml à la fin de cette section sur Tableau Server 2018.1 et antérieur.

Une balise <connection> sans information concernant le type de source de données, le serveur ou la base de données définit le nombre maximal de requêtes pour toutes les connexions non couvertes par une autre spécification de connexion plus précise. Par exemple :

<connection>
<limit max='8'>
</limit>
</connection>

Cette valeur écrase la limite de requête parallèle par défaut. Pour le processus vizqlserver, la limite par défaut est de 16. Pour le processus du serveur de données, la limite par défaut est de 1 000 000.

Remarque : lors d'une connexion à Amazon Redshift, la limite par défaut est de 8 pour les deux processus.

Les paramètres de connexion du fichier connection-configs.xml peuvent fonctionner à diffèrents niveaux de spécificité. Lors de l'établissement d'une connexion, Tableau analyse le fichier de haut en bas, de sorte que s'il existe plusieurs entrées susceptibles de s'appliquer à une connexion données, l'entrée la plus proche du haut du fichier est utilisée.

Pour cette raison, il est également recommandé d'organiser les spécifications de connexion des plus spécifiques aux moins spécifiques.

D'autres limites (non globales) sont définies dans une section <connection-list> en haut du fichier connection-configs.xml.

Les paramètres que vous pouvez utiliser dans une balise <connection> sont les suivants :

Paramètre	Chaîne
class	Type de source de données. Reportez-vous au tableau « Chaînes de classe », ci-dessous, pour connaître les chaînes à utiliser pour tous les types de sources de données.
server	Ordinateur serveur.
dbname	Nom de la base de données.
schema	Ce paramètre peut être utile avec les sources de données Teradata.

Vous pouvez spécifier des paramètres dans n'importe quel ordre et n'importe quelle combinaison. Par exemple, vous pouvez spécifier un paramètre server et un paramètre dbname sans spécifier de paramètre class ou schema.

Vous pouvez également définir des limites par connexion individuelle pour les processus du serveur vizql et du serveur de données dans Tableau Server, en limitant le nombre de connexions simultanées que ces processus peuvent créer. 

Vous spécifiez des limites de processus en ajoutant un attribut de processus dans l'élément <limit>.

Pour définir une limite de connexion pour un des processus, créez une configuration de connexion comme celle-ci :

<connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

</connection>

Le paramètre ci-dessus limite le processus vizqlserver à six connexions simultanées. Étant donné qu'aucune limite n'est spécifiée pour le processus de serveur de données, la limite de connexion est déterminée par la limite globale.

Vous pouvez également créer un élément de connexion comme celui-ci :

 <connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

<limit max='12'>

</limit>

</connection>

 

Comme précédemment, le processus vizqlserver est limité à six connexions simultanées. Mais le processus de serveur de données utilise désormais la limite spécifique de connexion pour cette classe de connexion (12) à la place de la limite globale. Lorsqu'aucun attribut de processus n'est spécifié pour un élément <limit>, cette limite s'applique à n'importe quel processus de serveur non spécifié au dessus de ce dernier au sein de l'élément de connexion.

Enfin, vous pouvez définir des limites spécifiques séparées pour chaque processus :

 <connection class='sqlserver'>

<limit max='6' process='vizqlserver'>

</limit>

<limit max='12' process='dataserver'>

</limit>

</connection>

L'exemple ci-dessous entraîne le même comportement que l'exemple précédent, mais cette fois, le serveur de données est explicitement spécifié. 

Si vous souhaitez définir une limite pour les deux processus de serveur dans une connexion, vous pouvez soit répertorier explicitement (délimité par des virgules) dans un élément <limit> ou juste utiliser un élément <limit> avec aucun processus spécifié. Ainsi, les deux éléments limite suivants sont équivalents :

<limit max='10' process='dataserver, vizqlserver'>
<limit max='10'>
Remarque : ces limites de processus s'appliquent uniquement à la configuration des requêtes parallèles dans Tableau Server. Si vous utilisez un fichier connection-configs.xml qui contient des limites de processus avec Tableau Desktop, tout élément <limit> qui spécifie les limites pour un processus ou les deux est ignoré.