Authentification pour les jeux de données privés et contrôlés

Pour accéder aux jeux de données privés ou protégés, vous devez configurer votre jeton Hugging Face dans le gestionnaire de secrets de DuckDB.

Accédez à Hugging Face Settings - Tokens pour obtenir votre jeton d'accès.

Si vous effectuez une requête via hf datasets sql, le secret du jeton est configuré automatiquement à partir de votre session connectée (ou --token) — aucune configuration manuelle du secret n'est nécessaire.

DuckDB prend en charge deux fournisseurs pour la gestion des secrets :

• CONFIG : Exige que l'utilisateur transmette toutes les informations de configuration dans l'énoncé CREATE SECRET.
• CREDENTIAL_CHAIN : essaie automatiquement de récupérer les identifiants. Pour le jeton Hugging Face, il tentera de le récupérer depuis ~/.cache/huggingface/token.

Pour plus d'informations sur les secrets DuckDB, consultez le guide Secrets Manager.

Créer un secret avec le fournisseur CONFIG

Pour créer un secret à l'aide du fournisseur CONFIG, utilisez la commande suivante :

CREATE SECRET hf_token (TYPE HUGGINGFACE, TOKEN 'your_hf_token');

Remplacez your_hf_token par votre jeton Hugging Face réel.

Créer un secret avec le fournisseur CREDENTIAL_CHAIN

Pour créer un secret à l'aide du fournisseur CREDENTIAL_CHAIN, utilisez la commande suivante :

CREATE SECRET hf_token (TYPE HUGGINGFACE, PROVIDER credential_chain);

Cette commande récupère automatiquement le jeton stocké dans ~/.cache/huggingface/token.

Tout d'abord, vous devez vous connecter avec votre compte Hugging Face, par exemple en utilisant :

hf auth login

Sinon, vous pouvez définir votre jeton Hugging Face en tant que variable d’environnement :

export HF_TOKEN="hf_xxxxxxxxxxxxx"

Pour plus d'informations sur l'authentification, consultez la documentation authentification Hugging Face.