`.
ملاحظة: عند استخدام استراتيجية التقسيم `HIVE`، لا يكون للإعداد `use_hive_partitioning` أي تأثير.
مثال على استراتيجية التقسيم `HIVE`:
```sql theme={null}
arthur :) CREATE TABLE t_03363_parquet (year UInt16, country String, counter UInt8)
ENGINE = S3(s3_conn, filename = 't_03363_parquet', format = Parquet, partition_strategy='hive')
PARTITION BY (year, country);
arthur :) INSERT INTO t_03363_parquet VALUES
(2022, 'USA', 1),
(2022, 'Canada', 2),
(2023, 'USA', 3),
(2023, 'Mexico', 4),
(2024, 'France', 5),
(2024, 'Germany', 6),
(2024, 'Germany', 7),
(1999, 'Brazil', 8),
(2100, 'Japan', 9),
(2024, 'CN', 10),
(2025, '', 11);
arthur :) select _path, * from t_03363_parquet;
┌─_path──────────────────────────────────────────────────────────────────────┬─year─┬─country─┬─counter─┐
1. │ test/t_03363_parquet/year=2100/country=Japan/7329604473272971264.parquet │ 2100 │ Japan │ 9 │
2. │ test/t_03363_parquet/year=2024/country=France/7329604473323302912.parquet │ 2024 │ France │ 5 │
3. │ test/t_03363_parquet/year=2022/country=Canada/7329604473314914304.parquet │ 2022 │ Canada │ 2 │
4. │ test/t_03363_parquet/year=1999/country=Brazil/7329604473289748480.parquet │ 1999 │ Brazil │ 8 │
5. │ test/t_03363_parquet/year=2023/country=Mexico/7329604473293942784.parquet │ 2023 │ Mexico │ 4 │
6. │ test/t_03363_parquet/year=2023/country=USA/7329604473319108608.parquet │ 2023 │ USA │ 3 │
7. │ test/t_03363_parquet/year=2025/country=/7329604473327497216.parquet │ 2025 │ │ 11 │
8. │ test/t_03363_parquet/year=2024/country=CN/7329604473310720000.parquet │ 2024 │ CN │ 10 │
9. │ test/t_03363_parquet/year=2022/country=USA/7329604473298137088.parquet │ 2022 │ USA │ 1 │
10. │ test/t_03363_parquet/year=2024/country=Germany/7329604473306525696.parquet │ 2024 │ Germany │ 6 │
11. │ test/t_03363_parquet/year=2024/country=Germany/7329604473306525696.parquet │ 2024 │ Germany │ 7 │
└────────────────────────────────────────────────────────────────────────────┴──────┴─────────┴─────────┘
```
### الاستعلام عن البيانات المُقسَّمة إلى أقسام
يستخدم هذا المثال [وصفة Docker Compose](https://github.com/ClickHouse/examples/tree/5fdc6ff72f4e5137e23ea075c88d3f44b0202490/docker-compose-recipes/recipes/ch-and-minio-S3)، التي تدمج ClickHouse مع MinIO. ينبغي أن تتمكن من إعادة تنفيذ الاستعلامات نفسها باستخدام S3 من خلال استبدال قيم endpoint والمصادقة.
لاحظ أن endpoint الخاص بـ S3 في إعداد `ENGINE` يستخدم رمز المعلمة `{_partition_id}` كجزء من كائن S3 (اسم الملف)، وأن استعلامات SELECT تُنفَّذ على أسماء الكائنات الناتجة تلك (مثل `test_3.csv`).
كما هو موضح في المثال، فإن الاستعلام من جداول S3 المُقسَّمة إلى أقسام
غير مدعوم مباشرةً في الوقت الحالي، لكن يمكن تحقيق ذلك عبر الاستعلام عن الأقسام الفردية
باستخدام S3 table function.
تتمثل حالة الاستخدام الأساسية لكتابة
البيانات المُقسَّمة إلى أقسام في S3 في تمكين نقل هذه البيانات إلى نظام
ClickHouse آخر (على سبيل المثال، الانتقال من البيئات المحلية إلى ClickHouse
Cloud). ونظرًا إلى أن مجموعات بيانات ClickHouse تكون غالبًا كبيرة جدًا، وأن
موثوقية الشبكة قد لا تكون مثالية دائمًا، فمن المنطقي نقل مجموعات البيانات
على شكل مجموعات فرعية، ومن هنا تأتي فائدة الكتابة المُقسَّمة إلى أقسام.
#### إنشاء الجدول
```sql highlight={8} theme={null}
CREATE TABLE p
(
`column1` UInt32,
`column2` UInt32,
`column3` UInt32
)
ENGINE = S3(
'http://minio:10000/clickhouse//test_{_partition_id}.csv',
'minioadmin',
'minioadminpassword',
'CSV')
PARTITION BY column3
```
#### إدراج البيانات
```sql theme={null}
INSERT INTO p VALUES (1, 2, 3), (3, 2, 1), (78, 43, 45)
```
#### الاستعلام من القسم 3
يستخدم هذا الاستعلام دالة الجدول S3
```sql theme={null}
SELECT *
FROM s3('http://minio:10000/clickhouse//test_3.csv', 'minioadmin', 'minioadminpassword', 'CSV')
```
```response theme={null}
┌─c1─┬─c2─┬─c3─┐
│ 1 │ 2 │ 3 │
└────┴────┴────┘
```
#### الاستعلام من التقسيم 1
```sql theme={null}
SELECT *
FROM s3('http://minio:10000/clickhouse//test_1.csv', 'minioadmin', 'minioadminpassword', 'CSV')
```
```response theme={null}
┌─c1─┬─c2─┬─c3─┐
│ 3 │ 2 │ 1 │
└────┴────┴────┘
```
#### الاستعلام من القسم 45
```sql theme={null}
SELECT *
FROM s3('http://minio:10000/clickhouse//test_45.csv', 'minioadmin', 'minioadminpassword', 'CSV')
```
```response theme={null}
┌─c1─┬─c2─┬─c3─┐
│ 78 │ 43 │ 45 │
└────┴────┴────┘
```
#### قيد
قد تحاول بطبيعة الحال تنفيذ `Select * from p`، لكن كما ذُكر أعلاه، سيفشل هذا الاستعلام؛ استخدم الاستعلام المذكور سابقًا.
```sql theme={null}
SELECT * FROM p
```
```response theme={null}
Received exception from server (version 23.4.1):
Code: 48. DB::Exception: Received from localhost:9000. DB::Exception: Reading from a partitioned S3 storage is not implemented yet. (NOT_IMPLEMENTED)
```
## إدراج البيانات
لاحظ أنه لا يمكن إدراج الصفوف إلا في الملفات الجديدة. ولا توجد دورات دمج أو عمليات تقسيم للملفات. وبمجرد كتابة ملف، ستفشل عمليات الإدراج اللاحقة. لتجنّب ذلك، يمكنك استخدام الإعدادين `s3_truncate_on_insert` و`s3_create_new_file_on_insert`. راجع مزيدًا من التفاصيل [هنا](/ar/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse#inserting-data).
## الأعمدة الافتراضية
* `_path` — مسار الملف. النوع: `LowCardinality(String)`.
* `_file` — اسم الملف. النوع: `LowCardinality(String)`.
* `_size` — حجم الملف بالبايت. النوع: `Nullable(UInt64)`. إذا كان الحجم غير معروف، فستكون القيمة `NULL`.
* `_time` — وقت آخر تعديل للملف. النوع: `Nullable(DateTime)`. إذا كان الوقت غير معروف، فستكون القيمة `NULL`.
* `_etag` — قيمة ETag للملف. النوع: `LowCardinality(String)`. إذا كانت قيمة etag غير معروفة، فستكون القيمة `NULL`.
* `_tags` — وسوم الملف. النوع: `Map(String, String)`. إذا لم تكن هناك وسوم، فستكون القيمة خريطة فارغة \`{}'.
لمزيد من المعلومات حول الأعمدة الافتراضية، راجع [هنا](/ar/reference/engines/table-engines/index#table_engines-virtual_columns).
## تفاصيل التنفيذ
* يمكن إجراء عمليات القراءة والكتابة بالتوازي
* غير مدعوم:
* عمليات `ALTER` و `SELECT...SAMPLE`.
* الفهارس.
* يمكن استخدام [النسخ المتماثل دون نسخ](/ar/concepts/features/configuration/server-config/storing-data#zero-copy) لكنه غير مدعوم.
**النسخ المتماثل دون نسخ غير جاهز لبيئة الإنتاج**
يكون النسخ المتماثل دون نسخ معطّلًا افتراضيًا في ClickHouse الإصدار 22.8 والإصدارات الأحدث. لا يُنصح باستخدام هذه الميزة في بيئة الإنتاج.
## أحرف البدل في المسار
يمكن للوسيطة `path` تحديد عدة ملفات باستخدام أحرف بدل شبيهة بتلك المستخدمة في bash. ولكي يُعالَج الملف، يجب أن يكون موجودًا وأن يطابق نمط المسار بالكامل. ويُحدَّد تعداد الملفات أثناء `SELECT` (وليس عند `CREATE`).
* `*` — يستبدل أي عدد من المحارف، باستثناء `/`، بما في ذلك السلسلة الفارغة.
* `**` — يستبدل أي عدد من المحارف، بما في ذلك `/`، بما في ذلك السلسلة الفارغة.
* `?` — يستبدل أي محرف واحد.
* `{some_string,another_string,yet_another_one}` — يستبدل أيًّا من السلاسل `'some_string', 'another_string', 'yet_another_one'`.
* `{N..M}` — يستبدل أي عدد ضمن النطاق من N إلى M، شاملًا الحدّين. ويمكن أن تحتوي N وM على أصفار بادئة، مثل `000..078`.
التركيبات التي تتضمن `{}` مشابهة لدالة الجدول [remote](/ar/reference/functions/table-functions/remote).
إذا كان تعداد الملفات يتضمن نطاقات أرقام بأصفار بادئة، فاستخدم البنية ذات الأقواس المعقوفة لكل رقم على حدة أو استخدم `?`.
**مثال على أحرف البدل 1**
أنشئ جدولًا بملفات تحمل الأسماء `file-000.csv`, `file-001.csv`, ... , `file-999.csv`:
```sql theme={null}
CREATE TABLE big_table (name String, value UInt32)
ENGINE = S3('https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/my_folder/file-{000..999}.csv', 'CSV');
```
**مثال على أحرف البدل 2**
لنفترض أن لدينا عدة ملفات بتنسيق CSV لها عناوين URI التالية على S3:
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_1.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_1.csv\');
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_2.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_2.csv\');
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_3.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/some\_folder/some\_file\_3.csv\');
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_1.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_1.csv\');
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_2.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_2.csv\');
* '[https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_3.csv\'](https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/another\_folder/some\_file\_3.csv\');
هناك عدة طرق لإنشاء جدول يتكوّن من الملفات الستة جميعها:
1. حدِّد نطاق لواحق الملفات:
```sql theme={null}
CREATE TABLE table_with_range (name String, value UInt32)
ENGINE = S3('https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/{some,another}_folder/some_file_{1..3}', 'CSV');
```
2. خذ جميع الملفات التي تبدأ بالبادئة `some_file_` (يجب ألا توجد أي ملفات إضافية بهذه البادئة في كلا المجلدين):
```sql theme={null}
CREATE TABLE table_with_question_mark (name String, value UInt32)
ENGINE = S3('https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/{some,another}_folder/some_file_?', 'CSV');
```
3. خذ جميع الملفات في كلا المجلدين (يجب أن تستوفي جميع الملفات التنسيق والمخطط الموضحين في الاستعلام):
```sql theme={null}
CREATE TABLE table_with_asterisk (name String, value UInt32)
ENGINE = S3('https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/{some,another}_folder/*', 'CSV');
```
## إعدادات التخزين
* [s3\_truncate\_on\_insert](/ar/reference/settings/session-settings#s3_truncate_on_insert) - يسمح بتفريغ الملف قبل الإدراج فيه. يكون مُعطّلًا افتراضيًا.
* [s3\_create\_new\_file\_on\_insert](/ar/reference/settings/session-settings#s3_create_new_file_on_insert) - يسمح بإنشاء ملف جديد عند كل عملية إدراج إذا كان التنسيق يتضمن لاحقة. يكون مُعطّلًا افتراضيًا.
* [s3\_skip\_empty\_files](/ar/reference/settings/session-settings#s3_skip_empty_files) - يسمح بتخطي الملفات الفارغة أثناء القراءة. يكون مُفعّلًا افتراضيًا.
## الإعدادات المتعلقة بـ S3
يمكن تعيين الإعدادات التالية قبل تنفيذ الاستعلام أو وضعها في ملف التهيئة.
* `s3_max_single_part_upload_size` — الحد الأقصى لحجم الكائن الذي يمكن رفعه إلى S3 باستخدام رفع أحادي الجزء. القيمة الافتراضية هي `32Mb`.
* `s3_min_upload_part_size` — الحد الأدنى لحجم الجزء المطلوب رفعه أثناء الرفع متعدد الأجزاء إلى [S3 Multipart upload](https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html). القيمة الافتراضية هي `16Mb`.
* `s3_max_redirects` — الحد الأقصى لعدد قفزات إعادة التوجيه المسموح بها في S3. القيمة الافتراضية هي `10`.
* `s3_single_read_retries` — الحد الأقصى لعدد المحاولات أثناء القراءة الواحدة. القيمة الافتراضية هي `4`.
* `s3_max_put_rps` — الحد الأقصى لمعدل طلبات PUT في الثانية قبل تطبيق تقييد المعدل. القيمة الافتراضية هي `0` (غير محدود).
* `s3_max_put_burst` — الحد الأقصى لعدد الطلبات التي يمكن إصدارها بالتزامن قبل بلوغ حد الطلبات في الثانية. افتراضيًا (عند القيمة `0`) يساوي `s3_max_put_rps`.
* `s3_max_get_rps` — الحد الأقصى لمعدل طلبات GET في الثانية قبل تطبيق تقييد المعدل. القيمة الافتراضية هي `0` (غير محدود).
* `s3_max_get_burst` — الحد الأقصى لعدد الطلبات التي يمكن إصدارها بالتزامن قبل بلوغ حد الطلبات في الثانية. افتراضيًا (عند القيمة `0`) يساوي `s3_max_get_rps`.
* `s3_upload_part_size_multiply_factor` - يُضرَب `s3_min_upload_part_size` في هذا العامل في كل مرة يتم فيها رفع `s3_multiply_parts_count_threshold` جزءًا من عملية كتابة واحدة إلى S3. القيمة الافتراضية هي `2`.
* `s3_upload_part_size_multiply_parts_count_threshold` - في كل مرة يُرفع فيها هذا العدد من الأجزاء إلى S3، يُضرَب `s3_min_upload_part_size` في `s3_upload_part_size_multiply_factor`. القيمة الافتراضية هي `500`.
* `s3_max_inflight_parts_for_one_file` - يقيّد عدد طلبات PUT التي يمكن تنفيذها بالتزامن لكائن واحد. ينبغي أن يكون هذا العدد محدودًا. تعني القيمة `0` عدم وجود حد. القيمة الافتراضية هي `20`. لكل جزء قيد النقل مخزن مؤقت بحجم `s3_min_upload_part_size` لأول `s3_upload_part_size_multiply_factor` جزءًا، ويزداد الحجم عندما يكون الملف كبيرًا بما يكفي؛ راجع `upload_part_size_multiply_factor`. باستخدام الإعدادات الافتراضية، لا يستهلك الملف المرفوع أكثر من `320Mb` للملف الذي يقل حجمه عن `8G`. ويزداد الاستهلاك للملفات الأكبر حجمًا.
اعتبار أمني: إذا كان بإمكان مستخدم خبيث تحديد عناوين URL عشوائية لـ S3، فيجب تعيين `s3_max_redirects` إلى صفر لتجنب هجمات [SSRF](https://en.wikipedia.org/wiki/Server-side_request_forgery)؛ أو بدلًا من ذلك، يجب تحديد `remote_host_filter` في إعدادات الخادم.
## الإعدادات المستندة إلى endpoint
يمكن تحديد الإعدادات التالية في ملف التهيئة لـ endpoint معين (الذي سيُطابَق بالبادئة الدقيقة لعنوان URL):
* `endpoint` — يحدد بادئة الـ endpoint. إلزامي.
* `access_key_id` و`secret_access_key` — يحددان credentials للاستخدام مع الـ endpoint المحدد. اختياري.
* `use_environment_credentials` — إذا كانت القيمة `true`، سيحاول S3 client الحصول على credentials من متغيرات البيئة ومن [Amazon EC2](https://en.wikipedia.org/wiki/Amazon_Elastic_Compute_Cloud) metadata للـ endpoint المحدد. اختياري، والقيمة الافتراضية هي `false`.
* `region` — يحدد اسم S3 region. اختياري.
* `use_insecure_imds_request` — إذا كانت القيمة `true`، سيستخدم S3 client طلب IMDS غير آمن عند الحصول على credentials من Amazon EC2 metadata. اختياري، والقيمة الافتراضية هي `false`.
* `expiration_window_seconds` — فترة سماح للتحقق من انتهاء صلاحية credentials المستندة إلى وقت الانتهاء. اختياري، والقيمة الافتراضية هي `120`.
* `no_sign_request` - تجاهل جميع credentials بحيث لا تُوقَّع الطلبات. مفيد للوصول إلى Public حاويات.
* `header` — يضيف HTTP header محدداً إلى الطلبات الموجَّهة للـ endpoint المحدد. اختياري، ويمكن تحديده أكثر من مرة.
* `access_header` - يضيف HTTP header محدداً إلى الطلبات الموجَّهة للـ endpoint المحدد، في الحالات التي لا تتوفر فيها credentials أخرى من أي source آخر.
* `server_side_encryption_customer_key_base64` — عند تحديده، تُضبط headers المطلوبة للوصول إلى كائنات S3 باستخدام تشفير SSE-C. اختياري.
* `server_side_encryption_kms_key_id` - عند تحديده، تُضبط headers المطلوبة للوصول إلى كائنات S3 باستخدام [تشفير SSE-KMS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html). وإذا تم تحديد سلسلة نصية فارغة، سيُستخدم مفتاح S3 المُدار من AWS. اختياري.
* `server_side_encryption_kms_encryption_context` - عند تحديده إلى جانب `server_side_encryption_kms_key_id`، يُضبط header سياق التشفير المحدد لـ SSE-KMS. اختياري.
* `server_side_encryption_kms_bucket_key_enabled` - عند تحديده إلى جانب `server_side_encryption_kms_key_id`، يُضبط header تفعيل مفاتيح حاوية S3 لـ SSE-KMS. اختياري، يمكن أن تكون قيمته `true` أو `false`، ويُعدّ غير محدد افتراضياً (يطابق الإعداد على مستوى الـ حاوية).
* `max_single_read_retries` — الحد الأقصى لعدد المحاولات خلال عملية قراءة واحدة. القيمة الافتراضية هي `4`. اختياري.
* `max_put_rps` و`max_put_burst` و`max_get_rps` و`max_get_burst` - إعدادات throttling (انظر الوصف أعلاه) لاستخدامها مع endpoint محدد بدلاً من تطبيقها على كل query. اختياري.
**مثال:**
```xml theme={null}
https://clickhouse-public-datasets.s3.amazonaws.com/my-test-bucket-768/
```
## العمل مع ملفات الأرشيف
لنفترض أن لدينا عدة ملفات أرشيفية بمعرّفات URI التالية على S3:
* '[https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-10.csv.zip\'](https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-10.csv.zip\');
* '[https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-11.csv.zip\'](https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-11.csv.zip\');
* '[https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-12.csv.zip\'](https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-12.csv.zip\');
يمكن استخراج البيانات من ملفات الأرشيف هذه باستخدام ::. ويمكن استخدام أنماط glob سواء في جزء `url` أو في الجزء الذي يلي :: (وهو المسؤول عن اسم الملف داخل الأرشيف).
```sql theme={null}
SELECT *
FROM s3(
'https://s3-us-west-1.amazonaws.com/umbrella-static/top-1m-2018-01-1{0..2}.csv.zip :: *.csv'
);
```
يدعم ClickHouse ثلاثة تنسيقات للأرشيف:
ZIP
TAR
7Z
وبينما يمكن الوصول إلى أرشيفات ZIP وTAR من أي موقع تخزين مدعوم، فلا يمكن قراءة أرشيفات 7Z إلا من نظام الملفات المحلي المثبّت عليه ClickHouse.
## الوصول إلى الحاويات العامة
يحاول ClickHouse جلب بيانات الاعتماد من أنواع متعددة من المصادر.
وقد يؤدي ذلك أحيانًا إلى حدوث مشكلات عند الوصول إلى بعض الحاويات العامة، فيُرجع العميل رمز الخطأ `403`.
يمكن تجنب هذه المشكلة باستخدام الكلمة المفتاحية `NOSIGN`، ما يفرض على العميل تجاهل جميع بيانات الاعتماد وعدم توقيع الطلبات.
```sql theme={null}
CREATE TABLE big_table (name String, value UInt32)
ENGINE = S3('https://datasets-documentation.s3.eu-west-3.amazonaws.com/aapl_stock.csv', NOSIGN, 'CSVWithNames');
```
## تحسين الأداء
للتعرّف على تفاصيل تحسين أداء الدالة `s3`، راجع [دليلنا المفصّل](/ar/integrations/connectors/data-ingestion/AWS/performance).
## التحكم في الوصول المستند إلى الأدوار
في ClickHouse Cloud، يمكنك استخدام التحكم في الوصول المستند إلى الأدوار للمصادقة على S3 بدلًا من استخدام مفاتيح الوصول. راجع [تأمين S3](/ar/products/cloud/guides/data-sources/accessing-s3-data-securely) للاطلاع على خطوات الإعداد.
بعد الإعداد، يمكن تمرير `roleARN` عبر المعلمة `extra_credentials`:
```sql theme={null}
CREATE TABLE my_s3_table(name String, value UInt32)
ENGINE = S3('https://my-bucket.s3.amazonaws.com/data/*.csv', extra_credentials(role_arn = 'arn:aws:iam::111111111111:role/ClickHouseAccessRole-001'), 'CSV')
```
يمكن أيضًا تمرير `external_id` اختياريًا إلى جانب `role_arn`. ويُمرَّر بوصفه المعلَمة `ExternalId` في استدعاء AWS STS `AssumeRole`، مما يتيح لسياسة الثقة الخاصة بالدور اشتراط سرٍّ مشترك للتخفيف من [مشكلة الوكيل المُربَك](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html):
```sql theme={null}
CREATE TABLE my_s3_table(name String, value UInt32)
ENGINE = S3('https://my-bucket.s3.amazonaws.com/data/*.csv', extra_credentials(role_arn = 'arn:aws:iam::111111111111:role/ClickHouseAccessRole-001', external_id = 'my-external-id'), 'CSV')
```
## راجع أيضًا
* [دالة الجدول S3](/ar/reference/functions/table-functions/s3)
* [تكامل S3 مع ClickHouse](/ar/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)