← Takaisin käyttöohjeisiin
Ulkoisen tietokannan integraatio-opas

Oman datan yhdistäminen Supabasella

Helpoin tapa saada oman tietokantasi mittarit (esim. pelko-ahneusindeksi, ketjudata) strategioiden luettaviksi ctx.data()-kutsulla. Supabasen ilmainen taso riittää, ja yhteysmerkkijono tallennetaan vain agenttilaitteellesi — coinsori-palvelin ei näe dataasi eikä salasanaasi.

Ennen aloitusta — Agentin on oltava asennettu ja paritettu (tarkista Agenttien hallinta -näkymästä). Jos datasi on jo toisessa Postgresissa, voit soveltaa ohjetta sellaisenaan vaiheesta 3 (vain luku -tili) alkaen.
1

Luo Supabase-projekti

Luo ilmainen projekti osoitteessa supabase.com. Alue kannattaa valita lähelle agenttia (VPS).

2

Luo taulu ja lisää data

Luo aikasarjataulu SQL-editorilla tai Table Editorilla. Vähimmäisvaatimus on kaksi saraketta: aikasarake (aikaleima) ja arvosarake. Esim.: fear_greed(ts bigint, v numeric) — ts:lle suositellaan epoch-sekunteja (myös millisekunnit ja ISO tunnistetaan automaattisesti). Jos sinulla ei vielä ole dataa, katso ensin alla oleva — voit ohittaa tämän vaiheen kokonaan.

Eikö sinulla ole dataa? — tähän useimmat jäävät jumiin

Nopeinta on aloittaa ilmaisesta julkisesta datasta. Tarjoamme avoimen lähdekoodin keräimet, jotka täyttävät tietokantaasi esimerkiksi pelko-ahneusindeksillä, Bitcoinin hashratella, Yhdysvaltain ohjauskorolla ja VIX:llä — kaikki ilmaisia, eikä API-avainta tarvita. Keräin **luo myös taulun puolestasi** (sarakkeet ts ja v). Siksi tämä vaihe 2 jää kokonaan pois — yksi komento lataa datan ja toinen rekisteröi cronin. ★ Lataukseen käytetään kirjoitusoikeudellista tiliä. Vaiheessa 3 luotava vain luku -tili on erillinen tili, jota agentti käyttää lukemiseen.

Avaa julkisen datan opas →
3

Luo vain luku -tili (tärkeää)

Strategioiden validointiin tarvitaan vain lukuoikeus. Liitä alla oleva SQL Supabasen SQL-editoriin ja luo vain luku -rooli — se on todellinen puolustuslinja: vaikka yhteysmerkkijono vuotaisi, dataa ei voi muuttaa.

create role readonly_bot login password 'vaihda-vahvaan-salasanaan';
grant usage on schema public to readonly_bot;
grant select on all tables in schema public to readonly_bot;
alter default privileges in schema public grant select on tables to readonly_bot;
4

Kopioi yhteysmerkkijono

Avaa projektin hallintapaneelista Project Overview → Get connected, kopioi URL kohdasta Direct ja vaihda vain käyttäjänimi ja salasana vaiheessa 3 luoduiksi. Samassa paikassa näkyy myös pooler-vaihtoehto. ★ Supabase voi muuttaa käyttöliittymän tekstejä — kopioitu URL itse kertoo, kumpi tapa on kyseessä: · jos isäntä on db.projektin-ref.supabase.co (suora) → käyttäjänimi on pelkkä readonly_bot · jos isännässä on pooler.supabase.com → käyttäjänimi on readonly_bot.projektin-ref (säilytä pisteen jälkeinen ref — jos poistat sen, yhteys hylätään) ★ Ilmaisella tasolla suora yhteys (5432) on vain IPv6 — jos agenttipalvelimella ei ole IPv6:ta, käytä Session mode (pooler) -URL:ia.

5

Yhdistä ja anna AI:n hoitaa loput

Kun syötät Agenttien hallinta → valitse agentti → Data-asetukset -välilehdellä yhteyden nimen (main) ja URL:n, yhteys tarkistetaan heti. Valitse sitten samassa näkymässä taulurivin [+ Lisää datajoukko tästä taulusta] -toiminnolla nimi, aikasarake ja arvosarake ja paina [Testaa] → [Tallenna] (AI vain lukee datajoukkoja). Tallennuksen jälkeen AI voi tehdä strategian tällä nimellä (esim. ctx.data('fg')) ja ajaa backtestin. Jos sinulla ei ole dataa, aloita /guide/datasets-sivun julkisista esimerkeistä (pelko-ahneusindeksi ym.).

Hyvä tietää
  • Ilmaiset projektit keskeytetään noin viikon käyttämättömyyden jälkeen — agentin 10 minuutin välein tekemä tarkistus lasketaan yleensä toiminnaksi, joten projekti pysyy hereillä.
  • Reaaliaikainen päivitys (notify-tila) toimii vain Session mode -URL:lla (Transaction mode -yhdistäminen ei tue LISTEN-komentoa).
  • Backtestin tulokseen tallentuu datan sormenjälki (rivimäärä, tiiviste) — jos tietokannan sisältö muuttuu, sormenjälki muuttuu, eivätkä kaksi eri sormenjäljen tulosta ole samoilla ehdoilla ajettuja.