GITHUB · 入門
GitHubのPull Request入門:SQLの差分・レビュー・検査・マージ
Pull Request(PR)は、変更を別のブランチへ取り込む提案です。1行の条件追加で、今まで読めたレポートが対象から外れる例を使います。差分の意味を読み、人のレビュー・自動検査・マージの役割を、このページの中で順に確かめます。
変更の影響を3行のデータから説明し、どの変更をレビュー・検査・取り込みしたのかを区別できる。
コミットは履歴の記録、ブランチは履歴上の位置を指す名前です。SQLはデータへ条件を付ける文。今回使うWHEREとANDの意味も本文で説明します。
まず、何が変わったかを読む
架空のリポジトリdemo-acme/report-infraで、mainへfeature/jp-report-filterの変更を提案するPR #42を考えます。baseは取り込み先、headは提案する側です。実際のGitHubアカウントやPRを作る操作はありません。
SELECT report_id, report_month
FROM reports
-WHERE approval = 'approved';
+WHERE approval = 'approved'
+ AND region = 'JP';SELECTは返す列、FROMは読む表、WHEREは行を選ぶ条件です。変更前は「approvalがapproved」、変更後は「approved、かつregionがJP」を要求します。ANDは両方の条件を満たすという意味です。行を読むSQLの条件変更であり、ここで表のデータを更新するわけではありません。
3行で、変更の影響を確かめる
| レポート | approval | region | 変更前 | 変更後 |
|---|---|---|---|---|
| R-A | approved | JP | 対象 | 対象 |
| R-B | approved | US | 対象 | 対象外 |
| R-C | pending | JP | 対象外 | 対象外 |
R-Bが新たに対象から外れます。 R-Aは両方の条件を満たし、R-Cは最初からapprovedではありません。変更前の結果集合はR-AとR-B、変更後はR-Aだけです。全行のreport_monthは2026-09と仮定しますが、このSQLに月の条件はありません。ORDER BYもないので、返る順序は約束していません。
レビューでは「R-Bを除くと、USのレポートを必要とする利用者が困らないか?」と聞きます。変更が小さくても影響が小さいとは限りません。実データへ進むならNULLの扱い、文字列比較の条件、月の範囲、結果を使う場所も確認が必要です。まず今回の3行について説明できることを優先します。
人のレビューと、自動検査を分ける
| 表示 | 確認すること |
|---|---|
| Files changed | どの行を、どう変えたか |
| Conversation | 目的・質問・合意した条件は何か |
| Commits | 提案した変更の履歴はどれか |
| Checks | どの対象へ、どんな検査が報告されたか |
レビューのCommentは意見、Approveは取り込みを支持する判断、Request changesは修正要求です。自動検査の成功とは別です。例えば「構文を検査できた」だけでは、USの行を除いてよいという合意にはなりません。checksはActions以外の連携サービスから報告されることもあります。
必要な承認数、必須の検査、保護の例外はリポジトリの設定・権限・利用プランに依存します。Approveボタンが押されたことだけでマージできるとは限りません。承認後に変更が加わったら、現在の差分と承認の有効性を見直します。古い承認を自動で失効させるかも設定次第です。
どの変更を検査したかを追う
Bは共通祖先、Hは提案の先端。この例ではmainもB。
R-Bを除いてよいか、人が要件と差分を検討する。
Tは検査用の合成revision。提案Hそのものとは区別する。
最新の差分・承認・検査を確認。結果をMと呼ぶ。
M由来の成果物を作り、配信先と利用時の動作を別に確認する。
矢印は検討する工程です。成功済みの記録ではありません。B・H・T・Mは説明用の名前で、実コミットのハッシュではありません。
GitHubのPRは通常、共通祖先(merge base)から提案側の先端までの差分を示します。この例はBを共通祖先と固定しています。取り込み先の現在の先端と、差分の基準が常に同じとは限りません。mainが進んだときは、何を比較・検査したかを確かめます。
通常の開いたマージ可能PRでpull_requestイベントの既定refを検査する場合、対象はGitHubが作るマージ検査用のrevisionです。この例ではTと呼びます。GITHUB_SHAと、提案の先端を示すgithub.event.pull_request.head.shaは区別します。checkoutの指定を変えた場合や別イベントの検査まで、Tと決めつけません。
提案やmainが更新されれば、検査用の対象も変わり得ます。Tの検査を通ったという記録を、将来の取り込み結果Mや配信済み成果物の検査へ読み替えないようにします。
マージの後は、何を確認する?
- 取り込み結果Mを特定する。merge commit・squash・rebaseなどの方式によって、履歴の作られ方は違う。
- Mから成果物を作り、その入力を記録する。この例の成果物名はreport-sql-bundle@Mという架空名。
- 意図したステージングへ、その成果物を送ったかを確認する。mainへの取り込みだけでは配信済みにならない。
- 配信先から読み出し、利用者が期待する結果を返すかを確認する。転送の成功だけで業務上の正常性を決めない。
差分・判断・検査を区別してみる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- SQLのAND条件で新たに除かれる行を説明する。
- レビューで聞く要件の質問を、一つ書く。
- 提案H・検査T・取り込み後Mを、同じ対象だと思い込んでいないか確かめる。
理解を確かめる: 「承認されてチェックも成功。もう利用者へ届いている」と言える?
いいえ。取り込み・ビルド・配信・利用時の動作を別に確かめます。
人の判断と特定対象の検査結果は、後段の工程を実施した証拠にはならないからです。
出典と確認した条件
説明に用いた一次資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実環境での検証は行っていません。
確認した内容・条件変更提案、PRの各表示と検査用ref。現在のbase先端と共通祖先の違い。 公式資料の確認であり、実環境の検証ではありません。
参照した本文まず、何が変わったかを読む 人のレビューと、自動検査を分ける マージの後は、何を確認する? 差分・判断・検査を区別してみる
確認した内容・条件Comment・Approve・Request changesの意味。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件プラン・公開範囲と保護設定による必須検査・承認、古い承認の扱い。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件PRのthree-dot差分は共通祖先と提案側の先端を比較する。現在のbase先端との差を直接比較するtwo-dotとは区別。 公式資料の確認であり、実環境の検証ではありません。
参照した本文どの変更を検査したかを追う
確認した内容・条件開いたマージ可能PRのpull_requestで、既定の検査用refとhead.shaを区別。別イベント・checkout指定の変更は別途確認。 公式資料の確認であり、実環境の検証ではありません。
参照した本文どの変更を検査したかを追う 差分・判断・検査を区別してみる
確認した内容・条件非信頼コードと特権処理、secret、第三者action、self-hosted runnerの残存状態。 公式資料の確認であり、実環境の検証ではありません。
参照した本文マージの後は、何を確認する?