跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何讓 StackQL 向 GitHub 進行驗證

StackQL 使用基本驗證向 GitHub 進行驗證:您的 GitHub 使用者名稱與個人存取權杖(PAT),以 STACKQL_GITHUB_USERNAME 與 STACKQL_GITHUB_PASSWORD 提供。公開資料無需任何憑證即可查詢,但適用 GitHub 的未驗證速率限制。

步驟​

  1. 在 GitHub 中建立個人存取權杖(Settings -> Developer settings)。只授予您的查詢所需的範圍:若要以較高的速率限制查詢公開資料,不需要任何範圍;私人存放庫則需要 repo。

  2. 匯出憑證:

export STACKQL_GITHUB_USERNAME=yourghuser
export STACKQL_GITHUB_PASSWORD=ghp_yourgithubpersonalaccesstoken
  1. 提取 GitHub Provider(僅首次使用時):
REGISTRY PULL github;
  1. 以查詢確認:
SELECT name, description, language, stargazers_count
FROM github.repos.repos
WHERE org = 'stackql';

org 述詞會選取 list_for_org 存取方法;WHERE username = '...' 則會改為選取 list_for_user。SHOW METHODS IN github.repos.repos 會列出每個方法及其必要參數,包括變更方法(create_in_org、update、delete)。

未驗證存取​

上述查詢無需憑證即可運作,因為 stackql 組織是公開的,這對於評估,以及讓代理程式在佈建憑證之前探索查詢模型都很有用。GitHub 的未驗證速率限制很低(每個 IP 每小時 60 個要求),因此任何持續性的使用都應進行驗證。