> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> وثائق واجهة SQL Console المضمّنة التي يوفّرها خادم HTTP في ClickHouse على المسار `/ui`

# SQL Console

SQL Console هي واجهة ويب مضمّنة لتنفيذ الاستعلامات واستكشاف البيانات، وهي متاحة عبر أي منفذ HTTP في ClickHouse على المسار `/ui`، مثل `http://localhost:8123/ui`.

<Note>
  SQL Console ميزة تجريبية.
</Note>

<h2 id="overview">
  نظرة عامة
</h2>

SQL Console هو تطبيق أحادي الصفحة (SPA) يُصرَّف إلى حزمة ثابتة ويُضمَّن مباشرةً داخل ملف ClickHouse التنفيذي (binary)، على غرار تضمين ClickStack عند `/clickstack`. وتُقدَّم جميع الأصول من ملف ClickHouse التنفيذي نفسه — دون تحميل أي شبكات توصيل محتوى (CDN) تابعة لطرف خارجي.

لفتحه، انتقل إلى `/ui` على أي منفذ HTTP خاص بـ ClickHouse (على سبيل المثال، `http://localhost:8123/ui`).

<h2 id="how-it-is-served">
  كيفية تقديمها
</h2>

تُضغط الحزمة (bundle) بصيغة gzip أثناء الـ build وتُضمَّن باستخدام `#embed`، لذا تحمل كل استجابة من `/ui` الـ header ‏`Content-Encoding: gzip`. ونظرًا لأن SQL Console تطبيق أحادي الصفحة ينفّذ التوجيه من جهة العميل، فإن الطلبات ضمن `/ui` التي لا تقابل أصلًا مُضمَّنًا ولا تبدو كملف (أي لا تحمل امتدادًا) تعود احتياطيًا إلى تقديم `index.html`. أما الطلبات الموجَّهة إلى مسارات تبدو كأصول مفقودة (مثل `/ui/nonexistent.js`) فتُرجع status ‏HTTP‏ `404 Not Found`.

يُطابَق المسار `/ui` تمامًا أو عندما يليه حدّ من نوع `/` أو `?` أو `#`، وبذلك لا تستولي آلية الـ fallback الخاصة بتطبيق الصفحة الواحدة على المسارات المجاورة مثل `/uix`.

<h2 id="relationship-to-other-web-uis">
  العلاقة بواجهات الويب الأخرى
</h2>

يوفّر ClickHouse عدة واجهات ويب مدمجة تُقدَّم عبر منفذ HTTP:

* [`/play`](/ar/interfaces/web-sql) — واجهة Web SQL الخفيفة.
* `/dashboard` — لوحات المعلومات المدمجة.
* `/clickstack` — واجهة ClickStack المضمّنة.
* `/ui` — واجهة SQL Console الموضّحة هنا.

تتوفّر روابط هذه الواجهات جميعها في الصفحة الرئيسية لخادم HTTP في ClickHouse.

<h2 id="authentication">
  المصادقة
</h2>

تعتمد SQL Console في المصادقة على نفس فحوصات `Session` والتحكم في الوصول المستخدمة في HTTP protocol. ولا يتطلب تقديم ملفات الـ UI الثابتة على المسار `/ui` أي مصادقة، أما الاستعلامات التي ترسلها الـ UI فتخضع للمصادقة مثل أي HTTP request آخر.