Shrnutí: v tomto výukovém programu se naučíte, jak používat komentář MySQL k dokumentaci příkazu SQL nebo bloku kódu v MySQL.
Pomocí komentářů lze dokumentovat účel příkaz SQL nebo logika bloku kódu v uložené proceduře. Při analýze kódu SQL MySQL ignoruje část komentářů. Provádí pouze část SQL s výjimkou spustitelného komentáře, o kterém se budeme bavit v následující části.
MySQL podporuje tři styly komentářů:
- Z
"-- "
na konec řádku. Styl dvojitých pomlček a komentářů vyžaduje za druhou pomlčkou alespoň mezery nebo kontrolní znaky (mezera, tabulátor, nový řádek atd.).SELECT * FROM users; -- This is a comment
Upozorňujeme, že standardní SQL nevyžaduje mezery po druhé pomlčce. MySQL používá mezery, aby se vyhnula problémům s některými konstrukcemi SQL, jako jsou:
SELECT 10--1;
Příkaz vrátí 11. Pokud MySQL nepoužil mezery, bylo by to místo toho vraťte 10.
- Z
"#"
na konec řádku.SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1002; # get subordinates of Diane
- Komentář ve stylu C
/**/
může zahrnovat více řádků. Tento styl komentářů se používá k dokumentaci bloku kódu SQL./* Get sales rep employees that reports to Anthony*/SELECT lastName, firstNameFROM employeesWHERE reportsTo = 1143 AND jobTitle = "Sales Rep";
Všimněte si, že MySQL nepodporuje vnořené komentáře.
Spustitelné komentáře
MySQL poskytuje spustitelné komentáře na podporu přenositelnosti mezi různými databázemi. Tyto komentáře vám umožňují vložit kód SQL, který se bude spouštět pouze v MySQL, ale nikoli v jiných databázích.
Následující text ilustruje syntaxi spustitelného komentáře:
Code language: SQL (Structured Query Language) (sql)
Například následující příkaz používá spustitelný komentář:
Code language: SQL (Structured Query Language) (sql)
Příkaz vrátí 2 místo 1. Vrátí však 1, pokud provedete v jiných databázových systémech.
Chcete-li provést komentář z konkrétní verze MySQL, použijte následující syntaxi:
Code language: SQL (Structured Query Language) (sql)