Utilisation d'ODBC pour connecter Tableau à une adresse SQL Data Flow

Téléchargement et installation du pilote ODBC sur Mac OS

Suivez ces étapes pour télécharger et installer un pilote ODBC à utiliser avec Tableau sur Mac OS.

  1. Téléchargez le pilote ODBC.
    1. Dans la barre de recherche globale, recherchez Data Flow et sélectionnez Service Data Flow.
    2. Sélectionnez Adresses SQL dans la navigation la plus à gauche.
    3. Sélectionnez une adresse SQL dans la liste. La page de détails de l'adresse SQL est affichée.
    4. Sous Connexion, sélectionnez Pilotes.
    5. Sous ODBC, sélectionnez Télécharger le pilote ODBC.
    6. Sélectionnez Mac. Le téléchargement commence.
    7. Une fois le téléchargement terminé, extrayez le fichier zip téléchargé.
  2. Cliquez deux fois pour installer le pilote.
    La fenêtre d'installation s'ouvre.
  3. Sélectionnez Continuer.
    Lisez le contrat de licence affiché.
  4. Sélectionnez Accepter.
  5. (Facultatif) Pour modifier le répertoire d'installation par défaut, sélectionnez Modifier l'emplacement d'installation, accédez à l'emplacement d'installation et sélectionnez OK.
  6. Sélectionnez Next pour confirmer le répertoire d'installation.
  7. Sélectionnez Install.
  8. Une fois l'installation terminée, sélectionnez Finish.
    Le répertoire d'installation du pilote est :
    /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
  9. (Facultatif) Installez ODBC Manager.
    ODBC Manager est un outil permettant de configurer des pilotes et de créer et de gérer des DSN. L'outil est facultatif car vous pouvez également créer des DSN manuellement en modifiant le fichier odbc.ini approprié.
    1. Téléchargez ODBC Manager à partir du site de téléchargement.
    2. Cliquez deux fois sur le fichier .dmg téléchargé.
    3. Cliquez deux fois sur le fichier ODBC Manager.pkg.
    4. Suivez les invites pour l'installer.

Configuration du pilote ODBC sur Mac OS

Suivez ces étapes pour configurer le pilote ODBC sur Mac OS.

Vous pouvez créer des DSN utilisateur (accessibles uniquement par l'utilisateur qui l'a créé sur le poste de travail) ou des DSN système (accessibles par tout utilisateur connecté au poste de travail).

  1. Obtenez le nom d'hôte de l'adresse SQL à laquelle se connecter.
    1. Ouvrez la page Détails de l'adresse SQL lorsqu'elle est active.
    2. Sélectionnez Drivers.
    3. Sous Pilote ODBC, sélectionnez Afficher les détails. En règle générale, les messages d'erreur indiquent la nature et la cause de l'échec.
    4. Sélectionnez Afficher dans la chaîne Nom d'hôte. Le nom d'hôte complet s'affiche.
    5. Sélectionnez Copier dans la chaîne Nom d'hôte. Le nom d'hôte complet est copié dans le presse-papiers.
    6. Enregistrez le nom d'hôte pour une utilisation ultérieure.
  2. (Facultatif) Créez un DSN à l'aide du gestionnaire ODBC.
    1. Démarrez le gestionnaire ODBC.

    2. Sélectionnez User DSN ou System DSN, le cas échéant.

    3. Choisissez Ajouter.

    4. Sélectionnez Simba OCI Spark ODBC Driver.

    5. Sélectionnez OK.

    6. Entrez le nom du DSN (par exemple, Data Flow SQL Endpoint) et, éventuellement, ajoutez une description.

    7. Créez une paire de valeurs de mot-clé pour chaque paramètre DSN.

    8. Sélectionnez Ajouter pour créer une paire de valeurs de mot-clé.

    9. Sélectionnez Mot-clé et remplacez-le par le nom du paramètre.

    10. Sélectionnez Valeur et remplacez-la par la valeur du paramètre.

    11. Répétez les étapes g à j pour chaque paramètre.
    12. Ajoutez les détails d'authentification de la connexion :
      1. Pour vous connecter à une adresse SQL à l'aide d'une clé de signature d'API située à l'emplacement par défaut ~/.oci/config, ajoutez le paramètre :
        OCIConfigFile=ConfigFileLocation
        ConfigFileLocation est le chemin absolu du fichier de configuration OCI à utiliser avec la connexion.
        Définissez éventuellement le champ OCIProfile sur le nom du profil OCI dans le fichier de configuration à utiliser avec la connexion :
        OCIProfile=<profile_to_use>
        Si aucun profil n'est spécifié, le connecteur tente d'utiliser le profil nommé DEFAULT :
        OCIProfile=<profile_to_use>
      2. Pour vous connecter à une adresse SQL à l'aide d'un jeton (via le navigateur), omettez le paramètre OCIConfigFile dans la configuration DSN.
    13. Sélectionnez OK pour créer le DSN.

    Remarque

    Si vous créez le premier DSN utilisateur ou système pour le pilote ODBC, ODBC Manager crée le fichier odbc.ini dans le répertoire correspondant pour le type de DSN créé. Si vous créez d'autres DSN, ODBC Manager ajoute des entrées pour chaque DSN au fichier odbc.ini existant. Le fichier odbc.ini se trouve sous le répertoire ~/Library/ODBC pour les DSN utilisateur et /Library/ODBC pour les DSN système.
  3. (Facultatif) Créez un DSN en ajoutant une entrée à odbc.ini.
    Si un DSN utilisateur ou un DSN système a déjà été créé pour le pilote, ajoutez la nouvelle entrée au fichier odbc.ini existant. Si vous créez le premier DSN pour le pilote, créez manuellement le fichier odbc.ini et ajoutez l'entrée au fichier.
    1. Si vous créez le premier DSN dans le fichier odbc.ini vide, créez une section pour les sources de données ODBC (pour la première fois uniquement) en ajoutant la ligne suivante au fichier odbc.ini :
      [ODBC Data Sources]
    2. Pour chaque DSN, spécifiez les éléments suivants :

      1. Sous [ODBC Data Sources], indiquez le nom du DSN et le nom du pilote ODBC (qui est le pilote ODBC Simba OCI Spark), sous la forme <dsn_name> = <driver_name>. Par exemple :
        [ODBC Data Sources]dsn_name = Simba OCI Spark ODBC Driver
      2. Créez une section pour la configuration DSN, en ajoutant [dsn_name] sur une nouvelle ligne à la fin du fichier.
        [dsn_name]
      3. Sous la section DSN créée, spécifiez le chemin de répertoire du fichier de pilote, sous la forme suivante :
        Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
      4. Fournissez les paramètres de connexion tels que l'hôte et le fichier de configuration. Il n'est pas nécessaire de spécifier les paramètres de connexion que vous ajoutez au DSN dans la chaîne de connexion ODBC.

        • Pour vous connecter à l'adresse SQL à l'aide d'une clé de signature d'API (et non à l'emplacement par défaut de ~/.oci/config), ajoutez le paramètre :
          OCIConfigFile=ConfigFileLocation
          ConfigFileLocation est le chemin absolu du fichier de configuration OCI à utiliser pour la connexion.

          Vous pouvez éventuellement définir le champ OCIProfile sur le nom du profil OCI dans le fichier de configuration à utiliser pour la connexion. Si aucun profil n'est indiqué, le connecteur tente d'utiliser le profil nommé DEFAULT :

          OCIProfile=PROFILE_TO_USE
        • Pour vous connecter à une adresse SQL à l'aide d'un jeton (basé sur un navigateur), vous pouvez omettre le paramètre OCIConfigFile de la configuration DSN.
      5. Tous les autres paramètres sont indiqués sous la forme <parameter_name> = <value>. L'exemple suivant présente un fichier odbc.ini qui configure les sources de données à l'aide de la clé d'API :
        [ODBC Data Sources]
        Data Flow SQL Endpoint = Simba OCI Spark ODBC Driver
        [Data Flow SQL Endpoint]
        Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
        Description = Description of the connection
        Host = amaaaaaaezym32iajmhpmxybehc7plnvpxsmjhleiav37x5rm7pjx476ewqa.interactive.dataflowclusters.us-ashburn-1.oci.oc-test.com
        OCIConfigFile = /Users/username/.oci/config
        OCIProfile = OCIProfileToUse
        OCIIgnoreDriverNoPrompt = 1
    3. Vérifiez que le chemin du fichier de configuration OCI permettant d'utiliser la clé de signature d'API pour l'authentification est correct.
    4. Validez le chemin du fichier de clés privées dans la configuration.

Téléchargement et installation du pilote ODBC sous Windows

Suivez ces étapes pour télécharger et installer un pilote ODBC à utiliser avec Tableau sous Windows/

  1. Téléchargez le pilote ODBC Windows à partir de .
    1. Dans la barre de recherche globale, recherchez Data Flow et sélectionnez Service Data Flow.
    2. Sélectionnez Adresses SQL dans la navigation la plus à gauche.
    3. Sélectionnez une adresse SQL dans la liste. La page de détails de l'adresse SQL est affichée.
    4. Sous Connexion, sélectionnez Pilotes.
    5. Sous ODBC, sélectionnez Télécharger le pilote ODBC.
    6. Sélectionnez Windows. Le téléchargement commence.
    7. Une fois le téléchargement terminé, extrayez le fichier zip téléchargé.
  2. Extrayez le fichier .zip.
  3. Double-cliquez sur le programme d'installation 32 bits, Simba OCI Spark 2.6 32-bit.msi, si le système est 32 bits, ou double-cliquez sur le programme d'installation 64 bits, Simba OCI Spark 2.6 64-bit.msi, si le système est 64 bits.
  4. Sélectionnez Suivant.
  5. Acceptez les conditions du contrat de licence.
  6. Sélectionnez Suivant.
  7. (Facultatif) Pour remplacer le répertoire d'installation par défaut :
    1. Sélectionnez Modifier....
    2. Accédez au répertoire requis.
    3. Sélectionnez OK.
  8. Pour accepter le répertoire d'installation, sélectionnez Next.
  9. Sélectionnez Install.
  10. Une fois l'installation terminée, sélectionnez Finish.

Configuration du pilote ODBC sous Windows

Suivez ces étapes pour configurer le pilote ODBC sous Windows.

Vous pouvez créer des DSN utilisateur (accessibles uniquement par l'utilisateur qui l'a créé sur le poste de travail) ou des DSN système (accessibles par tout utilisateur connecté au poste de travail).

  1. Obtenez le nom d'hôte de l'adresse SQL à laquelle se connecter.
    1. Ouvrez la page Détails de l'adresse SQL lorsqu'elle est active.
    2. Sélectionnez Drivers.
    3. Sous Pilote ODBC, sélectionnez Afficher les détails. En règle générale, les messages d'erreur indiquent la nature et la cause de l'échec.
    4. Sélectionnez Afficher dans la chaîne Nom d'hôte. Le nom d'hôte complet s'affiche.
    5. Sélectionnez Copier dans la chaîne Nom d'hôte. Le nom d'hôte complet est copié dans le presse-papiers.
    6. Enregistrez le nom d'hôte pour une utilisation ultérieure.
  2. Créez un DSN.
    1. Ouvrez l'application ODBC Data Sources.

    2. Sélectionnez User DSN ou System DSN, le cas échéant.

    3. Choisissez Ajouter.

    4. Sélectionnez Simba OCI Spark ODBC Driver.

    5. Cliquez sur Fin.

    6. Entrez le nom du DSN (par exemple, Data Flow SQL Endpoint) et, éventuellement, ajoutez une description.

    7. Pour l'authentification, vous pouvez utiliser une clé de signature d'API pour vous connecter à une adresse SQL ou vous pouvez utiliser un jeton (basé sur un navigateur) pour vous connecter à une adresse SQL.

      Procédure d'utilisation d'une clé de signature d'API
      1. Définissez le fichier de configuration OCI sur le chemin absolu du fichier de configuration OCI à utiliser pour la connexion.
      2. Vous pouvez éventuellement définir le champ Profil OCI sur le nom du profil OCI à utiliser pour la connexion. Si aucun profil n'est indiqué, le connecteur tente d'utiliser le profil nommé DEFAULT.
      3. Cochez Ignorer SQL_DRIVER_NOPROMPT.
      4. Sélectionnez OK pour enregistrer les paramètres.
      Pour utiliser un jeton (basé sur un navigateur)
      Vous pouvez choisir de ne pas configurer entièrement les options de l'établissement de dépôt et de ne tester que le DSN (étape iv), ou de sélectionner Options de l'établissement de dépôt et de poursuivre avec les étapes suivantes :
      1. Définissez le champ Fichier de configuration OCI sur un chemin qui ne contient pas de fichier de configuration OCI pour utiliser l'authentification par jeton.
      2. Pour afficher un navigateur Web utilisé pour terminer le flux d'authentification par jeton même lorsque SQL_DRIVER_NOPROMPT est activé, cochez Ignorer SQL_ DRIVER_NOPROMPT.
      3. Sélectionnez OK pour enregistrer les paramètres.
      4. Pour tester le DSN, sélectionnez Test.
    8. Sélectionnez OK pour créer le DSN.

Connexion de Tableau à une adresse SQL Data Flow à l'aide d'ODBC

Suivez ces étapes pour connecter Tableau à une adresse SQL Data Flow à l'aide d'ODBC.

  1. Ouvrez Tableau.
  2. Sélectionnez Autres bases de données (ODBC).
    Une nouvelle fenêtre s'ouvre.
  3. Cochez la case DSN.
  4. Sélectionnez le DSN, Data Flow SQL Endpoint, dans la liste.
    Tous les paramètres de connexion requis sont automatiquement renseignés.
  5. Sélectionnez Connexion.