INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

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を作る操作はありません。

sql/monthly_report.sqlの差分:−は削除、+は追加
 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行で、変更の影響を確かめる

approvedに加えてJPを要求するとどうなる?
レポートapprovalregion変更前変更後
R-AapprovedJP対象対象
R-BapprovedUS対象対象外
R-CpendingJP対象外対象外

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行について説明できることを優先します。

人のレビューと、自動検査を分ける

PRで読む場所と、確かめること
表示確認すること
Files changedどの行を、どう変えたか
Conversation目的・質問・合意した条件は何か
Commits提案した変更の履歴はどれか
Checksどの対象へ、どんな検査が報告されたか

レビューのCommentは意見、Approveは取り込みを支持する判断、Request changesは修正要求です。自動検査の成功とは別です。例えば「構文を検査できた」だけでは、USの行を除いてよいという合意にはなりません。checksはActions以外の連携サービスから報告されることもあります。

必要な承認数、必須の検査、保護の例外はリポジトリの設定・権限・利用プランに依存します。Approveボタンが押されたことだけでマージできるとは限りません。承認後に変更が加わったら、現在の差分と承認の有効性を見直します。古い承認を自動で失効させるかも設定次第です。

どの変更を検査したかを追う

提案から取り込みへ:レビューと検査は別の確認
B → H
変更前と提案を比べる

Bは共通祖先、Hは提案の先端。この例ではmainもB。

REVIEW / H
意図と影響をレビュー

R-Bを除いてよいか、人が要件と差分を検討する。

CHECK / T
取り込み結果を検査

Tは検査用の合成revision。提案Hそのものとは区別する。

MERGE / M
条件を確認して取り込む

最新の差分・承認・検査を確認。結果をMと呼ぶ。

AFTER MERGE
成果物・配信・動作を確認

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や配信済み成果物の検査へ読み替えないようにします。

マージの後は、何を確認する?

  1. 取り込み結果Mを特定する。merge commit・squash・rebaseなどの方式によって、履歴の作られ方は違う。
  2. Mから成果物を作り、その入力を記録する。この例の成果物名はreport-sql-bundle@Mという架空名。
  3. 意図したステージングへ、その成果物を送ったかを確認する。mainへの取り込みだけでは配信済みにならない。
  4. 配信先から読み出し、利用者が期待する結果を返すかを確認する。転送の成功だけで業務上の正常性を決めない。

差分・判断・検査を区別してみる

選択すると、正誤と理由が表示されます。

approvedに加えregion = JPを要求すると、3行の例で対象から外れるのは?
答えと理由を読む

正解:R-B:approved / US。 · R-Bは変更前に含まれますが、新しいregion条件を満たしません。

HをApproveした後、提案側へ追加の変更が入りました。次に確かめるのは?
答えと理由を読む

正解:現在の差分、承認の有効性と最新の検査対象。 · 以前の判断が新しい変更を覆うとは限りません。承認失効の自動化は設定次第です。

この例の通常のpull_request検査対象Tと提案Hについて正しいのは?
答えと理由を読む

正解:別の対象。実際にcheckoutしたrevisionも確認する。 · 開いたmerge可能PRの既定の検査用refとhead.shaは区別します。

チェックが成功しただけでは確認できないものは?
答えと理由を読む

正解:取り込み後の成果物が配信され、利用者の期待どおり動くこと。 · ビルド・配信・動作確認は、それぞれの工程で確かめます。

確認して、自分の言葉で説明する

  1. SQLのAND条件で新たに除かれる行を説明する。
  2. レビューで聞く要件の質問を、一つ書く。
  3. 提案H・検査T・取り込み後Mを、同じ対象だと思い込んでいないか確かめる。
理解を確かめる: 「承認されてチェックも成功。もう利用者へ届いている」と言える?

いいえ。取り込み・ビルド・配信・利用時の動作を別に確かめます。

人の判断と特定対象の検査結果は、後段の工程を実施した証拠にはならないからです。

出典と確認した条件

説明に用いた一次資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実環境での検証は行っていません。