Kodutöö III variant: SQL

Ülesande püstitus

Selles ülesandes tutvud SQL keele ja SQLite failipõhiste andmebaaside liidestamisega C keeles. Sinu ülesandeks saab olema nii SQL kui ka C-keelse koodi kirjutamine ning sidumine. Lisaks pead ülesande käigus teostama ka väikese muudatuse andmebaasi struktuuris. Andmebaasi kasutamine ei vaja võrguühendust.

Variant

Ülesande sooritamine

  1. Lisa ülesande variandis nõutud tabel olemasolevasse andmebaasi struktuuri, tabelisse lisa vajalikud väljad kasutades sobilike andmetüüpe. Tabeli täpne sisu on sinu välja mõelda! Lisatabel tuleb luua vajaduspõhiselt sinu rakenduse käivitamise hetkel.
  2. Loo käsurea põhine andmebaasi kasutajaliides C keeles, millega saab
    1. Teha SELECT päringuid – ühest ja mitmest tabelist kasutades erinevaid JOIN operatsioone. Muuhulgas tuleb andmeid filtreerida kasutades WHERE või HAVING käske, järjestada ümber kasutades ORDER BY käsku jne.
    2. Andmeid muuta (INSERT, DELETE, UPDATE käsud)
    3. Tulemuste leidmine (SUM, AVG jne käsud)
  3. Dokumenteeri oma töö

Keskkond

  • Peab kasutama SQLite3 andmebaasi ja libsqlite3-dev teeki.
  • Peab töötama Linuxis ja kompileeruma kasutades GCCd
  • Rakendus peab olema kirjutatud kas C90 või C99 standardina. Lisa Makefile nii, et “make all” retseptiga saaks rakenduse kompileerida.

Soovituslikud paketid:

  • sqlite3 – andmebaasitarkvara
  • libsqlite-dev – teek mille abil on võimalik C keelsetes rakendustes kasutada SQLite andmebaase.
  • sqlitebrowser – graafilise kasutajaliidesega andmebaasirakendus, mille abil on võimalik tutvuda andmebaasiga ning testida käske enne rakenduses kasutusse võtmist.

Paigaldamiseks debian-põhistes süsteemides (nt Ubuntu, Kubuntu, Mint, …)

Nõuded

  • Rakenduses peab olema kasutusel käsureapõhine kasutajaliides. Kõik tegevused peavad olema korratavad kuniks kasutaja soovib rakenduse sulgeda.
  • SQLi päringute ohutuks koostamiseks tuleb parameetrite lisamisel päringusse kasutada sqlite3_bind_  funktsioone
  • Rakendus peab kontrollima iga käsu soorituse tulemust (kui on võimalik) ja raporteerima olukorrad, kus käsu sooritamine ebaõnnestub.
  • UPDATE ja INSERT käskude korral pead esmalt kasutaja sisestust kontrollima enne kui neid andmebaasi suunas saadad!
  • Kõik küsitud ressursid tuleb vabastada enne rakenduse sulgemist
  • Rakendus peab olema kompileeritav kasutades Makefile’i, mille peab töö autor koostama ja lahendusega kaasa panema.

Dokumentatsioon

  • Tiitelleht
  • Autorideklaratsioon
  • Lühendite ja mõistete sõnastik (vajadusel)
  • Sisukord
  • Jooniste ja tabelite loetelu (vajadusel)
  • Ülesande püstitus
  • Rakenduse kirjeldus
    • Kõik SQL päringud peavad olema loetelud. Päringud peavad olema grupeeritud päringu tüübi järgi (nt INSERT, UPDATE, …). Kõik nõutavad eeltingimused peavad olema märgitud (nt õpilasele hinde lisamiseks peab vastava koodiga õpilane eksisteerima). Kõik päringud peavad olema lisatud kasutades koodi värvimist. Näiteks:
  • Andmebaasi disaini selgitus
    • Lisa andmebaasi disain joonisena (ülesande püstituses). Joonis peab olema viidatud ja loetletud kasutatud kirjanduses!
    • Kirjelda kõik PK-FK suhted oma andmebaasis
      Nt: Välisvõti students.student_code viitab primaarvõtmele grades.student_code.
    • Iga andmebaasitabeli kohta loo aruandes tabel, kus on kirjeldatud kõik atribuudid (tabeli tulbad). Iga atribuudi kohta peab olema kirjeldatud selle nimi, kõik selle omadused (nt PK, Not NULL, Unique), kirjeldus ja näide.
      Näide: ühe atribuudi kirjeldus tudengite tabelis:
Atribuut Kirjeldus Omadused Näidis
student_code Unikaalne tudengi tunnuskood, mis koosneb kuuenumbrilisest matriklinumbrist täisarvuna ja neljatähelisest õppekava koodist sõnena. Ei ole NULL
Unikaalne		 “123456MVEB”

NB! Funktsioonide dokumenteerimine on osa dokumentatsioonist. Funktsioonid tuleb dokumenteerida koodis. Iga funktsiooni kohta kirjelda selle eesmärki, parameetreid, nõudeid parameetritele tagastavat väärtust ja kõrvalmõjusid.

Töö esitamine

Kõigi kodutöö 3 variantide tähtaeg on 8. juuni 2025.

Töö juhendajaks on René Pihlak (Kontakt: Ülikooli MS Teams).

Kodutöö esitamine käib kahes etapis:

  1. Lae üles oma lahendus Moodlesse: https://moodle.taltech.ee/mod/assign/view.php?id=499816
  2. Kirjuta töö juhendajale andmaks teada, et lahendus on esitatud. Täiendavalt on soovitav lahendus saata ka talle otse tema eelistatud suhtlusvahendi kaudu.

Esitada tuleb järgnevad failid:

  • Aruanne (pdf dokument)
  • Projekti failid .zip arhiivina (lähtekood, SQLite3 andmebaas, Makefile)

Juhendajal on õigus nõuda töö kaitsmist, sh kohapeal!