Wskazówki

Adminer trzyma częste zadania pod ręką, a resztę raczej ukrywa, niż pomija. Ta strona zbiera funkcje, które łatwo przeoczyć, i większość z nich można od razu wypróbować. (demo)

Na macOS naciskaj Cmd wszędzie tam, gdzie mowa o Ctrl. Kod na końcu wskazówki jest trwałym odnośnikiem do niej.

Wybieranie danych

• Ctrl+kliknięcie dowolnej wartości w wyniku zmienia ją na miejscu, Esc przywraca pierwotną. Zapisz zmiany zapisuje wszystkie zmienione komórki naraz. (demo) [S1]
• Długie teksty są skracane do pierwszych 100 znaków. Ctrl+kliknięcie pobiera całą wartość, a pusta Długość tekstu od razu pokazuje wszystko. [S2]
• Odnośnik Zmień zamienia cały wynik naraz w pola do wpisywania. [S3]
• Kliknięcie gdziekolwiek w wierszu zaznacza go. Zaznaczanie tekstu przeciąganiem zostawia wiersz w spokoju. [S4]
• Shift+kliknięcie pola wyboru zaznacza wszystko między nim a poprzednio klikniętym. [S5]
• Pole wyboru w nagłówku zaznacza rekordy z bieżącej strony, a to w sekcji Wybierz wszystkie wszystko, co pasuje do filtru. Gdy nie zaznaczono nic, Edytuj, Duplikuj i Usuń są wyłączone, ale Eksportuj i tak obejmuje cały wynik. [S6]
• Zaznacz kilka rekordów i naciśnij Edytuj, aby nadpisać je razem. Kolumny pozostawione na bez zmian zachowują swoją wartość w każdym rekordzie. [S7]
• Duplikuj działa tak samo i wstawia kopie wszystkich zaznaczonych rekordów. [S8]
• Wybierz kolumnę i funkcję agregującą w sekcji pokaż, a Adminer zbuduje za ciebie zapytanie z GROUP BY, np. author, COUNT(*). (demo) [S9]
• Kliknięcie otrzymanej liczby pokazuje rekordy, które za nią stoją. Pozostałe warunki zostają w mocy. [S10]
• Operator SQL w wyszukiwaniu wysyła twój tekst do bazy bez zmian: porównaj dwie kolumny (= inna_kolumna), użyj podzapytania (IN (SELECT ...)) albo operatora, którego Adminer nie oferuje, jak JSON-owy ->> w PostgreSQL. (demo – taki warunek mógłby też zmienić dane, więc Adminer prosi o ponowne wysłanie formularza) [S11]
• Pozostawienie pustej kolumny szuka we wszystkich. Adminer pomija kolumny, do których twój tekst i tak nie może pasować, np. liczbowe, gdy szukasz słowa. [S12]
• Najedź myszą na nagłówek kolumny: ↓ sortuje malejąco, a = otwiera wyszukiwanie z już wybraną kolumną. [S13]
• Wykrzyknik obok przycisku pokaż ostrzega, że baza będzie musiała przeczytać całą tabelę, bo do twoich warunków nie pasuje żaden indeks. [S14]
• Wartości kluczy obcych są odnośnikami do wskazywanego rekordu, także w innej bazie lub schemacie. [S15]
• Liczba rekordów zapisana jako ~ 150 to oszacowanie. Adminer nie liczy dużych tabel dokładnie, bo byłoby to wolne. [S16]
• Nowy rekord wypełnia formularz z twojego wyszukiwania, jeśli użyto operatora =. [S17]
• Zaimportuj plik CSV prosto do tabeli. Pierwszy wiersz odpowiadający nazwom kolumn zostanie użyty jako nagłówek, a rekordy z istniejącym kluczem głównym będą aktualizowane zamiast dublowane. [S18]

Edycja rekordów

• W kolumnie pokazującej NULL nie trzeba nigdzie klikać, wystarczy zacząć wpisywać wartość, a NULL zniknie. (demo) [E1]
• Zmień wartość względnie: wybierz + i wpisz 10, albo + interval i 1 DAY, albo concat, aby dopisać tekst. Są oferowane tylko tam, gdzie wartość już istnieje, więc nie przy zwykłym wstawianiu. (demo) [E2]
• Wybierz funkcję SQL, aby napisać własne wyrażenie, np. REPLACE(text, 'a', 'b'). [E3]
• Funkcje takie jak now czy uuid ukrywają pole wartości, bo wartość pochodzi z bazy. [E4]
• Wartość dłuższa, niż pozwala kolumna, jest podświetlana już podczas pisania. [E5]
• Ctrl+Enter wysyła dowolny formularz w Adminerze. Przycisk, który nacisnąłby Enter, jest podświetlony podczas wypełniania. [E6]
• Ctrl+Shift+Enter to Zapisz i kontynuuj edycję przy zmianie rekordu i Zapisz i dodaj następny przy dodawaniu. Zapis odbywa się bez opuszczania strony. [E7]
• Ctrl+Shift+↑ i Ctrl+Shift+↓ przenoszą do tego samego pola o wiersz wyżej lub niżej. [E8]
• Nadaj tabeli klucz główny albo przynajmniej unikalny indeks bez NULL, a Adminer rozpozna po nim każdy rekord. Bez niego musi opisać rekord wszystkimi jego kolumnami, przez co odnośniki są długie, każda zmiana ogranicza się do jednego rekordu i znika Zapisz i kontynuuj edycję. [E9]

Tworzenie i zmiana tabel

• Kliknij najpierw przycisk AI, a nazwa kolumny wypełni się jako id. (demo) [C1]
• Typ, długość i NULL poprzedniej kolumny przenoszą się na następną, więc dodanie kilku kolumn tego samego typu kosztuje po jednym kliknięciu. [C2]
• Nazwij kolumnę user albo user_id, a Adminer sam znajdzie klucz obcy, łącznie z nazwami tabel w liczbie mnogiej. [C3]
• Przy inaczej nazwanej kolumnie cel możesz wybrać sam z grupy Klucze obce na końcu listy typów. [C4]
• Przeciągnij uchwyt ↕, aby przenieść kolumnę. [C5]
• Kliknij pole Długość przy kolumnie typu enum lub set i wpisuj wartości po jednej w wierszu, Adminer sam ujmie je w apostrofy. [C6]
• Przy indeksie wystarczy wybrać kolumny, typ INDEX i nazwa wypełnią się same. (demo) [C7]
• Wyzwalacz jest nazywany według momentu i zdarzenia, które wybierzesz, np. comments_bi. [C8]

Poruszanie się

• Kolumny w przeglądzie bazy prowadzą do różnych stron: Rozmiar danych do Zmień tabelę, Rozmiar indeksów do Zmień indeksy, Liczba rekordów do Pokaż dane, Wolne miejsce do Nowy rekord, a Automatyczny przyrost do Zmień tabelę z wpisaną bieżącą wartością, którą w innym wypadku celowo się pomija. (demo) [G1]
• Kliknięcie nagłówków sortuje listę tabel. [G2]
• Wyszukaj we wszystkich tabelach naprawdę przechodzi dane każdej tabeli. Zaznacz najpierw kilka tabel, aby szukać tylko w nich; działa dowolny operator, także SQL. [G3]
• Odnośnik Eksportuj otwiera się z już zaznaczoną bieżącą tabelą, gdy użyjesz go na strukturze tabeli albo na jej danych. [G4]
• Odnośniki pod listą tabel w eksporcie zaznaczają naraz wszystkie tabele o tym samym przedrostku. [G5]
• Ctrl+kliknięcie albo Shift+kliknięcie listy baz lub dowolnego przycisku otwiera wynik w nowym oknie. [G6]
• Adminer nie umieszcza wartości domyślnych w swoich adresach, dlatego pozostają krótkie i można je bezpiecznie zmieniać ręcznie, np. limit=, text_length= czy page=last. [G7]
• W Schemacie bazy danych kolory oznaczają typy danych, a kursywa klucz główny. Rozmieść tabele przeciąganiem, układ zostanie zapamiętany i prowadzi do niego trwały odnośnik. (demo) [G8]
• Lista procesów potrafi skopiować działające zapytanie do zapytania SQL, żeby można było mu się spokojnie przyjrzeć. [G9]

Polecenie SQL

• Ctrl+Enter uruchamia zapytanie, Ctrl+spacja uzupełnia nazwy tabel i kolumn. (demo) [Q1]
• Ctrl+kliknięcie podświetlonego słowa kluczowego otwiera jego dokumentację. Nazwy tabel w zapytaniu są odnośnikami do tabeli. [Q2]
• Wynik linkuje klucz główny każdej użytej tabeli, więc a JOIN b daje odnośnik do edycji obu, o ile wybrano cały klucz tabeli. [Q3]
• Najedź myszą na nagłówek wyniku, aby zobaczyć, z której tabeli i kolumny wartość naprawdę pochodzi. [Q4]
• Zapytanie podróżuje w adresie, więc działa historia, zakładki i wysłanie odnośnika koledze. [Q5]
• Limit rekordów pokazuje tylko pierwsze rekordy, ale zapytanie i tak wykonuje się w całości, a eksport poniżej wyeksportuje wszystko. [Q6]
• Historia jest prowadzona osobno dla każdej bazy. Edytuj wszystkie wczytuje wszystkie wcześniejsze zapytania z powrotem do pola tekstowego. [Q7]
• Pokaż tylko błędy i Zatrzymaj w przypadku błędu czynią import dużego pliku znośnym. [Q8]
• Wyślij kilka plików naraz, .gz zostanie po drodze rozpakowany. Plik zbyt duży do wysłania możesz położyć obok skryptu jako adminer.sql i zaimportować stamtąd. [Q9]
• Eksport kilku tabel do CSV daje jedno archiwum TAR. [Q10]

Gdy coś pójdzie nie tak

• Błąd po zapisie jest pokazywany pod tym samym adresem zamiast przekierowania, więc możesz usunąć przyczynę w innej karcie i wysłać te same dane ponownie, odświeżając stronę. [W1]
• Jeśli sesja wygaśnie podczas zapisu, zaloguj się tymi samymi danymi, a operacja zostanie wykonana. Adminer o tym uprzedza. [W2]
• Jeśli zmieniłeś dołączoną wtyczkę albo wygląd i nie chcesz, aby był oznaczany jako nieaktualny, zmień nazwę pliku wtyczki albo pierwszy wiersz pliku CSS. Adminer porównuje tylko pliki, które zna. [W3]
• Dodaj do adresu ?ext=pdo, aby połączyć się przez PDO, gdy zwykłe rozszerzenie sprawia kłopoty. To wyjście awaryjne, nie lepsza droga. [W4]

Wtyczki

• backward-keys: Dodaje kolumnę z odnośnikami do rekordów wskazujących na bieżący, dzięki czemu klucz obcy można prześledzić także wstecz. Adminer Editor robi to sam z siebie. (demo) [P1]
• edit-foreign: Zamienia kolumny z kluczem obcym w formularzu edycji na listę rekordów, na które mogą wskazywać, więc wybierasz rekord zamiast wpisywać jego numer. Adminer Editor robi to sam z siebie. [P2]
• remote-color: Rysuje czerwony pasek, gdy Adminer albo baza nie działa na twoim komputerze — tani sposób, aby przez pomyłkę nie zmienić danych produkcyjnych. [P3]
• tables-filter: Umieszcza pole filtru nad listą tabel, podczas pisania ukrywa tabele, które nie pasują, i podświetla pasujący fragment. Filtr zostaje, dopóki pozostajesz w tej samej bazie. [P4]
• display-foreign-key-name: Zamiast samej liczby wyświetla pierwszą kolumnę tekstową wskazywanej tabeli, więc klucz obcy od razu mówi, na co wskazuje. Adminer Editor robi to sam z siebie. [P5]
• sql-claude: Dodaje do zapytania SQL pole, które napisze za ciebie zapytanie przy użyciu Anthropic Claude. [P6]