`sqlgen::PrimaryKey`

sqlgen::PrimaryKey is used to indicate which key should be a primary key.

Usage

Basic Definition

Define a primary key field in your struct:

struct People {
    sqlgen::PrimaryKey<std::string> first_name;
    std::string last_name;
    uint age;
};

This generates the following SQL schema:

CREATE TABLE IF NOT EXISTS "People"(
    "first_name" TEXT NOT NULL, 
    "last_name"  TEXT NOT NULL, 
    "age"        INTEGER NOT NULL,
    PRIMARY_KEY("first_name")
);

Auto-incrementing Primary Keys

You can define an auto-incrementing primary key by providing sqlgen::auto_incr as the second template argument to sqlgen::PrimaryKey. The underlying type of an auto-incrementing primary key must be an integral type.

struct Person {
  sqlgen::PrimaryKey<uint32_t, sqlgen::auto_incr> id;
  std::string first_name;
  std::string last_name;
  int age;
};

This will produce SQL schema with an auto-incrementing primary key. For instance, for PostgreSQL it will generate:

CREATE TABLE IF NOT EXISTS "Person"(
    "id"         INTEGER GENERATED ALWAYS AS IDENTITY,
    "first_name" TEXT NOT NULL, 
    "last_name"  TEXT NOT NULL, 
    "age"        INTEGER NOT NULL,
    PRIMARY KEY("id")
);

And for SQLite:

CREATE TABLE IF NOT EXISTS "Person"(
    "id"         INTEGER PRIMARY KEY AUTOINCREMENT, 
    "first_name" TEXT NOT NULL, 
    "last_name"  TEXT NOT NULL, 
    "age"        INTEGER NOT NULL
);

When you insert an object with an auto-incrementing primary key, you do not need to provide a value for the key field. The database will automatically assign a unique, incrementing value.

auto homer = Person{.first_name = "Homer", .last_name = "Simpson", .age = 45};
// The 'id' field is not set.

// After writing to the database and reading it back, the 'id' will be populated.
auto people = std::vector<Person>({homer});
auto result = conn.and_then(sqlgen::write(std::ref(people)))
                  .and_then(sqlgen::read<std::vector<Person>>())
                  .value();

// result[0].id will now have a value, for instance 1.

Assignment and Access

Assign values to primary key fields:

const auto person = People{
    .first_name = "Homer",
    .last_name = "Simpson",
    .age = 45
};

Access the underlying value using any of these methods:

person.first_name();
person.first_name.get();
person.first_name.value();

Notes

The template parameter specifies the type of the primary key field
Primary key fields are automatically marked as NOT NULL in the generated SQL
Auto-incrementing primary keys must have an integral type.
The class supports:
- Direct value assignment
- Multiple access methods for the underlying value
- Reflection for SQL operations
- Move and copy semantics
Primary keys can be used with any supported SQL data type

2.8 KiB Raw Blame History

sqlgen::PrimaryKey