HDX Reader


The HDXReader utility is available exclusively via the AWS Marketplace. Once the instance is running, access your instance via SSH using the username ‘ubuntu’ and your Amazon private key.


Initalize the HDXReader app by running the script “enable-hdxreader”. The enable-hdxreader script requires 3 arguments: The name of the S3 region and the name of the S3 bucket you wish to search, along with the path within that bucket where the HDX data resides. For example:

sudo enable-hdxreader {region} {bucket} {path}

If you do not yet have any private data stored in HDX format, you can test out HDXReader by pointing at the hdx-public bucket in us-east-2:

sudo enable-hdxreader us-east-2 hdx-public /hdxformat/sample_project/

If you wish to test HDXReader locally, you are invited to copy the contents of this bucket to your local S3 account.


You can issue SQL queries against your data by running the script “hdxsql”:

hdxsql "select * from sample_project.sample_table limit 1" | less