عميل ClickHouse

يوفّر ClickHouse عميل سطر أوامر أصليًا لتنفيذ استعلامات SQL مباشرةً على خادم ClickHouse. ويدعم كلًا من الوضع التفاعلي (لتنفيذ الاستعلامات مباشرةً) ووضع الدُفعات (للبرامج النصية والأتمتة). يمكن عرض نتائج الاستعلام في الطرفية أو تصديرها إلى ملف، مع دعم جميع تنسيقات إخراج ClickHouse، مثل Pretty وCSV وJSON وغيرها.

يوفّر العميل معلومات آنية عن تنفيذ الاستعلام عبر شريط التقدّم، وعدد الصفوف المقروءة، والبايتات المُعالجة، وزمن تنفيذ الاستعلام. كما يدعم كلًا من خيارات سطر الأوامر وملفات التهيئة.

لتنزيل ClickHouse، نفّذ:

curl https://clickhouse.com/ | sh

ولتثبيته أيضًا، شغّل:

sudo ./clickhouse install

راجع تثبيت ClickHouse للاطلاع على مزيد من خيارات التثبيت.

تتوافق الإصدارات المختلفة للعميل والخادم مع بعضها البعض، لكن قد لا تتوفر بعض الميزات في إصدارات العميل الأقدم. نوصي باستخدام الإصدار نفسه لكل من العميل والخادم.

للاتصال بخادم ClickHouse، شغّل:

$ clickhouse-client --host server

ClickHouse client version 24.12.2.29 (official build).
Connecting to server:9000 as user default.
Connected to ClickHouse server version 24.12.2.

:)

حدِّد تفاصيل اتصال إضافية حسب الحاجة:

للاطلاع على قائمة كاملة بخيارات سطر الأوامر، راجع خيارات سطر الأوامر.

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في وحدة تحكم ClickHouse Cloud. حدِّد الخدمة التي تريد الاتصال بها ثم انقر على Connect:

اختر Native، وستظهر التفاصيل مع مثال لأمر clickhouse-client:

يمكنك تخزين تفاصيل الاتصال بخادم ClickHouse واحد أو أكثر في ملف تهيئة.

يكون التنسيق كما يلي:

<config>
    <connections_credentials>
        <connection>
            <name>default</name>
            <hostname>hostname</hostname>
            <port>9440</port>
            <secure>1</secure>
            <user>default</user>
            <password>password</password>
            <!-- <history_file></history_file> -->
            <!-- <history_max_entries></history_max_entries> -->
            <!-- <accept-invalid-certificate>false</accept-invalid-certificate> -->
            <!-- <prompt></prompt> -->
        </connection>
    </connections_credentials>
</config>

راجع قسم ملفات التهيئة لمزيد من المعلومات.

لتشغيل ClickHouse في الوضع التفاعلي، ما عليك سوى تنفيذ ما يلي:

clickhouse-client

يؤدي هذا إلى فتح حلقة القراءة-التقييم-الطباعة (REPL)، حيث يمكنك بدء كتابة استعلامات SQL بشكل تفاعلي. وبعد الاتصال، سيظهر لك موجّه يمكنك من خلاله إدخال الاستعلامات:

ClickHouse client version 25.x.x.x
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 25.x.x.x

hostname :)

في الوضع التفاعلي، يكون تنسيق الإخراج الافتراضي هو PrettyCompact. يمكنك تغيير التنسيق في بند FORMAT في الاستعلام أو بتحديد خيار سطر الأوامر --format. لاستخدام Vertical format، يمكنك استخدام --vertical أو إضافة \G في نهاية الاستعلام. في هذا التنسيق، تُطبع كل قيمة في سطر منفصل، وهو ما يكون مناسبًا للجداول العريضة.

في الوضع التفاعلي، يُنفَّذ افتراضيًا كل ما تُدخله عند الضغط على Enter. ولا تحتاج إلى فاصلة منقوطة في نهاية الاستعلام.

يمكنك تشغيل العميل باستخدام المعامل -m, --multiline. ولإدخال استعلام متعدد الأسطر، أدخل شرطة مائلة عكسية \ قبل محرف سطر جديد. بعد الضغط على Enter، سيُطلب منك إدخال السطر التالي من الاستعلام. ولتنفيذ الاستعلام، أنهِه بفاصلة منقوطة ثم اضغط Enter.

يعتمد عميل ClickHouse على replxx (وهو مشابه لـ readline)، لذا فهو يستخدم اختصارات لوحة مفاتيح مألوفة ويحتفظ بسجل الأوامر. ويُكتَب سجل الأوامر افتراضيًا في ~/.clickhouse-client-history.

للخروج من العميل، اضغط Ctrl+D، أو أدخل أحد الخيارات التالية بدلًا من الاستعلام:

• exit أو exit;
• quit أو quit;
• q أو Q أو :q
• logout أو logout;

يمكنك الاطلاع على وثائق أي دالة أو محرك جدول أو نوع البيانات أو تنسيق أو إعداد أو أي عنصر آخر في النظام، من داخل العميل مباشرةً. أدخل help متبوعًا باسم (كما تعمل أيضًا الصيغ المكافئة /help وman و/man):

help domainWithoutWWW

البحث غير حساس لحالة الأحرف، ويستعلم جدول system.documentation. ويُعرَض التوثيق المطابق من Markdown في الطرفية، مع نص عريض/مائل، وجداول، وكتل شيفرة مميّزة بحسب الصياغة. وعندما يكون الاسم مشتركًا بين عدة مكوّنات (على سبيل المثال file، إذ يكون دالة ومحرّك جدول في الوقت نفسه)، تُعرَض جميعها.

عند عدم وجود تطابق تام، يعرض العميل أسماءً مشابهة (مع السماح بالأخطاء الإملائية) والمكوّنات التي تَرِد هذه الكلمة في توثيقها:

help maxx_threads

عند كتابة help وحده، يُعرض ملخص موجز للاستخدام.

ينفّذ العميل بعض الأوامر التي تبدأ بـ / بنفسه بدلاً من إرسالها إلى الخادم:

تؤدي كتابة / في بداية الإدخال إلى عرض الأوامر كتلميحات hints، وتؤدي كتابة المزيد من أحرف الاسم إلى تضييق القائمة؛ ويُكمل Tab الأمر الجاري كتابته، وهي أيضاً طريقة إكمال الأوامر عند تعطيل التلميحات. لا يُعد إدخال / بمفرده أمراً؛ إذ إنه، كما في Oracle SQL*Plus، يكرر الإدخال الأخير. ويُبلّغ عن اسم الأمر المكتوب بصورة خاطئة، مع عرض الأوامر التي قد تكون المقصودة، بدلاً من تشغيله كاستعلام:

:) /hepl

Exception on client:
Code: 36. DB::Exception: Unknown command `/hepl`. Maybe you meant: ['/help']. Type `/` at the beginning of the line to see all the commands. (BAD_ARGUMENTS)

عند معالجة استعلام، يعرض العميل ما يلي:

1. معلومات التقدّم، وتُحدَّث افتراضيًا بما لا يزيد على 10 مرات في الثانية. بالنسبة إلى الاستعلامات السريعة، قد لا يكون هناك وقت كافٍ لعرض التقدّم.
2. الاستعلام بعد تنسيقه وبعد التحليل، لأغراض تصحيح الأخطاء.
3. النتيجة بالتنسيق المحدد.
4. عدد الأسطر في النتيجة، والوقت المنقضي، ومتوسط سرعة معالجة الاستعلام. تشير جميع كميات البيانات إلى بيانات غير مضغوطة.

يمكنك إلغاء استعلام طويل بالضغط على Ctrl+C. ومع ذلك، ستظل بحاجة إلى الانتظار قليلًا حتى يُلغي الخادم الطلب. لا يمكن إلغاء الاستعلام في مراحل معيّنة. إذا لم تنتظر وضغطت على Ctrl+C مرةً ثانية، فسيخرج العميل.

يتيح عميل ClickHouse تمرير بيانات خارجية (جداول مؤقتة خارجية) لاستخدامها في الاستعلام. لمزيد من المعلومات، راجع قسم البيانات الخارجية لمعالجة الاستعلام.

يمكنك استخدام الأسماء المستعارة التالية من داخل بيئة REPL:

• \l - SHOW DATABASES
• \d - SHOW TABLES
• \c <DATABASE> - USE DATABASE
• . - كرّر آخر استعلام

• Alt (Option) + Shift + e - افتح المحرر مع الاستعلام الحالي. يمكن تحديد المحرر المراد استخدامه عبر متغير البيئة EDITOR. يُستخدم vim افتراضيًا.
• Alt (Option) + # - علّق السطر.
• Ctrl + r - بحث تقريبي في السجل.

تتوفر القائمة الكاملة بجميع اختصارات لوحة المفاتيح المتاحة في replxx.

بدلاً من استخدام عميل ClickHouse بشكل تفاعلي، يمكنك تشغيله في وضع الدُفعات. في وضع الدُفعات، ينفّذ ClickHouse استعلامًا واحدًا ثم يُنهي التشغيل فورًا - فلا يوجد موجّه أوامر تفاعلي ولا حلقة تكرار.

يمكنك تحديد استعلام واحد كما يلي:

$ clickhouse-client "SELECT sum(number) FROM numbers(10)"
45

يمكنك أيضًا استخدام الخيار --query في سطر الأوامر:

$ clickhouse-client --query "SELECT uniq(number) FROM numbers(10)"
10

يمكنك تمرير استعلام عبر stdin:

$ echo "SELECT avg(number) FROM numbers(10)" | clickhouse-client
4.5

بافتراض وجود جدول باسم messages، يمكنك أيضًا إدراج البيانات من سطر الأوامر:

$ echo "Hello\nGoodbye" | clickhouse-client --query "INSERT INTO messages FORMAT CSV"

عند تحديد --query، تُضاف أي مدخلات إلى الطلب بعد محرف سطر جديد.

يوضح هذا المثال كيفية إدراج ملف CSV لمجموعة بيانات تجريبية، cell_towers.csv، في الجدول الموجود cell_towers ضمن قاعدة البيانات default:

clickhouse-client --host HOSTNAME.clickhouse.cloud \
  --port 9440 \
  --user default \
  --password PASSWORD \
  --query "INSERT INTO cell_towers FORMAT CSVWithNames" \
  < cell_towers.csv

هناك عدة طرق لإدراج البيانات من سطر الأوامر. يوضح المثال أدناه كيفية إدراج صفَّين من بيانات CSV في جدول ClickHouse باستخدام وضع الدُفعات:

echo -ne "1, 'some text', '2016-08-14 00:00:00'\n2, 'some more text', '2016-08-14 00:00:01'" | \
  clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";

في المثال أدناه، يبدأ cat <<_EOF كتلة heredoc التي تقرأ كل شيء حتى تصادف _EOF مرة أخرى، ثم تُخرِجه:

cat <<_EOF | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";
3, 'some text', '2016-08-14 00:00:00'
4, 'some more text', '2016-08-14 00:00:01'
_EOF

في المثال أدناه، تُعرَض محتويات الملف file.csv على stdout باستخدام cat، ثم تُمرَّر عبر أنبوب إلى clickhouse-client كمدخلات:

cat file.csv | clickhouse-client --database=test --query="INSERT INTO test FORMAT CSV";

في وضع الدُفعات، يكون تنسيق البيانات الافتراضي هو TabSeparated. يمكنك تعيين التنسيق في عبارة FORMAT في الاستعلام كما هو موضح في المثال أعلاه.

يمكنك تحديد معلمات في الاستعلام وتمرير قيم إليها باستخدام خيارات سطر الأوامر. يؤدي ذلك إلى تجنّب تنسيق الاستعلام بقيم ديناميكية محددة من جهة العميل. على سبيل المثال:

$ clickhouse-client --param_parName="[1, 2]" --query "SELECT {parName: Array(UInt16)}"
[1,2]

يمكن أيضًا تعيين المعلمات ضمن جلسة تفاعلية:

$ clickhouse-client
ClickHouse client version 25.X.X.XXX (official build).

:) SET param_parName='[1, 2]';

SET param_parName = '[1, 2]'

Query id: 7ac1f84e-e89a-4eeb-a4bb-d24b8f9fd977

Ok.

0 rows in set. Elapsed: 0.000 sec.

:) SELECT {parName:Array(UInt16)}

SELECT {parName:Array(UInt16)}

Query id: 0358a729-7bbe-4191-bb48-29b063c548a7

   ┌─_CAST([1, 2]⋯y(UInt16)')─┐
1. │ [1,2]                    │
   └──────────────────────────┘

1 row in set. Elapsed: 0.006 sec.

في الاستعلام، ضع القيم التي تريد تعبئتها باستخدام معلمات سطر الأوامر بين أقواس معقوفة بالتنسيق التالي:

{<name>:<data type>}

$ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" \
    --query "SELECT * FROM table WHERE val = {tuple_in_tuple:Tuple(UInt8, Tuple(String, UInt8))}"

$ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --param_alias="top_ten" \
    --query "SELECT {col:Identifier} as {alias:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"

يتضمن ClickHouse Client مساعدة مدمجة بالذكاء الاصطناعي لتوليد استعلامات SQL من أوصاف بلغة طبيعية. تساعد هذه الميزة المستخدمين على كتابة استعلامات معقدة من دون الحاجة إلى معرفة متعمقة بـ SQL.

تعمل المساعدة بالذكاء الاصطناعي تلقائيًا إذا كان أحد متغيرَي البيئة OPENAI_API_KEY أو ANTHROPIC_API_KEY مُعيَّنًا. ولمزيد من التهيئة المتقدمة، راجع قسم التهيئة.

لاستخدام ميزة توليد SQL بالاستعانة بالذكاء الاصطناعي، ضع البادئة ?? في بداية استعلامك باللغة الطبيعية:

:) ?? show all users who made purchases in the last 30 days

سيقوم الذكاء الاصطناعي بما يلي:

1. استكشاف مخطط قاعدة بياناتك تلقائيًا
2. إنشاء SQL مناسب بناءً على الجداول والأعمدة المكتشفة
3. تنفيذ الاستعلام الذي تم إنشاؤه فورًا

:) ?? count orders by product category

Starting AI SQL generation with schema discovery...
──────────────────────────────────────────────────

🔍 list_databases
   ➜ system, default, sales_db

🔍 list_tables_in_database
   database: sales_db
   ➜ orders, products, categories

🔍 get_schema_for_table
   database: sales_db
   table: orders
   ➜ CREATE TABLE orders (order_id UInt64, product_id UInt64, quantity UInt32, ...)

✨ SQL query generated successfully!
──────────────────────────────────────────────────

SELECT
    c.name AS category,
    COUNT(DISTINCT o.order_id) AS order_count
FROM sales_db.orders o
JOIN sales_db.products p ON o.product_id = p.product_id
JOIN sales_db.categories c ON p.category_id = c.category_id
GROUP BY c.name
ORDER BY order_count DESC

يتطلب توليد SQL بالاستعانة بالذكاء الاصطناعي إعداد موفّر ذكاء اصطناعي في ملف تهيئة عميل ClickHouse لديك. يمكنك استخدام OpenAI أو Anthropic أو أي خدمة واجهة برمجة تطبيقات متوافقة مع OpenAI.

إذا لم يُحدَّد أي إعداد للذكاء الاصطناعي في ملف الإعداد، فسيحاول عميل ClickHouse تلقائيًا استخدام متغيرات البيئة:

1. يتحقق أولًا من متغير البيئة OPENAI_API_KEY
2. إذا لم يجده، يتحقق من متغير البيئة ANTHROPIC_API_KEY
3. إذا لم يعثر على أيٍّ منهما، فسيتم تعطيل ميزات الذكاء الاصطناعي

يتيح ذلك إعدادًا سريعًا من دون الحاجة إلى ملفات إعداد:

# Using OpenAI
export OPENAI_API_KEY=your-openai-key
clickhouse-client

# Using Anthropic
export ANTHROPIC_API_KEY=your-anthropic-key
clickhouse-client

لمزيد من التحكم في إعدادات الذكاء الاصطناعي، اضبطها في ملف إعدادات عميل ClickHouse الموجود في:

• $XDG_CONFIG_HOME/clickhouse/config.xml (أو ~/.config/clickhouse/config.xml إذا لم يتم تعيين XDG_CONFIG_HOME) (بتنسيق XML)
• $XDG_CONFIG_HOME/clickhouse/config.yaml (أو ~/.config/clickhouse/config.yaml إذا لم يتم تعيين XDG_CONFIG_HOME) (بتنسيق YAML)
• ~/.clickhouse-client/config.xml (بتنسيق XML، الموقع القديم)
• ~/.clickhouse-client/config.yaml (بتنسيق YAML، الموقع القديم)
• أو حدِّد موقعًا مخصصًا باستخدام --config-file

<config>
    <ai>
        {/* مطلوب: مفتاح واجهة برمجة التطبيقات الخاص بك (أو اضبطه عبر متغير البيئة) */}
        <api_key>your-api-key-here</api_key>

        {/* مطلوب: نوع المزوّد (openai, anthropic) */}
        <provider>openai</provider>

        {/* النموذج المراد استخدامه (تختلف القيم الافتراضية حسب المزوّد) */}
        <model>gpt-4o</model>

        {/* اختياري: نقطة نهاية واجهة برمجة تطبيقات مخصصة للخدمات المتوافقة مع OpenAI */}
        {/* <base_url>https://openrouter.ai/api</base_url> */}

        {/* إعدادات استكشاف المخطط */}
        <enable_schema_access>true</enable_schema_access>

        {/* معلمات التوليد */}
        {/* اختياري: لا يتم إرسال temperature إلى النموذج إلا عند تعيينه هنا.
             ويتم تجاهله افتراضيًا لأن بعض النماذج ترفض هذه المعلمة. */}
        {/* <temperature>0.0</temperature> */}
        <max_tokens>1000</max_tokens>
        <timeout_seconds>30</timeout_seconds>
        <max_steps>10</max_steps>

        {/* اختياري: موجّه نظام مخصص */}
        {/* <system_prompt>أنت مساعد خبير في ClickHouse SQL...</system_prompt> */}
    </ai>
</config>

ai:
  # مطلوب: مفتاح واجهة برمجة التطبيقات الخاص بك (أو اضبطه عبر متغير البيئة)
  api_key: your-api-key-here

  # مطلوب: نوع المزوّد (openai, anthropic)
  provider: openai

  # النموذج المراد استخدامه
  model: gpt-4o

  # اختياري: نقطة نهاية واجهة برمجة تطبيقات مخصصة للخدمات المتوافقة مع OpenAI
  # base_url: https://openrouter.ai/api

  # تمكين الوصول إلى المخطط - يتيح للذكاء الاصطناعي الاستعلام عن معلومات قاعدة البيانات/الجدول
  enable_schema_access: true

  # معلمات التوليد
  # لا يتم إرسال temperature إلى النموذج إلا عند تعيينه هنا؛ ويتم تجاهله افتراضيًا
  # لأن بعض النماذج ترفض هذه المعلمة.
  # temperature: 0.0    # يتحكم في العشوائية (0.0 = حتمي)
  max_tokens: 1000      # الحد الأقصى لطول الاستجابة
  timeout_seconds: 30   # مهلة الطلب
  max_steps: 10         # الحد الأقصى لخطوات استكشاف المخطط

  # اختياري: موجّه نظام مخصص
  # system_prompt: |
  #   أنت مساعد خبير في ClickHouse SQL. حوّل اللغة الطبيعية إلى SQL.
  #   ركّز على الأداء واستخدم تحسينات خاصة بـ ClickHouse.
  #   أعد دائمًا عبارات SQL قابلة للتنفيذ من دون شروحات.

استخدام واجهات برمجة التطبيقات المتوافقة مع OpenAI (مثل OpenRouter):

ai:
  provider: openai  # Use 'openai' for compatibility
  api_key: your-openrouter-api-key
  base_url: https://openrouter.ai/api/v1
  model: anthropic/claude-3.5-sonnet  # Use OpenRouter model naming

أمثلة على الحد الأدنى من التهيئة:

# Minimal config - uses environment variable for API key
ai:
  provider: openai  # Will use OPENAI_API_KEY env var

# No config at all - automatic fallback
# (Empty or no ai section - will try OPENAI_API_KEY then ANTHROPIC_API_KEY)

# Only override model - uses env var for API key
ai:
  provider: openai
  model: gpt-3.5-turbo

يستخدم مُولِّد SQL المعتمد على الذكاء الاصطناعي عمليةً متعددة الخطوات:

1. اكتشاف المخطط

يستخدم الذكاء الاصطناعي أدوات مدمجة لاستكشاف قاعدة بياناتك:

• يسرد قواعد البيانات المتاحة
• يكتشف الجداول ضمن قواعد البيانات ذات الصلة
• يفحص بنية الجداول من خلال عبارات CREATE TABLE

2. توليد الاستعلامات

استنادًا إلى المخطط المكتشف، يُنشئ الذكاء الاصطناعي SQL بحيث:

• يتوافق مع طلبك المكتوب بلغة طبيعية
• يستخدم أسماء الجداول والأعمدة الصحيحة
• يطبّق عمليات JOIN وعمليات التجميع المناسبة

3. التنفيذ

يُنفَّذ SQL المُنشأ تلقائيًا وتُعرَض النتائج

• يتطلب اتصالًا نشطًا بالإنترنت
• يخضع استخدام واجهة برمجة التطبيقات لقيود على معدل الاستخدام ولتكاليف يفرضها مزوّد الذكاء الاصطناعي
• قد تتطلب الاستعلامات المعقدة عدة تنقيحات
• لدى الذكاء الاصطناعي وصول للقراءة فقط إلى معلومات المخطط، وليس إلى البيانات الفعلية

• لا تُرسَل مفاتيح واجهة برمجة تطبيقات مطلقًا إلى خوادم ClickHouse
• لا يرى الذكاء الاصطناعي سوى معلومات المخطط (أسماء الجداول/الأعمدة والأنواع)، وليس البيانات الفعلية
• تلتزم جميع الاستعلامات المُولَّدة بأذونات قاعدة البيانات الحالية لديك

يدعم عميل ClickHouse أيضًا الاتصال بخادم ClickHouse باستخدام سلسلة اتصال مشابهة لتلك المستخدمة في MongoDB، وPostgreSQL، وMySQL. وصيغتها كما يلي:

clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]

إذا تم تحديد اسم المستخدم أو كلمة المرور أو قاعدة البيانات في سلسلة الاتصال، فلا يمكن تحديدها باستخدام --user أو --password أو --database، والعكس صحيح.

يمكن أن يكون مكوّن المضيف إما اسم مضيف أو عنوان IPv4 أو IPv6. يجب أن تكون عناوين IPv6 بين []:

clickhouse://[2001:db8::1234]

يمكن أن تحتوي سلاسل الاتصال على عدة مضيفين. سيحاول عميل ClickHouse الاتصال بهذه المضيفات حسب الترتيب (من اليسار إلى اليمين). وبمجرد إنشاء الاتصال، لن تُجرى أي محاولة للاتصال بالمضيفات المتبقية.

يجب تحديد سلسلة الاتصال باعتبارها الوسيط الأول لـ clickhouse-client. يمكن استخدام سلسلة الاتصال مع أي عدد من خيارات سطر الأوامر الأخرى، باستثناء --host و--port.

المفاتيح التالية مسموح بها لـ query_parameters:

الترميز بالنسبة المئوية

يجب أن تكون الأحرف غير التابعة لـ ASCII الأمريكي، والمسافات، والأحرف الخاصة في المَعلمات التالية مرمّزة بالنسبة المئوية:

• user
• password
• hosts
• database
• query parameters

اتصل بـ localhost على المنفذ 9000 ونفّذ الاستعلام SELECT 1.

clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"

اتصل بـ localhost كمستخدم john باستخدام كلمة المرور secret، والمضيف 127.0.0.1 والمنفذ 9000

clickhouse-client clickhouse://john:secret@127.0.0.1:9000

اتصل بـlocalhost باسم المستخدم default، وبالمضيف ذي عنوان IPv6 [::1] وعلى المنفذ 9000.

clickhouse-client clickhouse://[::1]:9000

اتصل بـ localhost على المنفذ 9000 باستخدام وضع متعدد الأسطر.

clickhouse-client clickhouse://localhost:9000 '-m'

اتصل بـ localhost باستخدام المنفذ 9000 باسم المستخدم default.

clickhouse-client clickhouse://default@localhost:9000

# equivalent to:
clickhouse-client clickhouse://localhost:9000 --user default

اتصل بـ localhost على المنفذ 9000، واستخدم قاعدة البيانات my_database كقاعدة بيانات افتراضية.

clickhouse-client clickhouse://localhost:9000/my_database

# equivalent to:
clickhouse-client clickhouse://localhost:9000 --database my_database

اتصل بـ localhost على المنفذ 9000، واجعل قاعدة البيانات الافتراضية my_database كما هي محددة في سلسلة الاتصال، مع استخدام اتصال آمن عبر المعامل المختصر s.

clickhouse-client clickhouse://localhost/my_database?s

# equivalent to:
clickhouse-client clickhouse://localhost/my_database -s

اتصل بالمضيف الافتراضي باستخدام المنفذ الافتراضي، والمستخدم default، وقاعدة البيانات الافتراضية.

clickhouse-client clickhouse:

اتصل بالمضيف الافتراضي باستخدام المنفذ الافتراضي، كمستخدم my_user ومن دون كلمة مرور.

clickhouse-client clickhouse://my_user@

# Using a blank password between : and @ means to asking the user to enter the password before starting the connection.
clickhouse-client clickhouse://my_user:@

اتصل بـ localhost باستخدام عنوان البريد الإلكتروني كاسم المستخدم. تُرمَّز العلامة @ بترميز النسبة المئوية إلى %40.

clickhouse-client clickhouse://some_user%40some_mail.com@localhost:9000

اتصل بأحد هذين المضيفين: 192.168.1.15، 192.168.1.25.

clickhouse-client clickhouse://192.168.1.15,192.168.1.25

في الوضع التفاعلي، يعرض عميل ClickHouse معرّف الاستعلام لكل استعلام. وبشكل افتراضي، يكون تنسيق المعرّف كما يلي:

Query id: 927f137d-00f1-4175-8914-0dd066365e96

يمكن تحديد تنسيق مخصّص في ملف إعدادات ضمن وسم query_id_formats. ويُستبدل العنصر النائب {query_id} بمعرّف الاستعلام في سلسلة التنسيق. ويمكن استخدام عدة سلاسل تنسيق داخل هذا الوسم. يمكن استخدام هذه الميزة لإنشاء عناوين URL لتسهيل تنميط الاستعلامات.

مثال

<config>
  <query_id_formats>
    <speedscope>http://speedscope-host/#profileURL=qp%3Fid%3D{query_id}</speedscope>
  </query_id_formats>
</config>

مع التهيئة أعلاه، يظهر معرّف الاستعلام بالتنسيق التالي:

speedscope:http://speedscope-host/#profileURL=qp%3Fid%3Dc8ecc783-e753-4b38-97f1-42cddfb98b7d

يستخدم عميل ClickHouse أول ملف موجود من بين ما يلي:

• ملف تم تحديده باستخدام المعلمة -c [ -C, --config, --config-file ].
• ./clickhouse-client.[xml|yaml|yml]
• $XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml] (أو ~/.config/clickhouse/config.[xml|yaml|yml] إذا لم يتم تعيين XDG_CONFIG_HOME)
• ~/.clickhouse-client/config.[xml|yaml|yml]
• /etc/clickhouse-client/config.[xml|yaml|yml]

اطّلع على نموذج ملف التهيئة في مستودع ClickHouse: clickhouse-client.xml

<config>
    <user>username</user>
    <password>password</password>
    <secure>true</secure>
    <openSSL>
      <client>
        <caConfig>/etc/ssl/cert.pem</caConfig>
      </client>
    </openSSL>
</config>

user: username
password: 'password'
secure: true
openSSL:
  client:
    caConfig: '/etc/ssl/cert.pem'

يمكن تعيين اسم المستخدم وكلمة المرور والمضيف من خلال متغيرات البيئة CLICKHOUSE_USER وCLICKHOUSE_PASSWORD وCLICKHOUSE_HOST. تكون لوسيطات سطر الأوامر --user و--password و--host، أو سلسلة الاتصال (إذا كانت محددة)، أولوية على متغيرات البيئة.

يمكن تحديد جميع خيارات سطر الأوامر مباشرةً عبر سطر الأوامر أو تعيينها كقيم افتراضية في ملف الإعدادات.

يمكن تحديد إعدادات الاستعلام كخيارات لسطر الأوامر في الـ client، على سبيل المثال:

$ clickhouse-client --max_threads 1

راجع الإعدادات للاطلاع على قائمة الإعدادات.