Ready to get started?

Learn more about CData Cloud Hub or sign up for a free trial:

Learn More

Query Amazon S3 Data as a MySQL Database in Node.js

Execute MySQL queries against Amazon S3 data from Node.js.

You can use the CData Cloud Hub to query Amazon S3 data through a MySQL interface. Follow the procedure below to create a virtual database for Amazon S3 in the Cloud Hub and start querying using Node.js.

The CData Cloud Hub provides a pure MySQL, cloud-to-cloud interface for Amazon S3, allowing you to easily query live Amazon S3 data in Node.js — without replicating the data to a natively supported database. As you query data in Node.js, the CData Cloud Hub pushes all supported SQL operations (filters, JOINs, etc) directly to Amazon S3, leveraging server-side processing to quickly return Amazon S3 data.

Create a Virtual MySQL Database for Amazon S3 Data

You can use any MySQL client to connect to the CData Cloud Hub and create virtual databases.

  1. Connect to the CData Cloud Hub:
    mysql --host --user admin --password
  2. Once authenticated, create the virtual database for Amazon S3:
    mysql> CREATE DATABASE amazons3db
        -> DRIVER = "AmazonS3",
        -> DBURL = "AccessKey=a123;SecretKey=s123;";

With the virtual database created, you are ready to connect to Amazon S3 data from any MySQL client.

Query Amazon S3 from Node.js

The following example shows how to define a connection and execute queries to Amazon S3 with the MySQL module. You will need the following information:

  • Host name, or address, and port: The address of your instance of the Cloud Hub ( and the port (3306)
  • Username and password: The username and password of a user you authorized on the Cloud Hub
  • Database name: The database you configured for Amazon S3 (amazons3db)

Connect to Amazon S3 data and start executing queries with the code below:

var mysql      = require('mysql');
var fs         = require('fs');
var connection = mysql.createConnection({
  host     : '',
  database : 'amazons3db',
  port	   : '3306',
  user     : 'admin',
  password : 'password',
  ssl      : {
    ca : fs.readFileSync('C:/certs/myCA.pem')
connection.query('SELECT * FROM ObjectsACL', function(err, rows, fields) {
  if (err) throw err;