অধ্যায় · আপনার ডেটা সংযুক্ত করুন
একটি কল একটি উৎস নিবন্ধন করে, একটি টাইপড স্কিমা অনুমান করে, এবং এটি স্পর্শ করা প্রতিটি প্ল্যানে এর রিভিশন পিন করে। ফাইল ও 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একরূপতা
প্রতিটি সোর্স একই টাইপড SqaiSource ফেরত দেয় — একই ফিল্ড, একই পিন, একই গ্যারান্টি। ওয়্যারহাউস দিয়ে ফাইল বদলে দিন, ডাউনস্ট্রিমে কিছুই বদলায় না।
"./data/sales.csv"{ type: "snowflake", connection_string, query }SqaiSource
একই কাঠামো · প্রতিটি সোর্সএকটি সার্টিফিকেট, যেকোনো সোর্সের জন্য। ডাউনস্ট্রিম কোড কখনো জানে না রো কোথায় থাকে।
নাম পুনরায় বাঁধলে এরর ছোড়ে source_already_registered
Vপিন
connect() প্রতিটি প্ল্যান ও কম্পিউটেশনে একটি স্কিমা রিভিশন পিন করে। পরিবর্তিত ডেটার বিপরীতে সংরক্ষিত প্ল্যান রিপ্লে করলে পরিবর্তন স্পষ্ট হয় — নীরবে ভিন্ন সংখ্যা নয়।
schema_revisionschema_revision_mismatchsource_already_registeredprovenance.bindings[0]
source_name"sales"fields["revenue"]schema_revisione4938027…c9b8cfberow_count12input_hash2ea5ede7…478e3212প্রতিটি বাউন্ড ফিল্ড তার উৎসপরম্পরা বহন করে।
VIপ্রশ্নাবলি
connect() দিয়ে কোডে সোর্স নিবন্ধন করুন। মডেল কখনো কানেকশন স্ট্রিং দেখে না — এটি টাইপড সোর্সের উপর তিনটি রিড-অনলি টুল পায়, এবং পলিসি নির্ধারণ করে কোন সোর্স ও ফিল্ড স্পর্শ করা যাবে।
না। ইন-প্রসেস সোর্স আপনার মেশিন ছাড়ে না। ইঞ্জিন সোর্স ক্রেডেনশিয়াল এনক্রিপ্টেড রাখে; রো চাহিদামতো পড়া হয়, কখনো কপি হয় না।
এর কোনোটিই নয়। কানেক্টিভিটি ডেটাবেসের নিজস্ব ওয়্যার প্রোটোকলে সরাসরি — ইঞ্জিন আপনার ডেটা যেখানে আছে সেখানেই কোয়েরি করে, আপনার অর্গানাইজেশনের স্কোপে, এবং কখনো ডেটাবেস কপি করে না।
ফাইল, ইন-মেমোরি রো বা SQLite-এর জন্য নয় — এগুলো কোনো অ্যাকাউন্ট ছাড়াই ইন-প্রসেসে চলে। লাইভ ডেটাবেস ও ওয়্যারহাউসের জন্য হোস্টেড ইঞ্জিনে SQAI_API_KEY, অথবা নিজের ইঞ্জিনে SQAI_ENGINE_URL দরকার।
না। ক্রেডেনশিয়াল আপনার কোডে connect()-এর সময় সরবরাহ করা হয় এবং ইঞ্জিনে এনক্রিপ্টেড থাকে। মডেলের টুল ইনপুটে থাকে টাইপড ইন্টেন্ট — কোনো কানেকশন বিবরণ নয়, কোনো পলিসি ফিল্ড নয়।
হ্যাঁ। ইঞ্জিনে বান্ডেলড Thin-mode ড্রাইভার আছে, তাই কোনো Oracle ক্লায়েন্ট ইনস্টল করতে হয় না।
connect-এর সময় পিন করা schema_revision মিলে না, এবং রিপ্লে নীরবে ভিন্ন সংখ্যার বদলে schema_revision_mismatch দেখায়। নিবন্ধিত নাম পুনরায় বাঁধলে source_already_registered ছোড়ে।