Tietokannan käyttö omalta koneelta

Ennen aloittamista

Tarvitset palvelun hallintaoikeudet ja PostgreSQL-tietokannan. Tietokantaasi pääsee vain palvelimiltamme ja niistä osoitteista, joille itse avaat yhteyden. Kirjautumiseen tarvitaan lisäksi aina tietokannan oma käyttäjätunnus ja salasana.

Taulujen selaamiseen ja SQL-kyselyihin et tarvitse omaa työkalua etkä yhteyden avaamista: valitse Tietokannat-sivulla tietokannan kohdalta Hallitse tietoja. Kyselyt vain lukevat tietoja, ellet salli muutoksia.

Kun sallit muutokset, voit ajaa myös kokonaisen SQL-skriptin, enintään 2 Mt, esimerkiksi tekoälyn tekemän tiedoston: liitä se tai valitse Avaa tiedosto. Skripti ajetaan yhtenä kokonaisuutena, eli joko kaikki lauseet onnistuvat tai mitään ei tallenneta.

Avaa yhteys

1. Avaa hallintapaneelista palvelusi Tietokannat.
2. Valitse kohdasta Yhteys omalta koneelta Avaa yhteys.
3. Tarkista IP-osoitteesi. Siinä on valmiina osoite, josta käytät hallintapaneelia. Jos yhdistät toiselta koneelta tai toisesta verkosta, kirjoita sen julkinen IPv4-osoite.
4. Valitse, kuinka pitkäksi aikaa yhteys on auki: 1, 8 tai 24 tuntia. Valitse Avaa yhteys.
5. Yhteys toimii, kun sen kohdalla lukee Auki … asti. Saat avauksesta myös sähköpostin.

Yhteys sulkeutuu itsestään valitsemasi ajan jälkeen, ja voit sulkea sen milloin tahansa valitsemalla Sulje. Yhteyksiä voi olla auki kolme kerrallaan.

Yhdistä tietokantaan

Tarvitset tietokannan kortilta nämä tiedot: Palvelin, Portti, Käyttäjä, Tietokanta ja Salasana. Salasana tulee näkyviin valitsemalla Näytä salasana, ja samalla näet Yhteysosoitteen, jossa ovat kaikki tiedot yhdessä.

Kirjoita palvelin ja portti eri kenttiin, äläkä lisää porttia palvelimen perään. Muuten ohjelma ei löydä palvelinta.

TablePlus, DBeaver tai pgAdmin: luo uusi PostgreSQL-yhteys, kirjoita tiedot ja valitse SSL-tilaksi require. Parhaiten suojatun yhteyden saat, kun valitset tietokantasivulla Lataa varmenne, lisäät tiedoston ohjelman SSL-asetuksiin CA-varmenteeksi (Root certificate) ja valitset tilaksi verify-full.

pgAdmin: kirjoita tietokannan nimi kohtaan Maintenance database. Jos yhdistäminen kaatuu Windowsissa ilmoitukseen access violation writing 0x0000000000000000, vika on pgAdminissa (esimerkiksi versiossa 9.18). Lisää silloin Parameters-välilehdellä parametri GSS encmode ja valitse arvoksi disable. Yhteys salataan edelleen SSL:llä.

psql: liitä yhteysosoite lainausmerkkeihin ja vaihda sen loppu muotoon, joka tarkistaa palvelimen varmenteen:

psql "postgresql://KÄYTTÄJÄ:SALASANA@PALVELIN:PORTTI/TIETOKANTA?sslmode=verify-full&sslrootcert=nordichost-database-ca.pem"

Prisma Studio: aseta koneellasi DATABASE_URL tietokannan yhteysosoitteeksi ja käynnistä npx prisma studio.

Siirrä tietokanta SQL-tiedostona

Omalla koneellasi tehty tietokanta siirtyy tänne yhtenä SQL-tiedostona. Tiedoston voi tehdä tekoäly, tai teet sen itse pg_dumpilla. Vaihda lainausmerkkien sisään koneesi tietokannan yhteysosoite:

pg_dump --inserts --no-owner --no-privileges --file=tietokanta.sql "postgresql://..."

Jos sivustosi luo taulut itse migraatioilla, lisää valinta --data-only, niin tiedostoon tulevat vain tiedot.

1. Valitse Tietokannat-sivulla tietokannan kohdalta Hallitse tietoja.
2. Laita Salli muutokset päälle.
3. Liitä tiedosto tai valitse Avaa tiedosto, ja valitse Suorita.

Joko koko tiedosto tallentuu tai ei mitään. Tiedosto voi olla enintään 2 Mt: jaa isompi osiin ja aja ne järjestyksessä taulut ensin, tai siirrä tietokanta alla olevalla tavalla. Kun sivustosi on yhdistetty tietokantaan, se käyttää samoja tauluja ja tietoja.

Siirrä vanha tietokanta tänne

Käytä PostgreSQL:n työkaluja, joiden versio on vähintään sama kuin vanhan tietokantasi ja mieluiten 18.

1. Ota vanhasta tietokannasta varmuuskopio omalla koneellasi. Vaihda lainausmerkkien sisään vanhan tietokantasi yhteysosoite:

pg_dump --format=custom --no-owner --no-privileges --file=vanha.dump "postgresql://..."

2. Avaa yhteys omalta koneeltasi tämän ohjeen alun mukaan.
3. Palauta varmuuskopio tietokantaasi. Vaihda lainausmerkkien sisään tietokantasi yhteysosoite:

pg_restore --no-owner --no-privileges --dbname="postgresql://..." vanha.dump

--no-owner ja --no-privileges jättävät vanhan palvelimen käyttäjät ja oikeudet pois, ja kaikki tiedot tulevat tietokantasi omalle käyttäjälle. Ilman niitä palautus ilmoittaa käyttäjistä, joita ei ole olemassa. Tuotu tieto lasketaan pakettisi levytilaan.

Kun lopetat

Sulje yhteys valitsemalla Sulje, kun et enää tarvitse sitä. Jos saat sähköpostin yhteydestä, jota et avannut itse, sulje se heti ja vaihda tietokannan salasana valitsemalla Vaihda salasana. Yhdistetyt sivustot saavat uuden salasanan itsestään.