دوال الجداول

توثيق دوال الجداول

دوال الجداول هي أساليب لإنشاء الجداول.

الصفحة	الوصف
azureBlobStorage	يوفّر واجهة شبيهة بالجدول لتنفيذ select/insert على الملفات في Azure Blob Storage. وهو مشابه للدالة s3.
azureBlobStorageCluster	يتيح معالجة الملفات من Azure Blob Storage بالتوازي باستخدام العديد من العُقد في عنقود محدد.
clusterAllReplicas	يتيح الوصول إلى جميع الشظايا (المُعدّة في قسم remote_servers) في عنقود ما دون إنشاء جدول Distributed.
deltaLake	يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول DeltaLake في Amazon S3.
deltaLakeCluster	هذا امتداد لدالة الجدول deltaLake.
dictionary	يعرض بيانات Dictionary كجدول ClickHouse. ويعمل بالطريقة نفسها التي يعمل بها محرك Dictionary.
executable	تنشئ دالة الجدول executable جدولًا استنادًا إلى مخرجات دالة معرّفة من المستخدم (UDF) تعرّفها في برنامج نصي يُخرج الصفوف إلى stdout.
file	محرك جدول يوفّر واجهة شبيهة بالجدول لتنفيذ SELECT من الملفات وINSERT إليها، على نحو مشابه لدالة الجدول s3. استخدم file عند العمل مع الملفات المحلية، وs3 عند العمل مع الحاويات في التخزين الكائني مثل S3 أو GCS أو MinIO.
fileCluster	يتيح المعالجة المتزامنة للملفات المطابقة لمسار محدد عبر عدة عُقد داخل عنقود. تنشئ العقدة البادئة اتصالات مع العقد العاملة، وتوسّع أنماط glob في مسار الملف، وتفوّض مهام قراءة الملفات إلى العقد العاملة. وتستعلم كل عقدة عاملة من العقدة البادئة عن الملف التالي لمعالجته، ويتكرر ذلك حتى تكتمل جميع المهام (أي تُقرأ كل الملفات).
filesystem	يوفّر الوصول إلى نظام الملفات لسرد الملفات وإرجاع بياناتها الوصفية ومحتوياتها.
format	يحلّل البيانات من الوسائط وفقًا لتنسيق الإدخال المحدد. وإذا لم تُحدَّد وسيطة البنية، فستُستخرج من البيانات.
gcs	يوفّر واجهة شبيهة بالجدول لـ SELECT وINSERT البيانات من Google Cloud Storage. ويتطلب دور IAM Storage Object User.
fuzzQuery	يُحدث تغييرات عشوائية في سلسلة الاستعلام المعطاة.
fuzzJSON	يُحدث تغييرات عشوائية في سلسلة JSON.
generateRandom	يولّد بيانات عشوائية وفق مخطط معيّن. ويتيح ملء جداول الاختبار بهذه البيانات. ليست كل الأنواع مدعومة.
mergeTreeTextIndex	يمثّل Dictionary لفهرس نصي في جدول MergeTree. ويمكن استخدامه للفحص الداخلي.
mergeTreeProjection	يمثّل محتويات بعض projection في جداول MergeTree. ويمكن استخدامه للفحص الداخلي.
mergeTreeIndex	يمثّل محتويات الفهرس وملفات العلامات الخاصة بجداول MergeTree. ويمكن استخدامه للفحص الداخلي.
hdfs	ينشئ جدولًا من ملفات في HDFS. ودالة الجدول هذه مشابهة لدالتي الجدول url وfile.
hdfsCluster	يتيح معالجة الملفات من HDFS بالتوازي باستخدام العديد من العُقد في عنقود محدد.
hudi	يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Hudi في Amazon S3.
ytsaurus	تتيح دالة الجدول قراءة البيانات من عنقود YTsaurus.
hudiCluster Table Function	امتداد لدالة الجدول hudi. ويتيح معالجة الملفات من جداول Apache Hudi في Amazon S3 بالتوازي باستخدام العديد من العُقد في عنقود محدد.
iceberg	يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Iceberg في Amazon S3 أو Azure أو HDFS أو المخزّنة محليًا.
paimon	يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Paimon في Amazon S3 أو Azure أو HDFS أو المخزّنة محليًا.
icebergCluster	امتداد لدالة الجدول iceberg يتيح معالجة الملفات من Apache Iceberg بالتوازي باستخدام العديد من العُقد في عنقود محدد.
paimonCluster	امتداد لدالة الجدول paimon يتيح معالجة الملفات من Apache Paimon بالتوازي باستخدام العديد من العُقد في عنقود محدد.
input	دالة جدول تتيح تحويل البيانات المرسلة إلى الخادم ببنية معينة وإدراجها بكفاءة في جدول ذي بنية أخرى.
jdbc	تُرجع جدولًا متصلًا عبر JDBC driver.
merge	ينشئ جدول Merge مؤقتًا. وسيُشتق التركيب من الجداول الأساسية باستخدام اتحاد أعمدتها واستنتاج الأنواع المشتركة.
mongodb	يتيح تنفيذ استعلامات SELECT على البيانات المخزنة على خادم MongoDB بعيد.
mysql	يتيح تنفيذ استعلامات SELECT و INSERT على البيانات المخزنة على خادم MySQL بعيد.
null	ينشئ جدولًا مؤقتًا بالبنية المحددة باستخدام محرك الجدول Null. تُستخدم هذه الدالة لتسهيل كتابة الاختبارات والعروض التوضيحية.
timeSeriesMetrics	تُرجع timeSeriesMetrics جدول المقاييس الذي يستخدمه الجدول db_name.time_series_table ذي محرك الجدول TimeSeries.
timeSeriesSelector	يقرأ السلاسل الزمنية من جدول TimeSeries بعد تصفيتها بواسطة محدِّد، ومع طوابع زمنية ضمن فاصل زمني محدد.
timeSeriesTags	تُرجع دالة الجدول timeSeriesTags جدول الوسوم الذي يستخدمه الجدول db_name.time_series_table ذي محرك الجدول TimeSeries.
prometheusQueryRange	يقيّم استعلام prometheus باستخدام بيانات من جدول TimeSeries.
zeros	تُستخدم لأغراض الاختبار بوصفها أسرع طريقة لتوليد عدد كبير من الصفوف. وهي مشابهة لجدولي النظام system.zeros و system.zeros_mt.
primes	تُرجع جدولًا يحتوي على عمود واحد باسم prime يتضمن الأعداد الأولية.
numbers	تُرجع جدولًا يحتوي على عمود واحد باسم number يتضمن تسلسلًا من الأعداد الصحيحة.
prometheusQuery	يقيّم استعلام prometheus باستخدام بيانات من جدول TimeSeries.
timeSeriesSamples	تُرجع timeSeriesSamples جدول العينات الذي يستخدمه الجدول db_name.time_series_table ذي محرك الجدول TimeSeries.
generate_series (generateSeries)	تُرجع جدولًا يحتوي على عمود واحد باسم generate_series ‏(UInt64) يتضمن أعدادًا صحيحة من البداية إلى النهاية، شاملًا القيمتين.
odbc	تُرجع الجدول المتصل عبر ODBC.
postgresql	يتيح تنفيذ استعلامات SELECT و INSERT على البيانات المخزنة على خادم PostgreSQL بعيد.
redis	تتيح دالة الجدول هذه تكامل ClickHouse مع Redis.
remote, remoteSecure	تتيح دالة الجدول remote الوصول إلى الخوادم البعيدة عند الطلب، أي من دون إنشاء جدول موزّع. أما دالة الجدول remoteSecure فهي مثل remote ولكن عبر اتصال آمن.
s3 Table Function	توفّر واجهة شبيهة بالجدول لاختيار الملفات أو إدراجها في Amazon S3 و Google Cloud Storage. دالة الجدول هذه مشابهة للدالة hdfs، لكنها توفّر ميزات خاصة بـ S3.
s3Cluster	امتداد لدالة الجدول s3، يتيح معالجة الملفات من Amazon S3 و Google Cloud Storage بالتوازي عبر عدد من العقد ضمن cluster محدد.
sqlite	يتيح تنفيذ استعلامات على البيانات المخزنة في قاعدة بيانات SQLite.
arrowFlight	يتيح القراءة من البيانات المعروضة عبر خادم Apache Arrow Flight والكتابة إليها.
url	ينشئ جدولًا من URL باستخدام format و structure المحددين
urlCluster	يتيح معالجة الملفات من URL بالتوازي عبر عدد من العقد ضمن cluster محدد.
view	يحوّل استعلامًا فرعيًا إلى جدول. تنفّذ هذه الدالة views.
values	ينشئ مساحة تخزين مؤقتة تملأ الأعمدة بالقيم.
loop	تُستخدم دالة الجدول loop في ClickHouse لإرجاع نتائج الاستعلام في حلقة لا نهائية.

​

الاستخدام

يمكن استخدام دوال الجداول في العبارة FROM ضمن استعلام SELECT. على سبيل المثال، يمكنك استخدام SELECT لقراءة البيانات من ملف على جهازك المحلي باستخدام دالة الجدول file.

Query

echo "1, 2, 3" > example.csv

Response

./clickhouse client
:) SELECT * FROM file('example.csv')
┌─c1─┬─c2─┬─c3─┐
│  1 │  2 │  3 │
└────┴────┴────┘

يمكنك أيضًا استخدام دوال الجداول لإنشاء جدول مؤقت لا يكون متاحًا إلا في الاستعلام الحالي. على سبيل المثال:

Query

SELECT * FROM generateSeries(1,5);

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

يُحذف الجدول عند انتهاء الاستعلام.

يمكن استخدام دوال الجداول لإنشاء الجداول، وفق الصياغة التالية:

Query

CREATE TABLE [IF NOT EXISTS] [db.]table_name AS table_function()

على سبيل المثال:

Query

CREATE TABLE series AS generateSeries(1, 5);
SELECT * FROM series;

Response

┌─generate_series─┐
│               1 │
│               2 │
│               3 │
│               4 │
│               5 │
└─────────────────┘

أخيرًا، يمكن أيضًا استخدام دوال الجداول لتنفيذ INSERT للبيانات إلى جدول. على سبيل المثال، يمكننا كتابة محتويات الجدول الذي أنشأناه في المثال السابق إلى ملف على القرص باستخدام دالة الجدول file مرة أخرى:

Query

INSERT INTO FUNCTION file('numbers.csv', 'CSV') SELECT * FROM series;

Query

cat numbers.csv
1
2
3
4
5

لا يمكنك استخدام دوال الجداول إذا كان الإعداد allow_ddl معطّلًا.