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

ServBay to lokalne środowisko web developerskie dostępne na macOS i Windows, które integruje wiele języków programowania, serwerów webowych i systemów bazodanowych, oferując deweloperom kompleksową platformę do pracy. Aby sprawnie zarządzać bazami danych dostępnymi w ServBay, takimi jak MySQL/MariaDB, PostgreSQL, SQLite, Redis, czy MongoDB, warto skorzystać z zaawansowanego narzędzia do zarządzania bazami danych. TablePlus to nowoczesny, intuicyjny klient obsługujący wiele typów baz danych, idealnie nadaje się do pracy z ServBay.

W tym przewodniku krok po kroku dowiesz się, jak na macOS połączyć się i zarządzać bazami danych dostępnych w ServBay przy użyciu TablePlus.

Czym jest TablePlus?

TablePlus to potężne i przyjazne użytkownikowi narzędzie GUI do zarządzania bazami danych. Wspiera szerokie spektrum typów baz danych, m.in.:

• Bazy relacyjne: MySQL, MariaDB, PostgreSQL, SQLite, SQL Server
• Bazy NoSQL: Redis, MongoDB
• Inne: Cassandra, Oracle i wiele więcej

TablePlus oferuje szereg funkcji ułatwiających programowanie, administrowanie i utrzymanie baz danych:

• Przejrzysty interfejs: Prosty układ, łatwa nawigacja i obsługa.
• Błyskawiczna reakcja: Optymalizowany pod względem wydajności, sprawnie obsługuje duże zbiory danych.
• Zaawansowany edytor zapytań: Podświetlanie składni, autouzupełnianie i wielozakładkowa praca z SQL.
• Łatwe przeglądanie i edycja danych: Intuicyjna obsługa dodawania, przeglądania, aktualizacji i usuwania rekordów.
• Zarządzanie strukturą: Wizualne zarządzanie strukturą tabel, indeksami, widokami itd.
• Bezpieczne połączenia: Wsparcie dla szyfrowania SSL/TLS.

Dla lokalnych deweloperów pracujących z ServBay, TablePlus znacząco usprawnia i przyspiesza pracę z bazami danych.

Łączenie baz danych ServBay z TablePlus

ServBay domyślnie uruchamia wiele usług bazodanowych lokalnie. Stan zainstalowanych i aktywnych baz danych można sprawdzić w zakładce Pakiety (Packages) w aplikacji ServBay. Aby połączyć bazę danych z TablePlus, potrzebne są prawidłowe dane połączenia – dostępne w zakładce Bazy danych (Databases) w ServBay.

Poniżej znajdziesz szczegółowe instrukcje oraz dane wymagane do połączenia się z różnymi bazami danych ServBay.

Połączenie z MariaDB lub MySQL

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

1. Pobierz i zainstaluj TablePlus: Jeśli jeszcze nie posiadasz, pobierz i zainstaluj TablePlus na macOS ze strony TablePlus.
2. Uruchom TablePlus i dodaj nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij ikonę "+" w lewym górnym rogu lub wybierz File -> New -> Connection... w menu.
   • Wybierz typ bazy danych: MariaDB albo MySQL.
3. Konfiguracja danych połączenia:
   • Name (Nazwa): Nazwij połączenie, np. ServBay MariaDB.
   • Host: 127.0.0.1 (połączenie lokalne)
   • Port: 3306 (domyślny port MariaDB/MySQL)
   • User (Użytkownik): Sprawdź nazwę użytkownika root w zakładce Bazy danych (Databases) w ServBay (zwykle root).
   • Password (Hasło): Sprawdź hasło root w zakładce Bazy danych (Databases) w ServBay.
   • Database (Baza danych): Możesz zostawić puste lub wpisać nazwę konkretnej bazy, którą chcesz używać.
   • Alternatywa: Możesz użyć połączenia przez Socket – zazwyczaj szybsze i bardziej bezpośrednie niż TCP/IP.
     • Zaznacz Use socket file.
     • Socket Path: /Applications/ServBay/tmp/mysql.sock (domyślna ścieżka 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 rogu, by sprawdzić poprawność danych.
   • Jeśli test zakończy się powodzeniem, kliknij Connect, by połączyć się z bazą, albo Save, by zapisać konfigurację na później.

Połączenie z PostgreSQL

ServBay obsługuje również PostgreSQL.

1. Uruchom TablePlus i dodaj nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+", lub wybierz File -> New -> Connection....
   • Wybierz typ bazy: PostgreSQL.
2. Konfiguracja danych połączenia:
   • Name (Nazwa): np. ServBay PostgreSQL.
   • Host: 127.0.0.1
   • Port: 5432 (domyślny port PostgreSQL)
   • User (Użytkownik): Sprawdź domyślną nazwę użytkownika w zakładce Bazy danych (Databases) w ServBay (zazwyczaj servbay).
   • Password (Hasło): Sprawdź domyślne hasło w ServBay.
   • Database (Baza): Najczęściej wybierz domyślną bazę postgres lub inną, którą utworzyłeś w ServBay.
   • Alternatywa: Możesz użyć połączenia przez Socket.
     • Zaznacz Use socket file.
     • Socket Path: /Applications/ServBay/tmp/.s.PGSQL.5432 (domyślna ścieżka socket PostgreSQL w ServBay).
     • Host i Port nie są wtedy potrzebne.
3. Testuj i zapisz połączenie:
   • Kliknij Test, by sprawdzić połączenie.
   • Kliknij Connect lub Save.

Połączenie z SQLite 3

SQLite to bezserwerowy silnik bazodanowy przechowujący dane w pliku. ServBay nie uruchamia dedykowanego procesu SQLite, ale możesz z niego korzystać poprzez PDO SQLite w PHP lub moduł Python sqlite3. TablePlus pozwala na bezpośrednie połączenie z wybranym plikiem bazy.

1. Uruchom TablePlus i dodaj nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+", lub wybierz File -> New -> Connection....
   • Wybierz typ bazy: SQLite.
2. Konfiguracja danych połączenia:
   • Name (Nazwa): np. ServBay SQLite Projekt.
   • Database File (Plik bazy): Kliknij ikonę folderu i wybierz plik bazy danych SQLite (.sqlite, .db, .sqlite3 itd.). Rekomendujemy trzymać pliki bazy w katalogu projektu lub w katalogu /Applications/ServBay/db/sqlite – usprawni to zarządzanie.
3. Testuj i zapisz połączenie:
   • Kliknij Test (jeśli plik istnieje i jest dostępny).
   • Kliknij Connect lub Save.

Połączenie z Redis

Redis to wydajna baza klucz-wartość. ServBay umożliwia instalację i uruchomienie usługi Redis.

1. Uruchom TablePlus i dodaj nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+", lub wybierz File -> New -> Connection....
   • Wybierz typ bazy: Redis.
2. Konfiguracja danych połączenia:
   • Name (Nazwa): np. ServBay Redis.
   • Host: 127.0.0.1
   • Port: 6379 (domyślny port Redis)
   • Password (Hasło): Jeśli ustawiłeś hasło dla Redis w ServBay, wpisz je tutaj. Domyślnie nie jest ustawione, więc pole może zostać puste.
3. Testuj i zapisz połączenie:
   • Kliknij Test, by sprawdzić połączenie.
   • Kliknij Connect lub Save.

Połączenie z MongoDB

ServBay wspiera instalację i uruchomienie MongoDB.

1. Uruchom TablePlus i dodaj nowe połączenie:
   • Otwórz TablePlus.
   • Kliknij "+", lub wybierz File -> New -> Connection....
   • Wybierz typ bazy: MongoDB.
2. Konfiguracja danych połączenia:
   • Name (Nazwa): np. ServBay MongoDB.
   • Host: 127.0.0.1
   • Port: 27017 (domyślny port MongoDB)
   • User (Użytkownik): Wpisz, jeśli włączyłeś autoryzację użytkownika w MongoDB. W domyślnej instalacji ServBay MongoDB zazwyczaj nie jest wymagane – możesz zostawić puste.
   • Password (Hasło): Wpisz, jeśli wymagana jest autoryzacja.
   • Authentication Database (Baza uwierzytelniania): Jeśli potrzebne – podaj np. admin.
   • Database (Baza): Możesz zostawić puste i wybrać bazę po połączeniu, lub wpisać konkretną nazwę bazy.
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 połączeniu TablePlus zapewnia zbliżony interfejs i workflow do zarządzania relacyjnymi bazami danych: MariaDB/MySQL, PostgreSQL i SQLite.

1. Tworzenie bazy danych

• Po połączeniu z serwerem bazy (lub plikiem – SQLite), zobaczysz lewy panel.
• W MariaDB/MySQL i PostgreSQL kliknij zakładkę Databases.
• Kliknij "+" lub prawym przyciskiem myszy wybierz New Database....
• Podaj nazwę nowej bazy, wybierz zestaw znaków i porządek (collation) – jeśli wymagane.
• Kliknij Save.

2. Tworzenie tabeli

• W lewym panelu wybierz bazę, w której chcesz utworzyć tabelę.
• Kliknij zakładkę Tables.
• Kliknij "+" lub prawym przyciskiem myszy wybierz New Table....
• Podaj nazwę tabeli.
• W dolnej części definiuj kolumny:
  • Kliknij "+", by dodać kolumnę.
  • Podaj nazwę kolumny.
  • Wybierz typ danych.
  • Ustaw długość lub wartości, jeśli typ tego wymaga.
  • Zaznacz PK (klucz główny), NN (niepusty), UQ (unikalny), AI (auto-increment) itd.
  • Ustaw domyślną wartość.
  • Dodaj komentarz (jeśli chcesz).
• Po zdefiniowaniu struktur, kliknij Save (lub skrót Cmd + S), by zapisać tabelę.

3. Dodawanie danych

• W lewym panelu wybierz bazę i tabelę.
• W oknie tabeli kliknij na dole + Row.
• Pojawi się nowy pusty wiersz – kliknij dwukrotnie każde pole, by wpisać wartość.
• Po uzupełnieniu kliknij Save (lub Cmd + S), by zapisać zmiany.

4. Wyszukiwanie danych

• W lewym panelu wybierz bazę i tabelę.
• Przeglądaj dane bezpośrednio w widoku tabeli.
• Skorzystaj z filtra u góry (Filter), by szybko wyszukać rekordy.
• W przypadku złożonych zapytań użyj edytora SQL TablePlus:
  • Kliknij SQL Query na pasku narzędzi lub użyj Cmd + N.
  • W nowej zakładce wpisz zapytanie SQL (np. SELECT * FROM your_table WHERE condition;).
  • Kliknij Run Current (ikona pioruna) lub użyj Cmd + Enter. Wyniki pojawią się poniżej.

5. Aktualizacja danych

• W widoku tabeli kliknij dwukrotnie pole, które chcesz zmienić.
• Wpisz nową wartość.
• Po zakończeniu kliknij Save (lub Cmd + S), by zapisać zmiany.

6. Usuwanie danych

• W widoku tabeli zaznacz jeden lub kilka wierszy do usunięcia.
• Kliknij prawym przyciskiem i wybierz Delete Row(s).
• Potwierdź usunięcie w wyświetlonym oknie dialogowym.
• Kliknij Save (lub Cmd + S), by zapisać zmiany.

7. Usuwanie tabeli

• W lewym panelu wybierz bazę.
• Przejdź do zakładki Tables.
• Zaznacz jedną lub kilka tabel do usunięcia.
• Kliknij prawym przyciskiem i wybierz Delete Table(s).
• W oknie potwierdzenia wpisz nazwę tabeli i kliknij Delete.

8. Usuwanie bazy danych

• W lewym panelu dla MariaDB/MySQL lub PostgreSQL przejdź do zakładki Databases.
• Zaznacz bazę do usunięcia.
• Kliknij prawym przyciskiem i wybierz Delete Database.
• W oknie potwierdzenia wpisz nazwę bazy i kliknij Delete.
• Dla SQLite: Usunięcie bazy polega na ręcznym usunięciu pliku .sqlite w systemie plików.

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

TablePlus oferuje dedykowane interfejsy dla Redis i MongoDB; obsługa różni się od relacyjnych baz danych.

Zarządzanie danymi Redis

Po połączeniu z Redis:

• W lewym panelu zobaczysz listę baz Redis (DB0, DB1, ...). Domyślnie wykorzystywane jest DB0.
• Wybierz bazę – po prawej zobaczysz wszystkie klucze (Keys).
• Przeglądanie kluczy: Przeglądaj listę nazw, skorzystaj z filtra na górze. Kliknij nazwę klucza, by zobaczyć typ i wartość. TablePlus przedstawi dane w odpowiedni sposób (string, hash, lista, set, sorted set itd.).
• Dodawanie klucza: Na dole kliknij + Row, wybierz typ, wpisz nazwę klucza i wartość. Kliknij Save.
• Edycja klucza: Dwukrotnie kliknij nazwę lub wartość, by edytować. Po modyfikacji kliknij Save.
• Usuwanie klucza: Zaznacz jeden lub kilka kluczy, kliknij prawym i wybierz Delete Row(s), potwierdź wybór.

Zarządzanie danymi MongoDB

Po połączeniu z MongoDB:

• W lewym panelu widzisz listę baz danych MongoDB.
• Wybierz bazę – po prawej pojawią się kolekcje (Collections).
• Przeglądanie danych w kolekcji: Dwukrotnie kliknij nazwę kolekcji, by przejść do widoku dokumentów (zazwyczaj JSON).
• Dodawanie dokumentu: Kliknij na dole + Row, pojawi się nowy dokument – wpisz wartości w polach. Kliknij Save.
• Edycja dokumentu: Dwukrotnie kliknij pole lub wartość; TablePlus obsługuje edycję w formacie JSON/BSON. Kliknij Save.
• Usuwanie dokumentu: W widoku kolekcji zaznacz dokument, kliknij prawym i wybierz Delete Row(s), potwierdź.
• Tworzenie kolekcji: Wybierz bazę w lewym panelu, kliknij zakładkę Collections, kliknij "+", lub prawym wybierz New Collection.... Podaj nazwę i kliknij Save.
• Usuwanie kolekcji: Zaznacz kolekcję w lewym panelu, kliknij prawym – wybierz Delete Collection(s), potwierdź.
• Usuwanie bazy: Zaznacz bazę w lewym panelu, kliknij prawym i wybierz Delete Database, potwierdź.

Ważne uwagi i najczęstsze pytania

• Stan ServBay: Przed próbą połączenia z bazą przez TablePlus upewnij się, że ServBay działa, a usługa bazy (np. MariaDB, PostgreSQL, Redis, MongoDB) jest oznaczona jako „uruchomiona” w zakładce Pakiety (Packages).
• Firewall: Sprawdź, czy firewall macOS lub dodatkowe oprogramowanie zabezpieczające nie blokuje TablePlus w komunikacji z lokalnymi portami baz danych (3306, 5432, 6379, 27017).
• Dane dostępowe: Domyślne loginy i hasła do baz znajdziesz w zakładce Bazy danych (Databases) w ServBay – dbaj o ich bezpieczeństwo.
• Zmiana haseł domyślnych: Dla bezpieczeństwa zaleca się zmianę domyślnego hasła root lub innego użytkownika w bazie – ServBay umożliwia resetowanie haseł w zakładce Bazy danych (Databases). Po zmianie należy zaktualizować dane w TablePlus.
• Socket czy Port: Połączenie przez socket korzysta z pliku systemowego i jest rekomendowane na jednej maszynie – jest odrobinę szybsze niż TCP/IP i nie zależy od konfiguracji sieci. Połączenie przez port (TCP/IP) pozwala na dostęp lokalny i z innych urządzeń. W środowisku lokalnym ServBay obie metody działają.
• Inne narzędzia? Oczywiście! TablePlus to nie jedyne narzędzie – są też DBeaver, DataGrip, Sequel Ace (MySQL/MariaDB), pgAdmin (PostgreSQL), MongoDB Compass itd. Wybór zależy od preferencji i potrzeb; sposób połączenia pozostaje podobny – wystarczy użyć odpowiednich danych z ServBay.

Podsumowanie

Dzięki temu przewodnikowi wiesz już, jak połączyć się oraz efektywnie zarządzać bazami danych ServBay na macOS przy użyciu TablePlus. Potężne możliwości i przejrzysty interfejs TablePlus w połączeniu z zintegrowanym lokalnym środowiskiem ServBay znacząco usprawnią Twój proces tworzenia aplikacji. Kluczowym jest, by dane dostępowe pobierać bezpośrednio z ServBay. Powodzenia w pracy i miłego kodowania!