Quite useful, I had the case where I needed to provide a CSV file to an external party from our Oracle 10g database. No problem, there are loads of CSV export tools out there. But it then transpired that the CSV’s that I was generating were using quote (“) marks to identify fields e.g. “field1″,”field2″ and so on…
When I ran the script in something like SQL Developer it would spool the file and also spool the query as well into the file no matter what I specified. Along with this it also wouldn’t recognise usage of variables in SQL Developer. Basically what I’m saying here is write the query in something like SQL Developer by all means but for writting and debugging a CSV spooler etc… just save the hassle and go straight to SQL*Plus.
First of all lets start with how to spool the CSV file without leading line breaks, no quote marks etc… the below is the SQL script to run, we’ll need to save this in order to run it later.
SET echo off SET verify off SET termout ON SET heading off SET pages 50000 SET feedback off SET newpage none SET linesize 160 spool /path/save/file/myFile.csv SELECT 'Field1Name,Field2Name,Field3Name,Field4Name,Field5Name' FROM dual; SELECT field1||','|| field2||','|| field3||','|| field4||','|| field5 FROM table1 WHERE field1='etc...'; spool off; exit;
We first set any settings we need at the start for the script these are as follows:
set echo off [Won't display any SQL commands that are run]
set verify off [If turned on, it prints out each defined variable twice]
set termout on [Supresses the output of SQL commands but not the commands themselves]
set heading off [Sets whether column headings are outputted or not]
set pages 50000 [50000 lines without a page break, basically sets the height of the page]
set feedback off [If on it will feedback to user e.g. table created, row deleted etc..]
set newpage none [Removes any leading/ blank lines at the start of a page]
set linesize 200 [Sets the width of a line]
We then start to build our file by calling the spool function with the directory of where to save the file and the file name. To get our headings or column names we then do a simple select statement on dual where each item will be what we want the column to be named – basically to print out the headings to the spool file. We could of course just set heading to ‘on’ and get the column names, but then column names are not always that useful.
We then run our query as normal, the only thing to note is the use of ||’,'|| which instead of double quotes it will still get used as the field separator, you can use ; or tabs for instance instead. The || || is actually used in Oracle for concatenation of fields to allow 2 strings to be used with an additional element imbetween – it also saves us writing CONCAT() for every 2 strings/ columns. If you do not specify this parameter after each column you select then the default double quotes will be used around your fields. We then turn spool off and then exit so when our .sql file is run it will stop and break the connection.
That’s our SQL script, we want to run this script in command prompt because we can launch SQL*Plus with various parameters and switches, the one we need here is silent, -s, which tells SQL*Plus not to show the dialogue and thus not to spool it.
The command to run your script will then be something like:
sqlplus -s {schema_name}/{schema_pwd}@{service_name} @test.sql
That lauches SQL*Plus in silent mode, connects to your schema and then runs the .sql script spooling your .csv file and finally exiting SQL*Plus.
Quick note, if you want to append your filename with todays date for instance then you can do something like the below where we assign the date to a variable, &mydate and set it with the value from your databases sysdate.
... SET linesize 160 COLUMN dcol new_value mydate noprint SELECT to_char(sysdate,'YYYYMMDD') dcol FROM dual; spool /path/TO/save/file/&mydate.myFile.csv SELECT 'Field1Name,Field2Name,Field3Name,Field4Name,Field5Name' FROM dual; ...
This content is published under the Attribution-Noncommercial-Share Alike 3.0 Unported license.










Nice post – proved very helpful for a report I needed to create. Thanks! Just something to add on your filename tip that I pulled from another source. If you have the variable at the end of the filename (myFile_&mydate.csv), you can end up with an odd name (myFile_&mydate.csv.LST). Something about SQL Plus not knowing where the variable ends. To fix this, you need to include an escape character at the end of the variable name.
set escape /
SET linesize 160;
COLUMN dcol new_value mydate noprint
SELECT to_char(sysdate,'YYYYMMDD') dcol FROM dual;
spool c:\temp\myFile_&mydate/.csv
set escape off;
SELECT 'Field1Name,Field2Name,Field3Name,Field4Name,Field5Name' FROM dual;
Any character works for the escape that you aren’t using between where you set the escape and set it off. The slash worked for me, but I had to set escape off after the spool command as I was using it in my query.
Thanks again!
Thanks James. Glad it helped you out and it’s not just me!
Interesting thing about the escape line and a good spot. I’m going to add that in on all my variables although I’ve not had the issue yet, but then I wouldn’t like to have the problem either.
Thanks! This is helpfull.
Glad it helped!