Schéma
Colonnes
Une colonne est un builder col.*, précisé par des modificateurs. Le builder détermine le
type Postgres ; les modificateurs définissent tout le reste : si la colonne peut être
nulle, sa valeur par défaut, sa validation, et qui peut la lire et l’écrire.
import { defineTable, col } from "@rebasepro/server/schema";
export const products = defineTable("products", { columns: { id: col.uuid().primaryKey().defaultRandom(), sku: col.varchar({ length: 32 }).notNull().unique(), name: col.text().notNull().validate({ min: 2, max: 120, trim: true }), price: col.numeric({ precision: 10, scale: 2 }).notNull().validate({ min: 0 }), status: col.enum(["draft", "active", "retired"]).notNull().default("draft"), tags: col.text().array().validate({ maxItems: 10 }), photo: col.storage({ path: "products/", accept: ["image/*"], maxBytes: "5MB" }), createdBy: col.uuid().onCreateUser().readOnly(), createdAt: col.timestamp({ withTimezone: true }).notNull().onCreateNow(), updatedAt: col.timestamp({ withTimezone: true }).notNull().onUpdateNow(), }, rls: "admin-only",});Les builders sont immuables : chaque modificateur renvoie un nouveau builder, de sorte qu’une colonne peut être déclarée une seule fois et partagée entre plusieurs tables.
Après le point, une colonne se lit comme le pg-core de Drizzle :
les mêmes noms de builders, un nom de colonne SQL optionnel en premier, puis
l’objet de configuration de Drizzle, puis le chaînage — col.varchar({ length: 32 }),
col.timestamp({ withTimezone: true }), col.text().array(),
.default(sql`now()`). Une syntaxe Drizzle qui signifierait autre chose ici
ne compilera pas, et l’erreur indiquera quoi écrire à la place. Deux différences à
garder à l’esprit :
- Une clé étrangère est une relation. Déclarez-la sous
relations:author: rel.belongsTo(() => users, { localKey: "author_id" }). La clé de la relation correspond à ce queincludenomme..references()n’existe pas, et le signale. Voir Relations. .defaultNow()est uniquement une valeur par défaut de base de données :DEFAULT now(), qu’un client peut toujours écraser..onCreateNow()est un stamp serveur : le serveur écrit l’heure à la création, peu importe ce que le client a envoyé.
Builders
Section intitulée « Builders »Un builder par type Postgres. Le type réseau est ce qu’un client lit dans une ligne et
envoie lors d’une écriture, et ce que le SDK et InferRow attribuent comme
type à la colonne. Chaque builder prend un nom de colonne SQL optionnel comme premier
argument (col.text("legacy_title")) ; sans celui-ci, le nom SQL correspond à la clé en
snake_case.
| Builder | Type Postgres | Type réseau | Notes |
|---|---|---|---|
col.uuid() |
UUID |
string |
.defaultRandom() pour gen_random_uuid() |
col.text() |
TEXT |
string |
col.text({ enum: [...] }) n’accepte que ces valeurs ; voir Ensembles de valeurs fermés |
col.varchar({ length }) |
VARCHAR(n) |
string |
la longueur est requise ; accepte aussi enum |
col.char({ length }) |
CHAR(n) |
string |
la longueur est requise ; accepte aussi enum |
col.enum(values) |
un type enum Postgres, <table>_<column> |
l’union de values |
voir Ensembles de valeurs fermés |
pgEnum(name, values), then status() |
un type enum Postgres nommé | l’union de values |
chaque colonne qui l’utilise partage ce même type |
col.smallint() |
SMALLINT |
number |
|
col.integer() |
INTEGER |
number |
|
col.bigint({ mode: "number" }) |
BIGINT |
number |
lu et écrit comme un nombre JavaScript |
col.smallserial() |
SMALLSERIAL |
number |
possède une valeur par défaut ; préférez col.smallint().generatedByDefaultAsIdentity() dans un nouveau schéma |
col.serial() |
SERIAL |
number |
possède une valeur par défaut ; préférez col.integer().generatedByDefaultAsIdentity() |
col.bigserial({ mode: "number" }) |
BIGSERIAL |
number |
possède une valeur par défaut ; préférez col.bigint({ mode: "number" }).generatedByDefaultAsIdentity() |
col.real() |
REAL |
number |
|
col.doublePrecision() |
DOUBLE PRECISION |
number |
|
col.numeric({ precision?, scale? }) |
NUMERIC, NUMERIC(p), NUMERIC(p, s) |
number |
une échelle nécessite une précision ; col.decimal() est le même builder |
col.boolean() |
BOOLEAN |
boolean |
|
col.timestamp({ withTimezone: true }) |
TIMESTAMPTZ |
string (ISO 8601) |
une écriture accepte également un Date ; un timestamp sans fuseau horaire s’écrit col.custom({ dataType: "timestamp" }) |
col.date() |
DATE |
string (YYYY-MM-DD) |
une écriture accepte également un Date |
col.time() |
TIME |
string (HH:MM:SS) |
une écriture accepte également un Date |
col.jsonb() / col.jsonb(shape) |
JSONB |
unknown (.$type<T>() le type), ou le type de la structure (shape) |
voir Documents JSON |
col.json() / col.json(shape) |
JSON |
comme jsonb |
conserve le texte fourni ; préférez jsonb |
<builder>.array() |
<inner>[] |
un tableau du type réseau interne | col.text().array() ; pas de tableaux de tableaux ; voir Tableaux |
col.vector({ dimensions, index? }) |
vector(dimensions) (pgvector) |
number[] |
un index cosinus HNSW sauf si index indique le contraire ; voir Recherche vectorielle |
col.bytea() |
BYTEA |
string (base64) |
|
col.geopoint() |
JSONB |
{ latitude: number; longitude: number } |
|
col.storage(options) |
TEXT |
string (le chemin du fichier) |
.multiple() en fait un TEXT[] ; voir Colonnes de stockage |
col.custom({ dataType }) |
tout autre type Postgres, tel quel ("inet", "citext") |
string (.$type<T>() le type) |
Rebase nomme le type dans le DDL et transmet les valeurs directement |
Modificateurs
Section intitulée « Modificateurs »Chaque builder dispose du premier groupe. Le reste n’existe que sur les builders pour lesquels cela a du sens ; appeler l’un d’eux ailleurs constitue une erreur de type.
| Modificateur | S’applique à | Base de données | API et types |
|---|---|---|---|
.notNull() |
chaque colonne | NOT NULL |
jamais null sur une ligne ; requis à la création sauf s’il possède une valeur par défaut |
.primaryKey() |
chaque colonne | fait partie de la clé primaire, NOT NULL |
absent du type Update |
.unique() |
chaque colonne | UNIQUE sur une seule colonne |
un doublon renvoie une 409 |
.default(value) |
chaque colonne | DEFAULT <value> |
également appliqué par le pilote à la création ; optionnel à la création |
.default(sql`expr`) |
chaque colonne | DEFAULT <expr> |
optionnel à la création ; sql est importé aux côtés de col |
.dbDefault() |
chaque colonne | laisse la valeur par défaut existante de la base de données inchangée | optionnel à la création |
.generatedAlwaysAs(sql`expr`) |
chaque colonne | GENERATED ALWAYS AS (<expr>) STORED |
jamais modifiable, par quiconque |
.$type<T>() |
chaque colonne | aucun | type la valeur pour TypeScript uniquement, comme dans Drizzle |
.array() |
chaque colonne | <type>[] |
voir Tableaux |
.readOnly() |
chaque colonne | aucun | écritures client refusées ; absent de Insert et Update |
.private() |
chaque colonne | aucun | jamais envoyé sur le réseau, dans le SDK ou dans OpenAPI |
.access({ read?, write? }) |
chaque colonne | aucun | lecture et écriture par rôle ; voir Accès aux champs |
.describe(text) |
chaque colonne | aucun | la description dans OpenAPI et MCP |
.validate(rules) |
chaque colonne | aucun | vérifié avant chaque écriture ; les règles dépendent du type, voir Validation |
.transform({ beforeSave?, afterRead? }) |
chaque colonne | aucun | hooks au niveau du champ ; value est T | null sauf si .notNull() précède ; voir Hooks de table |
.oneOf(values) |
colonnes numériques | aucun | seules ces valeurs sont acceptées ; typé comme leur union (une colonne texte prend { enum: [...] }) |
.defaultRandom() |
col.uuid() |
DEFAULT gen_random_uuid() |
optionnel à la création |
.generatedByDefaultAsIdentity() |
col.smallint(), col.integer(), col.bigint({ mode: "number" }) |
GENERATED BY DEFAULT AS IDENTITY |
optionnel à la création |
.defaultNow() |
timestamptz, date, time |
DEFAULT now() |
optionnel à la création ; un client peut toujours envoyer une valeur |
.onCreateNow() |
timestamptz, date, time |
DEFAULT now() |
le serveur applique l’horodatage à la création |
.onUpdateNow() |
timestamptz, date, time |
DEFAULT now() et un déclencheur BEFORE UPDATE |
le serveur applique l’horodatage à la création et à chaque mise à jour |
.onCreateUser() |
colonnes texte, col.uuid() |
aucun | le serveur écrit l’identifiant de l’appelant à la création |
.onUpdateUser() |
colonnes texte, col.uuid() |
aucun | le serveur écrit l’identifiant de l’appelant à chaque écriture |
.userId() |
colonnes texte, col.uuid() |
aucun | la colonne contient l’identifiant d’un utilisateur ; le panneau propose un sélecteur d’utilisateur ; voir Colonnes utilisateur |
.multiple() |
col.storage() |
TEXT[] |
la colonne contient plusieurs chemins de fichiers |
Null, requis et valeurs par défaut
Section intitulée « Null, requis et valeurs par défaut »Les colonnes acceptent les valeurs nulles par défaut. .notNull() et .primaryKey() rendent une colonne
NOT NULL, et l’API la rend alors obligatoire à la création sauf si elle a une valeur par défaut. Une
colonne NOT NULL est de type T sur une ligne ; toute autre colonne est de type T | null.
Une valeur par défaut peut être définie par .default(), .default(sql`…`), .defaultNow(),
.dbDefault(), .defaultRandom(), .generatedByDefaultAsIdentity(), un stamp
ou un builder de type serial. Une colonne ayant une valeur
par défaut peut être omise lors d’une création :
import { defineTable, col, sql } from "@rebasepro/server/schema";
export const tickets = defineTable("tickets", { columns: { id: col.integer().primaryKey().generatedByDefaultAsIdentity(), code: col.text().notNull().default(sql`gen_short_id()`), priority: col.smallint().notNull().default(3), legacy: col.text().dbDefault(), }, rls: "admin-only",});.default(value)est inscrit comme leDEFAULTde la colonne et est également appliqué par le pilote lors de la création, afin que la ligne soit identique quel que soit l’auteur de l’insertion. Une colonne temporelle accepte également unDate, stocké sous forme de chaîne ISO. La valeur par défaut d’une colonne enum doit faire partie de ses valeurs..default(sql`expression`)est évalué par Postgres. L’expression est inscrite telle quelle dans le DDL, donc la balisesqln’accepte pas de${…}..defaultNow()équivaut à.default(sql`now()`)..dbDefault()indique que la base de données possède déjà une valeur par défaut non déclarée dans le schéma. Une création peut omettre la colonne, et un push de schéma ne supprime pas cette valeur par défaut.
.generatedAlwaysAs() ne peut pas avoir de valeur par défaut ni de stamp : Postgres calcule la colonne
à chaque écriture. Une colonne de clé primaire ne peut pas être .private().
Un stamp est une valeur que le serveur écrit lui-même dans une colonne. Il écrase tout ce qu’un client pourrait envoyer pour cette colonne.
| Stamp | Écrit | Quand |
|---|---|---|
.onCreateNow() |
l’heure actuelle | à la création |
.onUpdateNow() |
l’heure actuelle | à la création et à chaque mise à jour |
.onCreateUser() |
l’identifiant utilisateur de l’appelant | à la création |
.onUpdateUser() |
l’identifiant utilisateur de l’appelant | à la création et à chaque mise à jour |
Une colonne ne peut comporter qu’un seul stamp. En appeler un second, différent, lève une exception lors du
chargement du module ; .onUpdateNow() applique déjà l’empreinte à la ligne lors de sa création.
Les colonnes avec stamp restent nullables à moins de spécifier .notNull().
.onCreateUser() permet d’attribuer sa valeur à une colonne qu’une règle de sécurité au niveau des lignes compare avec
l’appelant (ownerField). Une colonne remplie par l’appelant est une colonne sur laquelle l’appelant peut mentir.
Colonnes utilisateur
Section intitulée « Colonnes utilisateur ».userId() indique qu’une colonne contient l’identifiant d’un utilisateur. Il s’agit d’une sémantique, non d’un
type : la colonne reste text (ou varchar, char, uuid), et le
descripteur renvoyé par le serveur porte la mention semantic: "user".
import { defineTable, col } from "@rebasepro/server/schema";
export const tickets = defineTable("tickets", { columns: { id: col.uuid().primaryKey().defaultRandom(), subject: col.text().notNull(), assignedTo: col.text().userId().describe("Team member assigned to this ticket"), watchers: col.text().userId().array() }, rls: "admin-only"});Deux conséquences en découlent :
- Le panneau d’administration affiche un sélecteur d’utilisateur pour la colonne au lieu d’un champ texte, et affiche l’utilisateur plutôt que l’identifiant brut.
- Un appelant autorisé à écrire dans la table peut rechercher des utilisateurs pour la renseigner. La lecture du sélecteur lui répond même lorsque la sécurité au niveau des lignes lui masque les lignes des autres utilisateurs.
Cela fonctionne sur col.text(), col.varchar(), col.char() et col.uuid(),
sur les éléments d’un tableau (col.text().userId().array()), et sur
json.string() à l’intérieur d’un document JSON. Partout ailleurs, cela
lève une exception au chargement du module. Cela ne déclare aucune clé étrangère : écrivez
rel.belongsTo(() => users) lorsque la base de données doit en appliquer une. Pour que le
serveur renseigne la colonne avec l’identifiant de l’appelant, utilisez plutôt un stamp.
Validation
Section intitulée « Validation ».validate(rules) prend les règles associées au type de la colonne. L’API les vérifie
avant une création ou une mise à jour et refuse l’écriture avec une erreur 400 mentionnant le
nom de la colonne. Appeler .validate() deux fois fusionne les règles.
| Règle | Colonnes texte et col.storage() |
Colonnes numériques | timestamptz, date, time |
Tableaux |
|---|---|---|---|---|
min, max |
longueur | bornes inclusives | valeur minimale et maximale (chaîne ISO ou Date) |
|
length |
longueur exacte | |||
matches, matchesFlags, matchesMessage |
un motif (chaîne ou RegExp) et l’erreur |
|||
email, url |
la valeur est une adresse e-mail ou une URL | |||
trim, lowercase, uppercase |
la valeur est normalisée avant d’être stockée | |||
lessThan, moreThan |
bornes exclusives | |||
positive, negative, integer |
signe, nombre entier | |||
minItems, maxItems, uniqueItems |
nombre d’éléments, pas de doublons | |||
requiredMessage |
✓ | ✓ | ✓ | ✓ |
requiredMessage est l’erreur renvoyée lors d’une création si une colonne .notNull()
sans valeur par défaut est omise. Tous les autres types de colonne (uuid, enum, boolean,
JSON, vector, bytea, geopoint) acceptent uniquement requiredMessage.
Une RegExp est stockée sous forme de source et de drapeaux (flags), et une borne Date sous forme de sa
chaîne ISO, de sorte que les règles transmises sur le réseau sont celles que le serveur vérifie.
import { defineTable, col } from "@rebasepro/server/schema";
export const signups = defineTable("signups", { columns: { id: col.uuid().primaryKey().defaultRandom(), email: col.text().notNull().validate({ email: true, lowercase: true, trim: true, requiredMessage: "Enter your e-mail address." }), handle: col.varchar({ length: 32 }).validate({ matches: /^[a-z0-9_]+$/, matchesMessage: "Lower-case letters, digits and _ only." }), age: col.smallint().validate({ integer: true, min: 13 }), birthday: col.date().validate({ max: "2013-01-01" }), }, rls: "admin-only",});Sur col.varchar({ length }) et col.char({ length }), la longueur est imposée
par Postgres et par l’API. Une règle max qui en différerait entrerait en contradiction avec elle ; indiquez
la longueur une seule fois.
Ensembles de valeurs fermés
Section intitulée « Ensembles de valeurs fermés »Deux façons de n’accepter que certaines valeurs :
- Un type enum Postgres, afin que la base de données applique également la contrainte.
col.enum(values)en crée un nommé<table>_<column>. Un type avec un nom de votre choix, partagé par plusieurs colonnes, est déclaré une seule fois avecpgEnum(name, values)— comme dans Drizzle — et appelé dans chaque colonne :postStatus(). Deux déclarations portant le même nom doivent lister les mêmes valeurs dans le même ordre. - Un ensemble vérifié par l’API, sans type Postgres :
{ enum: [...] }surcol.text(),col.varchar()oucol.char(), et.oneOf(values)sur une colonne numérique. C’est également la syntaxe pour un tableau de chaînes connues :col.text({ enum: ["a", "b"] }).array().
Tous typent la colonne comme l’union de leurs valeurs : status ci-dessous est
"draft" | "published" sur la ligne, kind est "news" | "guide", et rating
est 1 | 2 | 3 | 4 | 5.
import { defineTable, col, pgEnum } from "@rebasepro/server/schema";
const reviewStatus = pgEnum("review_status", ["draft", "published"]);
export const reviews = defineTable("reviews", { columns: { id: col.uuid().primaryKey().defaultRandom(), status: reviewStatus().notNull().default("draft"), kind: col.text({ enum: ["news", "guide"] }), rating: col.smallint().notNull().oneOf([1, 2, 3, 4, 5]), labels: col.text({ enum: ["bug", "praise", "question"] }).array(), }, rls: "admin-only",});Les libellés et les couleurs associés aux valeurs relèvent de la présentation. Ils appartiennent au CMS, non à la table.
Tableaux
Section intitulée « Tableaux ».array() crée un tableau Postgres du type de la colonne, comme dans Drizzle :
col.text().array() donne TEXT[], col.integer().array() donne INTEGER[]. Ce qui
est chaîné avant .array() décrit chaque élément : son { enum }, .validate(),
.oneOf(), les options de stockage et .transform(). Ce qui vient après décrit
la colonne tableau elle-même : son propre .validate() accepte minItems, maxItems et
uniqueItems.
Les modificateurs qui décrivent une colonne (.notNull(), une valeur par défaut, .unique(),
.access()) se placent après .array() — col.text().array().notNull().default([]) ;
placés avant, ils ne compileront pas. Un tableau de tableaux est refusé ; utilisez
col.jsonb() pour les listes imbriquées. Un tableau contient des scalaires — texte, uuid, nombres,
booléens, dates, enums : un .array() de jsonb, json, vector, bytea,
geopoints ou col.custom() est refusé, et une liste de documents, de points ou
de vecteurs s’exprime par col.jsonb(json.array(…)). Un type de liste personnalisé est nommé tel quel :
col.custom({ dataType: "inet[]" }).
Chaque élément est renvoyé selon les règles de son type sur une colonne scalaire : un
élément timestamptz[] sous forme de chaîne RFC 3339, un élément numeric[] sous forme de nombre, et
un élément null sous forme de null.
Clés, identité et serials
Section intitulée « Clés, identité et serials ».generatedByDefaultAsIdentity() transforme une colonne d’entiers en GENERATED BY DEFAULT AS IDENTITY. C’est la syntaxe recommandée pour une clé entière dans un nouveau schéma
(.generatedAlwaysAsIdentity() ne compile pas : Rebase crée uniquement des identités par
défaut). Les builders serial (col.smallserial(), col.serial(),
col.bigserial({ mode: "number" })) existent pour les schémas qui
les utilisent déjà ; une colonne pointant vers une clé serial est un entier simple de
même taille. Voir Clés primaires pour les clés composites.
col.bigint({ mode: "number" }) est lu et écrit comme un number JavaScript
(le mode: "bigint" de Drizzle ne compile pas), qui est exact jusqu’à
2⁵³ − 1. col.numeric() est également un number, il transporte donc la précision d’un
double sur le réseau, quelle que soit la précision stockée par Postgres.
Qui peut lire et écrire une colonne
Section intitulée « Qui peut lire et écrire une colonne »La sécurité au niveau des lignes (RLS) détermine les lignes auxquelles un appelant a accès. Trois modificateurs restreignent ce qu’il peut voir d’une ligne et ce qu’il peut définir :
.readOnly()refuse toute écriture client sur la colonne, à la création comme à la mise à jour, quel que soit le rôle de l’appelant. La base de données (valeur par défaut, déclencheur) et le code serveur continuent de la renseigner. La colonne est absente des typesInsertetUpdate..private()conserve la colonne sur le serveur : absente de chaque ligne sur le réseau, du SDK, d’OpenAPI, et refusée dans les filtres et les tris. Les hooks et le code serveur la voient toujours. Une colonne privée ne peut pas déclarer en plus.access()..access({ read, write })liste les rôles qui reçoivent la colonne et les rôles qui peuvent y écrire. L’omission d’une liste laisse cette direction au niveau de la ligne ; une liste vide la verrouille pour tous les appelants.
Accès aux champs détaille ce qu’un appelant voit lorsqu’une colonne est retenue, ainsi que tous les points d’accès auxquels la règle s’applique.
Colonnes de stockage
Section intitulée « Colonnes de stockage »col.storage(options) contient le chemin d’un fichier dans un bucket de stockage. La route
de téléversement applique accept et maxBytes, et le nettoyage des fichiers orphelins considère le fichier
comme référencé tant qu’une ligne conserve son chemin. .multiple() permet à la colonne de contenir
plusieurs chemins (TEXT[]).
import { defineTable, col } from "@rebasepro/server/schema";
export const listings = defineTable("listings", { columns: { id: col.uuid().primaryKey().defaultRandom(), cover: col.storage({ path: "listings/{id}/", accept: ["image/*"], maxBytes: "10MB", imageResize: { maxWidth: 1600, format: "webp", quality: 80 } }), photos: col.storage({ path: "listings/{id}/gallery/", accept: ["image/*"] }).multiple(), terms: col.storage({ path: "listings/terms/", accept: ["application/pdf"], public: true }), }, rls: "admin-only",});| Option | Description |
|---|---|
path |
Requis. Emplacement des fichiers, sous forme de modèle de chemin : "posts/heroes/", "users/{id}/". |
source |
Le bucket, déclaré dans backend/resources.ts. Le bucket par défaut s’il est omis. |
accept |
Types MIME acceptés, avec caractères génériques : ["image/*", "application/pdf"]. |
maxBytes |
Taille maximale acceptée pour un fichier : un nombre d’octets ou une taille telle que "10MB", "512 kb", "1.5GB". Multiples binaires : 1 Mo vaut 1 048 576 octets. Une taille illisible lève une exception. |
imageResize |
Redimensionner les images avant de les stocker : maxWidth, maxHeight, mode ("contain" ou "cover"), format ("original", "jpeg", "png", "webp"), quality. |
public |
Les fichiers sont lisibles sans URL signée. |
fileName |
Le nom du fichier stocké, sous forme de modèle. Le nom d’origine téléversé s’il est omis. |
metadata |
Métadonnées stockées avec chaque fichier. |
includeBucketUrl |
Stocker l’URL du bucket devant le chemin. |
storeUrl |
Stocker l’URL de téléchargement au lieu du chemin. |
Une colonne de stockage accepte les règles de validation d’une colonne texte. Un fichier à l’intérieur d’un
document JSON utilise json.storage(), avec les mêmes options ; voir
Documents JSON. La gestion des permissions d’envoi et de téléchargement selon les chemins relève de
l’autorisation de stockage ; la distribution et la mise en
cache des fichiers sont traitées dans Stockage.
Ce qui est refusé
Section intitulée « Ce qui est refusé »Lors du chargement du module, un builder lève une exception en cas de :
col.varchar()oucol.char()sans longueur ; unelengthou desdimensionsqui ne sont pas un entier positif, etcol.numeric({ scale })sans précision ;col.enum([]),pgEnum(name, { … }), et un.array()de tableau ;- une valeur par défaut ou expression générée
sqlavec une interpolation ; - un second stamp différent sur une même colonne, et
.oneOf()avec une valeur qui n’est ni une chaîne ni un nombre ; .access()dontreadouwriten’est pas une liste de noms de rôles non vides ;col.storage()sanspath, ou avec unmaxBytesqui n’est pas une taille valide.
Lors de la compilation du schéma, la table est refusée en cas de :
- valeur par défaut combinée à
.generatedAlwaysAs(), ou stamp combiné à celui-ci ; .generatedByDefaultAsIdentity()sur une colonne non entière,.defaultRandom()sur une colonne non-uuid, stamp temporel sur une colonne non temporelle, stamp utilisateur sur une colonne qui n’est ni du texte ni unuuid;- clé primaire
.private(), ou clé primaire de typetimestamptzoutime; - clé primaire sur une colonne
jsonb,json, geopoint,vector,bytea, tableau ou liste personnalisée : une clé est un scalaire (texte,varchar,char,uuid, un enum, un nombre, un booléen ou une date).schema introspectignore une table ayant une telle clé et en explique la raison ; .array()dejsonb,json,vector,bytea, geopoints oucol.custom()(voir Tableaux) ;- règle
.validate()que le type de colonne, ses éléments ou un nœud JSON ne prennent pas en charge (integersur une colonne texte,trimsur un nombre,minItemssur un scalaire) ; - colonne qui est à la fois
.private()et.access(); .transform()sur une colonne et un autre sur sa structure JSON ;col.custom({ dataType })dont le nom de type ne correspond pas à la forme d’un nom de type Postgres ;.oneOf([]), et.oneOf()sur une colonne qui n’est ni texte ni numérique ;- enum avec une valeur vide ou en double, ou une valeur par défaut qui ne fait pas partie de ses valeurs ;
- deux clés qui correspondent à la même colonne SQL, y compris après troncature des noms à 63 octets par Postgres ;
- type enum nommé auquel ont été fournies deux listes de valeurs différentes.
Chaque refus indique la table, la colonne et ce qu’il convient d’écrire à la place.
Les syntaxes Drizzle qui signifieraient autre chose ici ne compilent pas, et le
compilateur affiche quoi écrire : col.timestamp() sans withTimezone: true,
.references(), .$defaultFn(), .$onUpdate(), .generatedAlwaysAsIdentity(),
.unique("name"), le mode: "string" de numeric, ainsi que col.inet(), col.interval()
et les autres types que Rebase ne nomme qu’à travers col.custom({ dataType }).
Prochaines étapes
Section intitulée « Prochaines étapes »- Documents JSON : la structure d’une colonne
jsonb - Relations : les clés étrangères proviennent de
rel.*, non des colonnes - Accès aux champs :
.access(),.private()et.readOnly()en détail - Inférence de types : l’effet de chaque modificateur sur
InferRowetInferInsert