Ringkasan. dalam tutorial ini, Anda akan mempelajari cara menggunakan komentar MySQL untuk mendokumentasikan pernyataan SQL atau blok kode di MySQL
Komentar
Komentar dapat digunakan untuk mendokumentasikan tujuan pernyataan SQL atau logika blok kode dalam prosedur tersimpan. Saat mem-parsing kode SQL, MySQL mengabaikan bagian komentar. Itu hanya mengeksekusi bagian SQL kecuali untuk komentar yang dapat dieksekusi, yang akan kita bahas di bagian selanjutnya
MySQL mendukung tiga gaya komentar
- Dari
'-- '
ke akhir baris. Gaya tanda hubung ganda membutuhkan setidaknya spasi putih atau karakter kontrol [spasi, tab, baris baru, dll] setelah tanda hubung kedua.SELECT * FROM users; -- This is a comment
Perhatikan bahwa SQL standar tidak memerlukan spasi setelah tanda hubung kedua. MySQL menggunakan spasi kosong untuk menghindari masalah dengan beberapa konstruksi SQL seperti
SELECT 10--1;
_Pernyataan mengembalikan 11. Jika MySQL tidak menggunakan spasi, itu akan mengembalikan 10 sebagai gantinya
- Dari
'#'
ke akhir baris.SELECT lastName, firstName FROM employees WHERE reportsTo = 1002; # get subordinates of Diane
- Komentar gaya-C
SELECT 10--1;
_0 dapat menjangkau beberapa baris. Anda menggunakan gaya komentar ini untuk mendokumentasikan blok kode SQL./* Get sales rep employees that reports to Anthony */ SELECT lastName, firstName FROM employees WHERE reportsTo = 1143 AND jobTitle = 'Sales Rep';
_
Perhatikan bahwa MySQL tidak mendukung komentar bersarang
Komentar yang dapat dieksekusi
MySQL memberikan komentar yang dapat dieksekusi untuk mendukung portabilitas antara database yang berbeda. Komentar ini memungkinkan Anda untuk menyematkan kode SQL yang hanya akan dieksekusi di MySQL tetapi tidak di database lain
Berikut ini mengilustrasikan sintaks komentar yang dapat dieksekusi
Code language: SQL [Structured Query Language] [sql]
/*! MySQL-specific code */
Misalnya, pernyataan berikut menggunakan komentar yang dapat dieksekusi
_Code language: SQL [Structured Query Language] [sql]
SELECT 1 /*! +1 */
Pernyataan mengembalikan 2 bukannya 1. Namun, ini akan mengembalikan 1 jika Anda menjalankannya di sistem database lain
Jika Anda ingin mengeksekusi komentar dari versi MySQL tertentu, Anda menggunakan sintaks berikut
Code language: SQL [Structured Query Language] [sql]
/*!##### MySQL-specific code */
String '#####' mewakili versi minimum MySQL yang dapat mengeksekusi komentar. # pertama adalah versi utama e. g. , 5 atau 8. 2 angka kedua [##] adalah versi minor. Dan 2 yang terakhir adalah level patch
MySQL menggunakan SQL untuk bekerja dengan database. Panduan ini akan menunjukkan cara menulis komentar dalam pernyataan MySQL
Komentar di MySQL
Di MySQL, ada tiga jenis perintah yang tersedia. Mereka dipisahkan oleh simbol mereka
Satu hal penting untuk diingat adalah bahwa MySQL tidak mendukung komentar bersarang
Komentar menggunakan “–“
Dengan menempatkan “–” di akhir baris kode, Anda dapat menempatkan komentar satu baris. Lihat contoh berikut
$ PILIH * dari karyawan;
Perhatikan bahwa tidak perlu spasi setelah simbol “–” untuk menulis komentar. Namun, MySQL mengimplementasikan fitur ini untuk menghindari masalah dengan kueri SQL tertentu. Misalnya, kueri ini kemungkinan besar akan menyebabkan masalah dengan jenis komentar ini jika tidak ada persyaratan spasi kosong
$ PILIH 100–1;
Jika MySQL tidak memerlukan spasi putih, hasilnya tidak akan terduga
Komentar menggunakan "#"
Ini adalah jenis komentar lain yang muncul di akhir baris. Kerjanya mirip dengan bagian yang ditunjukkan sebelumnya. Sebagai contoh,
$ PILIH * dari karyawan;
Mengomentari gaya-C
Jika Anda pernah memiliki pengalaman bekerja dengan pemrograman C, maka Anda akan terbiasa dengan jenis komentar ini. Dimulai dengan “/*” dan diakhiri dengan “*/”. Mirip dengan C, komentar dapat menjangkau beberapa baris
/* Rubah cokelat cepat
Melompati anjing pemalas */
PILIH * dari pengguna ;
Komentar yang Dapat Dijalankan
Ada jenis komentar lain yang didukung MySQL – komentar yang akan dieksekusi. Ini adalah fitur menarik yang meningkatkan portabilitas antara database yang berbeda. Hal ini memungkinkan penyematan kode yang hanya akan dijalankan oleh MySQL tetapi bukan solusi basis data lainnya
Komentar yang dapat dieksekusi umumnya akan terlihat seperti ini. Ini melibatkan komentar gaya-C. Namun, setelah “/*”, dimulai dengan tanda seru [. ] tanda
$ /*. */
Mari kita terapkan dalam kode yang dapat dieksekusi. Dalam kode berikut, MySQL akan mengembalikan 5. Namun, mesin basis data lainnya akan mengembalikan 10
$ PILIH 5 /*. + 1 */
Komentar ini juga mendukung penentuan versi MySQL yang diperlukan untuk menjalankan kode ini di dalam komentar. Dalam kasus seperti itu, struktur komentar akan terlihat seperti ini
$ /*. #####
Perhatikan bahwa total ada 5 digit yang menggambarkan versi MySQL
- Karakter 1. Menjelaskan versi utama, misalnya, 5 atau 8
- Karakter 2-3. Menjelaskan versi minor
- Karakter 4-5. Menjelaskan tingkat tambalan
Pada contoh berikut, kode komentar hanya akan berjalan jika server MySQL adalah v8. 0. 27
$ PILIH 5 /*. 80027 + 1 */
Untuk memeriksa versi MySQL saat ini, jalankan perintah berikut
$ mysql --version
Kita juga bisa mendapatkan versi MySQL dari shell MySQL
$ TAMPILKAN VARIABEL SEPERTI "%version%"
Pikiran Akhir
Panduan ini menjelaskan semua format komentar yang didukung di MySQL. Ini juga menampilkan penerapannya dalam kueri. Dalam situasi tertentu, MySQL bahkan mengizinkan menjalankan kode dari komentar juga
Jika Anda lebih tertarik dengan MySQL, lihat panduan ini tentang izin pengguna, mengganti nama tabel, menggunakan tabel temp, dll.