Clear ORM
Search…
⌃K

Primary Keys

Clear needs your model to define a primary key column. By default, Clear can handle properly int, bigint, string and uuid primary keys.
As time of writing this manual, compound primary keys are not handled properly.

primary_key helper

Clear offers a built-in primary_key helper which will define your primary key without hassle:
class Product
include Clear::Model
self.table = "products"
primary_key name: "product_id", type: :uuid
end
  • name is the name of your column in your table. (Default: id)
  • type is the type of the column in your table. Set to (Default: bigserial).
  • By default, types can be of type bigserial, serial, int, bigint, text and uuid.
Note than primary_key directive in the model class is just a fast way of writing:
column id : Int64, primary: true, presence: false
The primary key name is ID, of type bigint and it won't check the presence on save because it has default value
In case of uuid, Clear will generate a new uuid at every new object creation before inserting it into the database.