翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何讓 StackQL 向 GitHub 進行驗證
StackQL 使用基本驗證向 GitHub 進行驗證:您的 GitHub 使用者名稱與個人存取權杖(PAT),以 STACKQL_GITHUB_USERNAME 與 STACKQL_GITHUB_PASSWORD 提供。公開資料無需任何憑證即可查詢,但適用 GitHub 的未驗證速率限制。
步驟
-
在 GitHub 中建立個人存取權杖(Settings -> Developer settings)。只授予您的查詢所需的範圍:若要以較高的速率限制查詢公開資料,不需要任何範圍;私人存放庫則需要
repo。 -
匯出憑證:
export STACKQL_GITHUB_USERNAME=yourghuser
export STACKQL_GITHUB_PASSWORD=ghp_yourgithubpersonalaccesstoken
- 提取 GitHub Provider(僅首次使用時):
REGISTRY PULL github;
- 以查詢確認:
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 個要求),因此任何持續性的使用都應進行驗證。
相關概念
- 如何使用 StackQL 查詢 GitHub 存放庫:完整的查詢模式
- 如何讓 StackQL 向 AWS 進行驗證:AWS 的對應做法
- 什麼是 SQL for APIs?:REST 作業如何對應到 SQL 動詞
- 開始使用 StackQL:GitHub 是最快的免憑證起點
- 常見 StackQL 錯誤:包括速率限制的徵兆