| Prev | Chapter 12. Engineering Standards | Next |
|---|
By Michael Bryzek
-</authorblurb> - -+
Constraint naming standard is important for one reason: The SYS_* name oracle assigns to unnamed constraints is not very understandable. By correctly naming all constraints, we can quickly associate a particular constraint with our data model. This gives us two real advantages: -
- -We can quickly identify and fix any errors.
We can reliability modify or drop constraints
-Why do we need a naming convention? +
We can quickly identify and fix any errors.
We can reliability modify or drop constraints
+
Oracle limits names, in general, to 30 characters, which is hardly enough for a human readable constraint name. -
- -We propose the following naming convention for all constraints, with the following abbreviations taken from Oracle Docs. Note that we shortened all of the constraint abbreviations to two characters to save room. -
- -| Constraint type | Abbreviation |
|---|---|
| references (foreign key) | fk |
| unique | un |
| primary key | pk |
| check | ck |
| not null | nn |
| index | idx |
+
| Constraint type | Abbreviation |
|---|---|
| references (foreign key) | fk |
| unique | un |
| primary key | pk |
| check | ck |
| not null | nn |
| index | idx |
<table name>_<column_name>_<constraint abbreviation> -
- -+
In reality, this won't be possible because of the character limitation on names inside oracle. When the name is too long, we will follow these two steps in order: -
- -Abbreviate the table name with the table's initials (e.g. users -> u and users_contact -> uc). -
Truncate the column name until it fits.
+
Abbreviate the table name with the table's initials (e.g. users -> u and users_contact -> uc). +
Truncate the column name until it fits.
If the constraint name is still too long, you should consider rewriting your entire data model :) -
- -Notes:
- -If you have to abbreviate the table name for one of the constraints, abbreviate it for all the constraints
If you are defining a multi column constraint, try to truncate the two column names evenly
+Notes:
If you have to abbreviate the table name for one of the constraints, abbreviate it for all the constraints
If you are defining a multi column constraint, try to truncate the two column names evenly
create table example_topics (
topic_id integer
constraint example_topics_topic_id_pk
@@ -98,20 +50,11 @@
constraint cne_example_id_one_line_unq unique(example_id, one_line_description)
);
-
-
-Naming primary keys might not have any obvious advantages. However, here's an example where naming the primary key really helps (and this is by no means a rare case! -
- -+SQL> set autotrace traceonly explain; @@ -123,39 +66,20 @@ 0 SELECT STATEMENT Optimizer=CHOOSE 1 0 NESTED LOOPS 2 1 TABLE ACCESS (FULL) OF 'CONSTRAINT_NAMING_EXAMPLE' - 3 1 INDEX (UNIQUE SCAN) OF 'EXAMPLE_TOPICS_TOPIC_ID_PK' (UNI - QUE) -- -+ 3 1 INDEX (UNIQUE SCAN) OF 'EXAMPLE_TOPICS_TOPIC_ID_PK' (UNIQUE) +
Isn't it nice to see "EXAMPLE_TOPICS_TOPIC_ID_PK" in the trace and know exactly which table oracle is using at each step? -
- -People disagree on whether or not we should be naming not null constraints. So, if you want to name them, please do so and follow the above naming standard. But, naming not null constraints is not a requirement. -
- --About Naming the not null constraints -
--Though naming "not null" constraints doesn't help immeditately in error +
+
+
+Though naming "not null" constraints doesn't help immediately in error debugging (e.g. the error will say something like "Cannot insert null value into column"), we recommend naming not null constraints to be consistent in our naming of all constraints. -
- -($Id$)
- -