Kimlik Doğrulama

Özel veya kısıtlı veri setlerine erişmek için önce kimlik doğrulamanız gerekir. Kimlik doğrulama, kısıtlı ve özel veri setlerine erişiminizi doğrulamak ve yetkilendirmek için kullanılacak bir erişim belirteci (access token) sağlayarak çalışır. İlk adım, hesabınız için bir erişim belirteci oluşturmaktır. Bunu Hugging Face Ayarları - Belirteçler sayfasını ziyaret ederek yapabilirsiniz.

Token'ı sağlamak için üç yol vardır: bir ortam değişkeni ayarlamak, okuyucuya bir parametre geçirmek veya Hugging Face CLI'ı kullanmak.

Ortam değişkeni

Ortam değişkeni HF_TOKEN'yi ayarlarsanız, Polars, Hugging Face'ten veri setleri isterken bunu otomatik olarak kullanır.

export HF_TOKEN="hf_xxxxxxxxxxxxx"

Parametreler

Ayrıca, erişim belirtecini storage_options parametresi aracılığıyla okuyucuya (ör. read_parquet) açıkça sağlayabilirsiniz. Tüm parametrelerin kapsamlı bir özetini görmek için API referans kılavuzuna göz atın.

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

CLI

Alternatif olarak, kimlik doğrulama için Hugging Face CLI kullanabilirsiniz. hf auth login ile başarıyla oturum açtıktan sonra bir erişim jetonu, varsayılan olarak ~/.cache/huggingface olan HF_HOME dizininde saklanır. Polars, kimlik doğrulama için bu jetonu kullanır.

Birden fazla yöntem belirtilirse, aşağıdaki sıraya göre önceliklendirilirler:

• Parametreler (storage_options)
• Ortam değişkeni (HF_TOKEN)
• CLI