Loading

Configuration d'une connexion Oracle pour qu'elle utilise TNSNames.ora ou LDAP.ora

Date de publication: Mar 17, 2025
Tâche
Comment configurer une connexion Oracle pour qu'elle utilise TNSNames.ora ou LDAP.ora.


Avantages à configurer des connexions TNSNames.ora ou LDAP.ora.

Les erreurs Oracle courantes suivantes peuvent être corrigées ou évitées en configurant votre connexion de données de manière à utiliser TNSNames.ora ou LDAP.ora.

  • ORA-12154 :TNS: could not resolve the connect identifier specified (Erreur au niveau de la base de données Oracle 12154 : ORA-12154 : TNS : impossible de résoudre l'identificateur de connexion spécifié)

  • ORA-12514 : TNS listener does not currently know of service requested in connect descriptor (TNS : le processus d'écoute ne connaît pas actuellement le service demandé dans le descripteur de connexion)

  • ORA-12541 : TNS: no listener (aucun écouteur)

  • ORA-12170 : TNS:Connect timeout occurred (une expiration de la connexion s'est produite)

  • ORA-12504 : L'écouteur TNS n'a pas reçu le SERVICE_NAME dans CONNECT_DATA
Étapes
CLIQUER POUR DÉVELOPPER LA SOLUTION
Tableau Desktop et/ou Server sur Windows, Client OCI

Étape 1 : Définition de la variable d'environnement TNS_Admin.

  1. Sélectionnez Démarrer > Panneau de configuration > Système 
  2. Sélectionnez Paramètres système avancés.
  3. Dans la boîte de dialogue Propriétés du système, sur l'onglet Avancé, sélectionnez Variables d'environnement. 
  4. Sous Variables système, cliquez sur Nouveau. 
  5. Dans la boîte de dialogue Nouvelle variable système, entrez ce qui suit, puis cliquez sur OK : 
    • Nom de la variable : TNS_ADMIN 
    • Valeur de la variable : répertoire contenant le fichier TNSNames.ora.
  6. Cliquez sur OK dans la boîte de dialogue Variables d'environnement et dans la boîte de dialogue Propriétés système. 
  7. Redémarrez votre ordinateur pour vous assurer que la nouvelle variable est reconnue. 

Étape 2 : Utilisez le nom de service réseau Oracle pour vous connecter à Oracle dans Tableau. 

  1. Fermez tous les classeurs Tableau et ouvrez une nouvelle instance de Tableau.
  2. Dans Tableau Desktop, sélectionnez Se connecter aux données > Oracle.
    • Pour le serveur, entrez le nom « net_service_name » oracle enregistré dans le fichier TNSNAmes.ora.
    • Entrez votre nom d'utilisateur et votre mot de passe selon vos besoins.

Le reste des détails de connexion du fichier TNSNames.ora est communiqué via la variable système TNS_ADMIN. Notez que vous devriez laisser vides le nom du service en option et les informations de port. Ils risquent sinon d'interférer avec la connexion en dupliquant les informations.

CLIQUER POUR DÉVELOPPER LA SOLUTION
Tableau Desktop et Server 2020.2 et ultérieur, Windows, pilote JDBC
 
Créez un fichier oracle.properties contenant le texte suivant (Exemple) :

oracle.net.tns_admin=C:\\Oracle_Client\\network\\admin

Si nécessaire, modifiez le chemin pour référencer l’emplacement du fichier tnsnames.ora dans le système de fichiers hôte. Les doubles barres obliques inverses \\ sont intentionnelles et obligatoires, même si les chemins \\ ne fonctionneront pas s’ils sont copiés et collés directement dans l’explorateur de fichiers Windows. Le fichier oracle.properties ne fonctionnera correctement qu’avec des doubles barres obliques inverses dans ce contexte.

Placez le fichier à l’emplacement suivant :
Desktop : Documents\My Tableau Repository\Datasources 
Server: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources (ou chemin équivalent si un autre emplacement d’installation est utilisé). Assurez-vous de créer le dossier s’il n’existe pas déjà.

Serveur uniquement : une fois les fichiers et les dossiers créés, assurez-vous que Exécuter en tant qu'utilisateur est fourni avec les autorisations appropriées sur le fichier et redémarrez Tableau Server.

Pour plus d’informations, sur les fichiers de propriétés JDBC, consultez https://help.salesforce.com/s/articleView?id=Customizing-JDBC-Connections&type=1&language=en_US
 
CLIQUER POUR DÉVELOPPER LA SOLUTION
Sur Mac

Étape 1 :

  1. Fermez Tableau Desktop s'il est ouvert. 
  2. Vérifiez que vous avez téléchargé et installé les pilotes Oracle pour Mac depuis la page Pilotes de Tableau.
  3. Copiez un fichier LDAP.ora ou TNSNames.ora existant contenant des informations de connexion sur /etc : 
  • Dans le Finder, sélectionnez Aller > Aller au dossier, puis tapez /etc.
  • Copiez le fichier .ora sur /etc.

Étape 2 : Configurez la variable d'environnement TNS_Admin 

  1. Démarrez le terminal et entrez la commande suivante :

    sudo nano /etc/launchd.conf

    Remarque : Nano est un éditeur basé texte qui est toujours disponible sur les ordinateurs Mac.

  2. Entrez votre mot de passe à l'invite.

  3. Entrez la commande suivante :

    launch setenv TNS_ADMIN /etc

  4. Appuyez sur Ctrl-X, puis Y, puis sur Entrée pour enregistrer vos modifications et quitter Nano.
  5. Redémarrez votre Mac.

Étape 3 : Vérifiez que la variable TNS_ADMIN a été définie : 

  1. Démarrez le terminal et entrez la commande suivante :

    export

  2. Vous verrez s'afficher la liste de toutes les variables système. Recherchez :

    declare -x TNS_ADMIN="/etc"

  3. Vérifiez que la résolution DNS fonctionne pour le nom d'hôte répertorié dans le fichier .ora en envoyant un ping au nom d'hôte dans l'utilitaire du terminal ou du réseau. Utilisez un nom de domaine qualifié complet, par exemple nomserveur.domaine.com, au lieu d'un simple nom de serveur. 
Vous devriez maintenant pouvoir démarrer Tableau Desktop sur votre Mac et vous connecter à la base de données Oracle, en fournissant seulement le nom du serveur à partir du fichier TNSNames.ora ou LDAP.ora. 
 
CLIQUER POUR DÉVELOPPER LA SOLUTION
Sur Linux

Résumé des étapes :

  1. Copiez le fichier tnsnames.ora sur un emplacement auquel l'utilisateur tableau a accès
  2. Définissez les autorisations sur le fichier.
  3. Mettez à jour la variable d'environnementTNS_ADMIN, si nécessaire, de manière à pointer vers le répertoire à partir de l'étape (1).

Étape 1 : Copier le fichier tnsnames.ora sur un répertoire auquel l'utilisateur sans privilège (tableau) peut accéder

Pour 2019.3.x et versions ultérieures :
Copiez le fichier tnsnames.ora sur le répertoire /etc.
Pour 2019.2.x et versions antérieures :
Par défaut , l'utilisateur sans privilège est appelé « tableau ». Tous les processus Tableau Server sont exécutés avec ce compte et doivent être capables de localiser le fichier tnsnames.ora pour l'utiliser.
Si vous avez déjà installé le connecteur Oracle, nous vous recommandons de copier le fichier sur le répertoire /opt/tableau/tableau_driver/oracle.
Vous pouvez vérifier que le répertoire est accessible par l'utilisateur en utilisant « su » pour basculer sur le compte et sur le répertoire. Par exemple :
sudo su tableau
cd /opt/tableau/tableau_driver/oracle
Si ces résultats entraînent une erreur « autorisation refusée », vous devez mettre à jour les autorisations sur le répertoire que vous utilisez.

Étape 2 : Définir les autorisations pour le fichier tnsnames.ora

2019.2.x et antérieur, suivez la procédure ci-dessous :
  1. Accédez au chemin d'accès du fichier où se trouve le fichier tnsnames.ora.
  2. Accordez des autorisations pour le fichier en exécutant la commande : chmod 666 tnsnames.ora
  3. Vérifiez les autorisations de fichier à l'aide de la commande suivante : ls -l
Remarque : le chemin d'environnement ne doit pas avoir de barre oblique finale. Si le format du chemin est incorrect, les utilisateurs peuvent rencontrer une erreur ORA-12154.

2019.3 et versions ultérieures :
Placez le fichier tsnames.ora dans le répertoire /etc sur l'ordinateur Linux. Aucune variable d'environnement n'est nécessaire.

2020.2 et versions ultérieures :

Créez un fichier /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/oracle2.tdc avec le texte ci-dessous :

Exemple : oracle.net.tns_admin=/etc

Modifiez /etc si nécessaire pour pointer vers le chemin du fichier tnsnames.ora dans le système de fichiers de votre Serveur.

Pour plus d’informations, sur les fichiers de propriétés JDBC, consultez https://help.salesforce.com/s/articleView?id=Customizing-JDBC-Connections&type=1&language=en_US
 

Étape 3 : Définir la variable d'environnement TNS_ADMIN de manière à pointer vers le répertoire à partir de l'étape (1)

Pour 2019.3.x et versions ultérieures : vous pouvez ignorer cette étape. Aucune variable d'environnement n'est requise.
Pour 2019.2.x et versions antérieures :
  1. Dans un éditeur de texte, ouvrez le fichier correspondant à votre version de Tableau Server :
    • ​​​Tableau Server 2018.1.x - 2019.2 --  /var/opt/tableau/tableau_server/.local/share/systemd/user/tabsvc_0.service
  2. Ajoutez la ligne suivante, où « /path/to/file-folder » correspond au répertoire sur lequel vous avez copié le fichier tnsnames.ora à l'étape 1 :
    • Environment=TNS_ADMIN=/path/to/file-folder
  3. Enregistrez les modifications apportées au fichier.

Remarque : le chemin d'environnement ne doit pas avoir de barre oblique finale. Si le format du chemin est incorrect, les utilisateurs peuvent rencontrer une erreur ORA-12154.

CLIQUER POUR DÉVELOPPER LA SOLUTION
Tous les environnements

Étapes facultatives

Trouver les fichiers tnsnames.ora

Si le client Oracle est installé sur votre serveur, le fichier tnsnames.ora se trouve dans le répertoire suivant : $ORACLE_HOME/network/admin.
Vous pouvez vérifier si ce fichier existe avec les commandes suivantes :

echo $ORACLE_HOME 
imprimera le chemin d'accès du fichier.
sudo find / -iname tnsnames.ora
 référence les emplacements de tous les fichiers tnsnames.ora sur votre système de fichiers.

Remarque : il n'est pas nécessaire que le client Oracle soit installé pour utiliser tnsnames.ora avec Tableau Server. Cette étape est simplement conçue pour vous aider à travailler avec toute installation existante.

Création d'un nouveau fichier tnsnames.ora depuis le début

Si aucun fichier tnsnames.ora n'est présent sur cet ordinateur et que vous n'en avez aucun à copier depuis la station de travail d'un client, vous pouvez en créer un avec un éditeur de texte. Gardez à l'esprit les restrictions suivantes :

  • Le nom de fichier tnsnames.ora est sensible à la casse et doit être entièrement en minuscules. 

  • Le fichier ne doit pas utiliser l'espacement par tabulation.

Voici un modèle possible d'entrée ci-dessous. Il est nécessaire de remplacer les éléments entre parenthèses par les valeurs transmises par votre administrateur de base de données.
Remarque : un fichier TNSNames.ora sur un ordinateur Windows ou Mac peut ne pas exiger l'entrée ADDRESS_LIST. Par contre, le fichier tnsnames.ora sur un ordinateur Linux requiert cette variable.
 

[net_service_name]=
(DESCRIPTION=
  (ADDRESS_LIST=
    (ADDRESS=[protocol_address_information])
   )
  (CONNECT_DATA= 
    (SERVICE_NAME=[service_name])
   )
 )

Par exemple :

Production =
(DESCRIPTION =
  (ADDRESS_LIST =
    (ADDRESS = (PROTOCOL = TCP)(HOST = prod.corp.com)(PORT = 1521)
   )
  (CONNECT_DATA = 
    (SERVICE_NAME = orcl)
   )
 )

 

Ressources supplémentaires

Étapes de configuration supplémentaires si SSL est configuré sur Oracle

Configuration de ORACLE_HOME et TNS_ADMIN pour Oracle (avec SSL configuré sur Oracle)

sudo su -l tableau
      touch /var/opt/tableau/tableau_server/.config/systemd/tableau_server.conf.d/oracle.conf
      echo "ORACLE_HOME=/u01/app/oracle/product/12.1.0/client_1" | tee -a /var/opt/tableau/tableau_server/.config/systemd/tableau_server.conf.d/oracle.conf
      echo "TNS_ADMIN=/u01/app/oracle/product/12.1.0/client_1/network/admin" | tee -a /var/opt/tableau/tableau_server/.config/systemd/tableau_server.conf.d/oracle.conf 
      chmod 744 /var/opt/tableau/tableau_server/.config/systemd/tableau_server.conf.d/oracle.conf
Quitter

cd /opt/tableau/tableau_server/packages/scripts.near.xx.xxxx.xxxx/
            sudo ./stop-administrative-services
            sudo ./start-administrative-services
source /etc/profile.d/tableau_server.sh

Numéro d’article de la base de connaissances

001453730

 
Chargement
Salesforce Help | Article