Jak zarządzać bazami danych ServBay przy użyciu TablePlus

ServBay to środowisko lokalne do tworzenia stron WWW zaprojektowane specjalnie dla macOS. Integruje wiele języków programowania, serwerów webowych oraz systemów baz danych, oferując deweloperom kompleksową platformę do pracy. Aby wygodnie zarządzać bazami danych zintegrowanymi w ServBay — takimi jak MySQL/MariaDB, PostgreSQL, SQLite, Redis czy MongoDB — warto wykorzystać zaawansowane narzędzie do zarządzania bazami danych. TablePlus to nowoczesny, intuicyjny klient obsługujący wiele typów baz danych, idealnie nadający się do współpracy z ServBay.

W tym przewodniku znajdziesz szczegółowe informacje, jak połączyć się i zarządzać bazami danych ServBay przy pomocy TablePlus na macOS.

Czym jest TablePlus?

TablePlus to wydajne, przyjazne dla użytkownika narzędzie GUI do zarządzania bazami danych. Obsługuje szeroką gamę systemów baz danych, w tym:

• Bazy danych relacyjne: MySQL, MariaDB, PostgreSQL, SQLite, SQL Server
• Bazy danych NoSQL: Redis, MongoDB
• Inne: Cassandra, Oracle i inne

TablePlus oferuje szereg funkcji, które ułatwiają deweloperom codzienną pracę:

• Intuicyjny interfejs: Przejrzysty układ i prosta nawigacja.
• Szybkie działanie: Optymalizacja pod kątem wydajności — obsługa dużych zbiorów danych bez spadków płynności.
• Zaawansowany edytor zapytań: Podświetlanie składni, autouzupełnianie, obsługa wielu zakładek z zapytaniami.
• Edytowanie i przeglądanie danych: Łatwa nawigacja, wprowadzanie, aktualizowanie oraz usuwanie rekordów.
• Zarządzanie strukturą: Wizualne zarządzanie strukturą tabel, indeksami, widokami itd.
• Bezpieczne połączenia: Obsługa połączeń szyfrowanych SSL/TLS.

Przy pracy z ServBay TablePlus znacząco podnosi efektywność zarządzania bazą danych podczas lokalnego developmentu.

Łączenie baz danych ServBay z TablePlus

ServBay domyślnie uruchamia i obsługuje wiele usług bazodanowych lokalnie. Status zainstalowanych i aktywnych baz danych sprawdzisz w zakładce Pakiety (Packages) w aplikacji ServBay. Aby dodać te bazy do TablePlus, potrzebujesz prawidłowych parametrów połączenia — znajdziesz je w zakładce Bazy danych (Databases) ServBay.

Poniżej znajdziesz instrukcję konfiguracji połączenia dla poszczególnych typów baz danych w ServBay.

Połączenie z MariaDB lub MySQL

ServBay domyślnie instaluje i uruchamia MariaDB (w pełni zgodną z MySQL).

1. Pobierz i zainstaluj TablePlus: Jeśli jeszcze nie masz, pobierz TablePlus dla macOS z oficjalnej strony i zainstaluj aplikację.
2. Uruchom TablePlus i utwórz nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij przycisk "+" w lewym górnym rogu lub wybierz z menu File -> New -> Connection....
   • Wybierz typ bazy danych: MariaDB lub MySQL.
3. Wprowadź dane połączenia:
   • Name: Nazwij połączenie (np. ServBay MariaDB).
   • Host: 127.0.0.1 (czyli lokalne połączenie)
   • Port: 3306 (domyślny port MariaDB/MySQL)
   • User: Odczytaj nazwę użytkownika root w zakładce Bazy danych (Databases) w ServBay (zwykle to root).
   • Password: Sprawdź hasło użytkownika root w tej samej zakładce ServBay.
   • Database: Pole można zostawić puste, by wybrać bazę po połączeniu; lub wpisać konkretną nazwę bazy.
   • Alternatywa: Możesz również wybrać połączenie przez Socket – często szybsze i bardziej bezpośrednie niż TCP/IP.
     • Zaznacz pole Use socket file.
     • Socket Path: /Applications/ServBay/tmp/mysql.sock (domyślna ścieżka do socket MariaDB/MySQL w ServBay).
     • Przy połączeniu przez Socket pola Host i Port są ignorowane.
4. Testuj i zapisz połączenie:
   • Kliknij przycisk Test w prawym dolnym roku, aby sprawdzić poprawność danych. Sukces oznacza poprawną konfigurację.
   • Kliknij Connect, aby się połączyć; możesz też najpierw kliknąć Save, by zachować ustawienia na przyszłość.

Połączenie z PostgreSQL

ServBay obsługuje również bazę danych PostgreSQL.

1. Uruchom TablePlus i utwórz nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+" lub wybierz z menu File -> New -> Connection....
   • Wybierz typ bazy: PostgreSQL.
2. Wprowadź dane połączenia:
   • Name: np. ServBay PostgreSQL.
   • Host: 127.0.0.1
   • Port: 5432 (domyślny port PostgreSQL)
   • User: Sprawdź domyślną nazwę użytkownika w zakładce Bazy danych (Databases) ServBay (zazwyczaj servbay).
   • Password: Sprawdź domyślne hasło w tej samej zakładce.
   • Database: Najczęściej należy wpisać nazwę bazy, np. domyślne postgres lub innej utworzonej w ServBay.
   • Alternatywa: Możesz wybrać połączenie przez Socket.
     • Zaznacz Use socket file.
     • Socket Path: /Applications/ServBay/tmp/.s.PGSQL.5432 (domyślna ścieżka do socket PostgreSQL w ServBay).
     • Przy połączeniu przez Socket Host i Port są ignorowane.
3. Testuj i zapisz połączenie:
   • Kliknij Test, by sprawdzić połączenie.
   • Kliknij Connect lub Save.

Połączenie z SQLite 3

SQLite to wbudowana baza bez serwera, przechowująca dane w pliku. ServBay nie uruchamia „serwera” SQLite, ale aplikacje można podłączać do pliku bazy przez PHP PDO SQLite, Python sqlite3 czy inne moduły. TablePlus łączy się bezpośrednio z plikiem bazy.

1. Uruchom TablePlus i utwórz nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+" lub wybierz z menu File -> New -> Connection....
   • Wybierz typ bazy: SQLite.
2. Wprowadź dane połączenia:
   • Name: np. ServBay SQLite Project.
   • Database File: Kliknij ikonę folderu i wskaż plik SQLite (.sqlite, .db, .sqlite3 itd.). Dla porządku pliki bazy możesz przechowywać w katalogu projektu lub w katalogu /Applications/ServBay/db/sqlite.
3. Testuj i zapisz połączenie:
   • Kliknij Test (jeśli plik istnieje i masz do niego dostęp).
   • Kliknij Connect lub Save.

Połączenie z Redis

Redis to wysokowydajna baza key-value. ServBay może ją zainstalować i uruchomić jako usługę.

1. Uruchom TablePlus i utwórz nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+" lub wybierz z menu File -> New -> Connection....
   • Wybierz typ bazy: Redis.
2. Wprowadź dane połączenia:
   • Name: np. ServBay Redis.
   • Host: 127.0.0.1
   • Port: 6379 (domyślny port Redis)
   • Password: Jeśli ustawiłeś hasło w ServBay dla Redis — wpisz je tutaj. Domyślnie jest puste.
3. Testuj i zapisz połączenie:
   • Kliknij Test, by sprawdzić połączenie.
   • Kliknij Connect lub Save.

Połączenie z MongoDB

ServBay pozwala instalować i uruchamiać bazę MongoDB.

1. Uruchom TablePlus i utwórz nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+" lub wybierz z menu File -> New -> Connection....
   • Wybierz typ bazy: MongoDB.
2. Wprowadź dane połączenia:
   • Name: np. ServBay MongoDB.
   • Host: 127.0.0.1
   • Port: 27017 (domyślny port MongoDB)
   • User: Jeśli ustawiłeś uwierzytelnianie, podaj użytkownika. Domyślnie MongoDB w ServBay ma wyłączoną autoryzację, więc pole można zostawić puste.
   • Password: Wpisz hasło, jeśli jest wymagane.
   • Authentication Database: Jeśli korzystasz z uwierzytelniania, być może trzeba podać bazę autoryzującą, np. admin.
   • Database: Opcjonalne — pozostaw puste lub wpisz docelową bazę.
3. Testuj i zapisz połączenie:
   • Kliknij Test, by sprawdzić połączenie.
   • Kliknij Connect lub Save.

Zarządzanie bazami relacyjnymi w TablePlus (MariaDB/MySQL, PostgreSQL, SQLite)

Po udanym połączeniu TablePlus oferuje zbliżony interfejs i workflow do zarządzania relacyjnymi bazami danych: MariaDB/MySQL, PostgreSQL oraz SQLite.

1. Tworzenie bazy danych

• Po połączeniu (dla SQLite — po wskazaniu pliku) zobaczysz pasek boczny po lewej stronie.
• Dla MariaDB/MySQL i PostgreSQL wybierz zakładkę Databases.
• Kliknij "+" (Nowa) w lewym górnym rogu lub kliknij prawym na puste miejsce i wybierz New Database....
• Podaj nazwę bazy, wybierz kodowanie i sortowanie (jeśli trzeba).
• Kliknij Save.

2. Tworzenie tabeli

• Wybierz bazę danych w bocznym menu.
• Otwórz zakładkę Tables.
• Kliknij "+" (Nowa) lub prawy przycisk na pustym miejscu → New Table....
• Podaj nazwę tabeli.
• Zdefiniuj jej kolumny:
  • Kliknij "+" by dodać kolumnę.
  • Uzupełnij nazwę kolumny.
  • Wybierz typ danych.
  • Ustaw długość (jeśli typ tego wymaga).
  • Zaznacz PK dla klucza głównego, NN dla NOT NULL, UQ dla unikalnego indeksu, AI dla auto-increment itp.
  • Możesz ustawić wartość domyślną (Default).
  • Możesz dodać komentarz (Comment).
• Po zdefiniowaniu wszystkich kolumn kliknij Save (lub skrót Cmd + S).

3. Dodawanie danych

• Wybierz odpowiednią bazę, następnie tabelę w zakładce Tables.
• W widoku danych tabeli kliknij + Row na dole.
• Pojawi się nowy pusty wiersz — kliknij dwukrotnie w komórki, by wprowadzić dane.
• Po wpisaniu danych kliknij Save (lub Cmd + S).

4. Wyszukiwanie (zapytania) danych

• W menu po lewej wybierz bazę oraz tabelę.
• Przeglądaj dane bezpośrednio w widoku tabeli.
• Możesz użyć pola filtrującego (Filter) na górze, by szybko wyszukać dane.
• Do bardziej zaawansowanych zapytań użyj edytora SQL TablePlus:
  • Kliknij SQL Query w pasku narzędzi lub użyj Cmd + N.
  • W nowej zakładce wpisz zapytanie SQL (np. SELECT * FROM twoja_tabela WHERE warunek;).
  • Kliknij Run Current (ikona błyskawicy) lub Cmd + Enter, by uruchomić zapytanie. Wyniki pokażą się poniżej.

5. Aktualizacja danych

• W widoku danych tabeli dwukrotnie kliknij komórkę do edycji.
• Wprowadź nową wartość.
• Po zakończeniu edycji kliknij Save lub Cmd + S.

6. Usuwanie danych

• Wybierz wiersze do usunięcia w widoku danych tabeli.
• Kliknij prawym na zaznaczeniu — wybierz Delete Row(s).
• Potwierdź usunięcie w oknie dialogowym.
• Kliknij Save lub Cmd + S.

7. Usuwanie tabeli

• Wybierz bazę w pasku bocznym.
• Otwórz zakładkę Tables.
• Zaznacz tabelę do usunięcia.
• Kliknij prawym — wybierz Delete Table(s).
• Potwierdź wpisując nazwę tabeli i klikając Delete.

8. Usuwanie bazy danych

• Dla MariaDB/MySQL lub PostgreSQL otwórz zakładkę Databases.
• Zaznacz bazę do usunięcia.
• Kliknij prawym — wybierz Delete Database.
• Potwierdź wpisując nazwę bazy i kliknij Delete.
• Dla SQLite: Usunięcie bazy to po prostu usunięcie odpowiedniego pliku .sqlite w systemie plików.

Zarządzanie bazami NoSQL w TablePlus (Redis, MongoDB)

TablePlus oferuje dedykowane panele do zarządzania Redis i MongoDB — interfejs i operacje różnią się od relacyjnych baz danych.

Zarządzanie danymi w Redis

Po połączeniu z Redis:

• Pasek boczny po lewej wyświetla listę baz Redis (DB0, DB1, ...). Zwykle używany jest DB0.
• Wybierz bazę — po prawej zobaczysz wszystkie klucze.
• Przeglądanie kluczy: Listę kluczy możesz przeglądać bezpośrednio lub filtrować u góry. Po kliknięciu w nazwę klucza zobaczysz jego typ i wartość. TablePlus wyświetla dane w odpowiednich formatach dla stringów, hashy, list, setów i sorted setów.
• Dodawanie kluczy: Kliknij + Row na dole. Wybierz typ, podaj nazwę i wartość — kliknij Save.
• Edycja kluczy: Dwukrotnie kliknij nazwę lub wartość klucza, edytuj, kliknij Save.
• Usuwanie kluczy: Zaznacz klucze, kliknij prawym, wybierz Delete Row(s), zatwierdź Delete.

Zarządzanie danymi w MongoDB

Po połączeniu z MongoDB:

• Pasek boczny po lewej wyświetla listę baz danych MongoDB.
• Wybierz bazę — po prawej pojawią się kolekcje (Collections).
• Przeglądanie danych kolekcji: Kliknij dwukrotnie nazwę kolekcji, a po prawej pojawi się widok dokumentów (zwykle w formacie JSON).
• Dodawanie dokumentów: W widoku kolekcji kliknij + Row na dole — nowy dokument można edytować dwukrotnie klikając pole lub używając edytora JSON. Kliknij Save.
• Edycja dokumentów: Dwukrotnie kliknij pole w dokumencie lub edytuj JSON, potem kliknij Save.
• Usuwanie dokumentów: Zaznacz dokumenty, kliknij prawym i wybierz Delete Row(s), zatwierdź Delete.
• Tworzenie kolekcji: W pasku bocznym wybierz bazę, zakładka Collections, kliknij "+" lub prawym → New Collection..., podaj nazwę i kliknij Save.
• Usuwanie kolekcji: Wybierz kolekcję, prawym → Delete Collection(s), potwierdź.
• Usuwanie bazy: Wybierz bazę w pasku bocznym, prawym → Delete Database, potwierdź.

Wskazówki i FAQ

• Status ServBay: Przed połączeniem upewnij się, że ServBay jest uruchomiony, a baza, z którą chcesz się połączyć (np. MariaDB, PostgreSQL, Redis, MongoDB), widnieje jako „uruchomiona” w zakładce Pakiety (Packages).
• Firewall: Sprawdź, czy firewall macOS lub inna aplikacja zabezpieczająca nie blokuje portów lokalnych (3306, 5432, 6379, 27017) dla TablePlus.
• Dane dostępowe: Domyślne loginy i hasła do baz znajdziesz zawsze w zakładce Bazy danych (Databases) w ServBay. Zadbaj o bezpieczeństwo tych informacji.
• Zmiana domyślnego hasła: Dla bezpieczeństwa zaleca się zmienić domyślne hasła kont root lub domyślnych użytkowników. W zakładce Bazy danych (Databases) zwykle jest opcja resetu hasła. Po zmianie uaktualnij je w TablePlus.
• Połączenia Socket vs Port: Połączenie Socket działa przez plik systemowy — szybciej i bez narodowych konfiguracji, idealne dla lokalnych połączeń; połączenie Port (TCP/IP) pozwala np. na zdalne połączenia (również lokalnie przez 127.0.0.1). Oba sposoby działają w środowisku lokalnym ServBay.
• Alternatywne narzędzia: Możesz korzystać z innych narzędzi, takich jak DBeaver, DataGrip, Sequel Ace (MySQL/MariaDB), pgAdmin (PostgreSQL), MongoDB Compass (MongoDB). Metody konfiguracji są bardzo podobne — użyj danych podanych w zakładce Bazy danych (Databases) ServBay.

Podsumowanie

Po zapoznaniu się z tym przewodnikiem powinieneś być w stanie połączyć się i sprawnie zarządzać różnymi bazami danych lokalnego środowiska programistycznego ServBay na macOS przy pomocy TablePlus. Dzięki funkcjonalności TablePlus i kompleksowemu środowisku ServBay, praca deweloperska staje się dużo wygodniejsza i sprawniejsza. Klucz do sukcesu: zawsze pobieraj aktualne dane autoryzacyjne z ServBay. Powodzenia w pracy!