Návod k aplikaci SQL Tools v.2.3 Jiří Chroust Copyright 2007 CENIA, laboratoř GIS 1. Úvod 2. Části základního okna 2.1. Menu 2.1.1. Connection 2.1.2. Help 2.1.3. Languages 2.2. Nástrojová lišta 2.3. Strom 2.4. Tabulka 2.5. SQL editor 3. Základní funkcionalita 3.1. Připojení k databázovému serveru 3.2. Práce s databázemi 3.3. Práce s tabulkami 3.4. Práce s poli 3.5. Získání informací o položkách ve stromu 3.6. Vložení položky ze stromu do SQL editoru 3.7. Práce s SQL editorem 4. Tutorial databáze 4.1. Vytvoření databáze 1. Úvod SQLTools je nástroj pro práci s daty uloženými v databázovém SQL serveru. Umožňuje se připojit k serveru a provádět základní operace s databankou, tabulkami, jejich strukturou a záznamy. Umožňuje vytvořit, načíst, editovat, uložit a vykonat sekvenci SQL příkazů. 2. Části základního okna Okno aplikace SQLTools se skládá z několika částí. Jsou to standardní menu, nástrojová lišta, strom, tabulka a SQL editor.
2.1. Menu Obsahuje obecně použitelné funkce 2.1.1. Connection Spouští aplikaci Connection Admin, která spravuje seznam připojení do databáze pro všechny aplikace systému JANITOR. 2.1.2. Help About - informace o metadatech aplikace 2.1.3. Languages Nástroj pro přepínání jazykové lokalizace. Nativně je vytvořena lokalizace v angličtině. Volitelně je k dispozici lokalizace v českém jazyce. 2.2. Nástrojová lišta Obsahuje Use Connection Admin - totožná se stejnojmennou funkcí v Menu - spouští aplikaci Connection Admin, která řídí seznam připojení do databáze pro všechny aplikace systému JANITOR.
Show List of SQL KeyWords - spouští okno obsahující seznam vybraných klíčových slov a znaků SQL jazyka. Dvojklikem lze kteroukoli položku z něj vložit do SQL editoru na místo kurzoru. Refresh Tree View - aktualizuje obsah stromu. Je vhodné využít po provedení sekvence příkazů z SQL editoru, která obsahovala příkazy CREATE a DROP. Start/Stop Editing - slouží k zahájení/ukončení editace tabulky. Obsah tabulky na formuláři lze editovat pouze v případě, že jsou do ní pomocí funkce Show All Records z kontextového menu pro tabulku nahrané všechny záznamy zvolené tabulky z databáze. Save Changes in Table - zajišťuje uložení editačních změn (provedených v tabulce na formuláři) do příslušné tabulky v databázi. Cancel Changes in Table - zruší editační změny (provedené v tabulce na formuláři). 2.3. Strom Na nejvyšší úrovni obsahuje seznam dostupných databázových serverů, dále se hierarchicky větví na seznam připojení k danému serveru, seznam databází v daném databázovém serveru, seznam tabulek v dané databázi a seznam polí v dané tabulce. Lze přidat ještě seznam unikátních hodnot pro daný sloupec tabulky. Valná většina operací a funkcí SQLTools se provádí přes kontextové menu na označené položce ve stromě. 2.4. Tabulka Slouží k zobrazování hodnot získaných ze serveru pro jednotlivé operace a funkce SQLTools, např. záznamy či hlavičku tabulky, výsledek SQL příkazu SELECT, seznam tabulek v databázi, vlastnosti připojení. V zobrazovacím režimu, který je dostupný při jakémkoli obsahu tabulky, jsou k dispozici tyto funkce: ruční výběr řádků/sloupců tabulky nebo jejich kombinace; realizuje se kliknutím na myší na číslo záznamu nebo na název pole, lze využít kláves Shift (výběr všech řádků/sloupců mezi místem kliknutí a aktuální buňkou, která je označena červeným rámečkem) a Ctrl (přidávání do nebo odebírání z existujícícho výběru); vybrané řádky/sloupce jsou barevně odišeny Copy To ClipBoard - kopírování do schránky; realizuje se pomocí kontextového menu při kliknutím pravou myší na tabulku; do schránky lze zkopírovat: Header - hlavičku (názvy sloupců); nabídka je v kontextovém menu dostupná při kliknutí na řádek s názvy polí Pointed Row/Column - řádek/sloupec označený kliknutím; nabídka je v kontextovém menu dostupná při kliknutí na číslo záznamu / název pole Selected Rows/Columns - vybrané řádky/sloupce; nabídka je v kontextovém menu dostupná při kliknutí na libovolné číslo záznamu / název pole Selection - aktuální výběr (pokud jsou vybrány současně řádky i sloupce, jedná se o jejich průnik - kombinovaný výběr); nabídka je v kontextovém menu dostupná vždy, pokud je vybrán alespoň jeden řádek/sloupec Whole Table - celou tabulku vč. hlavičky; nabídka je v kontextovém menu dostupná vždy
Show Selected Rows On Top - zobrazí vybrané řádky tabulky nahoře; realizuje se pomocí kontextového menu při kliknutím pravou myší na sloupec s čísly záznamů Sort - seřazení řádků podle hodnot ve vybraném sloupci; realizuje se pomocí kontextového menu při kliknutím pravou myší na název sloupce Ascending - řadí vzestupně Descending - řadí sestupně UnSort - vrátí se k původnímu řazení řádků tabulky, ruší též řazení změněné funkcí Show Selected Rows On Top; realizuje se pomocí kontextového menu při kliknutím pravou myší na název sloupce, nabídka je v kontextovém menu dostupná, pokud jsou záznamy řazeny jinak než původně ColumnStatistics - zobrazí statistické údaje pro hodnoty ve zvoleném sloupci; pokud jsou vybrané nějáké řádky, pracuje pouze s hodnotami v nich; realizuje se pomocí kontextového menu při kliknutím pravou myší na název sloupce. Zobrazují se následující statistické údaje: Count - počet položek zahrnutých do statistiky (pro všechny datové typy) Count of NULL - počet položek nezahrnutých do statistiky, protože nemají zadanou (korektní) hodnotu (pro všechny datové typy); údaj se zobrazuje, pokud je tento poče nenulový Minimum - minimální hodnota (numerický typ) Maximum - maximální hodnota (numerický typ) Sum - součet hodnot (numerický typ) Mean - průměrná hodnota (numerický typ) Standard Deviation - standardní odchylka od průměrné hodnoty (numerický typ) Minimal Length - počet znaků nejkratšího řetězce (typ řetězec) Maximal Length - počet znaků nejdelšího řetězce (typ řetězec) Mean Length - průměrný počet znaků v řetězcích (typ řetězec) First in Alphabet - řetězec, který je první v abecedním řazení (typ řetězec) Last in Alphabet - řetězec, který je poslední v abecedním řazení (typ řetězec) True - počet pozitivních hodnot (logický typ) False - počet negativních hodnot (logický typ) Oldiest - nejstarší datum v daném poli (typ datum) Nearest - nejmladší datum (typ datum) Difference - rozdíl mezi nejmladším a nejstarším datem, uváděno ve dnech (typ datum)
V editačním režimu, který je dostupný pouze pokud jsou v tabulce pomocí funkce Show All Records z kontextového menu pro tabulku nahrané všechny záznamy zvolené tabulky z databáze, jsou navíc k dispozici tyto funkce: ruční editace jednotlivých hodnot Delete Selected Records - odstraní z tabulky vybrané záznamy; realizuje se pomocí kontextového menu po kliknutí na číslo libovolného záznamu; nabídka je dostupná, pokud je vybrán aspoň jeden záznam v tabulce Duplicate Pointed Record - přidá do tabulky nový záznam a zapíše do něj hodnoty z existujícího řádku označeného kliknutím; pokud jsou vybrané některé sloupce, přenáší do nového řádku pouze hodnoty z těchto sloupců; hodnota ze sloupce s vlastností AUTOINCREMENT se do nového záznamu nepřenáší; realizuje se pomocí kontextového menu po kliknutí na číslo záznamu, který má být zkopírován Insert Record - přidá do tabulky nový prázdný řádek (záznam); realizuje se pomocí kontextového menu po kliknutí na číslo libovolného záznamu UnDo - zruší poslední provedenou editační operaci, lze zrušit všechny editační kroky od posledního uložení změn; realizuje se pomocí kontextového menu po kliknutí dovnitř tabulky 2.5. SQL editor Skládá se z: pole pro SQL sekvence, které umožňuje ruční editaci tlačítka Load - spouští OpenDialog pro načtení SQL sekvence ze souboru s příponou *.sql do SQL editoru tlačítka Save - ukládá obsah SQL editoru do souboru s příponou *.sql tlačítka "Clear" - maže obsah SQL editoru tlačítka "Execute" - posílá SQL sekvenci obsaženou v SQL editoru databázovému serveru, zobrazí zprávu o úspěšném provedení (nezobrazuje, pokud sekvenci tvořil pouze jediný příkaz) nebo chybové hlášení serveru (pokud bylo vykonávání sekvence přerušeno na jiném než posledním příkazu, nabídne vykonání zbývajících příkazů nebo zrušení operace) 3. Základní funkcionalita Nezbytnou podmínkou pro korektní fungování všech funkcí je existence přístupného databázového serveru. 3.1. Připojení k databázovému serveru Při spuštění SQLTools jsou do části strom vygenerovány existující připojení (vytvořené pomocí Connection Admin). Pomocí těchto připojení je možné připojovat se do daných serverů. To lze realizovat dvojklikem na jedno z připojení nebo využitím kontextového menu pro zvolené připojení a v něm příkazu Activate Connection.
Pro korektní připojení do severu je nutné <vyplnit a> potvrdit hodnoty v dialogu "Enter Password". Tak je konektován server a vrací vlastní seznam databází. Ty jsou ve stromě zobrazeny pod daným připojením. V kontexovém menu na neaktivní připojení jsou dostupné funkce: Activate Connection - zajišťuje spojení s databázovým serverem prostřednictvím dialogu "Enter Password" Set Connection - pouští aplikaci Connection Admin, která spravuje seznam připojení do databáze pro všechny aplikace systému JANITOR V kontexovém menu na aktivní připojení jsou dostupné funkce: Deactivate Connection - ruší spojení s databázovým serverem Create New Database - pomocí dialogu vytváří novou databázi. Je nutné definovat název databáze, jazykovou sadu a jazykovou sadu pro řazení. Tím je nová databáze zobrazena pod daným připojením Example 1. Připojení k MySQL serveru "localhost" a vytvoření nové databáze "tutorial" 1. Je spuštěna aplikace SQLTools 2. Pokud strom neobsahuje žádný databázový server s připojením, je možné připojení definovat pomocí funkce "Connection" (viz. nápověda pro Connection Admin) 3. Dvojklikem nebo přes kontextové menu a příkaz Activate Connection realizovat připojení "local" 4. Potvrdit hodnoty v dalogu "Enter Password", které jsou převzaty z parametrů připojení "local" 5. Databázový server vrátí seznam databází serveru "localhost" a zobrazí je ve stromě pod připojením "local" a ve View jsou zobrazeny parametry připojení 6. Přes kontextové menu a příkaz Create New Database je spuštěn dialog na vytváření nové databáze. Do pole "Name" zapište hodnotu "tutorial" a hodnoty v obou rozbalovacích menu nepřenastavujte. Tlačítkem "OK" je vytvořena databáze "Tutorial". 3.2. Práce s databázemi SQLTools umožňuje přes kontextové menu pro databáze tyto funkce: Drop database - maže danou databázi z databázového serveru Create New Table - v databázi vytváří novou tabulku (zatím pouze zapíše do SQL editoru klíčová slova CREATE TABLE, zbytek příkazu musí uživatel vytvořit ručně) 3.3. Práce s tabulkami Přes kontextové menu jsou pro tabulky přístupné tyto funkce: Show All Records - zobrazí všechny záznamy vybrané tabulky v prohlížecí tabulce
Show Limited Nuber of Records - zobrazí v prohlížecí tabulce uživatelem omezený počet záznamů vybrané tabulky. Limitem je počet záznamů a číslo záznamu, od kterého se má výběr zobrazovat. Show Records As SQL- zobrazí v SQL editoru příkaz INSERT INTO se seznamem všech záznamů vybrané tabulky Insert Record - umožní vložit nový záznam do tabulky a zadat jeho hodnoty (zatím není realizováno) Alter Table - umožní změnit strukturu vybrané tabulky (zatím pouze zapíše do SQL editoru klíčová slova ALTER TABLE, zbytek příkazu musí uživatel vytvořit ručně) Drop Table - smaže vybranou tabulku z databáze Rename Table - umožňuje změnit jméno vybrané tabulky Show Header- zobrazí všechna pole tabulky a jejich vlastnosti v prohlížecí tabulce Show Header As SQL - zobrazí v SQL editoru příkaz CREATE TABLE odpovídající vybrané tabulce 3.4. Práce s poli Přes kontextové menu jsou pro pole přístupné tyto funkce: Add Unique Values - přidá do stromu vzestupně řazený seznam unikátních hodnot v daném poli tabulky (maximální přípustný počet hodnot: 1000) Remove Unique Values - odstraní ze stromu seznam unikátních hodnot pro dané poli tabulky 3.5. Získání informací o položkách ve stromu Po kliknutí levou myší při stisknuté klávese Ctrl se v prohlížecí tabulce zobrazí informace o vybrané položce: připojení - zobrazí vlastnosti připojení databáze - zobrazí seznam tabulek ve vybrané databázi tabulka - zobrazí seznam polí vybrané tabulky a jejich vlastnosti pole - zobrazí seznam unikátních hodnot pro vybrané pole příslušné tabulky 3.6. Vložení položky ze stromu do SQL editoru Po kliknutí levou myší při stisknuté klávese Shift se vybraná položka přenese na pozici kurzoru v SQL editoru. Platí pro názvy databází, tabulek, polí a konkrétních hodnot. připojení - zobrazí vlastnosti připojení databáze - zobrazí seznam tabulek ve vybrané databázi
tabulka - zobrazí seznam polí vybrané tabulky a jejich vlastnosti pole - zobrazí seznam unikátních hodnot pro vybrané pole příslušné tabulky 3.7. Práce s SQL editorem SQL editor slouží k práci s SQL příkazy. Umožňuje SQL příkaz nebo sekvenci příkazů načíst, editovat, vykonat nebo smazat. SQL sekvence je vztažena k databázi, která je konektovaná. Example 2. Práce s tutorial SQL sekvencí 1. Označí se databáze "tutorial" 2. Tlačítkem "Load" je vybrán SQL soubor tutorial.sql, který je součástí tutorial dat. Obsahuje SQL příkazy pro vytvoření struktury databáze. 3. Obsah souboru (SQL sekvence) se načte do memo pole 4. Tlačítkem "Execute" je SQL sekvence vykonána a databáze "tutorial" je naplněna 4. tabulkami, které je možné si ve View prohlížet 5. Tlačítkem "Clear" je obsah memo pole vymazán 4. Tutorial databáze Ve spolupráci s aplikací Databuilder Light je připravena ukázka práce s nástroji aplikace SQLTools. Pro správné fungování SQLTools je nezbytný databázový server MySQL s přístupem na úrovni tvoření databází 4.1. Vytvoření databáze 1. Nejprve je nutné vytvořet spojení s databázovým serverem. To je řešeno kliknutím na funkci "Connection" - je nastartována aplikace Connection Admin, kde se připojení vytvoří (viz. Návod k aplikaci Connection Admin) 2. Po vytvoření "tutorial" připojení se položka připojení objeví ve stromové struktuře. Dvojklikem nebo přes kontextové menu a funkci "Activate Connection" je dané připojení zaktivněno a jsou zobrazeny všechny databáze daného databázového serveru 3. Přes kontextové menu na aktivním připojení a funkcí "Create New Database" je spuštěn dialog pro vytvoření nové databáze. Hodnoty nové databáze jsou zobrazeny v obrázku
4. Po potvrzení hodnot je tutorial databáze vytvořena a zobrazena pod aktivní připojení 5. Nyní je možné novou (prázdnou) databázi naplnit strukturou. Pomocí tlačítka "Load" je otevřen OpenDialog, kde se vybere soubor "Tutorial.sql" Ten obsahuje strukturu tutorial databáze. Obsah souboru je vložen do spodního memo boxu, kde je možné ho dodatečně editovat. Tlačítkem "Execute" je SQL sekvence realizována. Tip Název aktuální výbrané databáze je zobrazen na horní liště aplikace (tim je zajištěna informace, pro kterou databázi je SQL sekvence určena) 6. Pomocí tlačítka "Refresh" na nástrojové liště je aktualizována stromová struktura. V databázi "Tutorial" jsou zobrazeny jednotlivé tabulky.