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

CData Cloud Hub uses a straightforward, point-and-click interface to connect to data sources and generate APIs.

  1. Login to Cloud Hub and click Databases.
  2. Select "Amazon S3" from Available Data Sources.
  3. Enter the necessary authentication properties to connect to Amazon S3.

    To authorize Amazon S3 requests, provide the credentials for an administrator account or for an IAM user with custom permissions. Set AccessKey to the access key Id. Set SecretKey to the secret access key.

    Note: You can connect as the AWS account administrator, but it is recommended to use IAM user credentials to access AWS services.

    For information on obtaining the credentials and other authentication methods, refer to the Getting Started section of the Help documentation.

  4. Click Test Database.
  5. Click Privileges -> Add and add the new user (or an existing user) with the appropriate permissions.

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 (myinstance.cdatacloud.net) 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     : 'myinstance.cdatacloud.net',
  database : 'amazons3db',
  port	   : '3306',
  user     : 'admin',
  password : 'password',
  ssl      : {
    ca : fs.readFileSync('C:/certs/myCA.pem')
  }
});
connection.connect();
connection.query('SELECT * FROM ObjectsACL', function(err, rows, fields) {
  if (err) throw err;
  console.log(rows);
});

connection.end();