MySQL Kommentare

1. Einzeilige MySQL-Kommentare
2. MySQL Mehrzeiliger Kommentar
3. Kommentare zur ausführbaren MySQL-Datei
4. Fazit

In diesem Artikel stellen wir MySQL-Kommentare vor. Wir werden auch lernen, wo und welche Art von Kommentar verwendet werden sollte.

Kommentare werden geschrieben, um den Code zu beschreiben und ihn leicht verständlich zu machen. Wir verwenden Kommentare auch, um einen bestimmten Teil des Codes beim Analysieren von SQL-Abfragen zu ignorieren (lassen Sie diesen Codeabschnitt nicht ausführen).

Es hilft auch den anderen Programmierern zu verstehen, was im Code passiert. Wir werden sehen, wie wir in MySQL einzeilige und mehrzeilige Kommentare verwenden können. Wir werden uns auch die ausführbaren Kommentare und ihre Verwendung ansehen.

Es gibt drei verschiedene Möglichkeiten, MySQL-Kommentare zu schreiben. Wir können die Symbole #, - oder /* und */ zum Kommentieren verwenden.

Einzeilige MySQL-Kommentare

Wir können einzeilige MySQL-Kommentare auf zwei Arten verwenden, entweder durch Verwendung von # oder -.

Lassen Sie uns eine Tabelle namens tb_teachers erstellen, um MySQL-Kommentare zu üben. Wir verwenden #, um einen einzeiligen Kommentar in die unten angegebene MySQL-Abfrage zu schreiben.

Dieser Kommentar wird am Ende der SQL-Abfrage verwendet und muss mit einem Zeilenumbruch versehen werden. Wenn Sie nach dem Kommentar keinen Zeilenumbruch verwenden, wird alles, was in derselben Zeile steht, kommentiert, bis es auf einen Zeilenumbruch stößt. Es ist nicht erforderlich, ein Leerzeichen nach # zu setzen. Es ist jedoch ein guter Ansatz, nach dem # ein Leerzeichen zu setzen, um die Lesbarkeit zu erhöhen.

MySQL-Beispielcode mit #:

# Following SQL query will create a table named 'tb_teachers'
CREATE TABLE `practice_mysql_comments`.`tb_teachers` (
 TEACHER_ID	INTEGER NOT NULL,
 FIRST_NAME	VARCHAR(30) NOT NULL,
 LAST_NAME	VARCHAR(30) NOT NULL,
 GENDER	VARCHAR(30) NOT NULL,
 CITY	VARCHAR(64) NOT NULL,
 EMAIL	VARCHAR(64) NOT NULL,
 JOINING_YEAR INTEGER NOT NULL,
 PRIMARY KEY	(TEACHER_ID)
);

Sehen Sie sich das folgende Codebeispiel an, in dem wir keinen Zeilenumbruch einfügen, nachdem wir einen einzeiligen Kommentar verwendet haben. Sie sehen, dass auch der CREATE-Befehl teilweise kommentiert ist.

# Following SQL query will create a table named 'tb_teachers' CREATE TABLE `practice_mysql_comments`.`tb_teachers` (
 TEACHER_ID	INTEGER NOT NULL,
 FIRST_NAME	VARCHAR(30) NOT NULL,
 LAST_NAME	VARCHAR(30) NOT NULL,
 GENDER	VARCHAR(30) NOT NULL,
 CITY	VARCHAR(64) NOT NULL,
 EMAIL	VARCHAR(64) NOT NULL,
 JOINING_YEAR INTEGER NOT NULL,
 PRIMARY KEY	(TEACHER_ID)
);

Wir können diese Art von Kommentar auch innerhalb der SQL-Abfrage verwenden. Sehen Sie sich das folgende Stück Code an; Sie können beobachten, dass wir innerhalb der SQL-Abfrage mit # kommentieren können.

# Following SQL query will create a table named 'tb_teachers' 
CREATE TABLE `practice_mysql_comments`.`tb_teachers` (
 TEACHER_ID	INTEGER NOT NULL, # teacher's id
 FIRST_NAME	VARCHAR(30) NOT NULL, # teacher's first name
 LAST_NAME	VARCHAR(30) NOT NULL, # teacher's last name
 GENDER	VARCHAR(30) NOT NULL, # teacher's gender
 CITY	VARCHAR(64) NOT NULL, # teacher's home town
 EMAIL	VARCHAR(64) NOT NULL, # teacher's email
 JOINING_YEAR INTEGER NOT NULL, # teacher's appointment year
 PRIMARY KEY (TEACHER_ID) # primay key of the teacher's table
);

Lassen Sie uns die andere Art von einzeiligen Kommentaren mit dem Symbol - untersuchen. Der folgende SQL-Code zeigt, dass wir das doppelte ‘-’ (Bindestrich) Symbol verwenden können, um sogar innerhalb der SQL-Abfrage zu kommentieren.

Es ist dasselbe, als würden wir mit dem Symbol # kommentieren, mit nur einem Unterschied. Nach dem zweiten Bindestrich müssen wir mindestens ein Leerzeichen setzen; Andernfalls fungiert es nicht als Kommentar.

-- Following SQL query will create a table named 'tb_students' 
CREATE TABLE `practice_mysql_comments`.`tb_students` (
 STUDENT_ID	INTEGER NOT NULL, -- student's id
 FIRST_NAME	VARCHAR(30) NOT NULL, -- student's first name
 LAST_NAME	VARCHAR(30) NOT NULL, -- student;s last name
 GENDER	VARCHAR(30) NOT NULL, -- student's gender
 CITY	VARCHAR(64) NOT NULL, -- student's home town
 EMAIL	VARCHAR(64) NOT NULL, -- student's email
 REGISTRATION_YEAR INTEGER NOT NULL, -- student's registration year
 PRIMARY KEY (STUDENT_ID) -- primay key of the student's table
);

MySQL Mehrzeiliger Kommentar

Wenn wir die SQL-Abfrage im Detail erklären müssen, um den Code leicht verständlich zu machen, verwenden wir mehrzeilige Kommentare. Alles innerhalb von /* */ wird ignoriert. Ob Sie am Ende dieser Art von Kommentaren einen Zeilenumbruch setzen oder nicht, spielt keine Rolle, aber es ist gut, einen Zeilenumbruch zu haben, um einen sauberen und organisierten Code zu schreiben.

/* 
Following SQL query will create a table named 'tb_students'
having the basic information about the students. This information includes
full name, gender, city, email and registration year.
*/
CREATE TABLE `practice_mysql_comments`.`tb_students` (
 STUDENT_ID	INTEGER NOT NULL, 
 FIRST_NAME	VARCHAR(30) NOT NULL, 
 LAST_NAME	VARCHAR(30) NOT NULL, 
 GENDER	VARCHAR(30) NOT NULL, 
 CITY	VARCHAR(64) NOT NULL, 
 EMAIL	VARCHAR(64) NOT NULL,
 REGISTRATION_YEAR INTEGER NOT NULL, 
 PRIMARY KEY (STUDENT_ID) 
);

Obwohl wir mehrzeilige Kommentare wie eine einzelne Zeile behandeln können, warum den Aufwand erhöhen, wenn wir einzeilige Kommentare haben. Es ist gut, mehrzeilige Kommentare zu verwenden, wenn Sie nicht möchten, dass mehr als eine Zeile ausgeführt wird. Siehe folgendes Beispiel.

/* 
Following SQL query will create a table named 'tb_students'
having the basic information about the students. This information includes
full name, gender, city, email and registration year.
*/
CREATE TABLE `practice_mysql_comments`.`tb_students` (
 STUDENT_ID	INTEGER NOT NULL, 
 FIRST_NAME	VARCHAR(30) NOT NULL, 
 LAST_NAME	VARCHAR(30) NOT NULL, 
 GENDER	VARCHAR(30) NOT NULL, 
 CITY	VARCHAR(64) NOT NULL, 
 /* EMAIL	VARCHAR(64) NOT NULL,
 REGISTRATION_YEAR INTEGER NOT NULL, */
 PRIMARY KEY (STUDENT_ID) 
);

Kommentare zur ausführbaren MySQL-Datei

MySQL unterstützt auch ausführbare Kommentare. Diese Art von Kommentar bietet Ihnen Portabilität zwischen verschiedenen Datenbanken. Der in diesen Kommentaren geschriebene Code wird nur in MySQL ausgeführt. Wenn Sie die Version nach dem ! Zeichen, es funktioniert nur auf dieser bestimmten MySQL-Version oder höher.

Beispielcode für ausführbare Kommentare:

SELECT 3 /*! *2 */ AS MULTIPLICATION;

Fazit

Wir sind zu dem Schluss gekommen, dass MySQL-Kommentare beim Programmieren eine wichtige Rolle spielen. Dabei spielt es keine Rolle, um welche Art von Programmierung es sich handelt. Die Verwendung von mehrzeiligen Kommentaren ist eine gute Wahl, wenn Sie mehr als eine Zeile ignorieren müssen; Andernfalls ist ein einzeiliger Kommentar in Ordnung. Sie können ausführbare MySQL-Kommentare verwenden, wenn Sie möchten, dass ein bestimmter Codeabschnitt nur auf MySQL Server ausgeführt wird.