README.md

Connecting JavaScript and MariaDB with ADBC

Instructions

Tip

If you already have a MariaDB instance running, skip the steps to set up and clean up MariaDB.

Prerequisites

1. Install Node.js (version 22 or later)

   • Alternatively, you can use Bun or Deno

2. Install dbc

Set up MariaDB

1. Install Docker

2. Start a MariaDB instance:

   docker run --detach --name some-mariadb -p 3306:3306 --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest

Connect to MariaDB

1. Install the MySQL ADBC driver:

   dbc install mysql

2. Install dependencies:

   npm --prefix ../.. install

3. Customize the script main.js as needed

   • Change the connection arguments in databaseOptions
     • Format uri according to the DSN (Data Source Name) format used by Go-MySQL-Driver, or keep it as is
   • If you changed which database you're connecting to, also change the SQL SELECT statement in conn.query()

4. Run the script:

   Node.js:

   node main.js

   Bun:

   bun run main.js

   Deno:

   deno run --allow-ffi --allow-env main.js

Clean up

Stop the Docker container running MariaDB:

docker stop some-mariadb