ForHosting KIT · البيانات والملفات: تحويل وتنظيف

أخذ عينة عشوائية قابلة للتكرار من صفوف CSV ببذرة

تختار هذه الأداة عدداً محدداً بدقة من سجلات CSV من دون إرجاع، مع إبقاء الترويسة الأصلية.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا نص CSV وحجم العينة وبذرة صحيحة؛ فالمدخلات الثلاثة نفسها تنتج دائماً ملف CSV المصغّر نفسه. تفيد الأداة خصوصاً عندما تحتاج المراجعة أو الاختبارات أو العروض أو أعمال التدقيق إلى مجموعة بيانات أصغر يستطيع زملاؤكم إعادة إنشائها بدقة، من دون الاعتماد على جلسة جدول بيانات أو مولد عشوائي غير قابل للتوقع.

أنشئوا مجموعة عشوائية فرعية يستطيع الآخرون تكرارها

يصبح أخذ العينات العشوائي المعتاد غير عملي عندما يتعين على شخص آخر تكراره. فقد يختار جدول البيانات سجلات مختلفة بعد إعادة الحساب، وقد يجعل النص البرمجي غير الموثق المراجعين غير واثقين مما إذا كانت النتيجة قد تغيرت بين تشغيل وآخر. تجعل هذه الأداة البذرة جزءاً صريحاً من المدخلات إلى جانب نص CSV وحجم العينة المطلوب. لذلك تعطي المدخلات المتطابقة السجلات نفسها تماماً، وهو ما يلائم التجارب ذات الإصدارات وملاحظات المراجعة وفحوص الجودة القابلة للتكرار. يُعامل أول سجل في CSV دائماً على أنه الترويسة ويظل محفوظاً. ولا يشمل الاختيار إلا سجلات البيانات التي تليه، ولا يمكن أن يظهر أي سجل مختار أكثر من مرة. تحافظ السجلات الناتجة على ترتيبها النسبي الأصلي، مما يسهل مقارنة الملف الأصغر بمصدره. ويمكن أن تحتوي الحقول المقتبسة على فواصل أو علامات اقتباس مهروبة أو فواصل أسطر؛ إذ تتعرف الأداة على حدود السجلات من دون تسطيح محتواها أو إعادة بنائه.

اختاروا حجم العينة والبذرة بعناية

اضبطوا sample_size على العدد الدقيق المطلوب من سجلات البيانات. تُقبل القيمة 0 وتعيد الترويسة وحدها، وقد يفيد ذلك في إنشاء ملف اختبار فارغ يحتفظ بالمخطط. لا يجوز أن يتجاوز الحجم عدد السجلات المتاحة لأن الاختيار يجري من دون إرجاع؛ فطلب صفوف مميزة أكثر من الموجودة يجعل النتيجة مستحيلة. في هذه الحالة يعيد الطلب خطأ إدخال واضحاً بدلاً من تكرار السجلات أو تقليل الحجم المطلوب بصمت. يجب أن تكون seed عدداً صحيحاً آمناً. وهي ليست سراً أمنياً ولا يلزم أن يتعذر توقعها؛ فالغرض منها تسمية اختيار يمكن تكراره. غالباً ما تشتق الفرق قيمة بسيطة من رقم تجربة أو حالة اختبار أو جولة مراجعة، ثم تحفظها مع النتيجة. يؤدي تغيير البذرة وحدها عادة إلى مجموعة فرعية مختلفة، بينما تعيد استعادة البذرة السابقة الاختيار السابق. أبقوا ملف CSV المصدر من دون تغيير عندما تكون قابلية التكرار مهمة، لأن إضافة الصفوف أو حذفها أو إعادة ترتيبها يغير مجتمع الاختيار.

استخدموا عينة CSV بمسؤولية في الاختبار والمراجعة

تفيد المجموعة العشوائية الفرعية في الفحص السريع واختبارات السلامة الأساسية لخطوط المعالجة والعروض وتوزيع ملفات اختبار سهلة التعامل، لكنها لا تصبح ممثلة إحصائياً بصورة تلقائية. قد تغيب الفئات النادرة بالمصادفة، ولا سيما عندما تكون العينة المطلوبة صغيرة. إذا كان لا بد من ظهور كل فئة، فاستخدموا أسلوباً طبقياً بدلاً من اعتبار العينة العشوائية غير المقيدة ضماناً. لا تجري هذه القدرة اتصالات شبكية أو إثراءً أو تحويل أنواع أو تغييراً للفاصل أو تنظيفاً للبيانات. فهي تحفظ سجلات CSV المختارة بصورتها الأصلية وتجمعها تحت الترويسة الأصلية، مما يمنع مفاجآت مثل إعادة تنسيق التواريخ أو توحيد الأرقام. وتظل السجلات المقتبسة متعددة الأسطر سليمة. كما تُعد الأسطر الفعلية الفارغة الواقعة تحت الترويسة سجلات، لأن إسقاطها سيغير المجتمع المقدم. في مسارات العمل الآلية، احفظوا البذرة والحجم ونسخة ثابتة من المصدر أو قيمة تحقق له إلى جانب الناتج. تبلغ كلفة طلب API مقدار $0.002، وتنفذ نسخة المتصفح الحساب نفسه محلياً.

حالات الاستخدام

إنشاء بيانات اختبار قابلة للتكرار

اختاروا مجموعة CSV صغيرة لاختبارات التكامل واحفظوا البذرة معها حتى يمكن إعادة إنتاج الأعطال.

مشاركة ملف مناسب للمراجعة

قدموا عدداً أقل من السجلات مع الحفاظ على الترويسة والتنسيق الخام وطريقة اختيار قابلة للتكرار.

مقارنة عمليات التشغيل التجريبية

استخدموا الصفوف نفسها مع التحويلات أو النماذج البديلة حتى لا تؤثر فروق المدخلات في المقارنة.

الأسئلة الشائعة

هل يمكن اختيار الصف نفسه مرتين؟

لا. يجري أخذ العينة من دون إرجاع، ولذلك يكون لكل سجل مختار موضع مختلف في المصدر.

هل يحتفظ الناتج بترويسة CSV؟

نعم. يبقى السجل الأول ترويسة، ولا يجري الاختيار إلا من السجلات التالية له.

ما الذي يجعل النتيجة حتمية؟

تبدأ البذرة الصحيحة خوارزمية شبه عشوائية ثابتة. وينتج CSV والحجم والبذرة نفسها الناتج نفسه.

ماذا يحدث إذا كان حجم العينة أكبر من CSV؟

يفشل الطلب بخطأ إدخال، لأنه يتعذر أخذ عينة مميزة أكبر من المجتمع من دون إرجاع.

هل الحقول المقتبسة أو متعددة الأسطر مدعومة؟

نعم. تتعرف الأداة على الفواصل المقتبسة وعلامات الاقتباس المزدوجة المهروبة وفواصل الأسطر داخل الحقول المقتبسة.

كم تبلغ كلفة طلب API؟

تبلغ كلفة كل طلب API مقدار $0.002. وتنفذ نسخة المتصفح الحساب الخالص نفسه محلياً.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/data/random-sample-rows

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/data/random-sample-rows \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"id,name,team\n1,Ada,Blue\n2,Grace,Red\n3,Linus,Blue\n4,Margaret,Green\n5,Donald,Red","sample_size":3,"seed":42}'

const res = await fetch("https://api.kit.forhosting.com/data/random-sample-rows", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "id,name,team\n1,Ada,Blue\n2,Grace,Red\n3,Linus,Blue\n4,Margaret,Green\n5,Donald,Red",
    "sample_size": 3,
    "seed": 42
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/random-sample-rows",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "id,name,team\n1,Ada,Blue\n2,Grace,Red\n3,Linus,Blue\n4,Margaret,Green\n5,Donald,Red",
    "sample_size": 3,
    "seed": 42
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/random-sample-rows", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"id,name,team\\n1,Ada,Blue\\n2,Grace,Red\\n3,Linus,Blue\\n4,Margaret,Green\\n5,Donald,Red","sample_size":3,"seed":42}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"id,name,team\n1,Ada,Blue\n2,Grace,Red\n3,Linus,Blue\n4,Margaret,Green\n5,Donald,Red","sample_size":3,"seed":42}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/random-sample-rows", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "csv": "id,name,team\n1,Ada,Blue\n2,Grace,Red\n3,Linus,Blue\n4,Margaret,Green\n5,Donald,Red",
  "sample_size": 3,
  "seed": 42
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.random_sample_rows",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_mb 25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←