README.md

Connecting C++ and CrateDB with ADBC

Instructions

Tip

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

Prerequisites

1. Install Pixi

2. Install dbc

Set up CrateDB

1. Install Docker

2. Start a CrateDB instance:

   docker run -d --rm --name cratedb -p 4200:4200 -p 5432:5432 crate -Cdiscovery.type=single-node

Connect to CrateDB

1. Install the PostgreSQL ADBC driver:

   dbc install --level user postgresql

2. Customize the C++ program main.cpp as needed

   • Change the connection arguments in the AdbcDatabaseSetOption() calls
     • Format uri according to the connection URI format used by PostgreSQL, or keep it as is
   • If you changed which database you're connecting to, also change the SQL SELECT statement in AdbcStatementSetSqlQuery()

3. Build and run the C++ program:

   Using Make:

   pixi run make
   ./cratedb_demo

   Or using CMake:

   pixi run cmake -B build
   pixi run cmake --build build
   ./build/cratedb_demo

Clean up

1. Clean build artifacts:

   Using Make:

   pixi run make clean

   Using CMake:

   rm -rf build

2. Stop the Docker container running CrateDB:

   docker stop cratedb