Dokumentacja ServBay: Zarządzanie bazą danych za pomocą Adminer

Przegląd

ServBay to potężne, lokalne środowisko do tworzenia stron www stworzone specjalnie dla systemu macOS, integrujące wiele serwerów www, środowisk wykonawczych i systemów bazodanowych. Aby ułatwić developerom zarządzanie tymi wbudowanymi bazami, ServBay ma preinstalowane i skonfigurowane narzędzie Adminer – potężny i lekki menedżer baz danych. Niniejsza dokumentacja przeprowadzi Cię przez proces użycia Adminera do łączenia się i zarządzania bazami danych w środowisku ServBay.

Czym jest Adminer

Adminer to jednoplikowe narzędzie do zarządzania bazami danych napisane w PHP. Obsługuje wiele systemów bazodanowych, w tym MySQL, MariaDB, PostgreSQL, SQLite, MongoDB i inne. W porównaniu do niektórych większych klientów do zarządzania bazami danych, Adminer wyróżnia się następującymi zaletami:

1. Lekkość i wdrożenie w jednym pliku: Adminer składa się tylko z jednego pliku PHP, nie wymaga skomplikowanej instalacji, jest łatwy do wdrożenia i użytkowania. ServBay już go integruje – działa od razu po instalacji.
2. Obsługa wielu baz danych: Z poziomu jednego, przejrzystego interfejsu możesz zarządzać różnymi typami baz, eliminując konieczność instalacji i nauki kilku oddzielnych narzędzi.
3. Prosty i intuicyjny interfejs: Oferuje jasny i łatwy w nawigacji interfejs, dzięki czemu nawet początkujący programista szybko zacznie z niego korzystać.
4. Pełen zestaw funkcji: Umożliwia wszystkie typowe działania – tworzenie, modyfikowanie i usuwanie baz, tabel, indeksów, użytkowników, wykonywanie zapytań SQL, import/export danych i więcej.

Dla developerów pracujących lokalnie w ServBay, Adminer to wygodne i efektywne rozwiązanie do codziennej obsługi baz danych.

Dostęp do Adminer

Po uruchomieniu ServBay, Adminer jest automatycznie włączony i dostępny przez wbudowany serwer www. Wejdź pod poniższy adres, korzystając z domyślnej domeny lokalnej ServBay i nazwy pliku Adminera:

https://servbay.host/adminer.php

Upewnij się, że aplikacja ServBay jest uruchomiona, a odpowiedni serwer www (np. Caddy lub Nginx) oraz wybrana przez Ciebie usługa bazy danych – aktywne.

Łączenie się z bazami danych w ServBay

Ekran logowania Adminer jest bardzo intuicyjny. Wybierasz typ bazy danych i podajesz wymagane dane do połączenia: adres serwera, nazwę użytkownika, hasło oraz dla niektórych baz – nazwę bazy. ServBay generuje domyślne login i hasło dla wbudowanych baz. Ich wartości znajdziesz w zakładce „Bazy danych” w aplikacji ServBay.

Połączenie z MariaDB / MySQL

ServBay standardowo oferuje MariaDB lub MySQL. W Adminerze należy wybrać typ "MySQL".

1. Otwórz przeglądarkę i odwiedź Adminer URL (https://servbay.host/adminer.php).
2. W ekranie logowania, z rozwijanego menu System wybierz MySQL.
3. Wprowadź dane połączeniowe:
   • Serwer: wpisz localhost albo użyj ścieżki socket ServBay /Applications/ServBay/tmp/mysql.sock. Połączenie przez socket jest zazwyczaj efektywniejsze.
   • Nazwa użytkownika: znajdziesz ją w zakładce „Bazy danych” aplikacji ServBay dla MariaDB/MySQL.
   • Hasło: również dostępne w zakładce „Bazy danych”.
   • Baza danych: (opcjonalnie) wpisz nazwę konkretnej bazy, jeśli chcesz się z nią połączyć bezpośrednio; zostaw puste, aby po zalogowaniu zarządzać wszystkimi bazami.
4. Naciśnij przycisk Zaloguj.

Połączenie z PostgreSQL

ServBay wspiera także PostgreSQL. W Adminerze należy wybrać typ "PostgreSQL".

1. Otwórz przeglądarkę i przejdź pod Adminer URL (https://servbay.host/adminer.php).
2. W ekranie logowania, z menu System wybierz PostgreSQL.
3. Wprowadź dane połączeniowe:
   • Serwer: wpisz /Applications/ServBay/tmp.
   • Nazwa użytkownika: znajdziesz w zakładce „Bazy danych” aplikacji ServBay.
   • Hasło: tamże.
   • Baza danych: wpisz nazwę wybranej bazy, np. domyślną postgres lub inną utworzoną przez Ciebie.
4. Kliknij Zaloguj.

Połączenie z SQLite 3

ServBay obsługuje bazę danych SQLite 3. Tutaj baza ma postać pliku, więc musisz podać ścieżkę do tego pliku.

1. Otwórz przeglądarkę i wejdź na Adminer URL (https://servbay.host/adminer.php).
2. W ekranie logowania, z menu System wybierz SQLite 3.
3. Podaj ścieżkę do pliku bazy:
   • Plik bazy danych: wpisz pełną ścieżkę do Twojego pliku SQLite. Zalecane jest umieszczenie pliku w katalogu danych ServBay, np. /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Jeśli ścieżka wskazuje na nieistniejący plik, Adminer zapyta o utworzenie nowego.
4. Kliknij Zaloguj.

Wykonywanie typowych operacji na bazie danych

Po zalogowaniu do serwera baz danych lub konkretnej bazy możesz zarządzać bazami korzystając z funkcjonalności Adminera. Wygląd oraz dostępność opcji może się nieco różnić zależnie od systemu bazy, lecz podstawowe czynności wykonuje się podobnie.

Tworzenie bazy danych

(dotyczy MariaDB/MySQL, PostgreSQL)

1. Zaloguj się na serwer baz danych (bez wskazania konkretnej bazy).
2. W lewym menu lub na stronie głównej znajdź opcję Utwórz bazę lub podobną.
3. Wprowadź nazwę nowej bazy.
4. W razie potrzeby wybierz zestaw znaków i regułę sortowania.
5. Kliknij Zapisz lub Utwórz.

(dla SQLite 3 baza tworzona jest przy logowaniu przez podanie ścieżki do nieistniejącego pliku).

Zarządzanie tabelami i danymi

1. Wybierz bazę danych (jeśli nie określiłeś jej przy logowaniu).
2. Na ekranie z podsumowaniem bazy kliknij Utwórz tabelę.
3. Podaj nazwę tabeli oraz zdefiniuj pola (nazwy kolumn, typy danych, długości, czy pole akceptuje NULL, wartość domyślną, indeksy – główny, unikalny lub zwykły).
4. Kliknij Zapisz, aby utworzyć tabelę.
5. Po utworzeniu wybierz tabelę z nawigacji lub ekranu podsumowania.
6. Skorzystaj z następujących akcji:
   • Wstaw: dodanie nowego rekordu.
   • Wybierz: podgląd, wyszukiwanie, sortowanie i filtrowanie danych.
   • Aktualizuj: edycja istniejącego rekordu.
   • Usuń: usuwanie rekordu.
   • Skorzystaj z Polecenie SQL, aby wykonać złożone zapytania lub operacje.

Wykonywanie poleceń SQL

Adminer posiada specjalny interfejs do wprowadzania i uruchamiania własnych zapytań SQL, co daje większą elastyczność w zarządzaniu bazą oraz jej analizie.

1. Wybierz bazę, na której chcesz wykonać zapytanie.
2. Kliknij w opcję Polecenie SQL.
3. W oknie wklej lub wpisz komendę SQL.
4. Kliknij Wykonaj.

Import i eksport danych

Adminer pozwala na eksport struktury i danych bazy do pliku SQL lub innych formatów (np. CSV), jak również na import z takich plików. Opcje te są bardzo przydatne do migracji, kopii zapasowych oraz wymiany danych z innymi osobami.

1. Wybierz bazę lub tabelę do importu/eksportu.
2. Znajdź opcję Eksport lub Import.
3. Wybierz format, zakres oraz ustawienia zgodnie z instrukcjami na ekranie i rozpocznij operację.

Usuwanie bazy danych

(dotyczy MariaDB/MySQL, PostgreSQL)

1. Zaloguj się na serwer baz danych (bez podania konkretnej bazy).
2. Znajdź na liście baz tę do usunięcia.
3. Kliknij na Usuń i potwierdź decyzję. Uwaga: Operacja jest nieodwracalna i usuwa wszystkie dane z danej bazy!

(dla SQLite 3 usunięcie bazy polega na ręcznym skasowaniu pliku .sqlite z systemu plików).

Uwagi

• Bezpieczeństwo danych uwierzytelniających: Login i hasło do baz danych pobrane z ustawień ServBay należy bezpiecznie przechowywać i nie udostępniać osobom niepowołanym.
• Stan działania ServBay: Adminer jest dostępny przez wbudowany serwer www ServBay i wymaga uruchomienia także własnej bazy danych. Jeśli nie można połączyć się z Adminerem lub bazą, upewnij się, że ServBay oraz powiązane usługi (Caddy/Nginx, MariaDB/MySQL, PostgreSQL itd.) są aktywne.
• Ścieżka do pliku SQLite: Wskazuj zawsze lokalizację, do której użytkownik ServBay ma prawa odczytu i zapisu – najlepiej katalog /Applications/ServBay/db/sqlite/.
• Wydajność: Adminer jest lekki i wygodny, ale w przypadku bardzo dużych baz lub złożonych zadań administracyjnych warto rozważyć dedykowane aplikacje desktopowe (TablePlus, DBeaver, pgAdmin itp.) oferujące więcej zaawansowanych funkcji.

Najczęściej zadawane pytania (FAQ)

Q: Nie mogę otworzyć https://servbay.host/adminer.php. Co robić?

A: Sprawdź, czy ServBay jest uruchomiony oraz czy serwer www ServBay (najczęściej Caddy lub Nginx) działa. Upewnij się także, że przeglądarka pozwala na dostęp do https://servbay.host.

Q: Zapomniałem loginu lub hasła do bazy – gdzie je znaleźć?

A: Domyślne dane dostępowe do każdej bazy są widoczne w zakładce „Bazy danych” w interfejsie aplikacji ServBay.

Q: Jaki adres i port serwera należy podać przy połączeniu z PostgreSQL?

A: Najczęściej jest to localhost oraz domyślny port 5432. Sprawdź jednak ustawienia PostgreSQL w ServBay dla pewności. Jeśli łączysz się przez Unix Domain Socket, wpisz /Applications/ServBay/tmp (bez końcówki .sock – PostgreSQL jej nie wymaga).

Q: Czym różni się podanie adresu serwera od ścieżki do socket przy łączeniu z MariaDB/MySQL?

A: Użycie localhost powoduje połączenie przez TCP/IP (port 3306), natomiast /Applications/ServBay/tmp/mysql.sock oznacza połączenie przez Unix Domain Socket – lokalne, zazwyczaj nieco szybsze i bezpieczniejsze. Możesz wybrać dowolny sposób, zależnie od potrzeb.

Q: Czy Adminer obsłuży inne bazy, których nie oferuje ServBay?

A: Adminer sam z siebie obsługuje szereg różnych systemów bazowych. Jeśli masz zainstalowaną poza ServBay inną bazę (np. samodzielnego MongoDB lub zdalną bazę), w teorii możesz połączyć się z nią przez Adminera z ServBay, mając poprawne dane i zapewnioną łączność. Główne zalety integracji Adminera dotyczą jednak wygody zarządzania bazami wbudowanymi w ServBay.

Podsumowanie

Adminer, narzędzie udostępniane przez ServBay, znacząco ułatwia zarządzanie bazami danych w środowisku lokalnym. Jego prostota instalacji (pojedynczy plik), lekkość oraz obsługa wielu rodzajów baz, pozwalają w wygodny sposób zarządzać MariaDB/MySQL, PostgreSQL i SQLite na swoim Macu. Mając ten przewodnik, bez trudu połączysz się z bazami danych w ServBay i przeprowadzisz podstawowe operacje administracyjne czy manipulacje danymi za pomocą Adminera.