# SPLIT_PART

> الدالة SPLIT_PART في StackQL: تقسيم سلسلة نصية حسب فاصل وإرجاع الجزء الموجود في موضع يبدأ ترقيمه من 1، وهي مفيدة لتفكيك معرفات الموارد وARN.

Source: https://stackql.io/ar/language-spec/functions/string/split_part

تقسم السلسلة النصية المصدر حسب فاصل وتعيد الجزء المحدد (مع العد من واحد).  

راجع أيضًا:  
[[` SELECT `]](/language-spec/select) 

* * * 

## بناء الجملة

```sql
SELECT SPLIT_PART(source, sep, part) FROM <multipartIdentifier>;
```

## الوسيطات

__*source*__  
قيمة حرفية نصية أو عمود من نوع سلسلة نصية تريد إجراء التقسيم عليه.

__*sep*__  
حرف أو أكثر تريد استخدامه كفاصل.  

> إذا كانت الوسيطة `sep` تتكون من عدة أحرف، فيتم التعامل مع كل حرف على أنه فاصل.  

> الرموز المدعومة كفواصل هي رموز ASCII (ذات البايت الواحد) فقط.  

__*part*__  
العنصر المراد إرجاعه من السلسلة النصية المقسمة (بترقيم يبدأ من 1). تستخدم القيم السالبة للعد إلى الوراء من العنصر الأخير.  

## القيمة المرجعة
تعيد سلسلة نصية.

* * *

## أمثلة

### استخراج العناصر من سلسلة نصية مفصولة بشرطة مائلة للأمام

**StackQL**

```sql
SELECT name,  
 split_part(id, '/', 3) as subscription,
 split_part(id, '/', 5) as resource_group,
 json_extract(properties, '$.hardwareProfile.vmSize') as vm_size
FROM azure.compute.virtual_machines 
 WHERE resource_group_name = 'stackql-ops-cicd-dev-01' 
 AND subscription_id = '273769f6-545f-45b2-8ab8-2f14ec5768dc';
```

**النتائج**

```
|------|--------------------------------------|-------------------------|-----------------|
| name |             subscription             |     resource_group      |     vm_size     |
|------|--------------------------------------|-------------------------|-----------------|
| test | 273769f6-545f-45b2-8ab8-2f14ec5768dc | stackql-ops-cicd-dev-01 | Standard_D2s_v3 |
|------|--------------------------------------|-------------------------|-----------------|
```

### استخراج العنصر الأخير من عنوان URL

**StackQL**

```sql
SELECT
name,
SPLIT_PART(network, '/', -1) as network,
SPLIT_PART(region, '/', -1) as region
FROM google.compute.vpn_gateways WHERE project = 'stackql-demo';
```

**النتائج**

```
+------------------------+-----------------------+----------------------+
| name                   | network               | region               |
+------------------------+-----------------------+----------------------+
| gcp-aws-vpn-gateway    | stackql-shrd-vpc-nw   | australia-southeast1 |
+------------------------+-----------------------+----------------------+
```

لمزيد من المعلومات، راجع [https://github.com/nalgeon/sqlean/blob/main/docs/text.md](https://github.com/nalgeon/sqlean/blob/main/docs/text.md)
