Kursus MariaDB / Menghubungkan Klien Baris Perintah dan Menjalankan Berkas SQL
Mulai koneksi MariaDB dari terminal, lalu masukkan SQL di dalam klien yang sudah terhubung. Untuk menjalankan berkas SQL UTF-8 yang tersimpan, gunakan perintah SOURCE dengan jalur pada komputer yang menjalankan klien; jalur ini bukan lokasi dalam sistem berkas server basis data.
Siapkan server, akun, dan berkas
Selesaikan penyiapan MariaDB di Windows atau penyiapan MariaDB di Ubuntu, lalu pastikan server berjalan. Contoh bersama memakai akun latihan dan nilai koneksi berikut. Ganti porta jika Anda sengaja memilih porta lain. SQL dikirim ke server sebagaimana dijelaskan dalam pengenalan server dan klien MariaDB; setelah terhubung, USE dapat dipakai untuk memilih basis data kerja bawaan.
| Komponen | Nilai atau pemeriksaan |
|---|---|
| Protokol dan host | TCP ke 127.0.0.1 |
| Porta | 3306, kecuali instans Anda memakai porta berbeda |
| Akun | course_user dengan kata sandi yang Anda tentukan |
| Kumpulan karakter koneksi | utf8mb4 |
| Berkas SQL | Teks UTF-8 dengan ekstensi .sql, bukan .sql.txt |
Shell menjalankan program klien; klien yang terhubung meneruskan SQL ke server. Perintah SOURCE ditafsirkan oleh klien, yang membaca berkas lokal lalu mengirim perintah-perintahnya. Mencampur ketiga lapisan ini sering membuat perintah yang sebenarnya benar dimasukkan di tempat yang salah.
Hubungkan dari terminal dan periksa koneksi
Jalankan perintah ini di terminal, di luar koneksi MariaDB yang sudah terbuka:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
| Pilihan | Kegunaan |
|---|---|
| --protocol=tcp | Memakai TCP secara eksplisit, bukan soket lokal |
| --host dan --port | Memilih alamat dan porta server |
| --user | Memilih nama pengguna MariaDB |
| --password | Meminta kata sandi, bukan menuliskannya dalam perintah |
| --default-character-set=utf8mb4 | Menetapkan kumpulan karakter koneksi klien |
| --abort-source-on-error | Menghentikan sisa masukan SOURCE ketika terjadi kesalahan |
Di Windows, jika mariadb tidak berada pada jalur pencarian program, gunakan MariaDB Command Prompt dari pemasangan atau jalur lengkap program sebagaimana dijelaskan pada panduan Windows. Prompt seperti MariaDB [(none)]> menunjukkan belum ada basis data bawaan yang dipilih. Prompt itu sendiri tidak menandakan kegagalan masuk.
Di dalam klien, jalankan:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
Server mengembalikan versi, informasi akun, nilai total 5, serta sapaan Hello, café. Karakter beraksen pada sapaan juga menjadi pemeriksaan pengodean sederhana. USER() menjelaskan identitas koneksi, sedangkan CURRENT_USER() menunjukkan akun untuk pemeriksaan hak akses. Referensi resmi klien baris perintah MariaDB menjelaskan pilihan dan perintahnya.
Selesaikan, batalkan, atau ubah tampilan perintah
SQL dapat ditulis dalam beberapa baris. Klien menunggu hingga perintah lengkap, biasanya ditandai titik koma:
SELECT
10 + 20 AS total;
Hasilnya 30. Jika Anda masih menulis perintah yang belum lengkap dan ingin membuangnya, masukkan perintah klien berikut:
\c
Untuk menampilkan hasil secara vertikal, gunakan penutup perintah klien \G sebagai pengganti titik koma:
SELECT VERSION() AS server_version\G
\c dan \G merupakan aturan klien, bukan sintaks SQL umum yang diterima setiap aplikasi basis data. Ketik quit untuk mengakhiri koneksi. Memutuskan koneksi tidak menghentikan server MariaDB atau menghapus datanya.
Simpan berkas SQL UTF-8 yang lengkap
Buat berkas teks biasa bernama lesson04-check.sql dengan seluruh isi contoh berikut:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
Gunakan pengodean UTF-8 pada editor dan periksa ekstensi sebenarnya. Misalnya, Windows dapat menyembunyikan ekstensi sehingga berkas ternyata bernama lesson04-check.sql.txt. Pilih direktori yang Anda kelola, seperti C:\mariadb-course\ di Windows atau /home/yourname/mariadb-course/ di Ubuntu. Ganti yourname dengan bagian jalur direktori yang sebenarnya.
Berkas ini menyimpan perintah, bukan cadangan basis data. Menyimpannya tidak menjalankan perintah apa pun. Jalurnya adalah lokasi dalam sistem berkas komputer klien, sedangkan 127.0.0.1:3306 menunjukkan alamat koneksi server.
Jalankan berkas dengan SOURCE dan periksa hasil
Setelah terhubung, gunakan jalur Windows dengan garis miring ke depan:
SOURCE C:/mariadb-course/lesson04-check.sql;
Atau gunakan jalur Ubuntu yang sebenarnya:
SOURCE /home/yourname/mariadb-course/lesson04-check.sql;
Kedua perintah tersebut adalah alternatif, bukan untuk dijalankan berurutan. Klien seharusnya menampilkan tiga hasil kueri yang sama, termasuk total 5 dan sapaan yang tetap utuh. Berkas khusus ini hanya membaca nilai, sehingga mengulangnya tidak menambah atau menghapus baris tabel. Sifat ini tidak berlaku otomatis bagi berkas lain yang berisi CREATE TABLE, INSERT, UPDATE, atau DELETE.
Jika klien dan server berada di dua komputer berbeda, SOURCE tetap membaca berkas pada komputer klien. Dengan --abort-source-on-error, kesalahan menghentikan sisa masukan berkas. Pilihan ini tidak membatalkan perintah yang sudah berhasil dan tidak membuat perintah pembuatan tabel dapat dipulihkan dengan ROLLBACK.
Atasi kesalahan berkas, pengodean, dan SQL
- Berkas tidak ditemukan: periksa jalur lengkap, ejaan, izin baca, dan apakah ekstensinya benar-benar .sql.
- Teks tidak terbaca: periksa pengodean UTF-8 berkas, kumpulan karakter koneksi, dan pengodean tampilan terminal.
- Akses ditolak: periksa akun dan hak akses; masalah ini berbeda dari berkas yang hilang.
- Kesalahan di tengah berkas: periksa perintah yang sudah berhasil sebelum menjalankan ulang berkas yang mengubah data.
Di Windows, jika sumber masalahnya pengodean tampilan terminal, keluar dari klien MariaDB, jalankan perintah berikut di terminal, lalu hubungkan kembali dengan pilihan koneksi UTF-8:
chcp 65001
Di dalam klien, periksa variabel kumpulan karakter koneksi bila diperlukan:
SHOW VARIABLES LIKE 'character_set_%';
Mengubah pengaturan koneksi tidak otomatis memperbaiki teks yang sebelumnya tersimpan dengan pengodean keliru. Pastikan asal masalah sebelum mengubah data tersimpan. Jalankan perintah shell, perintah klien, dan SQL dalam konteks yang sesuai.





