groupArrayInsertAt

يُدرِج قيمةً في المصفوفة في الموضع المحدد.

​

groupArrayInsertAt

أُضيفت في: v1.1.0

تُدرِج قيمة في المصفوفة عند الموضع المحدد.

إذا أُدرِجت عدة قيم في الموضع نفسه ضمن استعلام واحد، فتتصرف الدالة على النحو التالي:

• إذا نُفِّذ الاستعلام في خيط تنفيذ واحد، فستُستخدم أول قيمة من القيم المُدرَجة.
• إذا نُفِّذ الاستعلام باستخدام عدة خيوط تنفيذ، فستكون القيمة الناتجة إحدى القيم المُدرَجة بشكل غير محدد.

الصياغة

groupArrayInsertAt(default_x, size)([x, pos])

المعلمات

• default_x — اختياري. القيمة الافتراضية المستخدمة للاستبدال في المواضع الفارغة. Any
• size — اختياري. طول المصفوفة الناتجة. عند استخدام هذه المعلمة، يجب تحديد القيمة الافتراضية default_x. UInt32

الوسائط

• x — القيمة المراد إدراجها. Any
• pos — الموضع الذي سيُدرج فيه العنصر المحدد x. يبدأ ترقيم الفهارس في المصفوفة من الصفر. UInt32

القيمة المُعادة

تعيد مصفوفة تحتوي على القيم المُدرَجة. Array

أمثلة

الاستخدام الأساسي من دون معلمات

Query

SELECT groupArrayInsertAt(toString(number), number * 2) FROM numbers(5);

Response

┌─groupArrayInsertAt(toString(number), multiply(number, 2))─┐
│ ['0','','1','','2','','3','','4']                         │
└───────────────────────────────────────────────────────────┘

الاستخدام مع معلمة القيمة الافتراضية

Query

SELECT groupArrayInsertAt('-')(toString(number), number * 2) FROM numbers(5);

Response

┌─groupArrayInsertAt('-')(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2','-','3','-','4']                          │
└────────────────────────────────────────────────────────────────┘

الاستخدام مع معامِلَي القيمة الافتراضية والحجم

Query

SELECT groupArrayInsertAt('-', 5)(toString(number), number * 2) FROM numbers(5);

Response

┌─groupArrayInsertAt('-', 5)(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2']                                             │
└───────────────────────────────────────────────────────────────────┘

الإدراج متعدد الخيوط في نفس الموضع

Query

SELECT groupArrayInsertAt(number, 0) FROM numbers_mt(10) SETTINGS max_block_size = 1;

Response

┌─groupArrayInsertAt(number, 0)─┐
│ [7]                           │
└───────────────────────────────┘