Tietokannan testaaminen

Testaa tietokantasi toiminta. Testaa erityisesti tietokantasi rakenne tekemällä riittävä määrä kyselyjä, joissa yhdistelet tietokannan tauluja. Muista testata myös tietueen poistaminen ja muuttaminen.

Käytä testaamiseen Knex:n querybuilder-rajapintaa. Tässä muutamia esimerkkejä (toimivat Knex-migrations demon tietokannan kanssa).

Tee tietokannan testaamisesta lyhyt raportti, josta käy ilmi tietokannan rakenne (myös tietotyypit), mitä toimintoja olet testannut ja mikä oli testauksen tulos.

Tee testikyselyt omaan db_tests.js-tiedostoon. Aja tiedosto node:lla:

node db_tests.js

Voit tulostaa kyselyn tulokset konsolille (console.log). Voit halutessasi automatisoida tietokantatestit myös käyttäen JEST:iä.

Voit tulostaa konsolille myös syntyneen SQL-lauseen (tämä lisätään ennen query:ä).

knex.on('query', console.log);

Yhteyden muodotaminen tietokantaan

Käynnistä MySQL ja PHPMyAdmin dockeriin. PHPMyAdmin:in avulla voit tarkistaa, että tietokannan sisältö muuttuu vastaavasti.

const options = {
    client: 'mysql2',
    connection: {
        host: '127.0.0.1',
        user: 'root',
        password: 'mypass123',
        database: 'notesdemo_db'
    }
}

const knex = require('knex')(options);

knex.on('query', console.log);  // SQL-muoto

Select *

Tietokantataulun saa ulos kokonaisuudessaa select(“”)-metodikutsun avulla. Konsolille voi logittaa suoraan *Knex:in palauttaman rows-taulukon:

knex.from('notes').select("*")
    .then((rows) => {
        console.log("starting notes");
        console.log(rows);
    })
    .catch((err) => {
        console.log(err); 
        throw err 
    })
    .finally(() => {
        console.log("close database connection")
        knex.destroy();
    });

Select where

Yksittäisen tietueen tiedot saa select().where()-metodien avulla.

knex.from('notes').select("content", "user_id").where('user_id', '=', '1')
    .then((rows) => {
        console.log(rows)
    })
    .catch((err) => { 
        console.log(err); 
        throw err
    })
    .finally(() => {
        knex.destroy();
    });

Select orderBy

Tietueet saadaan haluttuun järjestykseen select().orderBy()-metodien avulla:

knex.from('notes').select('notes', 'date', 'user_id').orderBy('date', 'asc')
    .then((rows) => {
        console.log("ordered")
        console.log(rows);
    }).catch((err) => { 
        console.log(err); 
        throw err
    })
    .finally(() => {
        knex.destroy();
    });

Insert

Tietokantaan voi lisätä yhden tai useamman tietueen insert-metodin avulla:

const more_notes = [
    {content: 'React is really cool', user_id: 2},
    {content: 'Knex is better than sequalize', user_id: 2},
    {content: 'Why are we not using nosql', user_id: 2},
    ]

knex('notes').insert(more_notes)
    .then(() => 
        console.log("more data inserted")
    )
    .catch((err) => { 
        console.log(err); 
        throw err
    })
    .finally(() => {
        knex.destroy();
    });

Delete/del

Tietueita voi poistaa select().where().del().-metodien avulla:

knex.from('notes').select('*')
    .where('user_id', 2)
    .del()
    .then((rows) => {
        console.log("delete")
    })
    .catch((err) => { 
        console.log( err); 
        throw err
    })
    .finally(() => {
        knex.destroy();
    });

Update

Tietueen tiedot voidaan päivittää from().where().update()-metodien avulla:

knex.from('notes')
    .where({ id: 2 })
    .update({ content: "Who needs Angular?" }, ['id', 'content']) 
    .then((returnvalue) => {
        console.log("update")
        console.log("returnvalue", returnvalue);
    })
    .catch((err) => { 
        console.log(err); 
        throw err })
    .finally(() => {
        knex.destroy();
    });

Inner join

Kahden taulun tiedot voidaan yhdistää from().join().select()-metodeilla:

knex.from('users')
    .join('notes', 'users.id', '=', 'notes.user_id')
    .select('users.id', 'users.username', 'notes.content', 'notes.date')
    .then((rows) => {
        console.log("inner join")
        console.log(rows);
    })
    .catch((err) => { 
        console.log(err); 
        throw err
    })
    .finally(() => {
        knex.destroy();
    });

Jos tietokannassasi on tauluja, joiden nimet ovat samat (esim. id), JavaScript:in kanssa tulee name collision-ongelma, eli palautuvassa oliossa on vain yksi sen niminen kenttä. Tämän voi välttää käyttämällä options-asetuksia:

    .options({ nestTables: "_"})
    .options({ nestTables: true})

Ensimmäinen lisää syntyvän olion kentille prefix:inä taulun nimen, toinen luo sisäkkäisiä olioita.

knex.from('shows')
    .join('users', 'users.id', '=', 'shows.user_id')
    .join('apartments', 'apartments.id', '=', 'shows.apartment_id')
    .select('shows.id', 'apartments.id', 'shows.showdate', 'users.username', 'users.email', 'apartments.address')
    .options({ nestTables: "_"})
    .then((rows) => {
        console.log("inner joins")
        console.log(rows);
        rows.forEach((row) => console.log(new Date(row['shows_showdate']).toLocaleDateString()))
    }).catch((err) => { console.log( err); throw err })
    .finally(() => {
        knex.destroy();
    });

Tämä kysely palauttaa siis:

{
    shows_id: 3,
    apartments_id: 3,
    shows_showdate: 2019-10-06T21:00:00.000Z,
    users_username: 'fodark',
    users_email: 'mock@email.com',
    apartments_address: 'Koulutie 3'
}

Huomaa, että mysql-kanta tallentaa päivämäärät ja ajat UTC-muodossa (shows_showdate), joten ne näyttävät hieman oudoilta raw-muodossa. Ajan saa muunnettua lokaaliksi luomalla Date()-olion ja tulostamalla sen toLocaleDateString()-metodin avulla:

rows.forEach((row) => console.log(new Date(row['date']).toLocaleDateString()))

Tämä tulostaa päivämäärät seuraavassa muodossa:

2019-11-7
2019-12-7
2019-10-7