Comments:"jackdb/jackdb-heroku-plugin · GitHub"
URL:https://github.com/jackdb/jackdb-heroku-plugin
JackDB Heroku Plugin
Extends heroku command-line to query and visualize Heroku data sources on JackDB.
Installation
$ heroku plugins:install https://github.com/jackdb/jackdb-heroku-plugin.gitUsage
$ heroku help jackdb
Usage: heroku jackdb
Open a database in JackDB
This will search through your app config for the valid database url and try to connect to it.
If you have more than one database then use one of the "jackdb:" commands to connect to a specific one.
Additional commands, type "heroku help COMMAND" for more details:
jackdb:cleardb # Opens a ClearDB MySQL database in JackDB
jackdb:mysql [CONFIG_VAR] # Opens a MySQL database in JackDB
jackdb:pg [DATABASE] # Opens a PostgreSQL database in JackDB
jackdb:xeround # Opens a Xeround MySQL database in JackDBExamples
Open up the default database in JackDB (the plugin searches for the first valid database URL):
$ heroku jackdbOpen up the default PostgreSQL database in JackDB:
$ heroku jackdb:pgOpen up a specific PostgreSQL database in JackDB:
$ heroku jackdb:pg COPPEROpen up the default MySQL database in JackDB:
$ heroku jackdb:mysqlWhat types of databases does it support?
The JackDB Heroku plugin currently supports PostgreSQL, MySQL, and MariaDB databases.
JackDB supports a number of other data source types. For more details, see here.
Can I use this for other types of databases?
We're working on adding support for additional data sources. Let us know what data sources you'd like us to support next.
Networking & Firewall
The plugin has been tested with Heroku Postgres, Xeround MySQL, and ClearDB MySQL and works without any additional setup with all three.
If your database is behind a firewall, you will need to open up the appropriate ports to allow JackDB to access it. For details, see here.
Can I use this with a database running on my local machine or network?
Not yet, but we're working on it. JackDB connects directly to your database so it's not currently possible to reach databases that are behind a firewall.
How does it work?
The plugin works in three steps.
First the plugin identifies the database to connect to. By default, the plugin attempts to get configuration details for the PostgreSQL database in the Heroku configuration property DATABASE_URL. The plugin's other commands change where to look for a database configuration and what type of configuration to look for.
Then, if the plugin finds a valid database configuration, it sends a POST request to JackDB with the config information for your database. The JackDB server:
The encryption key used to encrypt your database configuration details is not saved by JackDB, and is only sent in response to the plugin's POST request.
Finally, the plugin then generates a URL to log in directly to JackDB using the token from the previous step and opens using your default web browser. If you're already logged into JackDB, then we'll immediately connect you to your data source. If not, then you'll be sent to the login page.
If your browser does not open automatically, the URL is also printed.
No attempt to connect to your data source is made until after you log in and open the URL in your browser.
Do I need to install JackDB?
No. JackDB works entirely in your web browser.
Is it secure?
All data transfer is done using SSL and the encryption key to decrypt your data source configuration is not persisted anywhere on the JackDB server. See here for more on how JackDB handles security.
Why does it say my token is expired?
The connection tokens expire after a couple of minutes (currently five) and the server rejects connection attempts for expired tokens. If you receive this error then try running the plugin command again and it should work.
License
The source code for this plugin is released under the MIT license. See the file LICENSE.
Use of this plugin with JackDB's services shall be subject to the Terms of Service.
Copyright
Copyright © 2013 JackDB, Inc.