L’administrateur de site peut modifier plusieurs paramètres du client Bridge afin de changer le mode d’exécution du client. Dans certains cas, un propriétaire de source de données peut être chargé de certaines des tâches décrites dans cette rubrique s’il gère son propre client pour exécuter les (anciennes) programmations Bridge.
Exécuter Bridge en tant que service Windows
Pour être inclus dans un pool, un client doit s’exécuter en tant que service Windows (mode Service). Par défaut, un client est configuré pour s’exécuter en tant que service Windows afin de pouvoir équilibrer la charge des requêtes en direct et des actualisations en arrière-plan sans exiger qu’un utilisateur dédié soit connecté à l’ordinateur. Pour qu’un client s’exécute en tant que service Windows, le compte utilisateur Windows qui exécute le client doit être un membre du groupe des administrateurs locaux sur l’ordinateur.
Remarque : si vous êtes propriétaire d’une source de données et gérez le client vous-même, votre client ne sera pas inclus dans le pool. Toutefois, si vous souhaitez que l’(ancienne) programmation Bridge s’exécute en arrière-plan même lorsque vous n’êtes pas connecté à votre ordinateur, votre client doit s’exécuter en tant que service Windows (mode Service).
Ouvrez la barre d’état système Windows et cliquez sur l’icône Bridge pour ouvrir le client.
Dans le menu déroulant Mode, sélectionnez Service. Une fenêtre de connexion s’affiche.
Entrez vos identifiants d’administrateur local.
Dans la liste des services Windows, Bridge s’affiche en tant que Service Tableau Bridge. Vous pouvez les retrouver dans la console des services Windows ou dans l’onglet Services du Gestionnaire de tâches.
Cesser d’exécuter Bridge en tant que service Windows
Pour empêcher le client de s’exécuter en tant que service, modifiez son mode.
Ouvrez la barre d’état système Windows et cliquez sur l’icône Bridge pour ouvrir le client.
Dans le menu déroulant Mode, sélectionnez Application.
Lorsque le client s’exécute en mode Application, les requêtes en direct et les actualisations programmées ne peuvent s’exécuter que lorsque l’utilisateur est connecté au compte utilisateur Windows sur l’ordinateur d’où le client s’exécute.
Modifier le site auquel un client est associé
Lorsque vous souhaitez utiliser un client pour maintenir à jour le contenu publié sur un autre site Tableau Cloud, vous pouvez dissocier le client existant et vous authentifier sur le nouveau site à partir du client.
- Ouvrez la barre d’état système Windows et cliquez sur l’icône Bridge pour ouvrir le client.
Dans le menu déroulant, sélectionnez Dissocier.
La dissociation supprime la liste des sources de données qui utilisent les planifications Bridge (héritées), les planifications et les informations de connexion du client.
Ouvrez la barre d’état système Windows et cliquez sur l’icône Bridge pour ouvrir le client.
Lorsque vous y êtes invité, connectez-vous au nouveau site avec vos informations d’identification d’administrateur de site.
Effectuez l’une ou les deux opérations suivantes pour configurer le client :
Si ce client actualise les sources de données associées à un client spécifique, demandez aux propriétaires de sources de données de reconfigurer leurs sources de données et d’actualiser les programmations.
Si vous souhaitez que ce client facilite les connexions en direct ou extrait les connexions qui utilisent les planifications en ligne, assurez-vous que le nouveau client fait partie du pool. Pour plus d’informations, consultez Configurer le pool de clients Bridge
Lorsque vous dissociez un client, vous devrez peut-être également supprimer les (anciennes) programmations Bridge pour les sources de données que le client était en train d’actualiser. Pour les autres sources de données, les tâches d’actualisation des données continuent d’être effectuées par d’autres clients enregistrés dans le pool.
Pour plus d’informations, consultez Effets de la fermeture de session et de la dissociation.
Paramètres du client Bridge
L’emplacement par défaut du fichier de configuration est C :\Users\jsmith\Documents\Mon référentiel Tableau Bridge\\ Configuration\TabBridgeClientConfiguration.txt.
| Configuration | Option de configuration | Configurable? | Description |
serviceConnectionSettings | serviceUrl | Non | URL du site Tableau. |
connection | connectTimeout | Oui | Le temps d’attente du client Bridge lors de la tentative de connexion à Tableau Cloud. Valeur par défaut : 1 minute |
operationTimeout | Oui | Le temps d’attente du client Bridge pour chaque appel d’API de serveur (tel que VizPortal) lorsqu’une connexion a été établie à Tableau Cloud. Valeur par défaut : 15 minutes | |
maxAttemptsToRedirectHttpRequests | Oui | Un appel d’API vers un serveur peut être redirigé de POD vers POD. Ce nombre spécifie le nombre maximum de redirections par appel d’API du serveur. Valeur par défaut : 20 | |
connectionPool | Size | Oui | S’applique aux programmations en ligne. Le nombre de jetons d’actualisation générés au moment de la connexion. Le client Bridge utilise des jetons d’actualisation lorsqu’une connexion à Tableau Cloud est nécessaire. Les tâches d’actualisation sont traitées simultanément et chaque tâche nécessite un jeton. Valeur par défaut : 10 Valeur minimale : 1 Valeur maximale : 100. La modification de cette valeur nécessite la dissociation du client. |
dataSourceRefreshSettings | shutdownTimeoutInSeconds | S.O. | Obsolète. Non pris en charge. |
downloadDataSourcesInterval | Oui | Intervalle de temps pour le téléchargement temporaire des noms des sources de données en direct et des sources de données de l’extrait qui sont attribuées au client pour les anciennes programmations. Valeur par défaut : 30 minutes. | |
checkRefreshDataSourcesInterval
| Oui | Intervalle de temps nécessaire au client Bridge pour vérifier les sources de données qui lui sont attribuées afin de déterminer si une actualisation est nécessaire pour les anciennes programmations. Valeur par défaut : 5 secondes | |
extractRefreshTimeout | Oui | Établit un délai pour les actualisations effectuées par le client. Cette limite est la durée maximum autorisée pour l’exécution de l’actualisation d’un seul extrait avant qu’elle soit annulée par le client. Si une actualisation d’extrait est annulée suite à une expiration de délai, vous verrez s’afficher un message dans le client et une alerte courriel sera envoyée au propriétaire de la source de données. Valeur par défaut : 24 heures. Pour les connexions virtuelles, le délai d’expiration par défaut de l’actualisation d’extrait est de 2 heures et est contrôlé par Tableau Cloud. Le délai d’expiration ne peut pas être contrôlé par le client Bridge. | |
maxRemoteJobConcurrency | Oui | S’applique aux programmations en ligne. Nombre maximal de tâches d’actualisation à distance autorisées par le client. La valeur de cette configuration doit être égale ou inférieure à Valeur par défaut : 10 Minimum : 1 Maximum : la valeur pour | |
JSONLogForExtractRefresh | Oui | Lorsqu’il est défini sur true, le client génère un fichier journal supplémentaire au format JSON. Le fichier journal capture les métriques des actualisations d’extraits, tant pour les actualisations anciennes que distantes, avec une ligne par extrait. Le format du fichier journal JSON est lisible par Tableau Desktop et peut être utilisé comme source de données pour créer des visualisations en direct. Pour plus d’information, consultez la section Fichier JSON. Voici un exemple de fichier journal :
La modification de la valeur de cette option de configuration nécessite un redémarrage du client Bridge. Les options de configuration Valeur par défaut : false | |
dataSources | Non | S’applique aux tâches d’actualisation des anciennes programmations. Non modifiable par l’utilisateur. Fournit une liste des emplacements de fichiers locaux mappés pour les sources de données basées sur des fichiers. | |
loggerSettings | maxLogFileSizeInMB | Oui | Taille maximale des fichiers journaux en Mo. Lorsqu’un fichier journal dépasse cette limite de taille, un nouveau fichier journal est créé. Valeur par défaut : 25 Mo. |
maxBackupLogFileCount | Oui | Nombre maximal de fichiers journaux Bridge autorisés. Lorsque le nombre de fichiers journaux dépasse la limite, le fichier journal le plus ancien est supprimé. La valeur par défaut est 40. | |
remoteRequestLogFileLifeSpan | Oui | Pour chaque tâche d’actualisation Bridge envoyée au client, un nouvel ensemble de fichiers journaux est créé : tabbridgeclijob_<process_id, et si la source de données est basée sur JDBC : fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id>.Par défaut, la durée maximale pendant laquelle les fichiers journaux restent dans le dossier Fichiers journaux avant d’être supprimés est de 8 heures si le nombre de fichiers journaux dépasse
Valeur par défaut : 8 heures | |
dataSyncRestartInterval | S.O. | Obsolète. Non pris en charge. | |
internetConnectionMonitorInterval | Oui | Intervalle pendant lequel Bridge teste les connexions Internet à l’aide de commandes Ping pour déterminer si une connexion valide a été établie. Valeur par défaut : 30 secondes | |
secureStorageMonitorInterval | S.O. | Obsolète. Non pris en charge. | |
cleanUpTempDirOnStartUp | Oui | Détermine s’il faut supprimer les fichiers temporaires au démarrage du client Bridge. Valeur par défaut : true | |
JSONLogForLiveQuery | Oui | Lorsqu’il est défini sur true, le client génère un fichier journal supplémentaire au format JSON. Le fichier journal capture les métriques de la demande de requête en direct, avec une ligne par extrait. Le format du fichier journal JSON est lisible par Tableau Desktop et peut être utilisé comme source de données pour créer des visualisations en direct. Pour plus d’information, consultez la section Fichier JSON. Voici un exemple de fichier journal :
La modification de la valeur de cette option de configuration nécessite un redémarrage du client Bridge. Les options de configuration Valeur par défaut : true |
Configurer une limite de délai d’expiration pour les actualisations
Pour contrôler l’utilisation abusive des extraits ou des actualisations, vous pouvez appliquer une limite de temps, également appelée limite de délai d’expiration, pour les actualisations effectuées par un client. Cette limite est la durée maximum autorisée pour l’exécution de l’actualisation d’un seul extrait avant qu’elle soit annulée par le client.
Remarque : pour les extraits de connexions virtuelles, le délai d’expiration par défaut de l’actualisation de l’extrait est de 2 heures et ne peut pas être contrôlé par le client Bridge. Comme alternative, vous pouvez modifier la connexion virtuelle pour qu’elle s’actualise dans la fenêtre par défaut de 2 heures ou basculer vers une source de données publiée.
Par défaut, la limite de délai d’expiration pour un client est définie sur 24 heures. Vous pouvez modifier la limite de délai d’expiration pour un client via le fichier de configuration de Bridge. Si une actualisation d’extrait est annulée suite à une expiration de délai, vous verrez s’afficher un message dans le client et une alerte courriel sera envoyée au propriétaire de la source de données.
Vous devez redémarrer le client pour que les modifications apportées au fichier de configuration prennent effet.
Sur l’ordinateur sur lequel le client est installé, accédez au dossier Configuration dans Mon référentiel Tableau Bridge.
Ouvrez le fichier TabBridgeClientConfiguration.txt.
À côté de extractRefreshTimeout, modifiez la durée autorisée pour l’exécution d’une tâche d’actualisation.
Remarque : si le paramètre n’est pas visible dans le fichier de configuration, vous pouvez ajouter "extractRefreshTimeout" et le délai d’actualisation souhaité au paramètre dataSourceRefreshSettings.
Enregistrez et fermez le fichier.
Quittez le client puis redémarrez-le pour que les modifications prennent effet. Le mode de redémarrage du client varie selon que le client s’exécute en mode Application ou Service.
En mode Application : dans le menu du client, sélectionnez Quitter.
En mode Service : dans le menu déroulant Mode, sélectionnez Application; dans le menu du client, sélectionnez Quitter.
Gérer les fichiers journaux Bridge
Le client crée des fichiers journaux d’activités dans le cadre de son fonctionnement normal. Vous pouvez utiliser ces fichiers journaux pour surveiller les actualisations, résoudre des problèmes de Bridge ou si l’équipe d’assistance Tableau vous demande des fichiers journaux afin de vous aider à résoudre un problème.
Vous pouvez utiliser le fichier TabBridgeClientConfiguration.txt pour gérer la taille des fichiers journaux Bridge ou augmenter la durée de conservation des fichiers journaux avant leur suppression.
Remarque : Les fichiers journaux nommés tabprotosrv* diffèrent des autres fichiers journaux Bridge. La taille maximale est de 1 Mo et le nombre maximum de fichiers journaux autorisés est de 8192. Ces valeurs ne sont pas non plus configurables.
Sur l’ordinateur sur lequel le client est installé, accédez au dossier Configuration dans Mon référentiel Tableau Bridge.
Ouvrez le fichier TabBridgeClientConfiguration.txt.
À côté de loggerSettings, vous pouvez modifier les valeurs des paramètres suivants :
"maxLogFileSizeInMB" : 25
"maxBackupLogFileCount" : 40
"remoteRequestLogFileLifeSpan" : "08 :00 :00"
Enregistrez et fermez le fichier.
Quittez le client puis redémarrez-le pour que les modifications prennent effet. Le mode de redémarrage du client varie selon que le client s’exécute en mode Application ou Service.
En mode Application : dans le menu du client, sélectionnez Quitter.
En mode Service : dans le menu déroulant Mode, sélectionnez Application; dans le menu du client, sélectionnez Quitter.
Gérer la taille du pool Bridge
Par défaut, chaque client d’un pool peut équilibrer la charge de 10 tâches d’actualisation simultanés au maximum. Si le nombre de tâches d’actualisation en cours d’exécution à un moment donné dépasse la capacité de votre pool de clients ou si vous disposez des ressources matérielles nécessaires pour le prendre en charge, envisagez d’augmenter la capacité de chaque client.
Vous pouvez gérer la capacité de mise en pool d’un client dans le fichier TabBridgeClientConfiguration.txt.
Modifier la configuration du pool de connexions
Important : la procédure décrite ci-dessous exige de dissocier le client. La dissociation supprime l’association entre le site et le client. Cela signifie que pour les sources de données qui sont actualisées à l’aide des (anciennes) programmations Bridge, la dissociation du client supprime les associations à ces sources de données, ses programmations et toute information de connexion du client. Dans le cadre de la modification de la taille du pool Bridge, nous vous recommandons de cliquer sur l’icône Bridge dans la barre système Windows et de noter les sources de données répertoriées (étape 5) pour faciliter le processus de reprogrammation (étape 10).
Sur l’ordinateur sur lequel le client est installé, accédez au dossier Configuration dans Mon référentiel Tableau Bridge.
L’emplacement par défaut du dossier Configuration est C :\Users\jsmith\Documents\Mon référentiel Tableau Bridge\Configuration.
Ouvrez le fichier TabBridgeClientConfiguration.txt.
Modifiez la valeur à côté de
ConnectionPool.Enregistrez et fermez le fichier.
- (Facultatif) Cliquez sur l’icône Bridge dans la barre d’état système Windows et notez les sources de données répertoriées et les programmations d’actualisation qui ont été configurés pour ces sources de données.
Faites un clic droit sur l’icône Bridge dans la barre d’état système Windows, puis sélectionnez Dissocier.
Pour plus d’informations sur l’option Dissocier, consultez Effets de la fermeture de session et de la dissociation.
Quittez le client pour que les modifications prennent effet. La manière dont vous quittez le client varie selon que le client s’exécute en mode Application ou Service.
En mode Application : dans le menu du client, sélectionnez Quitter.
Pour le mode Service : dans le menu Client, sélectionnez Quitter. Dans la boîte de dialogue, cochez la case Quitter le client et arrêter les activités et cliquez sur Fermer.
Redémarrez Bridge.
Lorsque vous y êtes invité, connectez-vous à Tableau Cloud avec vos informations d’identification d’administrateur de site.
- (Facultatif) Si vous avez suivi l’étape 5 pour les sources de données qui utilisent les (anciennes) programmations Bridge, suivez la procédure décrite dans Ajouter une nouvelle programmation ou mettre à jour une (ancienne) programmation Bridge existante pour reprogrammer les actualisations et réassocier efficacement les sources de données avec le client.
Modifier une configuration maxRemoteJobConcurrency
Sur l’ordinateur sur lequel le client est installé, accédez au dossier Configuration dans Mon référentiel Tableau Bridge.
Ouvrez le fichier TabBridgeClientConfiguration.txt.
Modifiez la valeur à côté de
maxRemoteJobConcurrency.Enregistrez et fermez le fichier.
Quittez le client pour que les modifications prennent effet. La manière dont vous quittez le client varie selon que le client s’exécute en mode Application ou Service.
En mode Application : dans le menu du client, sélectionnez Quitter.
Pour le mode Service : dans le menu Client, sélectionnez Quitter. Dans la boîte de dialogue, cochez la case Quitter le client et arrêter les activités et cliquez sur Fermer.
Redémarrez Bridge.
Lorsque vous y êtes invité, connectez-vous à Tableau Cloud avec vos informations d’identification d’administrateur de site.
- (Facultatif) Si vous avez suivi l’étape 5 pour les sources de données qui utilisent les (anciennes) programmations Bridge, suivez la procédure décrite dans Ajouter une nouvelle programmation ou mettre à jour une (ancienne) programmation Bridge existante pour reprogrammer les actualisations et réassocier efficacement les sources de données avec le client.