Tästä kansiosta löytyy dokumentaatio palvelimen käyttämästä tietokannasta ja sen asetuksista. Tiedostosta löytyy myös listattuna komennot, jotka ajamalla tietokannan saa palvelimen vaatimaan toimintakuntoon.
Kaikissa tässä kansiossa olevissa tiedostoissa ei ole listattu tietokannassa käytettyjä parametreja, kuten esimerkiksi käyttäjätunnuksia ja salasanoja, vaan ne on korvattu hakasulkeilla rajattuja käyttäjärooleja (esim. [peruskäyttäjä], [admin] tai [salasana])
Tämä tiedosto. Sisältää yleiskielisen selityksen tietokannan asetuksista ja vaatimuksista.
Sisältää komennot tietokannan ja käyttäjien alustamiseksi.
Tämä palvelin tarvitsee kaverikseen postgres-tietokannan, jossa tallennettua tietoa säilytetään. Tässä dokumentaatiossa ei ole merkitty Oulun yliopistossa ja OAMKissa käytössä olevan tietokannan osoitteita, käyttäjätunnuksia tai salasanoja. Tässä dokumentaatiossa mainitaan vain kaikki elementit, jotka löytyvät tietokannasta ja joita tarvitaan tietokantaan, jotta tämä toimisi. Postgres-tietokannan pystyttäminen ja ajaminen on siis käyttäjän tehtävä erikseen.
Tänne menee kaikki LTI-integraation vaatimat taulut. Huom! Vaikka oikeaoppisesti paras tapa tehdä kyseinen skeema-jako olisi luoda erillinen 'lti'-skeema, ongelmana on se, että käytössä oleva "ltijs-sequelize" -plugin olettaa käyttävänsä 'public' skeemaa.
Tähän schemaan kirjataan kaikki palvelimen tarvitsemat tiedot. Tämä dokumentaatio käsittelee lähinnä core-schemassa olevia tauluja. Ainoastaan peruskäyttäjällä on rajatut oikeudet tähän tauluun.
Tietokannan käyttäjät. Näiden käyttäjien nimet voivat olla mitä vain, kunhan ne kirjataan ympäristömuuttujiin.
Admin käyttäjä, jolla on admin oikeudet kaikkialle. Tämä ei ole tärkeä palvelimen kannalta, mutta sellainen kannattaa olla olemassa. Käytännössä tämä rooli voidaan jakaa myös pienempiin rooleihin tarvittaessa. Tiedostoissa esitetään muodossa [admin].
Peruskäyttäjä, jona palvelin kirjautuu sisälle. Tämä käyttäjä omistaa palvelimen tietokannan. Tiedostoissa esitetään muodossa [peruskäyttäjä].
$ psql "host=[osoite] port=[portti] user=[käyttäjätunnus] dbname=[tietokanta] password=[salasana] sslmode=require"
PostgreSQL:ssä on muutama sisäänrakennettu komento. Ne alkavat kenoviivalla '\'. Seuraavaksi muutama hyödyllinen komento.
\c [DB] [USER]- yhdistää tietokantaan [DB] käyttäjällä [USER]\du- listaa tietokantajärjestelmään luodut käyttäjät\l- listaa tietokantajärjestelmään luodut tietokannat\dt- listaa tietokantaan luodut taulut\dt [SCHEMA].*- listaa tietokannassa tiettyyn skeemaan [SCHEMA] luodut taulut\q- sulje yhteys PostgreSQL:ään
Komentorivillä pitää kirjautua sisään postgres-käyttäjänimellä. Se on myös PostgreSQL:n pääkäyttäjä. Pääkäyttäjä voi olla myös jokin muu riippuen omasta konfiguraatiostasi.
$ sudo -u postgres psql
Seuraavaksi aukeaa PostgreSQL:n oma komentorivi. Se näyttää seuraavalta:
postgres=#
'postgres' kertoo tässä tapauksessa sen, että MIHIN tietokantaan olet NYT yhdistettynä. Oletuksena PostgreSQL yhdistää olemassaolevaan 'postgres' -tietokantaan. Esimerkiksi 'test' tietokantaan yhdistettynä komentokehoite näyttäisi seuraavalta:
test=#
TAI
test=>
Eli kun syötät komentoja tästä ohjeesta, niin seuraa tarkasti tuota, jotta olet varmasti yhdistynyt oikeaan tietokantaan!
Aluksi lisätään uusi käyttäjä tietokantajärjestelmään. Tämä Tukki-palvelin käyttää peruskäyttäjää tietokantaoperaatioiden suorittamisessa.
postgres=# CREATE USER "[peruskäyttäjä]" WITH PASSWORD '[salasana]';
Komennon jälkeen viestiksi pitäisi tulla "CREATE ROLE". Kyseinen viesti on geneerinen ja kertoo ainoastaan suoritetun operaation lyhykäisyydessään. Jos jotain menee vikaan, niin silloin tulee erillinen virheviesti. Tässä ohjeessa ei huomioida kyseisiä saatuja viestejä.
Seuraavaksi luodaan uusi tietokanta:
postgres=# CREATE DATABASE "[tietokanta]" WITH OWNER "[peruskäyttäjä]";
Nyt tietokanta on valmis käytettäväksi palvelimen kanssa. Pavelin ajaa automaattisesti projektin juuressa olevassa migrations/sql kansiossa olevat sql skriptit Postgrator -palikalla palvelimen käynnistämisen ja testien ajon yhteydessä. Tietokannan skeeman päivittäminen tapahtuu näiden skriptien avulla, joten tietokannan pääkäyttäjän ei tarvitse manuaalisesti päivittää tietokantaa.
HUOM! Jos yhdistät tietokantaan peruskäyttäjänä, niin sinun täytyy yhdistää tietokantaan verkon yli! PostgreSQL:ään voi yhdistää paikallisesti AINOASTAAN käyttämällä paikallista käyttäjätunnusta. Eli esimerkiksi näin voit yhdistää paikalliseen PostgreSQL tietokantapalvelimeen verkon yli:
$ psql -U "[peruskäyttäjä]" -h "127.0.0.1" -d "[tietokanta]"