ForHosting KIT · النصوص والذكاء الاصطناعي

استخراج عمود CSV

اطلب عمود email من جدول فيه name وemail وrole لتحصل على ada@example.com وbob@example.com بالترتيب ودون صف العناوين. اختر العمود بالاسم أو بالموضع بدءًا من 0، مع الفاصلة أو الفاصلة المنقوطة أو الجدولة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

العمود: email

تحصل على

فهرس العمود: 1
القيم: ada@example.com, bob@example.com
الكمية: 2
المحدد: ,

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

معنى استخراج عمود CSV ومتى يُستخدم

نية البحث عن استخراج عمود CSV أو سحب حقل من CSV أو الحصول على قيم حقل واحد من تصدير جدول أضيق من تحويلات الجدول الكاملة. لدى الباحث بالفعل جدولًا مفصولًا بفاصل ويريد شريحة رأسية فقط: كل بريد، كل SKU، كل درجة. تعرّف هذه القدرة CSV كصفوف مفصولة بـ CR أو LF أو CRLF، وحقول مفصولة بفاصل من حرف واحد (فاصلة افتراضيًا، مع دعم الفاصلة المنقوطة وعلامة الجدولة للتصدير الإقليمي وTSV).

يجوز إحاطة الحقول بعلامات اقتباس مزدوجة؛ ويجب مضاعفة الاقتباسات المضمّنة وفق RFC 4180 حتى لا تفصل الفواصل والأسطر الجديدة داخل الخلية الصف. فضّل أداة extract-csv-column هذه عندما تقصد صفحة الهبوط حرفيًا حقلًا واحدًا كقائمة.

كيف تستخرج عمودًا وما حدود الأداة

استدعِ أداة استخراج عمود CSV المجانية في المتصفح لجداول الواجبات وتصديرات CRM وسحب الحقول السريع دون كتابة محلّل CSV بكل لغة. مسار آخر يبني تثبيتات حتمية: قدّم عينة متعددة الأسطر بحقل مقتبس يحوي فاصلة، وثبّت مصفوفة values، واجعل CI تفشل إن أفسد إصلاح لاحق الاقتباس أو فواصل الافتراض. اربط هذه النقطة الطرفية بـ filter-csv أو csv-to-json عندما تكون الخطوة التالية اختيار صفوف أو مصفوفة كائنات كاملة، لكن أبقِ استخراج عمود CSV صفحة مستقلة حتى لا تختلط نية الحقل الواحد بتحويلات متعددة الأعمدة.

لا تتوقع استنتاج أنواع أو تحليل تواريخ أو كشف فاصل تلقائيًا خارج المعامل delimiter الصريح — فتلك مسائل منفصلة. ثبّت تثبيتات للفواصل المقتبسة وفواصل الفاصلة المنقوطة والاختيار بالفهرس بلا رؤوس حتى لا تغيّر الإصلاحات القائمة المرتبة بصمت.

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

قوائم بريد من تصديرات CRM

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

معرّفات تثبيت للاختبارات

تستخرج سكربتات CI عمود id مستقرًا بفهرس صفري من تثبيتات CSV الذهبية حتى تفشل المحلّلات والمسارات عند انحدار ترتيب الأعمدة.

أعمدة درجات لسجلات الصف

يسحب المعلمون عمود تقييم واحدًا من تصدير صف دون فتح جدول، ثم يلصقون القيم في آلة حاسبة أو نظام LMS.

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

كيف أستخرج عمودًا واحدًا من CSV؟

تسرد مصفوفة values في الاستجابة ذلك الحقل بترتيب الصفوف.

هل يمكن اختيار عمود بالفهرس بدل الاسم؟

نعم. مرّر column كرقم أو سلسلة رقمية مثل 0 أو "2".

هل تدعم علامات الجدولة أو الفواصل المنقوطة كفواصل؟

نعم. عيّن delimiter إلى ";" أو استخدم "\t" للقيم المفصولة بجدولة. الفاصل الافتراضي هو الفاصلة.

لماذا لا يُعثر على اسم العمود؟

يجب أن تتطابق العناوين تمامًا بما في ذلك حالة الأحرف، لذا يُعد Email وemail عمودين مختلفين. وإذا اختلفت حالة الأحرف فقط فقد تقترح الرسالة الكتابة الموجودة. وتأكد كذلك من أن الصف الأول يحتوي على العناوين.

ماذا أفعل إذا كان الصف الأول يحتوي على بيانات؟

أوقف خيار صف العناوين، فيُعامل كل صف على أنه بيانات. ثم اختر العمود بموضعه بدءًا من 0، لأنه لن تكون هناك أسماء للأعمدة.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/csv-select-column

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

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

curl -X POST https://api.kit.forhosting.com/str/csv-select-column \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,email,role\nAda,ada@example.com,admin\nBob,bob@example.com,user","column":"email"}'

const res = await fetch("https://api.kit.forhosting.com/str/csv-select-column", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "name,email,role\nAda,ada@example.com,admin\nBob,bob@example.com,user",
    "column": "email"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/csv-select-column",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "name,email,role\nAda,ada@example.com,admin\nBob,bob@example.com,user",
    "column": "email"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/csv-select-column", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"name,email,role\\nAda,ada@example.com,admin\\nBob,bob@example.com,user","column":"email"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"name,email,role\nAda,ada@example.com,admin\nBob,bob@example.com,user","column":"email"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/csv-select-column", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "csv": "name,email,role\nAda,ada@example.com,admin\nBob,bob@example.com,user",
  "column": "email"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

ملاحظات تقنية

يعمل ودجت المتصفح المجاني بالكامل على جهازك؛ وتفرض واجهة API المدفوعة مسبقًا $0.002 لكل عنصر ناجح عندما تحتاج الخوادم وSDK نفس العقد الحتمي.

معنى استخراج عمود CSV ومتى يُستخدم

عندما يكون has_header صحيحًا يوفّر الصف الأول أسماء الأعمدة ويُستبعد من مصفوفة values المُعادة؛ وعندما يكون خطأً فكل صف بيانات ويجب الاختيار بفهرس رقمي. لا تستخدمها لتصفية الصفوف بشرط أو دمج ملفين أو إعادة تسمية أعمدة كثيرة أو تحويل جدول كامل إلى JSON متداخل — فتلك نوايا منتج منفصلة بصفحاتها.

عقد الإدخال والاختيار بالرأس أو الفهرس وحقول الاستجابة

الفاصل الاختياري delimiter هو الفاصلة افتراضيًا؛ استخدم حرفًا واحدًا أو الصيغة الشائعة "\t" للجدولة. مطابقة الرأس حسّاسة لحالة الأحرف فـ Email وemail مختلفان؛ وعندما يحلّ اختلاف الحالة وحده التطابق بشكل فريد قد تقترح رسالة الخطأ الإملاء المتاح. أرسل جسم JSON بالحقل النصي الإلزامي csv مساويًا لنص الجدول غير الفارغ وcolumn الإلزامي مساويًا لاسم رأس أو فهرس صحيح صفري (كرقم أو سلسلة رقمية خالصة مثل "0"). تُقبل الأسماء البديلة text وinput وdata وsource وcontent وvalue لجسم CSV؛ وcol وfield وindex وname للمحدد. القيمة الافتراضية لـ has_header هي true؛ اجعلها false عندما يكون الصف الأول بيانات فعلًا. غياب csv أو فراغه أو كونه غير نص، وغياب column، وأسماء الرؤوس المجهولة، والفهارس السالبة أو خارج النطاق، والحقول المقتبسة غير المغلقة ترفع invalid_input برسالة تسمّي المشكلة، ولا تُحاسب تلك الإخفاقات على API المدفوعة مسبقًا. عند النجاح تتضمن الاستجابة column كتسمية محلولة، وcolumn_index كموضع صفري مستخدم، وvalues كسلاسل الخلايا المرتبة (سلسلة فارغة للصفوف القصيرة بلا تلك الخلية)، وcount مساويًا لطول values، وhas_header وdelimiter يعكسان الوضع، وrow_count كعدد صفوف البيانات، وmethod دائمًا csv_select_column، وheaders بأسماء الصف الأول فقط عندما يكون has_header صحيحًا — تُحذف الحقول الاختيارية بدل null. استخدم values وحدها عندما تحتاج قائمة بريد العمود فقط؛ واستخدم headers وcolumn_index عند بناء جداول واجهة تبرز الحقل المختار.

استخدام API والتسعير ومسارات العمل والحدود العملية

استخدم API KIT المدفوعة مسبقًا عندما يحتاج نظام إدارة محتوى أو خطوة ETL أو منصة QA أو تطبيق تعليم أو عميل جوال نفس العقد برصيد $0.002 لكل عنصر ناجح؛ ولا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك. مسار نموذجي يلصق تصديرًا ويختار عمود email مع has_header true ثم يمرّر values إلى بريد أو خطوة إزالة تكرار. يمكن لمؤلفي SDK توثيق csv وcolumn كإلزاميين، وعرض مثال نجاح برأس مسمّى ومثال خطأ لعمود مفقود ليرى المكاملون جانبي العقد. أبقِ الحمولات بأحجام مستندات عادية تلائم عزل Worker لا مكبات مستودع متعددة الميجابايت.

أسئلة تقنية

ماذا يحدث إذا كان اسم الرأس خاطئًا؟

تفشل الطلبات بـ invalid_input وتسرد الرؤوس المتاحة. المطابقة حسّاسة لحالة الأحرف؛ ولا تُحاسب إخفاقات التحقق على API المدفوعة مسبقًا.

هل أداة استخراج عمود CSV مجانية؟

تعمل أداة المتصفح مجانًا على جهازك. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بمبلغ $0.002 لكل عنصر ناجح.

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

شغّل الأداة مجانًا

مثال محلول

معنى استخراج عمود CSV ومتى يُستخدم

كيف تستخرج عمودًا وما حدود الأداة

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

قوائم بريد من تصديرات CRM

معرّفات تثبيت للاختبارات

أعمدة درجات لسجلات الصف

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

معنى استخراج عمود CSV ومتى يُستخدم

عقد الإدخال والاختيار بالرأس أو الفهرس وحقول الاستجابة

استخدام API والتسعير ومسارات العمل والحدود العملية

أسئلة تقنية

شكرًا