الفصل · ربط بياناتك
استدعاء واحد يسجّل مصدراً، ويستنتج مخططاً مكتوباً، ويثبّت مراجعته في كل خطة تلمسه. تعمل الملفات و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
كل اختبار يفتح اتصالًا حقيقيًا — SELECT 1 لـ SQL، وطلب HEAD لتخزين الكائنات، وجلب عيّنة لـ REST. لا يصبح الموصِّل نشطًا إلا بعد نجاح اتصال حقيقي؛ عدِّل إعداداته وسيعود إلى حالة غير مختبَر.
البروتوكول الرئيسي · Oracle
يدمج المحرك python-oracledb في وضع Thin ويتصل مباشرةً — لا Instant Client، ولا عملية تشغيل إضافية، ولا حزمة Python زائدة. يمتلك المحرك البروتوكول من طرف إلى طرف: برنامج التشغيل، ومجموعة الاتصالات المحدودة، والتحقق من بيانات الاعتماد، وتصفح المخطط، ومسار جلب دُفعي متوافق مع Arrow — لا اتصال احتياطي خفي خارج المجموعة.
تُقرأ الجداول في مكانها عبر بروتوكول PostgreSQL — لا يُنسخ الكلاستر أبدًا. حتى رسالة نجاح الاختبار تُسمّي PostgreSQL.
تخزين الكائنات والملفات المرفوعة يشتركان في المحللات ذاتها — ملف Parquet في S3 وملف 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.
يتوقف schema_revision المُثبَّت عند الاتصال عن المطابقة، وتُظهر الإعادة schema_revision_mismatch بدلاً من أرقام مختلفة بصمت. إعادة ربط اسم مسجَّل تُطلق source_already_registered.