Návod k aplikaci SQL Tools v.2.3

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.