> ## 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.

> يعرض محرك قاعدة البيانات S3 الكائنات المخزّنة في Amazon S3 وفي أنظمة تخزين الكائنات المتوافقة معه كجداول للقراءة فقط.

# S3

يعرض محرك قواعد البيانات `S3` الكائنات المخزّنة في Amazon S3 وفي تخزين الكائنات المتوافق مع S3 على هيئة جداول للقراءة فقط. ويُترجَم اسم الجدول إلى عنوان URL للكائن عبر دالة الجدول [`s3`](/ar/reference/functions/table-functions/s3).

## إنشاء قاعدة بيانات

```sql theme={null}
CREATE DATABASE s3_data
ENGINE = S3([url[, NOSIGN | access_key_id, secret_access_key]]);
```

يمكن للمحرك أيضًا أن يقبل named collection. ومفاتيح configuration المدعومة هي `url` و`access_key_id` و`secret_access_key` و`no_sign_request` و`use_environment_credentials`.

## الاستخدام

عند تحديد base URL، تكون أسماء الجداول مسارات كائنات نسبية إلى ذلك الـ URL:

```sql theme={null}
CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;
```

في حال عدم وجود base URL، استخدم عنوان URL الكامل للـ object كاسم للجدول. يُستنتج الـ schema والـ format بالطريقة نفسها المتبعة مع دالة الجدول الخاصة بـ `s3`. لا تمتلك قاعدة بيانات أي تعريفات للجداول، ولا تدعم عبارات DDL الخاصة بالجداول أو عمليات الكتابة.

## Access control

يتم التحقق من عناوين URL الخاصة بـ S3 مقابل filter المضيفات البعيدة في الـ server. ويتطلب إنشاء هذه قاعدة بيانات صلاحيتي `READ` و`WRITE` من نوع source grants على `S3`، بصرف النظر عن [`table_engines_require_grant`](/ar/reference/settings/server-settings/settings/other#table_engines_require_grant)، على سبيل المثال:

```sql theme={null}
GRANT READ, WRITE ON S3 TO user_name;
```

راجع [امتيازات `SOURCES`](/ar/reference/statements/grant#sources) للاطلاع على تفاصيل الإصدار والتوافق.

## انظر أيضاً

* [دالة الجدول `s3`](/ar/reference/functions/table-functions/s3)
* [استخدام S3 مع ClickHouse](/ar/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [محرك قاعدة البيانات Filesystem](/ar/reference/engines/database-engines/filesystem)
* [محرك قاعدة البيانات HDFS](/ar/reference/engines/database-engines/hdfs)