← استعمال کی رہنمائی پر واپس جائیں
بیرونی DB انضمام گائیڈ

Supabase سے اپنا ڈیٹا منسلک کریں

اپنے ڈیٹا بیس کے انڈیکیٹرز (مثلاً خوف و لالچ انڈیکس، آن چین ڈیٹا) کو حکمتِ عملی میں ctx.data() سے پڑھنے کا سب سے آسان طریقہ۔ Supabase کا مفت ٹیئر کافی ہے، اور کنکشن اسٹرنگ صرف ایجنٹ ڈیوائس پر محفوظ ہوتی ہے — coinsori سرور نہ ڈیٹا دیکھ سکتا ہے نہ پاس ورڈ۔

شروع کرنے سے پہلے — ایجنٹ انسٹال اور پیئر ہونا چاہیے (ایجنٹ مینجمنٹ اسکرین پر چیک کریں)۔ اگر ڈیٹا پہلے سے کسی اور Postgres میں ہے تو مرحلہ 3 (صرف پڑھنے والا اکاؤنٹ) سے ویسے ہی شروع کریں۔
1

Supabase پروجیکٹ بنائیں

supabase.com پر مفت پروجیکٹ بنائیں۔ ریجن ایجنٹ (VPS) کے قریب والا بہتر ہے۔

2

ٹیبل بنائیں اور ڈیٹا ڈالیں

SQL ایڈیٹر یا Table Editor سے ٹائم سیریز ٹیبل بنائیں۔ کم از کم دو کالم درکار ہیں: وقت کا کالم (ٹائم اسٹیمپ) اور قدر کا کالم۔ مثال: fear_greed(ts bigint, v numeric) — ts کے لیے سیکنڈوں میں epoch تجویز ہے (ملی سیکنڈ اور ISO بھی خودکار پہچانے جاتے ہیں)۔ اگر ابھی ڈالنے کو ڈیٹا نہیں ہے تو پہلے نیچے دیکھیں — یہ مرحلہ پورا چھوڑا جا سکتا ہے۔

ڈالنے کو ڈیٹا نہیں؟ — زیادہ تر لوگ یہیں اٹکتے ہیں

مفت عوامی ڈیٹا سے شروع کرنا سب سے تیز ہے۔ ہم اوپن سورس کلیکٹرز فراہم کرتے ہیں جو خوف و لالچ انڈیکس، بٹ کوائن ہیش ریٹ، امریکی شرحِ سود، VIX جیسے انڈیکیٹرز آپ کے DB میں بھرتے ہیں — سب مفت اور کسی API کلید کے بغیر۔ کلیکٹر **ٹیبل بھی خود بنا دیتا ہے** (ts اور v دو کالم)۔ اس لیے مرحلہ 2 کا کام ختم ہو جاتا ہے — ایک کمانڈ سے ڈیٹا لوڈ، اور cron رجسٹر کرنا بھی ایک لائن۔ ★ لوڈ کرنے کے لیے لکھنے کی اجازت والا اکاؤنٹ استعمال ہوتا ہے۔ مرحلہ 3 میں بننے والا صرف پڑھنے والا اکاؤنٹ الگ ہے، جو ایجنٹ پڑھنے کے لیے استعمال کرتا ہے۔

عوامی ڈیٹا ڈالنے کی گائیڈ دیکھیں →
3

صرف پڑھنے والا اکاؤنٹ بنائیں (اہم)

حکمتِ عملی کی تصدیق کے لیے صرف پڑھنا کافی ہے۔ نیچے والا SQL Supabase SQL ایڈیٹر میں پیسٹ کر کے صرف پڑھنے والا رول بنائیں — یہی اصل حفاظتی دیوار ہے کہ کنکشن اسٹرنگ لیک ہو جائے تب بھی ڈیٹا بدلا نہ جا سکے۔

create role readonly_bot login password 'مضبوط-پاس-ورڈ-سے-بدلیں';
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

کنکشن اسٹرنگ کاپی کریں

پروجیکٹ ڈیش بورڈ میں Project Overview → Get connected کھولیں، Direct والے حصے سے URL کاپی کریں، پھر صرف اکاؤنٹ کا نام اور پاس ورڈ مرحلہ 3 میں بنائے گئے سے بدل دیں۔ اسی جگہ پولر (pooler) طریقہ بھی دکھایا جاتا ہے۔ ★ UI کے الفاظ Supabase بدل سکتا ہے — کون سا طریقہ ہے یہ کاپی کیا گیا URL خود بتاتا ہے: · ہوسٹ db.پروجیکٹ‌ref.supabase.co ہو (براہِ راست) → اکاؤنٹ کا نام صرف readonly_bot · ہوسٹ میں pooler.supabase.com ہو → اکاؤنٹ کا نام readonly_bot.پروجیکٹ‌ref (نقطے کے بعد ref رکھیں — ہٹائیں تو کنکشن مسترد) ★ مفت ٹیئر میں براہِ راست کنکشن (5432) صرف IPv6 ہے — اگر ایجنٹ سرور پر IPv6 نہیں تو Session mode (پولر) URL استعمال کریں۔

5

منسلک کریں اور AI کے سپرد کریں

ایجنٹ مینجمنٹ → ایجنٹ منتخب کریں → ڈیٹا سیٹنگز ٹیب میں کنکشن کا نام (main) اور URL درج کریں، کنکشن فوراً تصدیق ہو جاتا ہے۔ پھر اسی اسکرین پر ٹیبل کی قطار میں [+ اس جدول سے ڈیٹا سیٹ شامل کریں] سے نام، وقت کا کالم اور قدر کا کالم منتخب کریں اور [ٹیسٹ] → [محفوظ کریں] دبائیں (AI ڈیٹا سیٹ صرف پڑھتا ہے)۔ محفوظ کرنے کے بعد AI اسی نام (مثلاً ctx.data('fg')) سے حکمتِ عملی بنا کر بیک ٹیسٹ بھی چلا سکتا ہے۔ اگر ڈالنے کو ڈیٹا نہیں ہے تو /guide/datasets کی عوامی ڈیٹا مثالوں (خوف و لالچ انڈیکس وغیرہ) سے شروع کریں۔

جاننے کی باتیں
  • مفت پروجیکٹس ایک ہفتہ استعمال نہ ہونے پر عارضی طور پر رک جاتے ہیں — ایجنٹ کی ہر 10 منٹ کی تصدیق سرگرمی شمار ہوتی ہے، اس لیے عموماً جاگتے رہتے ہیں۔
  • ریئل ٹائم اپڈیٹ (notify موڈ) صرف Session mode URL پر کام کرتا ہے (Transaction mode پولنگ LISTEN کو سپورٹ نہیں کرتی)۔
  • بیک ٹیسٹ کے نتائج میں ڈیٹا فنگر پرنٹ (قطاروں کی تعداد، ہیش) محفوظ ہوتا ہے — DB کا مواد بدلے تو فنگر پرنٹ بدل جاتا ہے، اور مختلف فنگر پرنٹ والے دو نتائج ایک جیسی شرائط کے نہیں ہوتے۔
دیگر گائیڈز

مکمل دستاویزات یہاں — رہنمائی