Tipy

Adminer má běžné úlohy po ruce a zbytek spíš skrývá, než aby ho vynechal. Tato stránka sbírá funkce, které se snadno přehlédnou. Většinu z nich si můžete rovnou vyzkoušet. (demo)

Na macOS stiskněte Cmd všude, kde se mluví o Ctrl. Kód na konci tipu je trvalý odkaz na daný tip.

Výběr dat

• Ctrl+klik na libovolnou hodnotu ve výpisu ji změní přímo na místě, Esc vrátí původní hodnotu. Uložit zapíše všechny změněné buňky najednou. (demo) [S1]
• Dlouhé texty jsou zkrácené na prvních 100 znaků. Ctrl+klik načte celou hodnotu, prázdná Délka textů zobrazí všechno rovnou. [S2]
• Odkaz Změnit promění celý výpis na políčka najednou. [S3]
• Kliknutí kamkoliv do řádku ho zaškrtne. Označování textu tažením řádek nechá být. [S4]
• Shift+klik na zaškrtávátko zaškrtne všechno mezi ním a předchozím kliknutím. [S5]
• Zaškrtávátko v hlavičce zaškrtne řádky na aktuální stránce, to v Celém výsledku všechno, co odpovídá filtru. Když není zaškrtnuté nic, Upravit, Klonovat a Smazat jsou vypnuté, ale Export se stejně týká celého výsledku. [S6]
• Zaškrtněte několik řádků a stiskněte Upravit, přepíšete je najednou. Sloupce ponechané na původní si v každém řádku zachovají svou hodnotu. [S7]
• Klonovat funguje stejně a vloží kopie všech zaškrtnutých řádků. [S8]
• Vyberte sloupec a agregační funkci ve Vypsat a Adminer za vás sestaví dotaz s GROUP BY, např. author, COUNT(*). (demo) [S9]
• Kliknutím na výsledný počet zobrazíte řádky, které za ním stojí. Ostatní podmínky zůstanou v platnosti. [S10]
• Operátor SQL ve vyhledávání pošle váš text do databáze tak, jak je: porovnejte dva sloupce (= jiny_sloupec), použijte poddotaz (IN (SELECT ...)) nebo operátor, který Adminer nenabízí, třeba PostgreSQL JSON ->>. (demo – taková podmínka může data i změnit, proto Adminer požádá o opětovné odeslání formuláře) [S11]
• Když sloupec ve vyhledávání necháte prázdný, hledá se ve všech. Adminer přeskočí sloupce, kterým váš text stejně nemůže odpovídat, třeba číselné, když hledáte slovo. [S12]
• Najeďte myší na hlavičku sloupce: ↓ seřadí sestupně a = otevře vyhledávání s tímto sloupcem už vybraným. [S13]
• Vykřičník vedle tlačítka Vypsat upozorňuje, že databáze bude muset přečíst celou tabulku, protože na vaše podmínky nesedí žádný index. [S14]
• Hodnoty cizích klíčů jsou odkazy na odkazovaný řádek, i v jiné databázi nebo schématu. [S15]
• Počet řádků zapsaný jako ~ 150 je odhad. Adminer velké tabulky nepočítá přesně, protože by to bylo pomalé. [S16]
• Nová položka předvyplní formulář z vašeho vyhledávání, pokud jste použili operátor =. [S17]
• Naimportujte CSV soubor rovnou do tabulky. První řádek odpovídající názvům sloupců se použije jako hlavička a řádky s existujícím primárním klíčem se místo zdvojení aktualizují. [S18]

Úprava řádků

• U sloupce, který ukazuje NULL, není potřeba nikam klikat, stačí začít psát hodnotu a NULL zmizí. (demo) [E1]
• Změňte hodnotu relativně: vyberte + a napište 10, nebo + interval a 1 DAY, nebo concat pro připojení textu. Nabízejí se jen tam, kde už hodnota existuje, tedy ne při obyčejném vkládání. (demo) [E2]
• Vyberte funkci SQL a napište vlastní výraz, např. REPLACE(text, 'a', 'b'). [E3]
• Funkce jako now nebo uuid políčko s hodnotou skryjí, protože hodnota přijde z databáze. [E4]
• Hodnota delší, než sloupec dovoluje, se zvýrazní při psaní. [E5]
• Ctrl+Enter odešle libovolný formulář v Admineru. Tlačítko, které by stiskl Enter, je při vyplňování zvýrazněné. [E6]
• Ctrl+Shift+Enter je Uložit a pokračovat v úpravách při změně řádku a Uložit a vložit další při vkládání. Ukládá se bez opuštění stránky. [E7]
• Ctrl+Shift+↑ a Ctrl+Shift+↓ přejdou na stejné políčko o řádek výš nebo níž. [E8]
• Dejte tabulce primární klíč, nebo aspoň unikátní index bez NULL, a Adminer podle něj pozná každý řádek. Bez něj musí řádek popsat všemi jeho sloupci, což prodlužuje odkazy, omezuje každou změnu na jediný řádek a znemožňuje Uložit a pokračovat v úpravách. [E9]

Vytváření a změny tabulek

• Klikněte nejdřív na přepínač AI a název sloupce se vyplní jako id. (demo) [C1]
• Typ, délka a NULL předchozího sloupce se přenesou na další, takže přidání několika sloupců stejného typu stojí jedno kliknutí za sloupec. [C2]
• Pojmenujte sloupec user nebo user_id a Adminer cizí klíč najde sám, včetně názvů tabulek v množném čísle. [C3]
• U jinak pojmenovaného sloupce si cíl můžete vybrat sami ze skupiny Cizí klíče na konci seznamu typů. [C4]
• Přetažením úchytu ↕ sloupec přesunete. [C5]
• Klikněte na políčko Délka u sloupce typu enum nebo set a pište hodnoty po jedné na řádek, Adminer je za vás dá do apostrofů. [C6]
• U indexu stačí vybrat sloupce, typ INDEX a název se vyplní samy. (demo) [C7]
• Trigger se pojmenuje podle času a události, které vyberete, např. comments_bi. [C8]

Orientace

• Sloupce v přehledu databáze vedou na různé stránky: Velikost dat na Pozměnit tabulku, Velikost indexů na Pozměnit indexy, Řádků na Vypsat data, Volné místo na Novou položku, Auto Increment na Pozměnit tabulku s vyplněnou aktuální hodnotou, která se jinak schválně vynechává. (demo) [G1]
• Kliknutím na hlavičky seřadíte seznam tabulek. [G2]
• Vyhledat data v tabulkách opravdu projde data každé tabulky. Když nejdřív některé tabulky zaškrtnete, hledá jen v nich, a funguje libovolný operátor včetně SQL. [G3]
• Odkaz Export se otevře s už zaškrtnutou aktuální tabulkou, pokud ho použijete na struktuře tabulky nebo na jejích datech. [G4]
• Odkazy pod seznamem tabulek v Exportu zaškrtnou najednou všechny tabulky se stejnou předponou. [G5]
• Ctrl+klik nebo Shift+klik na výběr databáze nebo na libovolné tlačítko otevře výsledek v novém okně. [G6]
• Adminer nedává výchozí hodnoty do svých adres, díky čemuž zůstávají krátké a dají se bezpečně upravovat ručně, např. limit=, text_length= nebo page=last. [G7]
• Ve Schématu databáze jsou barvy datové typy a kurzíva značí primární klíč. Tabulky rozmístíte tažením, rozmístění se zapamatuje a vede na něj trvalý odkaz. (demo) [G8]
• Seznam procesů umí zkopírovat běžící dotaz do SQL příkazu, kde si ho v klidu prohlédnete. [G9]

SQL příkaz

• Ctrl+Enter spustí dotaz, Ctrl+mezerník doplní názvy tabulek a sloupců. (demo) [Q1]
• Ctrl+klik na zvýrazněné klíčové slovo otevře jeho dokumentaci. Názvy tabulek v dotazu jsou odkazy na tabulku. [Q2]
• Výsledek odkáže primární klíč každé zúčastněné tabulky, takže a JOIN b vám dá odkaz na úpravu obou, pokud je vybraný celý klíč tabulky. [Q3]
• Najeďte myší na hlavičku výsledku a uvidíte, ze které tabulky a ze kterého sloupce hodnota doopravdy pochází. [Q4]
• Dotaz se přenáší v adrese, takže funguje historie, záložky i poslání odkazu kolegovi. [Q5]
• Limit řádků zobrazí jen prvních pár řádků, ale dotaz proběhne celý a Export pod ním pak vyexportuje všechno. [Q6]
• Historie se udržuje pro každou databázi zvlášť. Upravit vše načte všechny dřívější dotazy zpátky do textového pole. [Q7]
• Zobrazit pouze chyby a Zastavit při chybě udělají z importu velkého souboru snesitelnou záležitost. [Q8]
• Pošlete několik souborů najednou, .gz se automaticky rozbalí. Soubor příliš velký na nahrání můžete zkopírovat vedle skriptu jako adminer.sql a naimportovat odtamtud. [Q9]
• Export několika tabulek do CSV vám dá jeden TAR archiv. [Q10]

Když se něco pokazí

• Chyba po uložení se místo přesměrování zobrazí na stejné adrese, takže můžete příčinu opravit v jiném panelu a obnovením stránky odeslat stejná data znovu. [W1]
• Když během ukládání vyprší sezení, přihlaste se stejnými údaji a akce se provede. Adminer na to upozorní. [W2]
• Pokud jste změnili přibalený plugin nebo design a nechcete, aby se označoval jako zastaralý, přejmenujte soubor pluginu nebo změňte první řádek CSS souboru. Adminer porovnává jen soubory, které zná. [W3]
• Přidejte do adresy ?ext=pdo a připojíte se přes PDO, když obvyklé rozšíření zlobí. Je to únik, ne lepší cesta. [W4]

Rozšíření

• backward-keys: Přidá sloupec s odkazy na řádky, které odkazují na ten aktuální, takže cizí klíč jde projít i pozpátku. Adminer Editor to umí sám. (demo) [P1]
• edit-foreign: Promění sloupce s cizím klíčem v editačním formuláři na seznam řádků, na které mohou ukazovat, takže řádek vyberete místo psaní jeho čísla. Adminer Editor to umí sám. [P2]
• remote-color: Vykreslí červený proužek, když Adminer nebo databáze neběží na vašem počítači, což je laciný způsob, jak omylem nezměnit ostrá data. [P3]
• tables-filter: Nad seznam tabulek dá filtrovací políčko, při psaní schová tabulky, které neodpovídají. Odpovídající část zvýrazní. Filtr zůstane, dokud nezměníte databázi. [P4]
• display-foreign-key-name: Zobrazí místo holého čísla první textový sloupec odkazované tabulky, takže cizí klíč rovnou říká, na co ukazuje. Adminer Editor to umí sám. [P5]
• sql-claude: Přidá do SQL příkazu prompt, který za vás napíše dotaz pomocí Anthropic Claude. [P6]