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

Terminal memulai klien mariadb, SOURCE membaca berkas SQL di komputer klien, server menjalankan SQL, dan klien menampilkan hasil

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.