Skip to content

Conventions

Following a set of database conventions improves the readability and understanding of the database and related SQL. Every DBA has their own thoughts about which convention to follow. This is ours, tailored for MySQL.

Note: While we typically recommend PascalCase naming for Linx development (e.g., UpdateCustomer), MySQL identifier case sensitivity depends on the underlying operating system and the lower_case_table_names setting.
To avoid portability issues between Windows and Linux servers, we encourage snake_case naming in MySQL for practical and technical consistency.

  • Names must clearly describe the object.
  • Use snake_case for all object names in MySQL.
  • Avoid Hungarian notation (e.g., int_number).
  • Avoid abbreviations unless they are widely recognized.
Applies ToConventionExample
Tablesnoun, singularcustomer
Stored Proceduresverb_nounupdate_customer
Viewsnouncustomer_orders
Fieldsnounsurname

You can use PascalCase object names in MySQL if you quote them consistently in every SQL statement (e.g., `Customer`).
However, this is discouraged as it leads to more verbose and error-prone SQL, and can break when moving between operating systems.

  • Use consistent indentation.
  • Use UPPERCASE for SQL keywords: SELECT, FROM, WHERE, JOIN, etc.
  • Use meaningful aliases—avoid single-letter or cryptic abbreviations.
  • Use single quotes ('string') for string literals.
  • Use backticks (`identifier`) only when necessary to refer to case-sensitive or reserved identifiers.