# Podręcznik stylu SQL ## Wstęp Możesz używać poniższego zestawu wytycznych, [sforkować je][fork] lub stworzyć własne – najważniejsze jest abyś wybrał styl i się go trzymał. Jeśli chcesz zasugerować zmiany lub poprawić błędy, utwórz na GitHubie [zgłoszenie][issue] lub zrób [pull request][pull]. Wytyczne zostały zaprojektowane tak, aby były zgodne z podręcznikiem [SQL Programming Style][celko] Joego Celko i były łatwe do przyswojenia dla zespołów, które już przeczytały tę książkę. Poniższy przewodnik w niektórych obszarach jest nieco bardziej stanowczy, a w innych nieco swobodniejszy. Z pewnością jest bardziej zwięzły, podczas gdy [książka Celko][celko] każdą regułę okrasza anegdotami i uzasadnieniem w formie przemyślanej wypowiedzi. Poniższy podręcznik można łatwo umieścić w głównym repozytorium projektu poprzez pobranie go w [formacie Markdown][dl-md] lub podając link bezpośrednio do tej strony. Dzieki temu każda osoba biorąca udział w projekcie będzie mogła swobodnie przeczytać umieszczone tutaj wytyczne – o wiele trudniej jest to osiągnąć przy pomocy fizycznej papierowej książki. Podręcznik stylu SQL [Simona Holywella][simon] jest wydany na licencji [Creative Commons Uznanie autorstwa-Na tych samych warunkach 4.0 Międzynarodowe][licence]. Na podstawie pracy dostępnej pod adresem [https://www.sqlstyle.guide/][sqlstyleguide]. ## Ogólne wytyczne ### Zalecane * Używaj spójnych oraz opisowych identyfikatorów i nazw. * Rozsądnie wykorzystuj białe znaki i wcięcia, tak aby ułatwić czytanie kodu. * Przechowuj informacje o czasie i dacie w formacie zgodnym z [ISO 8601][iso-8601] (`YYYY-MM-DDTHH:MM:SS.SSSSS`). * Ze względu na przenośność kodu staraj się używać wyłącznie standardowych funkcji SQL zamiast funkcji specyficznych dla danego dostawcy silnika bazodanowego. * Kod powinien być zwięzły i pozbawiony zbędnego kodu SQL, np. bez zbędnych cudzysłowów, nawiasów lub klauzul `WHERE`, które mogą być wyprowadzone w inny sposób. * Dodawaj komentarze do kodu SQL tam, gdzie jest to konieczne. Używaj komentarzy w stylu C, otwierając `/*` i zamykając `*/` je tam, gdzie jest to możliwe; w przeciwnym razie poprzedzaj komentarze znakami `--` i kończ je nową linią. ```sql SELECT file_hash -- stored ssdeep hash FROM file_system WHERE file_name = '.vimrc'; ``` ```sql /* Updating the file record after writing to the file */ UPDATE file_system SET file_modified_date = '1980-02-22 13:19:01.00000', file_size = 209732 WHERE file_name = '.vimrc'; ``` ### Niezalecane * camelCase – trudno się go odczytuje przy szybkim przęglądaniu kodu. * Przedrostki opisowe lub notacja węgierska, takie jak `sp_` lub `tbl`. * Liczba mnoga – tam, gdzie jest to możliwe, używaj bardziej naturalnego określenia zbiorowego, np. `staff` zamiast `employees` lub `people` zamiast `individuals`. * Identyfikatory otoczone cudzysłowem/apostrofem – jeśli musisz ich używać, to w celu zachowania przenośności kodu trzymaj się standardu SQL-92, czyli stosuj cudzysłów (w zależności od dostawcy silnika bazodanowego być może będziesz musiał dodatkowo skonfigurować swój serwer SQL). * Zasady projektowania obiektowego nie powinny być stosowane do kodu SQL i struktur bazy danych. ## Konwencje nazywania ### Ogólne * Upewnij się, że nazwa jest unikalna i nie istnieje jako [zastrzeżone słowo kluczowe][reserved-keywords]. * Nazwa powinna mieć rozmiar maksymalnie 30 bajtów – w praktyce jest to 30 znaków, chyba że używasz wielobajtowego zestawu znaków. * Nazwy muszą zaczynać się od litery i nie mogą kończyć się podkreślnikiem. * W nazwach należy używać tylko liter, cyfr i podkreślników. * Unikaj stosowania wielu kolejnych podkreśleń – mogą być one trudne do odczytania. * Używaj podkreśleń tam, gdzie normalnie umieściłbyś spację w nazwie (np. w języku angielskim "first name" staje się `first_name`). * Unikaj skrótów, a jeśli musisz ich użyć, to upewnij się, że są one powszechnie zrozumiałe. ```sql SELECT first_name FROM staff; ``` ### Tabele * Używaj nazwy zbiorowej lub, w najgorszym przypadku, formy liczby mnogiej. Na przykład (w kolejności preferencji) `staff` i `employees`. * Nie używaj przedrostka `tbl` ani żadnego innego opisowego przedrostka lub notacji węgierskiej. * Nigdy nie nadawaj tabeli tej samej nazwy co jedna z jej kolumn i vice versa. * Jeśli to możliwe, to unikaj konkatenacji nazw dwóch tabel w celu utworzenia nazwy tabeli odzwierciedlającej związek między tymi tabelami. Zamiast `cars_mechanics` wybierz `services`. ### Kolumny * Zawsze używaj nazwy w liczbie pojedynczej. * Jeśli to możliwe, to unikaj używania `id` jako głównego identyfikatora tabeli. * Nie dodawaj kolumny o tej samej nazwie co tabela i vice versa. * Zawsze używaj małych liter, z wyjątkiem sytuacji, gdy nie ma sensu ich używać, np. w przypadku nazw własnych. ### Aliasy * Nazwy powinny w jakiś sposób odnosić się do obiektu lub wyrażenia, które jest aliasowane. * Ogólną zasadą jest, że nazwa aliasu powinna być pierwszą literą każdego słowa z nazwy obiektu. * Jeśli istnieje już alias o tej samej nazwie, to dodaj do nazwy numer. * Zawsze dołączaj słowo kluczowe `AS` – ułatwia to czytanie, ponieważ jawnie definiuje alias. * Dla danych wyliczanych (`SUM()` lub `AVG()`) używaj nazwy, którą nadałbyś tej kolumnie, gdyby była zdefiniowana w schemacie. ```sql SELECT first_name AS fn FROM staff AS s1 JOIN students AS s2 ON s2.mentor_id = s1.staff_num; ``` ```sql SELECT SUM(s.monitor_tally) AS monitor_total FROM staff AS s; ``` ### Procedury składowane * Nazwa musi zawierać czasownik. * Nie należy jej poprzedzać przedrostkiem `sp_` ani żadnym innym podobnym przedrostkiem opisowym lub notacją węgierską. ### Jednolite przyrostki Poniższe przyrostki mają uniwersalne znaczenie, dzięki czemu można łatwo znaleźć kolumny w kodzie SQL i zrozumieć ich przeznaczenie. Używaj właściwego przyrostka tam, gdzie jest to stosowne. * `_id` – unikalny identyfikator, np. kolumna będąca kluczem głównym. * `_status` – wartość flagi lub inny status dowolnego typu, np. `publication_status`. * `_total` – łączna wartość lub suma zbioru wartości. * `_num` – oznacza, że pole zawiera dowolny rodzaj liczby. * `_name` – oznacza nazwę, np. `first_name`. * `_seq` – zawiera nieprzerwaną sekwencję wartości. * `_date` – oznacza kolumnę, która zawiera datę jakiegoś zdarzenia. * `_tally` – podliczenie. * `_size` – rozmiar czegoś, np. rozmiar pliku lub ubrania. * `_addr` – adres, który może być fizyczny lub niematerialny, np. `ip_addr`. ## Składnia zapytań ### Słowa zastrzeżone Zawsze używaj dużych liter dla [zastrzeżonych słów kluczowych][reserved-keywords] takich jak `SELECT` i `WHERE`. Najlepiej jest unikać skróconych słów kluczowych i używać ich pełnych nazw, oczywiście o ile są dostępne (preferuj `ABSOLUTE` zamiast `ABS`). Jeśli w specyfikacji ANSI SQL istnieje słowo kluczowe realizujące żądaną operację, to stosuj je zamiast słów kluczowych specyficznych dla danego silnika bazy danych. Dzięki temu kod jest bardziej przenośny. ```sql SELECT model_num FROM phones AS p WHERE p.release_date > '2014-09-30'; ``` ### Białe znaki Aby kod był łatwiejszy do odczytania, należy używać odpowiednich odstępów między wyrażeniami. Nie zagęszczaj kodu ani nie usuwaj spacji, które występują w języku naturalnym. #### Spacje Spacje powinny być użyte do ułożenia kodu w taki sposób, aby główne słowa kluczowe kończyły się na tej samej granicy znaków. Tworzy to pośrodku kodu tzw. rzekę, ułatwiając oku czytelnika przeglądanie kodu i oddzielenie słów kluczowych od szczegółów implementacji. Rzeki zasadniczo są [złe w typografii][rivers], ale tutaj okazują się pomocne. ```sql (SELECT f.species_name, AVG(f.height) AS average_height, AVG(f.diameter) AS average_diameter FROM flora AS f WHERE f.species_name = 'Banksia' OR f.species_name = 'Sheoak' OR f.species_name = 'Wattle' GROUP BY f.species_name, f.observation_date) UNION ALL (SELECT b.species_name, AVG(b.height) AS average_height, AVG(b.diameter) AS average_diameter FROM botanic_garden_flora AS b WHERE b.species_name = 'Banksia' OR b.species_name = 'Sheoak' OR b.species_name = 'Wattle' GROUP BY b.species_name, b.observation_date); ``` Zauważ, że `SELECT`, `FROM` itp. są wyrównane do prawej, podczas gdy nazwy kolumn i szczegóły specyficzne dla implementacji są wyrównane do lewej. Choć nie jest to lista wyczerpująca, zawsze umieszczaj spacje: * przed i po znaku równości (`=`), * po przecinkach (`,`), * wokół apostrofów (`'`), o ile nie są w nawiasach lub przed kończącym linię przecinkiem albo średnikiem. ```sql SELECT a.title, a.release_date, a.recording_date FROM albums AS a WHERE a.title = 'Charcoal Lane' OR a.title = 'The New Danger'; ``` #### Odstępy między wierszami Zawsze dodawaj nowe linie/odstęp pionowy: * przed `AND` lub `OR`, * po średnikach, tak aby oddzielić zapytania w celu ich łatwiejszego czytania, * po każdej definicji słowa kluczowego, * po przecinku przy rozdzielaniu wielu kolumn na grupy logiczne, * aby rozdzielić kod na powiązane sekcje, co zwiększa czytelności dużych fragmentów kodu. Utrzymanie wszystkich słów kluczowych wyrównanych do prawej strony, a wartości wyrównanych do lewej, tworzy jednolitą przerwę pośrodku zapytania. Ułatwia to również szybkie przeglądanie definicji zapytania. ```sql INSERT INTO albums (title, release_date, recording_date) VALUES ('Charcoal Lane', '1990-01-01 01:01:01.00000', '1990-01-01 01:01:01.00000'), ('The New Danger', '2008-01-01 01:01:01.00000', '1990-01-01 01:01:01.00000'); ``` ```sql UPDATE albums SET release_date = '1990-01-01 01:01:01.00000' WHERE title = 'The New Danger'; ``` ```sql SELECT a.title, a.release_date, a.recording_date, a.production_date -- grouped dates together FROM albums AS a WHERE a.title = 'Charcoal Lane' OR a.title = 'The New Danger'; ``` ### Wcięcia Aby zapewnić przejrzystość kodu SQL, należy przestrzegać standardów wcięć. #### Złączenia Złączenia powinny być wcięte do drugiej strony rzeki i w razie potrzeby zgrupowane z nową linią. ```sql SELECT r.last_name FROM riders AS r INNER JOIN bikes AS b ON r.bike_vin_num = b.vin_num AND b.engine_tally > 2 INNER JOIN crew AS c ON r.crew_chief_last_name = c.last_name AND c.chief = 'Y'; ``` #### Podzapytania Podzapytania również powinny być wyrównane do prawej strony rzeki, a następnie ułożone w tym samym stylu, co każde inne zapytanie. Czasami można umieścić nawias zamykający w nowej linii, na tej samej pozycji co towarzyszący mu nawias otwierający – ma to szczególne zastosowanie w przypadku podzapytań zagnieżdżonych. ```sql SELECT r.last_name, (SELECT MAX(YEAR(championship_date)) FROM champions AS c WHERE c.last_name = r.last_name AND c.confirmed = 'Y') AS last_championship_year FROM riders AS r WHERE r.last_name IN (SELECT c.last_name FROM champions AS c WHERE YEAR(championship_date) > '2008' AND c.confirmed = 'Y'); ``` ### Preferowane formalizmy * Używaj `BETWEEN` tam, gdzie jest to możliwe, zamiast łączyć wiele wyrażeń przy pomocy `AND`. * Podobnie używaj `IN()` zamiast wielu `OR`. * Używaj wyrażeń `CASE` zamiast skomplikowanych predykatów z dużą liczbą nawiasów. Wyrażenia `CASE` mogą być zagnieżdżane w celu uzyskania bardziej złożonych struktur logicznych. * Unikaj stosowania klauzul `UNION` i tabel tymczasowych, o ile to możliwe. Jeśli schemat może być zoptymalizowany tak, aby nie zależał od tych elementów SQL-a, to najprawdopodobniej powinien zostać zoptymalizowany. ```sql SELECT CASE postcode WHEN 'BN1' THEN 'Brighton' WHEN 'EH1' THEN 'Edinburgh' END AS city FROM office_locations WHERE country = 'United Kingdom' AND opening_time BETWEEN 8 AND 9 AND postcode IN ('EH1', 'BN1', 'NN1', 'KW1'); ``` ## Składnia tworzenia obiektów Podczas deklarowania informacji o schemacie ważne jest również zapewnienie czytelnego kodu. Aby to uzyskać, upewnij się, że definicje kolumn są uporządkowane i pogrupowane razem w tych miejscach, gdzie ma to sens. W poleceniu `CREATE` w definicjach kolumn stosuj cztery (4) spacje. ### Wybór typów danych * Jeśli to możliwe, nie używaj typów danych specyficznych dla dostawcy silnika bazodanowego – nie są one przenośne i mogą nie być dostępne w starszych wersjach oprogramowania tego samego dostawcy. * Używaj typów `REAL` lub `FLOAT` tylko wtedy, gdy jest to absolutnie konieczne dla obliczeń zmiennoprzecinkowych; w przeciwnym razie zawsze preferuj typy `NUMERIC` i `DECIMAL`. Błędy zaokrągleń w typach zmiennoprzecinkowych są utrapieniem! ### Określanie wartości domyślnych * Wartość domyślna musi być tego samego typu co kolumna – jeśli kolumna jest zadeklarowana jako `DECIMAL`, to nie należy podawać wartości domyślnej typu `INTEGER`. * Wartości domyślne muszą następować po deklaracji typu danych i znajdować się przed każdą instrukcją `NOT NULL`. ### Ograniczenia i klucze Ograniczenia i ich podzbiór, klucze, są bardzo ważnym elementem każdej definicji bazy danych. Mogą one jednak szybko stać się bardzo trudne do odczytania i zrozumienia, dlatego ważne jest, aby stosować się do standardowego zestawu wytycznych. #### Wybór kluczy Określenie kolumny lub kolumn, które będą stanowiły klucze w definicji tabeli, powinno być starannie przemyślane, ponieważ będzie miało to wpływ na wydajność i integralność danych. 1. Klucz powinien być do pewnego stopnia unikalny. 2. Spójność pod względem typu danych dla wartości klucza w całym schemacie i małe prawdopodobieństwo, że w przyszłości się to zmieni. 3. Czy wartość klucza może być zweryfikowana względem standardowego formatu (np. takiego jak opublikowany przez ISO)? Zachęcanie do zgodności z punktem 2. 4. Utrzymanie klucza tak prostego, jak to tylko możliwe, ale nie bójmy się używać kluczy złożonych, gdy jest to konieczne. Powyższe rozważania to uzasadnione i przemyślane działania, które należy wykonać podczas definiowania bazy danych i mają za zadanie rozważyć wszystkie za i przeciw. Jeśli wymagania będą w przyszłości się zmieniały, to możliwe jest wprowadzenie zmian w definicjach, tak aby zachować ich aktualność. #### Definiowanie ograniczeń Po wybraniu kluczy, możliwe jest ich zdefiniowanie w systemie bazodanowym za pomocą ograniczeń wraz z weryfikowaniem wartości pól. ##### Ogólne * Tabele, aby były kompletne i użyteczne, muszą posiadać co najmniej jeden klucz. * Ograniczenia powinny mieć własną nazwę, z wyjątkiem `UNIQUE`, `PRIMARY KEY` i `FOREIGN KEY`, w których dostawca silnika bazy danych zazwyczaj automatycznie generuje wystarczająco zrozumiałe nazwy. ##### Układ i kolejność * Określ klucz główny jako pierwszy zaraz po instrukcji `CREATE TABLE`. * Ograniczenia powinny być zdefiniowane bezpośrednio pod kolumną, której odpowiadają. Wyrównaj wcięciami ograniczenie tak, aby wyrównać do prawej strony nazwy kolumny. * Jeśli ograniczenie dotyczy wielu kolumn, rozważ umieszczenie go jak najbliżej definicji obu kolumn, a jeśli jest to trudne, to w ostateczności umieść je na końcu definicji `CREATE TABLE`. * Jeśli ograniczenie odnosi się do całej tabeli, to również powinno pojawić się na końcu definicji `CREATE TABLE`. * Użyj kolejności alfabetycznej, tak aby `ON DELETE` było przed `ON UPDATE`. * Jeśli ma to sens, to umieść każdy element zapytania na tej samej pozycji; np. wszystkie definicje `NOT NULL` mogą zaczynać się na tej samej wysokości tekstu. Nie jest to ani trudne, ani szybkie, ale z pewnością ułatwia przeglądanie i czytanie kodu. ##### Sprawdzanie poprawności * Używaj ograniczeń `LIKE` i `SIMILAR TO` do zapewnienia integralność ciągów znaków, których format jest znany. * Tam, gdzie znany jest zakres wartości liczbowych, musi być stosowane ograniczenie `CHECK()`; zapobiegnie to wprowadzaniu do bazy danych nieprawidłowych wartości lub niejawnemu obcięciu zbyt dużych wartości, które nie zmieściłyby się w definicji kolumny. Ograniczenie to powinno w większości przypadków przynajmniej sprawdzać czy wartość jest większa niż zero. * Ograniczenia `CHECK()` powinny być przechowywane w oddzielnych klauzulach, tak aby ułatwić debugowanie. ##### Przykład ```sql CREATE TABLE staff ( PRIMARY KEY (staff_num), staff_num INT(5) NOT NULL, first_name VARCHAR(100) NOT NULL, pens_in_drawer INT(2) NOT NULL, CONSTRAINT pens_in_drawer_range CHECK(pens_in_drawer BETWEEN 1 AND 99) ); ``` ### Konstrukcje projektowe, których należy unikać * Zasady projektowania obiektowego nie przekładają się efektywnie na projekty relacyjnych baz danych – unikaj tej pułapki. * Umieszczanie wartości w jednej kolumnie, a jednostek w drugiej. Kolumna powinna czynić jednostki oczywistymi, dzięki czemu unikniemy wymogu ponownego łączenia kolumn w dalszej części aplikacji. Używaj `CHECK()` aby upewnić się, że do kolumny są wstawiane poprawne dane. * Tabele typu [Encja-Atrybut-Wartość][eav] (ang. *Entity–Attribute–Value*, EAV) – zamiast tego użyj specjalistycznego produktu przeznaczonego do obsługi tego typu danych, które nie posiadają schematu. * Rozdzielanie danych, które powinny znajdować się w jednej tabeli, na wiele tabel z powodu arbitralnych decyzji, np. z powodu archiwizacji według czasu lub lokalizacji geograficznej w międzynarodowej organizacji. Późniejsze zapytania muszą wtedy pracować na wielu tabelach przy pomocy `UNION`, zamiast po prostu odpytywać jedną tabelę. ## Dodatek ### Lista zastrzeżonych słów kluczowych Poniżej znajduje się lista zastrzeżonych słów kluczowych ANSI SQL (92, 99 i 2003), MySQL od 3 do 5.x, PostgreSQL 8.1, MS SQL Server 2000, MS ODBC i Oracle 10.2. ```sql A ABORT ABS ABSOLUTE ACCESS ACTION ADA ADD ADMIN AFTER AGGREGATE ALIAS ALL ALLOCATE ALSO ALTER ALWAYS ANALYSE ANALYZE AND ANY ARE ARRAY AS ASC ASENSITIVE ASSERTION ASSIGNMENT ASYMMETRIC AT ATOMIC ATTRIBUTE ATTRIBUTES AUDIT AUTHORIZATION AUTO_INCREMENT AVG AVG_ROW_LENGTH BACKUP BACKWARD BEFORE BEGIN BERNOULLI BETWEEN BIGINT BINARY BIT BIT_LENGTH BITVAR BLOB BOOL BOOLEAN BOTH BREADTH BREAK BROWSE BULK BY C CACHE CALL CALLED CARDINALITY CASCADE CASCADED CASE CAST CATALOG CATALOG_NAME CEIL CEILING CHAIN CHANGE CHAR CHAR_LENGTH CHARACTER CHARACTER_LENGTH CHARACTER_SET_CATALOG CHARACTER_SET_NAME CHARACTER_SET_SCHEMA CHARACTERISTICS CHARACTERS CHECK CHECKED CHECKPOINT CHECKSUM CLASS CLASS_ORIGIN CLOB CLOSE CLUSTER CLUSTERED COALESCE COBOL COLLATE COLLATION COLLATION_CATALOG COLLATION_NAME COLLATION_SCHEMA COLLECT COLUMN COLUMN_NAME COLUMNS COMMAND_FUNCTION COMMAND_FUNCTION_CODE COMMENT COMMIT COMMITTED COMPLETION COMPRESS COMPUTE CONDITION CONDITION_NUMBER CONNECT CONNECTION CONNECTION_NAME CONSTRAINT CONSTRAINT_CATALOG CONSTRAINT_NAME CONSTRAINT_SCHEMA CONSTRAINTS CONSTRUCTOR CONTAINS CONTAINSTABLE CONTINUE CONVERSION CONVERT COPY CORR CORRESPONDING COUNT COVAR_POP COVAR_SAMP CREATE CREATEDB CREATEROLE CREATEUSER CROSS CSV CUBE CUME_DIST CURRENT CURRENT_DATE CURRENT_DEFAULT_TRANSFORM_GROUP CURRENT_PATH CURRENT_ROLE CURRENT_TIME CURRENT_TIMESTAMP CURRENT_TRANSFORM_GROUP_FOR_TYPE CURRENT_USER CURSOR CURSOR_NAME CYCLE DATA DATABASE DATABASES DATE DATETIME DATETIME_INTERVAL_CODE DATETIME_INTERVAL_PRECISION DAY DAY_HOUR DAY_MICROSECOND DAY_MINUTE DAY_SECOND DAYOFMONTH DAYOFWEEK DAYOFYEAR DBCC DEALLOCATE DEC DECIMAL DECLARE DEFAULT DEFAULTS DEFERRABLE DEFERRED DEFINED DEFINER DEGREE DELAY_KEY_WRITE DELAYED DELETE DELIMITER DELIMITERS DENSE_RANK DENY DEPTH DEREF DERIVED DESC DESCRIBE DESCRIPTOR DESTROY DESTRUCTOR DETERMINISTIC DIAGNOSTICS DICTIONARY DISABLE DISCONNECT DISK DISPATCH DISTINCT DISTINCTROW DISTRIBUTED DIV DO DOMAIN DOUBLE DROP DUAL DUMMY DUMP DYNAMIC DYNAMIC_FUNCTION DYNAMIC_FUNCTION_CODE EACH ELEMENT ELSE ELSEIF ENABLE ENCLOSED ENCODING ENCRYPTED END END-EXEC ENUM EQUALS ERRLVL ESCAPE ESCAPED EVERY EXCEPT EXCEPTION EXCLUDE EXCLUDING EXCLUSIVE EXEC EXECUTE EXISTING EXISTS EXIT EXP EXPLAIN EXTERNAL EXTRACT FALSE FETCH FIELDS FILE FILLFACTOR FILTER FINAL FIRST FLOAT FLOAT4 FLOAT8 FLOOR FLUSH FOLLOWING FOR FORCE FOREIGN FORTRAN FORWARD FOUND FREE FREETEXT FREETEXTTABLE FREEZE FROM FULL FULLTEXT FUNCTION FUSION G GENERAL GENERATED GET GLOBAL GO GOTO GRANT GRANTED GRANTS GREATEST GROUP GROUPING HANDLER HAVING HEADER HEAP HIERARCHY HIGH_PRIORITY HOLD HOLDLOCK HOST HOSTS HOUR HOUR_MICROSECOND HOUR_MINUTE HOUR_SECOND IDENTIFIED IDENTITY IDENTITY_INSERT IDENTITYCOL IF IGNORE ILIKE IMMEDIATE IMMUTABLE IMPLEMENTATION IMPLICIT IN INCLUDE INCLUDING INCREMENT INDEX INDICATOR INFILE INFIX INHERIT INHERITS INITIAL INITIALIZE INITIALLY INNER INOUT INPUT INSENSITIVE INSERT INSERT_ID INSTANCE INSTANTIABLE INSTEAD INT INT1 INT2 INT3 INT4 INT8 INTEGER INTERSECT INTERSECTION INTERVAL INTO INVOKER IS ISAM ISNULL ISOLATION ITERATE JOIN K KEY KEY_MEMBER KEY_TYPE KEYS KILL LANCOMPILER LANGUAGE LARGE LAST LAST_INSERT_ID LATERAL LEADING LEAST LEAVE LEFT LENGTH LESS LEVEL LIKE LIMIT LINENO LINES LISTEN LN LOAD LOCAL LOCALTIME LOCALTIMESTAMP LOCATION LOCATOR LOCK LOGIN LOGS LONG LONGBLOB LONGTEXT LOOP LOW_PRIORITY LOWER M MAP MATCH MATCHED MAX MAX_ROWS MAXEXTENTS MAXVALUE MEDIUMBLOB MEDIUMINT MEDIUMTEXT MEMBER MERGE MESSAGE_LENGTH MESSAGE_OCTET_LENGTH MESSAGE_TEXT METHOD MIDDLEINT MIN MIN_ROWS MINUS MINUTE MINUTE_MICROSECOND MINUTE_SECOND MINVALUE MLSLABEL MOD MODE MODIFIES MODIFY MODULE MONTH MONTHNAME MORE MOVE MULTISET MUMPS MYISAM NAME NAMES NATIONAL NATURAL NCHAR NCLOB NESTING NEW NEXT NO NO_WRITE_TO_BINLOG NOAUDIT NOCHECK NOCOMPRESS NOCREATEDB NOCREATEROLE NOCREATEUSER NOINHERIT NOLOGIN NONCLUSTERED NONE NORMALIZE NORMALIZED NOSUPERUSER NOT NOTHING NOTIFY NOTNULL NOWAIT NULL NULLABLE NULLIF NULLS NUMBER NUMERIC OBJECT OCTET_LENGTH OCTETS OF OFF OFFLINE OFFSET OFFSETS OIDS OLD ON ONLINE ONLY OPEN OPENDATASOURCE OPENQUERY OPENROWSET OPENXML OPERATION OPERATOR OPTIMIZE OPTION OPTIONALLY OPTIONS OR ORDER ORDERING ORDINALITY OTHERS OUT OUTER OUTFILE OUTPUT OVER OVERLAPS OVERLAY OVERRIDING OWNER PACK_KEYS PAD PARAMETER PARAMETER_MODE PARAMETER_NAME PARAMETER_ORDINAL_POSITION PARAMETER_SPECIFIC_CATALOG PARAMETER_SPECIFIC_NAME PARAMETER_SPECIFIC_SCHEMA PARAMETERS PARTIAL PARTITION PASCAL PASSWORD PATH PCTFREE PERCENT PERCENT_RANK PERCENTILE_CONT PERCENTILE_DISC PLACING PLAN PLI POSITION POSTFIX POWER PRECEDING PRECISION PREFIX PREORDER PREPARE PREPARED PRESERVE PRIMARY PRINT PRIOR PRIVILEGES PROC PROCEDURAL PROCEDURE PROCESS PROCESSLIST PUBLIC PURGE QUOTE RAID0 RAISERROR RANGE RANK RAW READ READS READTEXT REAL RECHECK RECONFIGURE RECURSIVE REF REFERENCES REFERENCING REGEXP REGR_AVGX REGR_AVGY REGR_COUNT REGR_INTERCEPT REGR_R2 REGR_SLOPE REGR_SXX REGR_SXY REGR_SYY REINDEX RELATIVE RELEASE RELOAD RENAME REPEAT REPEATABLE REPLACE REPLICATION REQUIRE RESET RESIGNAL RESOURCE RESTART RESTORE RESTRICT RESULT RETURN RETURNED_CARDINALITY RETURNED_LENGTH RETURNED_OCTET_LENGTH RETURNED_SQLSTATE RETURNS REVOKE RIGHT RLIKE ROLE ROLLBACK ROLLUP ROUTINE ROUTINE_CATALOG ROUTINE_NAME ROUTINE_SCHEMA ROW ROW_COUNT ROW_NUMBER ROWCOUNT ROWGUIDCOL ROWID ROWNUM ROWS RULE SAVE SAVEPOINT SCALE SCHEMA SCHEMA_NAME SCHEMAS SCOPE SCOPE_CATALOG SCOPE_NAME SCOPE_SCHEMA SCROLL SEARCH SECOND SECOND_MICROSECOND SECTION SECURITY SELECT SELF SENSITIVE SEPARATOR SEQUENCE SERIALIZABLE SERVER_NAME SESSION SESSION_USER SET SETOF SETS SETUSER SHARE SHOW SHUTDOWN SIGNAL SIMILAR SIMPLE SIZE SMALLINT SOME SONAME SOURCE SPACE SPATIAL SPECIFIC SPECIFIC_NAME SPECIFICTYPE SQL SQL_BIG_RESULT SQL_BIG_SELECTS SQL_BIG_TABLES SQL_CALC_FOUND_ROWS SQL_LOG_OFF SQL_LOG_UPDATE SQL_LOW_PRIORITY_UPDATES SQL_SELECT_LIMIT SQL_SMALL_RESULT SQL_WARNINGS SQLCA SQLCODE SQLERROR SQLEXCEPTION SQLSTATE SQLWARNING SQRT SSL STABLE START STARTING STATE STATEMENT STATIC STATISTICS STATUS STDDEV_POP STDDEV_SAMP STDIN STDOUT STORAGE STRAIGHT_JOIN STRICT STRING STRUCTURE STYLE SUBCLASS_ORIGIN SUBLIST SUBMULTISET SUBSTRING SUCCESSFUL SUM SUPERUSER SYMMETRIC SYNONYM SYSDATE SYSID SYSTEM SYSTEM_USER TABLE TABLE_NAME TABLES TABLESAMPLE TABLESPACE TEMP TEMPLATE TEMPORARY TERMINATE TERMINATED TEXT TEXTSIZE THAN THEN TIES TIME TIMESTAMP TIMEZONE_HOUR TIMEZONE_MINUTE TINYBLOB TINYINT TINYTEXT TO TOAST TOP TOP_LEVEL_COUNT TRAILING TRAN TRANSACTION TRANSACTION_ACTIVE TRANSACTIONS_COMMITTED TRANSACTIONS_ROLLED_BACK TRANSFORM TRANSFORMS TRANSLATE TRANSLATION TREAT TRIGGER TRIGGER_CATALOG TRIGGER_NAME TRIGGER_SCHEMA TRIM TRUE TRUNCATE TRUSTED TSEQUAL TYPE UESCAPE UID UNBOUNDED UNCOMMITTED UNDER UNDO UNENCRYPTED UNION UNIQUE UNKNOWN UNLISTEN UNLOCK UNNAMED UNNEST UNSIGNED UNTIL UPDATE UPDATETEXT UPPER USAGE USE USER USER_DEFINED_TYPE_CATALOG USER_DEFINED_TYPE_CODE USER_DEFINED_TYPE_NAME USER_DEFINED_TYPE_SCHEMA USING UTC_DATE UTC_TIME UTC_TIMESTAMP VACUUM VALID VALIDATE VALIDATOR VALUE VALUES VAR_POP VAR_SAMP VARBINARY VARCHAR VARCHAR2 VARCHARACTER VARIABLE VARIABLES VARYING VERBOSE VIEW VOLATILE WAITFOR WHEN WHENEVER WHERE WHILE WIDTH_BUCKET WINDOW WITH WITHIN WITHOUT WORK WRITE WRITETEXT X509 XOR YEAR YEAR_MONTH ZEROFILL ZONE ``` ### Typy danych Poniżej znajdują się sugerowane typy danych, których należy używać w celu uzyskania maksymalnej kompatybilności pomiędzy różnymi silnikami baz danych. #### Typy znakowe * `CHAR` * `CLOB` * `VARCHAR` #### Typy numeryczne * Dokładne * `BIGINT` * `DECIMAL` * `DECFLOAT` * `INTEGER` * `NUMERIC` * `SMALLINT` * Przybliżone * `DOUBLE PRECISION` * `FLOAT` * `REAL` #### Typy daty i czasu * `DATE` * `TIME` * `TIMESTAMP` #### Typy binarne * `BINARY` * `BLOB` * `VARBINARY` #### Typy dodatkowe * `BOOLEAN` * `INTERVAL` * `XML` [simon]: https://www.simonholywell.com/?utm_source=sqlstyle.guide&utm_medium=link&utm_campaign=md-document "SimonHolywell.com" [issue]: https://github.com/treffynnon/sqlstyle.guide/issues "Zgłoszenia na GitHubie dotyczące Podręcznika stylu SQL" [fork]: https://github.com/treffynnon/sqlstyle.guide/fork "Sforkuj na GitHubie Podręcznik stylu SQL" [pull]: https://github.com/treffynnon/sqlstyle.guide/pulls/ "Pull requesty na GitHubie dotyczące Podręcznika stylu SQL" [celko]: https://www.amazon.com/gp/product/0120887975/ref=as_li_ss_tl?ie=UTF8&linkCode=ll1&tag=treffynnon-20&linkId=9c88eac8cd420e979675c815771313d5 "Joe Celko's SQL Programming Style (The Morgan Kaufmann Series in Data Management Systems)" [dl-md]: https://raw.githubusercontent.com/treffynnon/sqlstyle.guide/gh-pages/_includes/sqlstyle.guide.pl.md "Pobierz podręcznik w formacie Markdown" [iso-8601]: https://pl.wikipedia.org/wiki/ISO_8601 "Wikipedia: ISO 8601" [rivers]: https://practicaltypography.com/one-space-between-sentences.html "Practical Typography: one space between sentences" [reserved-keywords]: #lista-zastrzeżonych-słów-kluczowych "Lista zastrzeżonych słów kluczowych" [eav]: https://en.wikipedia.org/wiki/Entity%E2%80%93attribute%E2%80%93value_model "Wikipedia: Entity–attribute–value model" [sqlstyleguide]: https://www.sqlstyle.guide/ "Podręcznik stylu SQL Simona Holywella" [licence]: https://creativecommons.org/licenses/by-sa/4.0/deed.pl "Licencja Creative Commons Uznanie autorstwa-Na tych samych warunkach 4.0 Międzynarodowe"