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

كشف فاصل CSV: الفاصلة أو المنقوطة أو الجدولة أو الأنبوب

لا تستخدم ملفات CSV الفاصلة دائماً. فكثيراً ما تعتمد الصادرات الإقليمية الفاصلة المنقوطة، وقد تختار مسارات معالجة البيانات علامة الجدولة، بينما تنتج أدوات سطر الأوامر نصوصاً مفصولة بعلامة الأنبوب.

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

شغّل الأداة مجانًا اطّلع على الـAPI

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

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

اختيار عينة CSV ممثلة

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

فهم قرار التكرار

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

معالجة العينات غير المتسقة أو الملتبسة

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

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

إعداد الاستيراد تلقائياً

افحصوا عينة المورد قبل اختيار الفاصل في محلل CSV أو عملية الاستيراد إلى قاعدة البيانات.

تشخيص خلل رفع جدول البيانات

تحققوا مما إذا كان التصدير يستخدم الفاصلة المنقوطة الإقليمية بدلاً من الفاصلة التي يتوقعها نموذج الرفع.

التحقق من افتراضات مسار البيانات

تأكدوا من ثبات بنية صفوف النص المفصول الوارد قبل بدء التحويل أو مطابقة المخطط.

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

ما الفواصل التي يمكن اكتشافها؟

المرشحون هم الفاصلة والفاصلة المنقوطة وعلامة الجدولة والأنبوب.

متى يعد الفاصل متسقاً؟

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

هل تدخل الأسطر الفارغة في التحليل؟

لا. تتجاهل الأداة الأسطر الفارغة أو المكونة من مسافات فقط، بما فيها سطر فارغ في النهاية.

هل يفهم الكشف حقول CSV المحاطة بعلامات اقتباس؟

لا. يجري التحليل عدّاً حرفياً، ولذلك يحسب الرموز المرشحة الموجودة داخل القيم المقتبسة.

لماذا تعيد العينة الملتبسة خطأ؟

عندما يتساوى عدة مرشحين في أعلى تكرار ثابت، يكون اختيار أحدها بالأولوية مجرد تخمين بلا دليل.

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

تبلغ تكلفة كل طلب API مقدار $0.002، أما نسخة المتصفح فتعمل محلياً بالمجان.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/data/detect-csv-delimiter

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

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

curl -X POST https://api.kit.forhosting.com/data/detect-csv-delimiter \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"name,city,score\nAda,London,92\nLinus,Helsinki,88"}'

const res = await fetch("https://api.kit.forhosting.com/data/detect-csv-delimiter", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "name,city,score\nAda,London,92\nLinus,Helsinki,88"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/detect-csv-delimiter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "name,city,score\nAda,London,92\nLinus,Helsinki,88"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/detect-csv-delimiter", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"name,city,score\\nAda,London,92\\nLinus,Helsinki,88"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"name,city,score\nAda,London,92\nLinus,Helsinki,88"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/detect-csv-delimiter", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "name,city,score\nAda,London,92\nLinus,Helsinki,88"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.detect_csv_delimiter",
  "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 الكامل ←