MySQL - 注释
MySQL 注释
MySQL 注释是添加到代码段中的文本解释,用于提供有关代码的附加信息。注释不应作为代码的一部分执行。它为读者(包括开发人员)提供注释,帮助他们理解代码的用途、功能或其他相关细节。
MySQL 中有两种类型的注释:单行注释 和 多行注释
MySQL 单行注释
单行注释用于在一行内进行简要说明。要在 MySQL 中创建单行注释,请使用两个连字符 (--) 后跟注释文本。
示例
在下面的查询中,我们使用单行注释来编写文本。
SELECT * FROM customers; -- 这是一条注释
MySQL 多行注释
MySQL 中的多行注释用于较长的解释或注释掉多行代码。这些注释以 /* 开头,以 */ 结尾。它们之间的所有内容都被视为注释。
示例
以下示例使用多行注释来解释查询 -
/* 这是一个多行注释。 您可以使用它来解释复杂的查询或注释掉多行代码。 SELECT * FROM products WHERE price > 50; */
注释放置位置
您几乎可以在 SQL 代码中的任何位置放置注释。常见位置包括:-
SQL 语句之前或之后。
在 SQL 语句中解释其特定部分。
在脚本或存储过程的开头描述其目的。
-- 这是查询前的注释 SELECT * FROM orders; SELECT /* This is an inline comment */ customer_name FROM customers; /* This is a comment block at the beginning of a script */ DELIMITER // CREATE PROCEDURE CalculateDiscount(IN product_id INT) BEGIN -- Calculate discount logic here END // DELIMITER ;
使用客户端程序的注释
我们也可以使用客户端程序注释任何值。
语法
要通过 PHP 程序注释任何值或查询,我们需要使用 mysqli 函数 query() 执行以下注释方法,如下所示 -
单行注释 -- 多行注释 /**/ (使用查询) $sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; $mysqli->query($sql);
要通过 JavaScript 程序注释任何值或查询,我们需要使用 mysql2 库的 query() 函数执行以下注释方法,如下所示 -
单行注释 -- 多行注释 /**/ (使用查询) sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; con.query(sql);
要通过 Java 程序注释任何值或查询,我们需要使用 JDBC 函数 executeQuery() 执行以下注释方法,如下所示 -
单行注释 -- 多行注释 /**/ (使用查询) String sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; statement.executeQuery(sql);
要通过 Python 程序注释任何值或查询,我们需要使用 MySQL Connector/Python 的 execute() 函数执行以下注释方法,如下所示 -
单行注释 -- 多行注释 /**/ (使用查询) comments_query = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'" cursorObj.execute(comments_query)
示例
以下是程序 -
$dbhost = 'localhost'; $dbuser = 'root'; $dbpass = 'password'; $db = 'TUTORIALS'; $mysqli = new mysqli($dbhost, $dbuser, $dbpass, $db); if ($mysqli->connect_errno) { printf("Connect failed: %s
", $mysqli->connect_error); exit(); } //printf('Connected successfully.
'); $sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; if($mysqli->query($sql)){ printf("Select query executed successfully...! "); } printf("Table records: "); if($result = $mysqli->query($sql)){ while($row = mysqli_fetch_array($result)){ printf("Id: %d", $row['ID']); printf(" "); } } if($mysqli->error){ printf("Error message: ", $mysqli->error); } $mysqli->close();
输出
获得的输出如下所示 -
Select query executed successfully...! Table records: Id: 4
var mysql = require('mysql2'); var con = mysql.createConnection({ host:"localhost", user:"root", password:"password" }); //连接到 MySQL con.connect(function(err) { if (err) throw err; // console.log("Connected successfully...!"); // console.log("--------------------------"); sql = "USE TUTORIALS"; con.query(sql); //create table sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; con.query(sql, function(err, result){ console.log("Select query executed successfully(where we commented the name and address column)...!"); console.log("Table records: ") if (err) throw err; console.log(result); }); });
输出
获得的输出如下所示 -
Select query executed successfully(where we commented the name and address column)...! Table records: [ { ID: 4 } ]
import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class Comments { public static void main(String[] args) { String url = "jdbc:mysql://localhost:3306/TUTORIALS"; String user = "root"; String password = "password"; ResultSet rs; try { Class.forName("com.mysql.cj.jdbc.Driver"); Connection con = DriverManager.getConnection(url, user, password); Statement st = con.createStatement(); //System.out.println("Database connected successfully...!"); //create table String sql = "SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'"; rs = st.executeQuery(sql); System.out.println("Table records: "); while(rs.next()) { String id = rs.getString("id"); System.out.println("Id: " + id); } }catch(Exception e) { e.printStackTrace(); } } }
输出
获得的输出如下所示 -
Table records: Id: 4
import mysql.connector # 建立连接 connection = mysql.connector.connect( host='localhost', user='root', password='password', database='tut' ) cursorObj = connection.cursor() # 带注释的查询 comments_query = """SELECT ID /*NAME, ADDRESS*/ FROM CUSTOMERS WHERE ADDRESS = 'Mumbai'""" cursorObj.execute(comments_query) # 获取所有符合条件的行 filtered_rows = cursorObj.fetchall() # 打印结果 print("IDs of customers from Mumbai:") for row in filtered_rows: print(row[0]) cursorObj.close() connection.close()
输出
获得的输出如下所示 -
IDs of customers from Mumbai: 4