Connect to an Oracle Database and Run a Query From a Bash Script

Published: Jun 7, 2019
Updated: Jun 17, 2022

Table of Contents

Prerequisites #

Files #

A query.sql file:

-- this file must end in a new line
SELECT 'foo'
FROM dual
WHERE 1 = 1
UNION ALL
SELECT 'bar'
FROM dual
WHERE 2 = 2;

An .env file:

ORACLE_HOST='localhost'
ORACLE_PORT='1521'
ORACLE_DATABASE='some_database'
ORACLE_USERNAME='some_user'
ORACLE_PASSWORD='some_password'

A script.sh file:

#!/usr/bin/env bash

# If sqlplus is not available, then exit
if ! command -v sqlplus > /dev/null ; then
  echo "This script requires sqlplus to be installed and on your PATH. Exiting"
  exit 1
fi

# Load database connection info
set -o allexport
source .env
set +o allexport

# Read sql query into a variable
sql="$(<"query.sql")"

# Connect to the database, run the query, then disconnect
echo -e "SET PAGESIZE 0\n SET FEEDBACK OFF\n ${sql}" | \
sqlplus -S -L "${ORACLE_USERNAME}/${ORACLE_PASSWORD}@${ORACLE_HOST}:${ORACLE_PORT}/${ORACLE_DATABASE}"

Usage #

Make it executable:

$ chmod 755 script.sh

Print results to stdout:

$ ./script.sh
foo
bar

Write results to file:

$ ./script.sh > results.txt

Notes #