MySQL Export Table to CSV

Summary: in this tutorial, you will learn various techniques of how to export a MySQL table to a CSV file.

The CSV stands for comma-separated values. You often use the CSV file format to exchange data between applications such as Microsoft Excel, Open Office, Google Docs, etc.

It will be useful to have data from the MySQL database in CSV file format because you can analyze and format the data in the way you want.

MySQL provides an easy way to export the query’s result into a CSV file that resides in the database server.

Before exporting data, you must ensure that:

• The MySQL server’s process has the write access to the target folder that contains the target CSV file.
• The target CSV file must not exist.

The following query selects canceled orders from the  orders table:

SELECT 
    orderNumber, status, orderDate, requiredDate, comments
FROM
    orders
WHERE
    status = 'Cancelled';

To export this result set into a CSV file, you add some clauses to the query above as follows:

SELECT 
    orderNumber, status, orderDate, requiredDate, comments
FROM
    orders
WHERE
    status = 'Cancelled' 
INTO OUTFILE 'C:/tmp/cancelled_orders.csv' 
FIELDS ENCLOSED BY '"' 
TERMINATED BY ';' 
ESCAPED BY '"' 
LINES TERMINATED BY '\r\n';

The statement created a CSV file named  cancelled_orders.csv in the  C:\tmp the folder that contains the result set.

The CSV file contains lines of rows in the result set. Each line is terminated by a sequence of carriage return and a line feed character specified by the LINES TERMINATED BY '\r\n' clause. Each line contains values of each column of the row in the result set.

Each value is enclosed by double quotation marks indicated by  FIELDS ENCLOSED BY '”' clause. This prevents the value that may contain a comma (,) will be interpreted as the field separator. When enclosing the values by the double quotation marks, the commas inside the value are not recognized as the field separators.

Exporting data to a CSV file whose filename contains a timestamp

You often need to export data into a CSV file whose name contains the timestamp at which the file is created. To do so, you need to use the MySQL prepared statement.

The following commands export the whole orders table into a CSV file with a timestamp as a part of the file name.

SET @TS = DATE_FORMAT(NOW(),'_%Y_%m_%d_%H_%i_%s');

SET @FOLDER = 'c:/tmp/';
SET @PREFIX = 'orders';
SET @EXT    = '.csv';

SET @CMD = CONCAT("SELECT * FROM orders INTO OUTFILE '",@FOLDER,@PREFIX,@TS,@EXT,
				   "' FIELDS ENCLOSED BY '\"' TERMINATED BY ';' ESCAPED BY '\"'",
				   "  LINES TERMINATED BY '\r\n';");

PREPARE statement FROM @CMD;

EXECUTE statement;

Let’s examine the commands above in more detail.

• First, we constructed a query with the current timestamp as a part of the file name.
• Second, we prepared the statement for execution by using PREPARE the statement FROM command.
• Third, we executed the statement by using the EXECUTE command.

You can wrap the command by an event and schedule the event to run periodically if needed.

Exporting data with column headings

It would be convenient if the CSV file contains the first line as the column headings so that the file is more understandable.

To add the column headings, you need to use the UNION statement as follows:

(SELECT 'Order Number','Order Date','Status')
UNION 
(SELECT orderNumber,orderDate, status
FROM orders
INTO OUTFILE 'C:/tmp/orders.csv'
FIELDS ENCLOSED BY '"' TERMINATED BY ';' ESCAPED BY '"'
LINES TERMINATED BY '\r\n');

As the query showed, you need to include the column heading of every column.

Handling NULL values

In case the values in the result set contain NULL values, the target file will contain  "N instead of NULL. To fix this issue, you need to replace the NULL value by another value e.g., not applicable ( N/A ) by using the IFNULL function as the following query:

SELECT 
    orderNumber, orderDate, IFNULL(shippedDate, 'N/A')
FROM
    orders INTO OUTFILE 'C:/tmp/orders2.csv' 
    FIELDS ENCLOSED BY '"' 
    TERMINATED BY ';' 
    ESCAPED BY '"' LINES 
    TERMINATED BY '\r\n';

We replaced NULL values in the shippedDate column by the  N/A strings. The CSV file shows  N/A instead of NULL values.

Exporting data to CSV file using MySQL Workbench

In case you don’t have access to the database server to get the exported CSV file, you can use MySQL Workbench to export the result set of a query to a CSV file on your local computer as follows:

• First, execute a query to get its result set.
• Second, from the result panel, click “export record set to an external file”. The result set is also known as a record set.
• Third, new dialog displays. It asks you for a filename and file format. Enter the file name, choose CSV as the file format, and click the Save button.

The CSV file exported by MySQL Workbench supports column headings, NULL values and other great features.