Autenticação para conjuntos de dados privados e restritos

Para acessar conjuntos de dados privados ou restritos, você precisa configurar seu Token do Hugging Face no DuckDB Secrets Manager.

Acesse Hugging Face Settings - Tokens para obter seu token de acesso.

Se você consultar por meio de hf datasets sql, o segredo do token é configurado automaticamente a partir da sua sessão conectada (ou --token) — não é necessário configurar o segredo manualmente.

O DuckDB suporta dois provedores para gerenciar segredos:

• CONFIG: Exige que o usuário passe todas as informações de configuração para a instrução CREATE SECRET.
• CREDENTIAL_CHAIN: Tenta automaticamente obter as credenciais. Para o token do Hugging Face, ele tentará obtê-lo em ~/.cache/huggingface/token.

Para mais informações sobre DuckDB Secrets, visite o guia Secrets Manager.

Criando um segredo com o provedor CONFIG

Para criar um segredo usando o provedor CONFIG, use o seguinte comando:

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

Substitua your_hf_token pelo seu token real do Hugging Face.

Criando um segredo com o provedor CREDENTIAL_CHAIN

Para criar um segredo usando o provedor CREDENTIAL_CHAIN, use o seguinte comando:

CREATE SECRET hf_token (TYPE HUGGINGFACE, PROVIDER credential_chain);

Este comando recupera automaticamente o token armazenado em ~/.cache/huggingface/token.

Primeiro, você precisa fazer login com sua conta do Hugging Face, por exemplo, usando:

hf auth login

Alternativamente, você pode definir seu token do Hugging Face como uma variável de ambiente:

export HF_TOKEN="hf_xxxxxxxxxxxxx"

Para mais informações sobre autenticação, consulte a documentação de autenticação do Hugging Face.