> ## Content Index > Fetch the complete content index at: https://arabroot.io/llms.txt > Use this file to discover other available public pages before exploring further. # Metabase: لوحات وتقارير من بياناتك دون كتابة كود - URL: https://arabroot.io/articles/metabase-لوحات-وتقارير-من-بياناتك/ - Published: 2026-10-08T07:30:00.000Z - Updated: 2026-10-12T05:26:09.000Z - Description: كيف تثبت Metabase على سيرفرك، وتبني منه أسئلة ولوحة مبيعات من بيانات شركتك بالنقر أو بلغة SQL. - Author: فريق عرب رووت - Tags: الأدلة التقنية, الذكاء الاصطناعي والبيانات, قواعد البيانات, تطبيقات لفريقك, الاستضافة الذاتية, Metabase كل أسبوع يسألك المدير السؤال نفسه: كم بعنا هذا الشهر؟ وأي مدينة الأعلى؟ وما المنتج الذي تراجع؟ فتفتح قاعدة البيانات وتكتب استعلام SQL وتنسخ النتيجة إلى ملف Excel وترسله، ثم يأتي السؤال التالي بعد ساعة بفلتر مختلف. والحل الذي تستخدمه الفرق لهذه المشكلة هو أداة ذكاء الأعمال Business Intelligence، واختصاراً BI، وهي أداة تتصل بقاعدة بياناتك وتسمح لغير المبرمج أن يسأل البيانات ويرى النتيجة رسماً بيانياً، وتجمع الرسوم في لوحة Dashboard تتحدث أرقامها وحدها. وهذا المقال هو أول مقال في [مرحلة البيانات وذكاء الأعمال](https://arabroot.io/start/#stage-data)، ونستخدم فيه Metabase لأنها أسهل أداة مفتوحة المصدر يبدأ بها فريق صغير، وسوف نناقش ما يلي: - ما هي أداة BI، ومعنى مصدر البيانات والسؤال Question والبطاقة Card واللوحة Dashboard والفلتر. - من أين تقرأ الأداة بياناتها، ولماذا لا تربطها بقاعدة الإنتاج بمستخدم المالك. - مكونات Metabase: قاعدة بياناتها الخاصة وقاعدة بياناتك، والرخصة والإصدارات التجارية. - تجربة عملية: متجر تجريبي على PostgreSQL ببيانات عربية، ثم تثبيت Metabase بإصدار مثبت وقاعدة تطبيق PostgreSQL، وبناء أسئلة ولوحة بفلاتر. - العربية في Metabase بصراحة: ما يعمل وما لا يعمل. - النسخ الاحتياطي والتحديث والتشغيل في الإنتاج. ## ما هي أداة ذكاء الأعمال BI؟ أداة BI تقف بين قاعدة البيانات والشخص الذي يريد أرقاماً، وفيها أربعة مفاهيم تتكرر في كل أداة، سواء كانت Metabase أو Superset أو Power BI: - **مصدر البيانات Data Source:** قاعدة بيانات تتصل بها الأداة، مثل PostgreSQL أو MySQL، أو ملف CSV ترفعه. - **السؤال Question أو الاستعلام Query:** طلب محدد مثل «مجموع المبيعات لكل مدينة»، تبنيه بالنقر في واجهة رسومية أو تكتبه بلغة SQL. - **البطاقة Card أو الرسم Chart:** نتيجة السؤال مع طريقة عرضها، رقم كبير أو أعمدة أو خط زمني أو جدول. - **اللوحة Dashboard:** مجموعة بطاقات في صفحة واحدة، ومعها فلاتر Filters مثل المدينة والفترة تغير كل البطاقات معاً، وكل من يفتحها يرى أرقاماً محدثة من قاعدة البيانات مباشرة. والصورة التالية تبين الطريق من البيانات إلى اللوحة: ![مخطط فيه ثلاثة مصادر بيانات PostgreSQL وMySQL وملف CSV تتصل بأداة BI عبر مستخدم للقراءة فقط، وداخل الأداة سؤال بالنقر وسؤال SQL يتحولان إلى بطاقة فيها نتيجة ونوع رسم، ثم لوحة Dashboard بفلاتر يراها المدير وفريق المبيعات](https://arabroot.io/content/images/2026/10/metabase-01-bi-flow.webp) المصدر، ثم السؤال، ثم البطاقة، ثم اللوحة التي يراها الفريق وقد يتساءل البعض: لماذا لا نكتفي بجدول Excel يحدث يدوياً؟ والإجابة أن الملف صورة للبيانات في لحظة تصديره، فكل سؤال جديد يحتاج تصديراً جديداً، وكل نسخة في بريد شخص مختلف قد تكون قديمة، أما اللوحة فتسأل قاعدة البيانات في كل مرة تفتح فيها، والصلاحيات فيها تحدد من يرى ماذا. ## من أين تقرأ الأداة بياناتها؟ الطريقة البسيطة أن تعطي الأداة عنوان قاعدة الإنتاج وكلمة مرور المستخدم الذي يملكها، وهذه الطريقة غير مناسبة إطلاقاً لسببين: الأول أن تقريراً واحداً ثقيلاً، مثل مجموع مبيعات سنتين دون فهرس، يقرأ ملايين الصفوف ويأخذ المعالج والذاكرة من التطبيق الذي يخدم العملاء، والثاني أن مستخدم المالك يستطيع أن يعدل ويحذف، فخطأ واحد في محرر SQL داخل الأداة يغير بيانات حقيقية. والصورة التالية تبين الطريقتين: ![مخطط من جزأين: في الطريقة البسيطة تتصل أداة BI بقاعدة الإنتاج بمستخدم المالك فيبطؤ المتجر بسبب مسح كامل لسنتين من الطلبات، وفي الطريقة الأنسب تقرأ الأداة من نسخة للقراءة Read Replica بمستخدم bi_reader لديه صلاحية SELECT فقط والتطبيق يكتب في القاعدة الرئيسية](https://arabroot.io/content/images/2026/10/metabase-02-where-to-query.webp) التقارير تقرأ من نسخة بمستخدم للقراءة فقط، والمتجر يحتفظ بسرعته لذلك فالقاعدة هي: مستخدم قاعدة بيانات للقراءة فقط خاص بأداة BI، وإذا كانت التقارير ثقيلة أو القاعدة مشغولة فاجعل الأداة تقرأ من نسخة للقراءة Read Replica كما شرحنا في [توجيه القراءة في عناقيد قواعد البيانات](https://arabroot.io/articles/%D8%B9%D9%86%D8%A7%D9%82%D9%8A%D8%AF-%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/#read-routing)، أو من مخزن بيانات Data Warehouse منفصل، وهذا موضوع مخطط له في [مرحلة البيانات](https://arabroot.io/start/#stage-data). وسوف نرى في التجربة كيف يرفض PostgreSQL أمر الحذف من مستخدم القراءة. ## مكونات Metabase وقاعدة بياناتها الخاصة [Metabase](https://www.metabase.com/?ref=arabroot.io) تطبيق Java واحد يعمل على المنفذ 3000، ولكن لاحظ أن هناك قاعدتي بيانات مختلفتين في كل تركيب، كما تبين الصورة التالية: ![مخطط فيه المتصفح ثم Reverse Proxy مع HTTPS ثم Container لتطبيق Metabase على المنفذ 3000، ومنه سهم إلى قاعدة التطبيق PostgreSQL التي تحفظ الأسئلة واللوحات والمستخدمين والصلاحيات والاتصالات، وسهم بمستخدم bi_reader إلى قاعدة بيانات المتجر، وسهم متقطع إلى مصادر أخرى، وتحذير أن ملف H2 الافتراضي داخل ال Container للتجربة فقط](https://arabroot.io/content/images/2026/10/metabase-03-metabase-parts.webp) قاعدة التطبيق تحفظ عمل فريقك، وقاعدة المتجر هي البيانات التي تسألها - **قاعدة التطبيق Application Database:** تحفظ فيها Metabase الأسئلة واللوحات والمستخدمين والصلاحيات وبيانات الاتصال بمصادرك، وبشكل افتراضي هي ملف H2 داخل ال Container، ولكن [توثيق قاعدة التطبيق](https://www.metabase.com/docs/latest/installation-and-operation/configuring-application-database?ref=arabroot.io) يوصي ب PostgreSQL للإنتاج ويصف H2 بأنه للتجربة المحلية وينصح بتجنبه في الإنتاج، والسبب أن الملف يضيع مع ال Container إذا لم تربطه ب Volume، وأنه أضعف في الأداء والموثوقية، ولهذا توجد صفحة كاملة عن [الانتقال من H2](https://www.metabase.com/docs/latest/installation-and-operation/migrating-from-h2?ref=arabroot.io). - **قاعدة بياناتك:** المصدر الذي تسأله، وتتصل به Metabase بالمستخدم الذي تعطيها إياه. - **مفتاح التشفير:** بيانات الاتصال بمصادرك، ومنها كلمات المرور، تحفظ في قاعدة التطبيق، والمتغير `MB_ENCRYPTION_SECRET_KEY` يجعلها مشفرة كما في [توثيق التشفير](https://www.metabase.com/docs/latest/databases/encrypting-details-at-rest?ref=arabroot.io)، ويجب أن يكون 16 حرفاً على الأقل بحسب [صفحة المتغيرات](https://www.metabase.com/docs/latest/configuring-metabase/environment-variables?ref=arabroot.io). ### الرخصة والإصدارات التجارية بحسب [ملف الرخصة في المستودع](https://github.com/metabase/metabase/blob/master/LICENSE.txt?ref=arabroot.io) فالكود خارج المجلد `enterprise` برخصة AGPL، وما داخله برخصة Metabase التجارية، وال Image `metabase/metabase` على Docker Hub هي النسخة المفتوحة برخصة AGPL، أما `metabase/metabase-enterprise` فبالرخصة التجارية. وتعرض [صفحة الأسعار](https://www.metabase.com/pricing/?ref=arabroot.io) النسخة المفتوحة مجاناً إلى جانب خطط مدفوعة Starter وPro وEnterprise، وبعض الميزات التي تحتاجها الشركات الأكبر مدفوعة، فمثلاً تقييد الصفوف والأعمدة لكل مجموعة متاح بحسب [صفحته](https://www.metabase.com/docs/latest/permissions/row-and-column-security?ref=arabroot.io) في Pro وEnterprise فقط. وتوضح [صفحة الرخص](https://www.metabase.com/license/?ref=arabroot.io) أن الرخصة التجارية تسمح أيضاً بتضمين Embedding اللوحات في تطبيقك دون أن يخضع تطبيقك لشروط AGPL، فإذا كنت ستضمن لوحات Metabase داخل منتج تبيعه فاقرأ الصفحة قبل أن تبدأ. ## تجربة عملية: متجر تجريبي ولوحة مبيعات الآن سوف نقوم ببناء متجر تجريبي يبيع التمور والقهوة والعسل في عشر مدن سعودية، ثم نثبت Metabase ونبني عليه لوحة مبيعات. نشغل كل شيء في Docker على المنافذ المحلية `127.0.0.1` فقط، وإذا لم يكن Docker مثبتاً لديك فابدأ من [دليل تثبيت Docker](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-docker-%D8%B9%D9%84%D9%89-ubuntu/). ### بيانات المتجر ومستخدم القراءة البيانات خمسة جداول: المدن والمنتجات والعملاء والطلبات وبنود الطلبات، ثم View اسمه `sales` يجمعها في جدول واحد مسطح يسهل السؤال منه، ثم مستخدم `bi_reader` لا يملك إلا القراءة. والأسماء العربية في البيانات عن قصد حتى نرى كيف تعرضها الأداة، وتصميم الجداول نفسه شرحناه في [تصميم قواعد البيانات](https://arabroot.io/articles/%D8%AA%D8%B5%D9%85%D9%8A%D9%85-%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%AA%D8%B7%D8%A8%D9%8A%D8%B9-%D9%88%D8%A7%D9%84%D8%AA%D9%88%D8%B3%D8%B9/): ```sql -- Sample data for the BI lab: a fictional online store (orders, products, cities) SELECT setseed(0.42); CREATE TABLE cities ( id int PRIMARY KEY, name text NOT NULL, region text NOT NULL ); INSERT INTO cities VALUES (1,'الرياض','الوسطى'),(2,'جدة','الغربية'),(3,'مكة المكرمة','الغربية'), (4,'المدينة المنورة','الغربية'),(5,'الدمام','الشرقية'),(6,'الخبر','الشرقية'), (7,'أبها','الجنوبية'),(8,'تبوك','الشمالية'),(9,'بريدة','الوسطى'),(10,'حائل','الشمالية'); CREATE TABLE products ( id int PRIMARY KEY, name text NOT NULL, category text NOT NULL, price numeric(10,2) NOT NULL ); INSERT INTO products VALUES (1,'تمر سكري 1 كجم','تمور',45),(2,'تمر عجوة 1 كجم','تمور',90),(3,'تمر خلاص 1 كجم','تمور',38), (4,'قهوة عربية شقراء 500 جم','قهوة',65),(5,'قهوة مختصة إثيوبية 250 جم','قهوة',58),(6,'هيل حب 250 جم','بهارات',72), (7,'دلة قهوة نحاس','أواني',140),(8,'فناجين قهوة 12 قطعة','أواني',55),(9,'زعفران 5 جم','بهارات',95), (10,'عسل سدر 500 جم','عسل',180),(11,'عسل طلح 500 جم','عسل',120),(12,'بخور عود 50 جم','بخور',210); CREATE TABLE customers ( id int PRIMARY KEY, city_id int NOT NULL REFERENCES cities(id), joined_at date NOT NULL ); INSERT INTO customers SELECT g, -- Riyadh and Jeddah get more customers than small cities (ARRAY[1,1,1,1,2,2,2,3,4,5,5,6,7,8,9,10])[1 + floor(random()*16)::int], date '2025-01-01' + floor(random()*600)::int FROM generate_series(1, 3000) g; CREATE TABLE orders ( id int PRIMARY KEY, customer_id int NOT NULL REFERENCES customers(id), created_at timestamptz NOT NULL, status text NOT NULL CHECK (status IN ('مكتمل','ملغي','مسترجع')) ); INSERT INTO orders SELECT g, 1 + floor(random()*3000)::int, timestamptz '2025-01-01 08:00+03' + (random() * (timestamptz '2026-09-30' - timestamptz '2025-01-01')), CASE WHEN random() < 0.90 THEN 'مكتمل' WHEN random() < 0.6 THEN 'ملغي' ELSE 'مسترجع' END FROM generate_series(1, 20000) g; CREATE TABLE order_items ( order_id int NOT NULL REFERENCES orders(id), product_id int NOT NULL REFERENCES products(id), quantity int NOT NULL, PRIMARY KEY (order_id, product_id) ); INSERT INTO order_items SELECT DISTINCT ON (o.id, p.pid) o.id, p.pid, 1 + floor(random()*3)::int FROM orders o CROSS JOIN LATERAL (SELECT 1 + floor(random()*12)::int AS pid FROM generate_series(1, 1 + (o.id % 3))) p; -- One flat view for reports: each row is one product line in one order CREATE VIEW sales AS SELECT o.id AS order_id, o.created_at, o.status, c.name AS city, c.region, p.name AS product, p.category, oi.quantity, oi.quantity * p.price AS revenue FROM orders o JOIN customers cu ON cu.id = o.customer_id JOIN cities c ON c.id = cu.city_id JOIN order_items oi ON oi.order_id = o.id JOIN products p ON p.id = oi.product_id; -- A read-only user for the BI tool: it can read the data and nothing else CREATE ROLE bi_reader LOGIN PASSWORD 'change-me-reader'; GRANT CONNECT ON DATABASE store TO bi_reader; GRANT USAGE ON SCHEMA public TO bi_reader; GRANT SELECT ON ALL TABLES IN SCHEMA public TO bi_reader; ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO bi_reader; ``` نحفظ الملف باسم `store.sql` ونشغل قاعدة المتجر على شبكة Docker خاصة بالتجربة، دون نشر منفذها على الجهاز: ```bash docker network create lab-bi-net docker run -d --name lab-bi-store --network lab-bi-net \ -e POSTGRES_DB=store -e POSTGRES_USER=store_owner -e POSTGRES_PASSWORD=change-me-owner \ -v lab-bi-store-data:/var/lib/postgresql postgres:18.6 docker exec -i lab-bi-store psql -U store_owner -d store < store.sql ``` والمخرج سوف يكون كما يلي: ```text setseed --------- (1 row) CREATE TABLE INSERT 0 10 CREATE TABLE INSERT 0 12 CREATE TABLE INSERT 0 3000 CREATE TABLE INSERT 0 20000 CREATE TABLE INSERT 0 37860 CREATE VIEW CREATE ROLE GRANT GRANT GRANT ALTER DEFAULT PRIVILEGES ``` قبل أن نعطي المستخدم لأي أداة نتأكد أنه يقرأ ولا يكتب، فنسأل بالمستخدم `bi_reader` عن أعلى خمس مدن، ثم نحاول أن نحذف طلباً: ```bash docker exec -e PGPASSWORD=change-me-reader lab-bi-store psql -h 127.0.0.1 -U bi_reader -d store \ -c "SELECT city, count(DISTINCT order_id) AS orders, round(sum(revenue)) AS revenue FROM sales WHERE status = 'مكتمل' GROUP BY city ORDER BY revenue DESC LIMIT 5;" \ -c "DELETE FROM orders WHERE id = 1;" ``` والمخرج سوف يكون كما يلي: ```text city | orders | revenue --------+--------+--------- الرياض | 4482 | 1644749 جدة | 3281 | 1217843 الدمام | 2233 | 850585 بريدة | 1259 | 475893 تبوك | 1207 | 444478 (5 rows) ERROR: permission denied for table orders ``` القراءة تعمل والحذف مرفوض من قاعدة البيانات نفسها، وهذا هو المهم، فالحماية لا تعتمد على إعدادات Metabase ولا على حرص من يستخدمها. ### تثبيت Metabase مع قاعدة تطبيق PostgreSQL نولد كلمة مرور قاعدة التطبيق ومفتاحي التشفير والجلسات في ملف `.env`، ثم نكتب ملف Compose بإصدار مثبت من Metabase وPostgreSQL: ```bash mkdir -p ~/lab-bi/metabase && cd ~/lab-bi/metabase cat > .env <