Glossary
Terms#
This table pairs every core Abrq DIP term with its Arabic equivalent and a short definition. It is the terminology source of truth for the Arabic documentation; translators reuse these pairs verbatim.
| English | Arabic | Definition |
|---|---|---|
| Connector | موصِّل | A saved connection definition for an external system — a database, object store, message broker, or file server. Connectors are instance-scoped and reused across pipelines; credentials are stored encrypted. |
| CDC (change data capture) | التقاط بيانات التغيير | Continuous replication of row-level changes from an operational source table into a mirror table, using a timestamp-based or transaction-log-based capture strategy. |
| Mirror table | جدول المرآة | The destination copy of a source table that a CDC pipeline creates and keeps up to date. |
| Snapshot | لقطة | A point-in-time record of a pipeline's source schema kept in the schema registry; incoming data is compared against the current snapshot to detect drift. |
| Stream | دفق | An ingestion pipeline that pulls records from an external HTTP API, stages them in batches, and delivers them to one or more configured destinations. A licensed feature. |
| Fan-out | التوزيع المتعدد الوجهات | Delivery of one stream's staged batches to several destinations independently; each destination has its own retries and checkpoint, and one destination's failure never blocks the others. |
| Dead letter | رسالة ميتة | A staged batch that exhausted all delivery retries for one destination. It is kept in full, with the failure reason, for targeted replay or discard — never silently dropped. |
| Circuit breaker | قاطع الدارة | A per-destination guard that suspends delivery attempts after repeated consecutive failures and probes again after a cooldown (closed → open → half-open). |
| File ingestion | استيعاب الملفات | Scheduled pickup of files from object storage or FTP/FTPS servers, loaded into a relational destination table. |
| Email feed | تغذية البريد الإلكتروني | A pipeline that polls an IMAP inbox and loads message attachments into a destination table. A licensed feature. |
| Pipeline | خط أنابيب البيانات | Any configured data flow in the platform: a CDC table, stream, file ingestion, email feed, or SQL task. |
| Project | مشروع | The container for SQL pipelines: it groups tasks, environments, and members with per-project roles. |
| Task | مهمة | A single SQL unit of work inside a project — extract-load, transform, or table copy — scoped to exactly one environment. |
| Environment | بيئة | A named per-project context (for example dev or prod) with its own connector bindings and its own copy of each task. |
| Protected environment | بيئة محمية | An environment flagged so that Developer-role members cannot write in it; environments named prod or production are protected by default. |
| Promotion | ترقية | The diff-and-confirm copy of a task's definition from one environment to another; the operator reviews the field-level diff and confirms with the target environment's name. |
| Sample run | تشغيل عيّنة | A bounded task run capped at a row count (default 1000) or a time window. Sample runs never advance watermarks, so they are safe to repeat while developing. |
| Load mode | وضع التحميل | How a task writes to its destination: full refresh, append, upsert, incremental, or historical upsert (SCD2). |
| Schema drift | انحراف المخطط | A difference between the source schema observed during a run and the last recorded schema, handled by the pipeline's policy: Reject, Evolve, or Rescue. |
| Rescue column | عمود الإنقاذ | The catch-all JSON column _abrq_rescued_data that the Rescue policy adds to a destination table; values from drifting columns land there instead of failing the run. |
| Entitlement | استحقاق | What a license grants: the list of licensed features, the expiry date, and the host fingerprints the license is bound to. |
| License file | ملف الترخيص | The signed JSON file the platform reads from local disk (default /var/abrq-dip/license.json). It is verified offline; there is no upload API and no phone-home. |
| Fingerprint | بصمة المضيف | A hash of a host's machine identity used to bind a license to specific machines; a license with no fingerprints is unbound. |
| Framework DB | قاعدة بيانات الإطار | The platform's own PostgreSQL database: connectors, pipelines, users, run history, the audit chain, and encrypted secrets. |
| Datastore | مخزن البيانات | The separate bundled PostgreSQL database used as a landing area for CDC mirror tables and file-ingestion landings. |
| Worker | عامل المعالجة | A Celery process that executes queued pipeline runs and maintenance tasks. Workers scale horizontally. |
| Scheduler | المجدوِل | The single Celery Beat process that enqueues all periodic work — polls, schedule ticks, and maintenance. Exactly one runs per installation. |
| Audit chain | سلسلة التدقيق | The hash-chained audit log in which every row links to the previous one, so tampering or deletion is detectable; verified daily and on demand. |
| Masking policy | سياسة إخفاء البيانات | An administrator-defined rule controlling how sensitive column values are masked when displayed. |
| Retention policy | سياسة الاحتفاظ بالبيانات | A stored rule for deleting aged rows from a dataset, with a dry-run preview and a confirmation-gated execute. |