باب · اپنا ڈیٹا جوڑیں
ایک کال ماخذ رجسٹر کرتی ہے، ٹائپڈ اسکیما اخذ کرتی ہے، اور اس کی ریویژن ہر اس پلان میں پن کر دیتی ہے جو اسے چھوتا ہے۔ فائلیں اور SQLite عمل کے اندر چلتے ہیں — کوئی کلید نہیں، کچھ باہر نہیں جاتا۔ لائیو ڈیٹا بیسز انجن کے ذریعے جڑتے ہیں — براہ راست، ہر ڈیٹا بیس کے اپنے وائر پروٹوکول پر: اسناد خفیہ کاری شدہ، کوئی ڈیٹا کاپی نہیں۔
›const sales = await sqai.connect("./data/sales.csv", { name: "sales" })
→ row_count 12 · schema_revision e4938027… · status ready
ٹائپڈ · ہیشپنڈ · صرف پڑھنے کے لیے
IIقسمیں
ہر خانہ ایک ہی کنٹریکٹ پر کھلتا ہے: کیسے جڑتا ہے، کیا چاہیے، کیا باہر جاتا ہے۔ ایک کھولیں۔
عمل کے اندرکوئی کلید نہیں · کوئی ڈیمن نہیں · کوئی نیٹ ورک نہیں
"./data/sales.csv""./data/orders.tsv""./data/sales.json"[{ region: "east", revenue: 512 }, …]{ records: [ … ] }{ provider: "sqlite", path, table | query }"./data/sales.xlsx""./data/sales.parquet"انجن کے ذریعےاسناد خفیہ کاری شدہ · کوئی ڈیٹا کاپی نہیں
{ type: "postgres", host, port, database, user, password, table | query }{ type: "mysql", host, port, database, user, password, table | query }{ type: "oracle", host, port, database, user, password, table | query }{ type: "mssql", host, port, database, user, password, table | query }{ type: "snowflake", connection_string, query }{ type: "bigquery", connection_string, query }{ type: "clickhouse", connection_string, query }{ type: "redshift", connection_string, query }{ type: "s3", … }{ type: "gcs", … }{ type: "azure_blob", … }{ type: "redis", … }{ type: "neo4j", … }{ type: "elasticsearch", … }{ type: "rest", … }{ type: "github", … }{ type: "gitlab", … }{ type: "bitbucket", … }موڈ ماحول سے خود بخود متعین ہوتا ہے
SQAI_ENGINE_URLself_hosted
آپ کا انجن، آپ کا نیٹ ورک۔
SQAI_API_KEYapi
میزبان انجن۔
کوئی بھی سیٹ نہیںlocal
صرف ان-پروسیس۔
فائلیں اور SQLite ہر موڈ میں کام کرتے ہیں۔ لائیو ڈیٹابیسز کے لیے api یا self_hosted درکار ہے۔ انجن ایک بار کنکشن قائم کرتا ہے، پھر گرم رہتا ہے — ایک مستقل ڈیمن، ہر سوال پر کوئی کولڈ اسٹارٹ نہیں۔
ڈیٹابیس کے اپنے وائر پروٹوکول پر براہِ راست رابطہ
IIIوائر
انجن براہِ راست جڑتا ہے، ہر ڈیٹابیس کا اپنا وائر پروٹوکول بولتا ہے۔ سوالات وہیں چلتے ہیں، آپ کی تنظیم تک محدود — آپ کا ڈیٹابیس کبھی نقل نہیں ہوتا۔
انجن آپ کا ڈیٹا وہیں سوال کرتا ہے جہاں وہ ہے، آپ کی تنظیم تک محدود — اور کبھی آپ کی ترتیب سے آگے نہیں جاتا۔
آرام پر خفیہ کاری شدہ، تنظیم-محدود، صرف آپ کی تنظیم کے سوالات کے لیے استعمال۔ کنیکٹر اپنی ترتیب کبھی نہیں لوٹاتا — صرف نام، قسم، حیثیت، اور آخری ٹیسٹ کا نتیجہ۔
انجن آپ کا ڈیٹابیس کبھی نقل نہیں کرتا — قطاریں وہیں پڑھی جاتی ہیں جہاں وہ ہیں۔
›SELECT 1ok · connector: live
ہر ٹیسٹ ایک حقیقی کنکشن کھولتا ہے — SQL کے لیے SELECT 1، آبجیکٹ اسٹوریج کے لیے HEAD، REST کے لیے نمونہ فیچ۔ کنیکٹر صرف تب لائیو ہوتا ہے جب حقیقی کنکشن کامیاب ہو؛ ترتیب بدلیں تو وہ غیر-آزمودہ پر واپس آ جاتا ہے۔
فلیگ شپ وائر · Oracle
انجن python-oracledb کو Thin موڈ میں بنڈل کرتا ہے اور براہِ راست جڑتا ہے — نہ Instant Client، نہ اضافی رن ٹائم عمل، نہ کوئی اضافی Python پیکیج۔ انجن وائر کا مکمل اختیار رکھتا ہے: ڈرائیور، محدود کنکشن پول، اسناد کی تصدیق، اسکیما براؤز، اور Arrow-مطابق بیچ فیچ راستہ — کوئی پوشیدہ غیر-پولڈ فال بیک کنکشن نہیں۔
ٹیبلز PostgreSQL وائر پروٹوکول پر وہیں پڑھی جاتی ہیں — کلسٹر کبھی نقل نہیں ہوتا۔ ٹیسٹ کامیابی کا پیغام بھی PostgreSQL کا نام لیتا ہے۔
آبجیکٹ اسٹوریج اور اپلوڈز ایک ہی پارسرز استعمال کرتے ہیں — S3 میں Parquet آبجیکٹ اور اپلوڈ شدہ Parquet فائل انجن میں یکساں طور پر پہنچتے ہیں۔
ایک ہی درخواست → ایک ہی قطاریں، ایک ہی ترتیب · ہر رسائی قابلِ آڈٹ · ایگریس ایک فیل-کلوزڈ فی-ڈیپلائمنٹ اجازت فہرست ہے
IVیکسانیت
ہر ذریعہ ایک ہی typed SqaiSource لوٹاتا ہے — یکساں فیلڈز، یکساں pins، یکساں ضمانتیں۔ فائل کی جگہ warehouse لگائیں، downstream میں کچھ نہیں بدلتا۔
"./data/sales.csv"{ type: "snowflake", connection_string, query }SqaiSource
یکساں ساخت · ہر ذریعہایک سند، ذریعہ کوئی بھی ہو۔ Downstream کوڈ کو کبھی معلوم نہیں ہوتا کہ rows کہاں ہیں۔
نام دوبارہ باندھنے پر خطا آتی ہے source_already_registered
VPin
connect() ہر plan اور computation میں schema revision pin کر دیتا ہے۔ بدلے ہوئے ڈیٹا پر محفوظ plan دوبارہ چلائیں تو تبدیلی سامنے آتی ہے — خاموشی سے غلط نمبر نہیں۔
schema_revisionschema_revision_mismatchsource_already_registeredprovenance.bindings[0]
source_name"sales"fields["revenue"]schema_revisione4938027…c9b8cfberow_count12input_hash2ea5ede7…478e3212ہر bound فیلڈ اپنی نسب اپنے ساتھ رکھتا ہے۔
VIسوالات
connect() سے کوڈ میں ذریعہ رجسٹر کریں۔ ماڈل کو connection string کبھی نہیں ملتی — اسے typed ذرائع پر صرف تین read-only tools ملتے ہیں، اور policy طے کرتی ہے کہ کون سے ذرائع اور فیلڈز چھو سکتا ہے۔
نہیں۔ In-process ذرائع آپ کی مشین نہیں چھوڑتے۔ Engine ذرائع credentials کو encrypted رکھتے ہیں؛ rows ضرورت پر پڑھی جاتی ہیں، copy نہیں ہوتیں۔
ان میں سے کچھ نہیں۔ رابطہ ڈیٹابیس کے اپنے wire protocol پر براہِ راست ہوتا ہے — engine آپ کا ڈیٹا وہیں query کرتا ہے، آپ کی تنظیم تک محدود، اور ڈیٹابیس کبھی copy نہیں ہوتا۔
فائلوں، in-memory rows، یا SQLite کے لیے نہیں — یہ بغیر کسی account کے in-process چلتے ہیں۔ Live ڈیٹابیس اور warehouses کو hosted engine کے لیے SQAI_API_KEY یا اپنے engine کے لیے SQAI_ENGINE_URL چاہیے۔
نہیں۔ Credentials آپ کے کوڈ میں connect() کے وقت فراہم ہوتے اور engine پر encrypted رہتے ہیں۔ ماڈل کا tool input typed intent رکھتا ہے — کوئی connection تفصیل نہیں، کوئی policy فیلڈ نہیں۔
ہاں۔ Engine میں Thin-mode driver شامل ہے، اس لیے Oracle client انسٹال کرنے کی ضرورت نہیں۔
connect کے وقت pin ہوئی schema_revision مطابقت کھو دیتی ہے، اور replay خاموشی سے غلط نمبروں کی بجائے schema_revision_mismatch ظاہر کرتا ہے۔ رجسٹرڈ نام دوبارہ باندھنے پر source_already_registered آتا ہے۔
Node ≥ 20 · Python ≥ 3.10 · فائلوں اور SQLite کو key کی ضرورت نہیں