mirror of
https://github.com/postgres/postgres.git
synced 2026-04-24 23:57:18 -04:00
a35c5b7c1f
The previous way of reconstructing check constraints was to do a separate "ALTER TABLE ONLY tab ADD CONSTRAINT" for each table in an inheritance hierarchy. However, that way has no hope of reconstructing the check constraints' own inheritance properties correctly, as pointed out in bug #13779 from Jan Dirk Zijlstra. What we should do instead is to do a regular "ALTER TABLE", allowing recursion, at the topmost table that has a particular constraint, and then suppress the work queue entries for inherited instances of the constraint. Annoyingly, we'd tried to fix this behavior before, in commit5ed6546cf, but we failed to notice that it wasn't reconstructing the pg_constraint field values correctly. As long as I'm touching pg_get_constraintdef_worker anyway, tweak it to always schema-qualify the target table name; this seems like useful backup to the protections installed by commit5f173040. In HEAD/9.5, get rid of get_constraint_relation_oids, which is now unused. (I could alternatively have modified it to also return conislocal, but that seemed like a pretty single-purpose API, so let's not pretend it has some other use.) It's unused in the back branches as well, but I left it in place just in case some third-party code has decided to use it. In HEAD/9.5, also rename pg_get_constraintdef_string to pg_get_constraintdef_command, as the previous name did nothing to explain what that entry point did differently from others (and its comment was equally useless). Again, that change doesn't seem like material for back-patching. I did a bit of re-pgindenting in tablecmds.c in HEAD/9.5, as well. Otherwise, back-patch to all supported branches.
258 lines
8 KiB
C
258 lines
8 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* pg_constraint.h
|
|
* definition of the system "constraint" relation (pg_constraint)
|
|
* along with the relation's initial contents.
|
|
*
|
|
*
|
|
* Portions Copyright (c) 1996-2015, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/catalog/pg_constraint.h
|
|
*
|
|
* NOTES
|
|
* the genbki.pl script reads this file and generates .bki
|
|
* information from the DATA() statements.
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef PG_CONSTRAINT_H
|
|
#define PG_CONSTRAINT_H
|
|
|
|
#include "catalog/genbki.h"
|
|
#include "catalog/dependency.h"
|
|
#include "nodes/pg_list.h"
|
|
|
|
/* ----------------
|
|
* pg_constraint definition. cpp turns this into
|
|
* typedef struct FormData_pg_constraint
|
|
* ----------------
|
|
*/
|
|
#define ConstraintRelationId 2606
|
|
|
|
CATALOG(pg_constraint,2606)
|
|
{
|
|
/*
|
|
* conname + connamespace is deliberately not unique; we allow, for
|
|
* example, the same name to be used for constraints of different
|
|
* relations. This is partly for backwards compatibility with past
|
|
* Postgres practice, and partly because we don't want to have to obtain a
|
|
* global lock to generate a globally unique name for a nameless
|
|
* constraint. We associate a namespace with constraint names only for
|
|
* SQL-spec compatibility.
|
|
*/
|
|
NameData conname; /* name of this constraint */
|
|
Oid connamespace; /* OID of namespace containing constraint */
|
|
char contype; /* constraint type; see codes below */
|
|
bool condeferrable; /* deferrable constraint? */
|
|
bool condeferred; /* deferred by default? */
|
|
bool convalidated; /* constraint has been validated? */
|
|
|
|
/*
|
|
* conrelid and conkey are only meaningful if the constraint applies to a
|
|
* specific relation (this excludes domain constraints and assertions).
|
|
* Otherwise conrelid is 0 and conkey is NULL.
|
|
*/
|
|
Oid conrelid; /* relation this constraint constrains */
|
|
|
|
/*
|
|
* contypid links to the pg_type row for a domain if this is a domain
|
|
* constraint. Otherwise it's 0.
|
|
*
|
|
* For SQL-style global ASSERTIONs, both conrelid and contypid would be
|
|
* zero. This is not presently supported, however.
|
|
*/
|
|
Oid contypid; /* domain this constraint constrains */
|
|
|
|
/*
|
|
* conindid links to the index supporting the constraint, if any;
|
|
* otherwise it's 0. This is used for unique, primary-key, and exclusion
|
|
* constraints, and less obviously for foreign-key constraints (where the
|
|
* index is a unique index on the referenced relation's referenced
|
|
* columns). Notice that the index is on conrelid in the first case but
|
|
* confrelid in the second.
|
|
*/
|
|
Oid conindid; /* index supporting this constraint */
|
|
|
|
/*
|
|
* These fields, plus confkey, are only meaningful for a foreign-key
|
|
* constraint. Otherwise confrelid is 0 and the char fields are spaces.
|
|
*/
|
|
Oid confrelid; /* relation referenced by foreign key */
|
|
char confupdtype; /* foreign key's ON UPDATE action */
|
|
char confdeltype; /* foreign key's ON DELETE action */
|
|
char confmatchtype; /* foreign key's match type */
|
|
|
|
/* Has a local definition (hence, do not drop when coninhcount is 0) */
|
|
bool conislocal;
|
|
|
|
/* Number of times inherited from direct parent relation(s) */
|
|
int32 coninhcount;
|
|
|
|
/* Has a local definition and cannot be inherited */
|
|
bool connoinherit;
|
|
|
|
#ifdef CATALOG_VARLEN /* variable-length fields start here */
|
|
|
|
/*
|
|
* Columns of conrelid that the constraint applies to, if known (this is
|
|
* NULL for trigger constraints)
|
|
*/
|
|
int16 conkey[1];
|
|
|
|
/*
|
|
* If a foreign key, the referenced columns of confrelid
|
|
*/
|
|
int16 confkey[1];
|
|
|
|
/*
|
|
* If a foreign key, the OIDs of the PK = FK equality operators for each
|
|
* column of the constraint
|
|
*/
|
|
Oid conpfeqop[1];
|
|
|
|
/*
|
|
* If a foreign key, the OIDs of the PK = PK equality operators for each
|
|
* column of the constraint (i.e., equality for the referenced columns)
|
|
*/
|
|
Oid conppeqop[1];
|
|
|
|
/*
|
|
* If a foreign key, the OIDs of the FK = FK equality operators for each
|
|
* column of the constraint (i.e., equality for the referencing columns)
|
|
*/
|
|
Oid conffeqop[1];
|
|
|
|
/*
|
|
* If an exclusion constraint, the OIDs of the exclusion operators for
|
|
* each column of the constraint
|
|
*/
|
|
Oid conexclop[1];
|
|
|
|
/*
|
|
* If a check constraint, nodeToString representation of expression
|
|
*/
|
|
pg_node_tree conbin;
|
|
|
|
/*
|
|
* If a check constraint, source-text representation of expression
|
|
*/
|
|
text consrc;
|
|
#endif
|
|
} FormData_pg_constraint;
|
|
|
|
/* ----------------
|
|
* Form_pg_constraint corresponds to a pointer to a tuple with
|
|
* the format of pg_constraint relation.
|
|
* ----------------
|
|
*/
|
|
typedef FormData_pg_constraint *Form_pg_constraint;
|
|
|
|
/* ----------------
|
|
* compiler constants for pg_constraint
|
|
* ----------------
|
|
*/
|
|
#define Natts_pg_constraint 24
|
|
#define Anum_pg_constraint_conname 1
|
|
#define Anum_pg_constraint_connamespace 2
|
|
#define Anum_pg_constraint_contype 3
|
|
#define Anum_pg_constraint_condeferrable 4
|
|
#define Anum_pg_constraint_condeferred 5
|
|
#define Anum_pg_constraint_convalidated 6
|
|
#define Anum_pg_constraint_conrelid 7
|
|
#define Anum_pg_constraint_contypid 8
|
|
#define Anum_pg_constraint_conindid 9
|
|
#define Anum_pg_constraint_confrelid 10
|
|
#define Anum_pg_constraint_confupdtype 11
|
|
#define Anum_pg_constraint_confdeltype 12
|
|
#define Anum_pg_constraint_confmatchtype 13
|
|
#define Anum_pg_constraint_conislocal 14
|
|
#define Anum_pg_constraint_coninhcount 15
|
|
#define Anum_pg_constraint_connoinherit 16
|
|
#define Anum_pg_constraint_conkey 17
|
|
#define Anum_pg_constraint_confkey 18
|
|
#define Anum_pg_constraint_conpfeqop 19
|
|
#define Anum_pg_constraint_conppeqop 20
|
|
#define Anum_pg_constraint_conffeqop 21
|
|
#define Anum_pg_constraint_conexclop 22
|
|
#define Anum_pg_constraint_conbin 23
|
|
#define Anum_pg_constraint_consrc 24
|
|
|
|
|
|
/* Valid values for contype */
|
|
#define CONSTRAINT_CHECK 'c'
|
|
#define CONSTRAINT_FOREIGN 'f'
|
|
#define CONSTRAINT_PRIMARY 'p'
|
|
#define CONSTRAINT_UNIQUE 'u'
|
|
#define CONSTRAINT_TRIGGER 't'
|
|
#define CONSTRAINT_EXCLUSION 'x'
|
|
|
|
/*
|
|
* Valid values for confupdtype and confdeltype are the FKCONSTR_ACTION_xxx
|
|
* constants defined in parsenodes.h. Valid values for confmatchtype are
|
|
* the FKCONSTR_MATCH_xxx constants defined in parsenodes.h.
|
|
*/
|
|
|
|
/*
|
|
* Identify constraint type for lookup purposes
|
|
*/
|
|
typedef enum ConstraintCategory
|
|
{
|
|
CONSTRAINT_RELATION,
|
|
CONSTRAINT_DOMAIN,
|
|
CONSTRAINT_ASSERTION /* for future expansion */
|
|
} ConstraintCategory;
|
|
|
|
/*
|
|
* prototypes for functions in pg_constraint.c
|
|
*/
|
|
extern Oid CreateConstraintEntry(const char *constraintName,
|
|
Oid constraintNamespace,
|
|
char constraintType,
|
|
bool isDeferrable,
|
|
bool isDeferred,
|
|
bool isValidated,
|
|
Oid relId,
|
|
const int16 *constraintKey,
|
|
int constraintNKeys,
|
|
Oid domainId,
|
|
Oid indexRelId,
|
|
Oid foreignRelId,
|
|
const int16 *foreignKey,
|
|
const Oid *pfEqOp,
|
|
const Oid *ppEqOp,
|
|
const Oid *ffEqOp,
|
|
int foreignNKeys,
|
|
char foreignUpdateType,
|
|
char foreignDeleteType,
|
|
char foreignMatchType,
|
|
const Oid *exclOp,
|
|
Node *conExpr,
|
|
const char *conBin,
|
|
const char *conSrc,
|
|
bool conIsLocal,
|
|
int conInhCount,
|
|
bool conNoInherit,
|
|
bool is_internal);
|
|
|
|
extern void RemoveConstraintById(Oid conId);
|
|
extern void RenameConstraintById(Oid conId, const char *newname);
|
|
extern void SetValidatedConstraintById(Oid conId);
|
|
|
|
extern bool ConstraintNameIsUsed(ConstraintCategory conCat, Oid objId,
|
|
Oid objNamespace, const char *conname);
|
|
extern char *ChooseConstraintName(const char *name1, const char *name2,
|
|
const char *label, Oid namespaceid,
|
|
List *others);
|
|
|
|
extern void AlterConstraintNamespaces(Oid ownerId, Oid oldNspId,
|
|
Oid newNspId, bool isType, ObjectAddresses *objsMoved);
|
|
extern Oid get_relation_constraint_oid(Oid relid, const char *conname, bool missing_ok);
|
|
extern Oid get_domain_constraint_oid(Oid typid, const char *conname, bool missing_ok);
|
|
|
|
extern bool check_functional_grouping(Oid relid,
|
|
Index varno, Index varlevelsup,
|
|
List *grouping_columns,
|
|
List **constraintDeps);
|
|
|
|
#endif /* PG_CONSTRAINT_H */
|