跳至主要內容
翻譯頁面

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

如何使用 StackQL 查詢 GitHub 存放庫

GitHub 存放庫以資料表 github.repos.repos 的形式公開。依組織或使用者列出存放庫,會對應到相應的 GitHub REST 作業,並由 WHERE 子句選擇:org = '...' 使用依組織列出的作業,username = '...' 使用依使用者列出的作業。

必要條件​

列出組織的存放庫​

SELECT name, description, language, stargazers_count
FROM github.repos.repos
WHERE org = 'stackql';

對公開的 stackql 組織執行時,此查詢會傳回 stackql 引擎存放庫(Go,撰寫本文時有 861 顆星)和 stackql-provider-registry 等資料列,這些都是即時 API 資料,不涉及任何快照。

依存放庫屬性篩選​

標準 SQL 述詞可套用至任何資料行:

SELECT name, visibility, default_branch, archived
FROM github.repos.repos
WHERE org = 'my-org'
AND archived = false
AND visibility = 'public';

實用的治理資料行包括 private、visibility、archived、fork、default_branch、delete_branch_on_merge、has_wiki、topics、created_at、pushed_at 和 security_and_analysis。DESCRIBE github.repos.repos 會列出所有資料行。

存放庫清單之外​

github.repos 服務將存放庫的其餘介面公開為同層級的資料表:github.repos.branches、github.repos.commits、github.repos.releases、github.repos.collaborators、github.repos.webhooks、github.repos.deployments 等。使用下列陳述式探索這些資料表:

SHOW RESOURCES IN github.repos;

更新存放庫​

變更存放庫設定使用 UPDATE 陳述式;此方法需要 owner 和 repo,本文欄位使用 data__ 前置詞:

UPDATE github.repos.repos
SET data__delete_branch_on_merge = true
WHERE owner = 'my-org' AND repo = 'my-repo';

將其套用至清單查詢的結果集,只需兩個陳述式即可治理所有存放庫。這種模式很適合搭配將 GitHub 資料與雲端資源聯結的跨 Provider 查詢。