المصادقة

للوصول إلى مجموعات البيانات الخاصة أو المحمية، يجب عليك المصادقة أولاً. تعمل المصادقة من خلال تقديم رمز وصول (access token) يُستخدم للمصادقة على هويتك وتفعيل وصولك إلى مجموعات البيانات المحمية والخاصة. الخطوة الأولى هي إنشاء رمز وصول لحسابك. يمكن القيام بذلك بزيارة Hugging Face Settings - Tokens.

هناك ثلاث طرق لتوفير الرمز: تعيين متغير بيئة، أو تمرير معامل إلى القارئ، أو استخدام سطر أوامر Hugging Face.

متغير البيئة

إذا قمت بتعيين متغير البيئة HF_TOKEN، فسيستخدم Polars هذا المتغير تلقائياً عند طلب مجموعات البيانات من Hugging Face.

export HF_TOKEN="hf_xxxxxxxxxxxxx"

المعاملات

يمكنك أيضًا تقديم رمز الوصول (access token) بشكل صريح إلى القارئ (مثل read_parquet) من خلال معامل storage_options. للحصول على نظرة شاملة على جميع المعاملات، راجع دليل مرجع الواجهة البرمجية.

pl.read_parquet(
    "hf://datasets/roneneldan/TinyStories/data/train-*.parquet",
    storage_options={"token": ACCESS_TOKEN},
)

سطر الأوامر

بديلًا عن ذلك، يمكنك استخدام Hugging Face CLI للمصادقة. بعد تسجيل الدخول بنجاح باستخدام hf auth login، سيتم تخزين رمز وصول في مجلد HF_HOME الذي يكون افتراضيًا ~/.cache/huggingface. ثم سيقوم Polars باستخدام هذا الرمز للمصادقة.

إذا تم تحديد عدة طرق، فإنها تُعطى الأولوية بالترتيب التالي:

• المعاملات (storage_options)
• متغير البيئة (HF_TOKEN)
• سطر الأوامر