Alteryx Designer Knowledge Base

Definitive answers from Designer experts.
Register for the upcoming Live Community Q&A Session - and don't forget to submit your questions for @DeanS regarding the future role of analytics here.

Unable to Find Oracle Client?


About the Oracle Client Directory

This directory was generated by the Alteryx install script, and contains an instance of the Oracle Instant Client. Oracle Instant Client is a collection of installed Oracle Database libraries for connecting Alteryx Designer to local or remote Oracle Databases. There’s no need for tnsnames.ora file.


The Oracle client setting is located in your UserSettings.xml file, located in C:\Users\%USERNAME%\AppData\Roaming\Alteryx\Engine\<AlteryxVersion>. This file is used to load your Designer settings during startup. You can open this file in notepad and look for the <OracleInstantClientInstallPath.. >. In my case, it looks something like this:




You can use this to check the location of your Oracle Instant Client or install a new one as well. To install a new one, you can:

  • Find the instantclient_12_1 folder (from the UserSettings.xml file) and put it in a different location > Restart Alteryx Designer > Try to connect to Oracle in Designer and you should receive a message “Oracle Client Not Found”. From here, you can re-install the client. unable2.png




8 - Asteroid

I was facing an issue of selecting an install location for the Oracle Instant Client driver, and my selection not working.

For example, I selected 'C:/Alteryx' as my install location and was getting an error ''Alteryx was unable to download or extract the oracle instant client driver zip file"


I checked my 'UserSettings.xml file' per Digan's suggestion above, and did not have any install location for OracleInstantClientInstallPath


I re-tried installing the Oracle Instant Client from Alteryx but this time set my install path as 'C:\Alteryx Oracle Drivers' and that made everything work 🙂