Pular para o conteúdo principal

SQL: Naming external identification code fields at database.


Demand

Use "id_{context}" to name fields of external identification codes and "{context}_id" to internal ones.


Description

When creating a column in a table that reference an id (identification code) of a table located at the database you are dealing it should be named as "{Table Name}_id".

When creating a column in a table that reference an id of a context external to the database you are dealing with  it should be named as "id_{Context Name}".

Examples

1:  CREATE TABLE customer (
2:      id INT NOT NULL,
3:      name VARCHAR(100) NOT NULL,
4:      id_ssn COMMENT 'the United States, the Social Security number',
5:      user_id INT NULL COMMENT 'if the customer have a system login it will be refernced here',
6:     PRIMARY KEY (id),
7:     UNIQUE `uq_ssn` (`ssn`),
8:     CONSTRAINT `fk_customers_user_id_users_user_id`
9:         FOREIGN KEY (`user_id`) 10:     
REFERENCES `users` (`id`) ON DELETE NO ACTION ON UPDATE NO ACTION 11: );


Examples Explanation

If a column in table "table1" references a table in the same database, such as e.g., "table2", then such a column in "table2" must be named by entering the name of the table where the key related to the column being created is located followed by an "id". In this example, it would be "table1.table2_id" (as used in most of the companies nowadays) and when we reference an "id" column in an external context we start with the string "id" followed by the name of the column or context that the id relates to. In our example the SSN field most of the times are just named as "ssn" and in the upper CREATE TABLE it was named "id_ssn" and anyone looking at it, even non americans, would then know that it is not an item originated in our database and that the column is an ID or could be used as an ID but it is not referencing a data, context or table inside the domains of that database.

Comentários

Postagens mais visitadas deste blog

General: Prevent arbitrary precision arithmetic

Demand Some simple decimal calculations like 4.6 * 100 may lead in irregularities when dealing with numbers. Description During arithmetic operations like addition, subtraction, multiplication, and division, the numbers are manipulated according to the rules defined by the IEEE 754 standard. However, due to the finite precision of the representation, rounding errors may occur, leading to small discrepancies between the expected and actual results of computations.  To prevent it we may use some libraries to prevent the problem. In Javascript and Typescript we have the BigNumbers library (and others). PHP has a built-in library for arbitrary-precision arithmetic called BCMath (Binary Calculator). Wich I reccomend. It provides functions to perform mathematical operations on numbers with arbitrary precision, including addition, subtraction, multiplication, division, and more. Examples PHP Sample 1: php > var_dump(floor((10*0.91597) * 1000000)/1000000); 2: float(9.159699) 3: php ...

PHP: Always use an index to add a values to an array

  Demand Always identify the array index when manipulating the array directly Description Whenever you are adding a new item to the array you must add an index so that php does not need to recalculate the size of the array to identify in which position the new content will be added. Examples 1: # Bad code: 2: do { 3: $array[] = $newItem; 4: } while(!feof($fp)); 5: 6: # Good code 7: $array = []; 8: $index = 0; 9: do { 10: $array[$index++] = $newItem; 11: } while(!feof($fp)); Examples Explanation When instantiating a new item in an array in the "bad example" php will identify that you expect the item to be added to the end of the array, since array is a primitive type and has no attributes php always needs to call a calculation function to identify the current size of the array before trying to add a new item to the end of it. By monitoring the growth of the array in an external variable and automatically reference which position will...