Tài liệu ServBay: Quản lý cơ sở dữ liệu với Adminer
Tổng quan
ServBay là một môi trường phát triển Web cục bộ mạnh mẽ dành cho macOS, tích hợp nhiều máy chủ Web, ngôn ngữ lập trình và hệ quản trị cơ sở dữ liệu. Nhằm giúp lập trình viên dễ dàng quản lý các cơ sở dữ liệu tích hợp sẵn này, ServBay đã cài đặt sẵn và cấu hình Adminer — công cụ quản lý cơ sở dữ liệu nhẹ nhưng rất mạnh mẽ. Tài liệu này sẽ hướng dẫn bạn cách sử dụng Adminer để kết nối và quản lý các cơ sở dữ liệu được tích hợp trong ServBay.
Adminer là gì?
Adminer là công cụ quản lý cơ sở dữ liệu đơn file viết bằng PHP, hỗ trợ nhiều hệ thống CSDL như MySQL, MariaDB, PostgreSQL, SQLite, MongoDB, v.v. So với các phần mềm quản lý CSDL lớn, Adminer có những ưu điểm nổi bật sau:
- Nhẹ, dễ triển khai: Chỉ gồm một file PHP duy nhất, không cần cài đặt phức tạp, dễ sử dụng. ServBay đã tích hợp sẵn, chỉ cần dùng ngay.
- Hỗ trợ đa dạng CSDL: Giao diện thống nhất cho nhiều loại cơ sở dữ liệu, giảm nhu cầu cài đặt và học nhiều công cụ độc lập.
- Giao diện trực quan, tối giản: Dễ định hướng, thao tác nhanh – kể cả người mới bắt đầu cũng tiếp cận được dễ dàng.
- Tính năng toàn diện: Hỗ trợ hầu hết các thao tác quan trọng: tạo, sửa, xóa cơ sở dữ liệu, bảng, chỉ mục, người dùng, thực thi truy vấn SQL, nhập/xuất dữ liệu, v.v.
Với các nhà phát triển làm việc trên ServBay, Adminer là giải pháp quản lý cơ sở dữ liệu tiện lợi và hiệu quả.
Truy cập Adminer
Khi ServBay khởi động, Adminer sẽ tự động được vận hành và phục vụ qua máy chủ Web tích hợp. Bạn có thể truy cập Adminer bằng cách nhập tên miền cục bộ mặc định của ServBay cộng với tên file Adminer như sau:
https://servbay.host/adminer.php
Hãy đảm bảo ứng dụng ServBay đang chạy, máy chủ Web liên quan (Caddy hoặc Nginx) cũng như dịch vụ cơ sở dữ liệu bạn muốn kết nối đã được bật.
Kết nối tới cơ sở dữ liệu trong ServBay
Giao diện đăng nhập Adminer rất trực quan. Bạn chỉ cần chọn loại CSDL và cung cấp địa chỉ máy chủ, tên đăng nhập, mật khẩu cũng như (với một số loại CSDL) tên cơ sở dữ liệu muốn truy cập. ServBay tự động tạo sẵn tên đăng nhập và mật khẩu mặc định cho các cơ sở dữ liệu tích hợp, bạn có thể tìm thấy thông tin này trong tab "Cơ sở dữ liệu" của ứng dụng ServBay.
Kết nối MariaDB / MySQL
ServBay tích hợp mặc định MariaDB hoặc MySQL. Trên Adminer, bạn chọn loại "MySQL" để kết nối.
- Mở trình duyệt và truy cập Adminer URL (
https://servbay.host/adminer.php
). - Ở màn hình đăng nhập, trong menu thả xuống Hệ thống, chọn
MySQL
. - Nhập thông tin kết nối:
- Máy chủ: Nhập
localhost
hoặc dùng đường dẫn Unix Socket do ServBay cung cấp/Applications/ServBay/tmp/mysql.sock
. Kết nối qua Socket thường nhanh và ổn định hơn. - Tên đăng nhập: Xem trong tab "Cơ sở dữ liệu" của ServBay đối với MariaDB/MySQL.
- Mật khẩu: Xem trong tab "Cơ sở dữ liệu" của ServBay.
- Cơ sở dữ liệu: (Không bắt buộc) Nếu muốn kết nối trực tiếp tới một CSDL cụ thể, nhập tên ở đây. Để trống sẽ đăng nhập vào máy chủ, sau đó bạn có thể quản lý tất cả các cơ sở dữ liệu.
- Máy chủ: Nhập
- Nhấn nút
Đăng nhập
.
Kết nối PostgreSQL
ServBay cũng hỗ trợ PostgreSQL. Trên Adminer, chọn "PostgreSQL".
- Mở trình duyệt và truy cập Adminer URL (
https://servbay.host/adminer.php
). - Ở màn hình đăng nhập, chọn
PostgreSQL
trong menu Hệ thống. - Nhập thông tin kết nối:
- Máy chủ: Nhập
/Applications/ServBay/tmp
. - Tên đăng nhập: Xem trong tab "Cơ sở dữ liệu" của ServBay.
- Mật khẩu: Xem trong tab "Cơ sở dữ liệu" của ServBay.
- Cơ sở dữ liệu: Nhập tên cơ sở dữ liệu (ví dụ
postgres
hoặc một CSDL bạn đã tự tạo).
- Máy chủ: Nhập
- Nhấn nút
Đăng nhập
.
Kết nối SQLite 3
ServBay hỗ trợ cơ sở dữ liệu SQLite 3. Đây là dạng CSDL file, vì vậy cần chỉ rõ đường dẫn file khi kết nối.
- Mở trình duyệt và truy cập Adminer URL (
https://servbay.host/adminer.php
). - Ở màn hình đăng nhập, chọn
SQLite 3
trong menu Hệ thống. - Nhập đường dẫn file database:
- Tệp dữ liệu: Nhập đường dẫn đầy đủ tới file SQLite. Nên lưu CSDL SQLite của bạn trong thư mục dữ liệu của ServBay, chẳng hạn
/Applications/ServBay/db/sqlite/your_database_name.sqlite
. - Nếu file chưa tồn tại, Adminer sẽ hỏi bạn có muốn tạo file mới này không.
- Tệp dữ liệu: Nhập đường dẫn đầy đủ tới file SQLite. Nên lưu CSDL SQLite của bạn trong thư mục dữ liệu của ServBay, chẳng hạn
- Nhấn nút
Đăng nhập
.
Thao tác cơ sở dữ liệu phổ biến
Sau khi đăng nhập thành công vào máy chủ hoặc CSDL cụ thể, bạn có thể dễ dàng thực hiện các thao tác quản lý cơ sở dữ liệu qua giao diện Adminer. Giao diện và các chức năng khả dụng có thể khác nhau tùy từng loại CSDL, nhưng quy trình cơ bản thì tương tự.
Tạo cơ sở dữ liệu
(Áp dụng cho MariaDB/MySQL, PostgreSQL)
- Đăng nhập vào máy chủ CSDL (chưa chỉ định CSDL cụ thể).
- Tìm mục
Tạo cơ sở dữ liệu
hoặc tương tự trong thanh bên trái hoặc trang chính. - Điền tên CSDL mới.
- Chọn bộ ký tự và collation nếu cần.
- Nhấn
Lưu
hoặcTạo
.
(Với SQLite 3, việc tạo CSDL thực hiện khi đăng nhập và chỉ định tới một tệp chưa tồn tại.)
Quản lý bảng và dữ liệu
- Chọn một CSDL (nếu chưa chỉ định trong lúc đăng nhập).
- Ở trang tổng quan CSDL, chọn chức năng
Tạo bảng
. - Nhập tên bảng, định nghĩa các trường (cột) gồm: tên trường, kiểu dữ liệu, độ dài, cho phép NULL hay không, giá trị mặc định, chỉ mục (khóa chính, unique, index thông thường), ...
- Nhấn
Lưu
để tạo bảng. - Sau khi tạo, chọn bảng đó từ thanh bên hoặc màn hình tổng quan.
- Thực hiện các thao tác dữ liệu:
Chèn
: Thêm dòng dữ liệu mới.Chọn
: Xem, tìm kiếm, sắp xếp và lọc dữ liệu hiện có.Cập nhật
: Chỉnh sửa các dòng dữ liệu.Xóa
: Xóa các dòng dữ liệu.- Dùng chức năng
Lệnh SQL
để thực hiện truy vấn và thao tác phức tạp hơn.
Thực thi lệnh SQL
Adminer cung cấp một khu vực nhập lệnh SQL, nơi bạn có thể trực tiếp viết và thực thi các truy vấn để quản lý CSDL.
- Chọn CSDL muốn thao tác.
- Nhấn
Lệnh SQL
. - Nhập câu lệnh SQL vào vùng soạn thảo.
- Nhấn
Thực hiện
.
Nhập và xuất dữ liệu
Adminer hỗ trợ xuất cấu trúc và dữ liệu CSDL ra file SQL hoặc định dạng khác (CSV), cũng như nhập dữ liệu từ các file này – rất hữu ích cho di chuyển, sao lưu hoặc chia sẻ.
- Chọn CSDL hoặc bảng cần xuất/nhập.
- Chọn chức năng
Xuất
hoặcNhập
. - Làm theo hướng dẫn trên giao diện, chọn định dạng, điều chỉnh tùy chọn và thực hiện thao tác.
Xóa cơ sở dữ liệu
(Áp dụng cho MariaDB/MySQL, PostgreSQL)
- Đăng nhập vào máy chủ CSDL (chưa chỉ định CSDL cụ thể).
- Chọn CSDL cần xóa từ danh sách.
- Nhấn
Xóa
và xác nhận. Lưu ý: thao tác này không thể hoàn tác — CSDL và toàn bộ dữ liệu sẽ bị xóa vĩnh viễn!
(Với SQLite 3, xóa database nghĩa là xóa file .sqlite
tương ứng. Bạn cần tự xóa file này trong hệ thống file.)
Lưu ý khi sử dụng
- Bảo mật tài khoản: Hãy giữ an toàn thông tin tài khoản và mật khẩu các cơ sở dữ liệu mà bạn lấy được từ ServBay, không chia sẻ ra ngoài.
- Trạng thái ServBay: Adminer chỉ truy cập được khi máy chủ Web tích hợp trong ServBay đang chạy và dịch vụ CSDL mong muốn cũng phải hoạt động. Nếu không truy cập được hoặc không kết nối được tới CSDL, hãy kiểm tra xem ServBay đã chạy chưa và các gói phần mềm liên quan (Caddy/Nginx, MariaDB/MySQL, PostgreSQL,...) đã được khởi động hay chưa.
- Đường dẫn file SQLite: Đảm bảo file CSDL SQLite được lưu ở nơi ServBay có quyền đọc/ghi. Lý tưởng nhất là thư mục
/Applications/ServBay/db/sqlite/
. - Hiệu suất: Adminer là công cụ nhẹ, nếu thao tác với CSDL rất lớn hoặc quản lý phức tạp, bạn nên cân nhắc phần mềm chuyên dụng như TablePlus, DBeaver, pgAdmin... để có thêm chức năng chuyên sâu và hiệu suất cao.
Các câu hỏi thường gặp (FAQ)
Q: Tôi không truy cập được https://servbay.host/adminer.php
, phải làm sao?
A: Đảm bảo ứng dụng ServBay đang chạy và máy chủ Web của ServBay (thường là Caddy hoặc Nginx) đã khởi động. Kiểm tra cả cài đặt trình duyệt, chắc chắn truy cập được vào https://servbay.host
.
Q: Nếu quên tên đăng nhập hoặc mật khẩu CSDL thì tìm ở đâu?
A: Bạn có thể mở ứng dụng ServBay, chuyển sang tab "Cơ sở dữ liệu" để xem thông tin tài khoản và mật khẩu mặc định của từng loại CSDL.
Q: Khi kết nối PostgreSQL, nên dùng địa chỉ máy chủ và cổng nào?
A: Mặc định, địa chỉ máy chủ là localhost
, cổng là 5432
. Bạn cũng có thể kiểm tra lại cấu hình trong cài đặt ServBay. Nếu kết nối qua Unix Domain Socket, hãy nhập /Applications/ServBay/tmp
(PostgreSQL không cần hậu tố .sock
).
Q: Sự khác biệt giữa địa chỉ máy chủ và đường dẫn socket khi kết nối MariaDB/MySQL?
A: localhost
là kết nối qua TCP/IP (cổng mặc định 3306), còn /Applications/ServBay/tmp/mysql.sock
là dùng Unix Domain Socket. Trên môi trường cục bộ, kết nối socket thường nhanh và an toàn hơn TCP/IP. Hãy chọn tùy theo nhu cầu.
Q: Tôi có thể quản lý các CSDL không tích hợp sẵn trong ServBay bằng Adminer?
A: Adminer hỗ trợ nhiều loại CSDL, nếu bạn cài đặt thêm ví dụ như MongoDB riêng hoặc CSDL từ xa bên ngoài ServBay thì về lý thuyết, bạn vẫn có thể kết nối bằng Adminer của ServBay, miễn là truy cập mạng được và có thông tin kết nối chính xác. Tuy nhiên, Adminer chủ yếu nổi bật khi dùng với các CSDL đã tích hợp trong ServBay.
Tổng kết
Adminer là công cụ quản lý cơ sở dữ liệu được ServBay tích hợp sẵn, giúp đơn giản hóa tối đa việc quản lý MariaDB/MySQL, PostgreSQL và SQLite ngay trên môi trường phát triển cục bộ. Nhờ vào thiết kế đơn file, nhẹ nhàng và hỗ trợ đa dạng hệ CSDL, bạn hoàn toàn có thể dễ dàng kết nối, quản trị và thực hiện các thao tác dữ liệu thường ngày nhờ các chỉ dẫn trong tài liệu này.