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

> يتيح معالجة الملفات من Azure Blob Storage بالتوازي باستخدام العديد من العقد في عنقود محدد.

# azureBlobStorageCluster

يتيح هذا معالجة الملفات من [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs) بالتوازي باستخدام العديد من العقد في عنقود محدد. على العقدة البادئة، يُنشئ اتصالًا بجميع العقد في العنقود، ويفك علامات النجمة في مسار ملف S3، ويوزّع كل ملف ديناميكيًا. وعلى العقدة العاملة، يطلب من العقدة البادئة المهمة التالية لمعالجتها ثم يعالجها. ويتكرر ذلك حتى تكتمل جميع المهام.
تشبه دالة الجدول هذه [الدالة s3Cluster](/ar/reference/functions/table-functions/s3Cluster).

<div id="syntax">
  ## البنية
</div>

```sql theme={null}
azureBlobStorageCluster(cluster_name, connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])
```

<div id="arguments">
  ## المعاملات
</div>

| Argument            | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cluster_name`      | اسم العنقود المستخدم لبناء مجموعة من العناوين ومعلمات الاتصال بالخوادم البعيدة والمحلية.                                                                                                                                                                                                                                                                                                                                                                                                       |
| `connection_string` | `storage_account_url` — تتضمن `connection_string` اسم الحساب والمفتاح ([إنشاء connection string](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json\&bc=%2Fazure%2Fstorage%2Fblobs%2Fbreadcrumb%2Ftoc.json#configure-a-connection-string-for-an-azure-storage-account))، أو يمكنك أيضًا توفير URL لحساب التخزين هنا، وتمرير اسم الحساب ومفتاحه كمعلمات منفصلة (راجع المعلمتين `account_name` و`account_key`) |
| `container_name`    | اسم الحاوية                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `blobpath`          | مسار الملف. يدعم أحرف البدل التالية في وضع `readonly`: `*`, `**`, `?`, `{abc,def}` و `{N..M}`، حيث إن `N` و`M` — أرقام، و`'abc'` و`'def'` — سلاسل نصية.                                                                                                                                                                                                                                                                                                                                        |
| `account_name`      | إذا استُخدم `storage_account_url`، فيمكن تحديد اسم الحساب هنا                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `account_key`       | إذا استُخدم `storage_account_url`، فيمكن تحديد مفتاح الحساب هنا                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `format`            | تنسيق الملف: [تنسيق](/ar/reference/formats/index)                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `compression`       | القيم المدعومة: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. افتراضيًا، سيُكتشف الضغط تلقائيًا من امتداد الملف. (وهو ما يعادل ضبطه على `auto`).                                                                                                                                                                                                                                                                                                                                      |
| `structure`         | بنية الجدول. التنسيق `'column1_name column1_type, column2_name column2_type, ...'`.                                                                                                                                                                                                                                                                                                                                                                                                            |

<div id="returned_value">
  ## القيمة المعادة
</div>

جدول بالبنية المحددة لقراءة البيانات من الملف المحدد أو كتابتها فيه.

<div id="examples">
  ## أمثلة
</div>

على غرار محرك الجدول [AzureBlobStorage](/ar/reference/engines/table-engines/integrations/azureBlobStorage)، يمكن للمستخدمين استخدام محاكي Azurite لتطوير Azure Storage محليًا. يمكن الاطلاع على مزيد من التفاصيل [هنا](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite?tabs=docker-hub%2Cblob-storage). نفترض أدناه أن Azurite متاح على اسم المضيف `azurite1`.

استعلِم عن العدد للملف `test_cluster_*.csv` باستخدام جميع العقد في عنقود `cluster_simple`:

```sql theme={null}
SELECT count(*) FROM azureBlobStorageCluster(
        'cluster_simple', 'http://azurite1:10000/devstoreaccount1', 'testcontainer', 'test_cluster_count.csv', 'devstoreaccount1',
        'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV',
        'auto', 'key UInt64')
```

<div id="using-shared-access-signatures-sas-sas-tokens">
  ## استخدام توقيعات الوصول المشتركة (SAS)
</div>

راجع [azureBlobStorage](/ar/reference/functions/table-functions/azureBlobStorage#using-shared-access-signatures-sas-sas-tokens) للاطلاع على أمثلة.

<div id="related">
  ## ذو صلة
</div>

* [محرك AzureBlobStorage](/ar/reference/engines/table-engines/integrations/azureBlobStorage)
* [دالة الجدول azureBlobStorage](/ar/reference/functions/table-functions/azureBlobStorage)