go-dbhub

Run read-only queries (eg SELECT statements) on databases, returning the results as JSON
List the names of tables, views, and indexes present in a database
List the columns present in a table or view, along with their details

Still to do

Tests for each function
Retrieve index details for a database
Return the list of available databases
Download a complete database
Upload a complete database
Retrieve database commit history details (size, branch, commit list, whatever else is useful)

Requirements

Go version 1.14.x
- Older Go releases should be ok, but only Go 1.14.x has been tested (so far).
A DBHub.io API key
- These can be generated in your Settings page, when logged in.

Example code

// Create a new DBHub.io API object
db, err := dbhub.New("YOUR_API_KEY_HERE")
if err != nil {
    log.Fatal(err)
}

// Retrieve the list of tables in the remote database
tables, err := db.Tables("justinclift", "Join Testing.sqlite")
if err != nil {
    log.Fatal(err)
}

// Display the retrieved list of tables
fmt.Println("Tables:")
for _, j := range tables {
    fmt.Printf("  * %s\n", j)
}

// Run a SQL query on the remote database
r, err := db.Query("justinclift", "Join Testing.sqlite", false,
    `SELECT table1.Name, table2.value
        FROM table1 JOIN table2
        USING (id)
        ORDER BY table1.id`)
if err != nil {
    log.Fatal(err)
}
fmt.Printf("Query results (JSON):\n\t%v\n", r)
fmt.Println()

Output

Tables:
  * table1
  * table2

Query results (JSON):
        {[{[Foo 5]} {[Bar 10]} {[Baz 15]} {[Blumph 12.5000]} {[Blargo 8]} {[Batty 3]}]}

Further examples

SQL Query - Run a SQL query, return the results as JSON
List tables - List the tables present in a database
List views - List the views present in a database
List indexes - List the indexes present in a database
Retrieve column details - Retrieve the details of columns in a table
Generate diff between two revisions - Figure out the differences between two databases or two versions of one database

Please try it out, submits PRs to extend or fix things, and report any weirdness or bugs you encounter. 😄