In this two part blog post we will demonstrate how to query an Oracle database from Powershell. Before we can run queries against Oracle we need to install the Oracle client on our Windows machine. Unlike SQL Server, the drivers for connecting to Oracle are not included with the operating systems. The drivers are however freely available from Oracle. You can find the client software on the Oracle Database Software Downloads Page.
Downloading the Oracle Client
You’ll notice several versions of Oracle software on the download page. The software you choose will varying depending on your operating system. Generally when with dealing Oracle client software it is safe to choose the latest client version even if the Oracle database you will be connecting to is a lower version.
At the time of this blog post the following versions were the latest available:
- 11.1.0.7.0 Windows 2008 and Windows 2008 R2
- 11.1.0.6.0 Windows 2003
However, check the download page and choose a later version if listed. I’ve installed both the Windows 2008 and 2003 x64 versions, but for this blog series I’m using the Windows 2003 x64 version. To complete the download
- Select See All
- Select Oracle Database 11g Release 1 Client (11.1.0.6.0) for Microsoft Windows (x64). Note: Be sure you select the Client download and not the full Oracle database software!
Note: When you attempt to download Oracle software you will be prompted to login to the Oracle Technology Network (OTN). If you don’t have an account you’ll need to create one—It’s free.
We’re now ready to install and configure the Oracle client software.
Installing the Oracle Client
Many of the components included with the Oracle client are not needed. The following steps are used to perform a minimal Oracle client installation.
Run setup.exe
Click next on the Install Welcome Screen.
Select Custom installation type and click next.
The Oracle base directory should be off of a root drive of your choosing. I’m using C:\Oracle. Change the path and ensure the name field is auto populated correctly and then click next.
Ensure all the requirement checks succeed and click next (Note: you may receive warnings on Windows 2008 R2 when using the Windows 2008 installation software. The install will still succeed even with these warnings).
Select SQL Plus and scroll down to select more components.
Select Oracle Windows Interfaces and ensure the first three components are NOT selected. Ensure all other Windows Interface ARE checked and scroll down to select additional components.
Select the Oracle Net component and click next.
Select Install.
Once the installation is complete the configuration utility will be launched by the installer.
Configuring the Oracle Client
Select next from the Oracle Net Configuration Assistant Welcome screen.
Select Next.
Enter the Oracle database service name. Note: I’m using Oracle Express on Ubuntu Linux. The service name is XE, your service name may differ.
Select Next.
Enter the Oracle database server host name or IP address.
Select Next to test connectivity.
The test will fail, you’ll need to change the login and password by selecting Change Login
The test should succeed and if not use the error message to troubleshoot.
Enter an alias name and select next.
Select Next.
Select Next.
Select Next.
Select Finish.
Select Exit.
Select Yes.
Congratulations you’ve installed the Oracle client! My thanks to an Oracle colleague who wishes to remain anonymous. He was a big help with the installation and putting together this guide. In part two of this blog series we’ll look at querying an Oracle database from Powershell.