How to convert MySQL output to HTML tables

In this article I’ll explain how to control the output of the mysql client program and feed it to another program to transform the results as desired. I often transform output into HTML tables for these blog articles – at least, I do when I’m not being lazy.

The mysql command-line program can accept a command and print the results directly to STDOUT. The default output behavior differs depending on where its input comes from. When the input comes via STDIN, the output is tab-separated values. When the input comes via the -e or --execute options, or when the -t option is specified, the output is in “tabular” format, with borders drawn by pipes, dashes and plus characters.

Results can also be printed vertically, as they are when an interactive command is terminated with \G instead of a semicolon. The command-line option for this format is -E or --vertical.

I usually select results in non-tabular format and feed them to awk to turn them into HTML. Here is a quick one-liner that will format the first two columns:

echo "select ..." | mysql | sed -e 's/\|//g' | awk '{a++; if(a<2){print "<tr><th>" $1 "</th><th>" $2 "</th></tr>";} else { print "<tr><td>" $1 "</td><td>" $2 "</td></tr>"; }}'

The result is formatted into HTML rows and columns, and all I need to do is wrap it in a set of <table> tags.

I sometimes use Perl, too. Here’s a script I’ve saved in my PATH so I can pipe results into it:

use strict;
use warnings;

while (my $line = <STDIN>) {
    next LINE if $line =~ m/^\+/;
    chomp $line;
    if ($line =~ m/^\|/) {
        $line =~ s#^\| | \|$##g;
        chomp $line;
        print "<tr><td>"
            . join("</td><td>", split(/(?<=\S)\s+\|\s+(?=\S)/, $line))
            . "</td></tr>\n";
    else {
        print "<tr><td>"
            . join("</td><td>", split(/\t/, $line))
            . "</td></tr>\n";

Update Looks like the MySQL folks already did this work for me, duh. The -H option outputs HTML for query results.

See Also

I'm Baron Schwartz, the founder and CEO of VividCortex. I am the author of High Performance MySQL and lots of open-source software for performance analysis, monitoring, and system administration. I contribute to various database communities such as Oracle, PostgreSQL, Redis and MongoDB. More about me.