Offizielle PostgreSQL-Kapitalisierungskonventionen [geschlossen]

Gibt es eine offizielle PostreSQL-Konvention zur Großschreibung von DB-, Tabellen- und Feldnamen?

Die Beispiele auf der offiziellen Website deuten auf eine _Trennung von Kleinbuchstaben und Wörtern hin, und ich frage mich, ob diese Richtlinie offiziell ist.

CREATE TABLE films (
    code        char(5) CONSTRAINT firstkey PRIMARY KEY,
    title       varchar(40) NOT NULL,
    did         integer NOT NULL,
    date_prod   date,
    kind        varchar(10),
    len         interval hour to minute
);

Ich werde im Grunde genommen Veraces Kommentare widerspiegeln und dies so formulieren, dass es halb amtlich ist:

Es gibt keine Best Practice , die alle Umstände abdeckt. Im Folgenden werden die folgenden Annahmen getroffen (und was zu tun ist, wenn Sie dies nicht getan haben):

• Sie haben dies bereits mit Ihrem Team besprochen (Menschen, die alleine arbeiten, müssen sich oft nur entscheiden)
• Es gibt noch keine formalisierte Stildefinition für SQL in Ihrem Team (ansonsten würden Sie uns nicht fragen)
• Es gibt keine formalisierte Stildefinition für Code. (Befolgen Sie die gleichen Grundkonventionen, die bereits für andere Sprachen festgelegt wurden, und formalisieren Sie einen Stil.)

Der Rest ist also ein wenig meinungsbewusst, basiert aber auf Erfahrung

1. Wenn es um Tabellennamen geht
   1. Sie sollten sich für einzelne Entitätsnamen entscheiden (dies erleichtert die Dokumentation)
   2. Sie sollten hier Pascal Case verwenden
2. Wenn es um Feldnamen geht
   1. Verwenden Sie camelCase für Ihre Feldnamen
   2. Verwenden Sie kurze Singularnamen, es sei denn, die Definition ergibt definitiv einen Sinn als Plural (dies ist so gut wie nie der Fall).
3. Wenn es um Ihre eigenen Funktions- oder Stored Procedure-Namen geht
   1. Verwenden Sie underscore_separation
   2. Verwenden Sie für die Parametrierung die Feldbezeichnung
4. Wenn es um eingebaute Datenbankfunktionen oder Sprachnamen geht (zB SELECT)
   1. Verwenden Sie ALLE GROSSBUCHSTABEN, es sei denn, eine Großschreibung ist erforderlich
   2. Kennen Sie die APIs für Ihre Sprache, um zu wissen, was sinnvoll oder erforderlich ist
5. Wenn es um Abstand geht
   1. Viele Leute verwenden Spaltenausrichtung für Schlüsselwörter und Einrückung für Dinge, die keine Schlüsselwörter sind
   2. Viele Leute verwenden Kommas am Anfang der Zeile, wenn die Felder in jeder Zeile getrennt sind (dies erleichtert das Auskommentieren eines bestimmten Feldes aus einer Auswahlliste).
   3. Verwenden Sie niemals Leerzeichen als Teil der Namen von Dingen, auch nicht für Rückgabewert-Header.
6. Wenn es um Zeichensetzung geht
   1. Klammern - BENUTZEN SIE SIE. Sie sind KOSTENLOS. Ich verspreche.
   2. Semikolons - BENUTZEN SIE SIE. Sie werden dich nicht brechen. Sie zwingen Sie, Ihren Code auszudenken. Und sie sind gute Hygiene.
   3. Carriage Returns - Wieder einmal sind sie kostenlos ;-) Und machen Sie Ihren Code lesbar.

Sie sollten auch berücksichtigen, dass die Community für Postgres beim Versuch, einen allgemeinen Styleguide anzuwenden, im Allgemeinen nicht camelCase oder PascalCase verwendet, sondern underscore_separation. Das wirklich wichtige ist, sicherzustellen, dass Sie überall einen bestimmten Stil festlegen und verwenden, um konsistent zu sein .

Eine schnelle Google-Suche zeigt viele Websites mit Best Practices. Ich würde nur zwei Dinge sagen - NIE Leerzeichen "My Table Name" verwenden (Portierung wird aufgrund unterschiedlicher Escape-Mechanismen unmöglich; dasselbe gilt für nicht-alphanumerische Zeichen). Bei solchen Mechanismen muss man normalerweise auch die Groß- und Kleinschreibung beachten. Es gibt genug Buchstaben und Wörter in der englischen (oder Ihrer eigenen) Sprache und die Länge der Bezeichner ist lang genug (ich kenne kein System mit bezeichner_länge <32, PostgreSQL ist 64). Verwenden Sie niemals SQL-Schlüsselwörter (die sich je nach RDBMS unterscheiden), die dasselbe tun.

Aussagen wie

SELECT "Field" FROM "Table";

kann gültig sein! Das absolut Entscheidende ist, eine klare und relativ einfache Konvention zu haben und sich dann daran zu halten. Wie Sie herausfinden, haben die Menschen unterschiedliche Meinungen - lesen Sie das Thema durch und finden Sie heraus, was für Sie "richtig" ist. Siehe diese Seiten 1 , 2 , 3 , 4 , 5 , ... (es gibt noch viele mehr).