データベースレビュアーガイドライン
このページには、新しいデータベースレビュアー向けの入門資料が含まれています。
アプリケーションアップデートのレビューに興味がある方は、データベースレビューガイドラインをご覧ください。
データベースレビュアーによる作業範囲
データベースレビュアーは、データベース、SQL
、クエリパフォーマンスの最適化に関する豊富な経験を持つドメインエキスパートです。
データベースのレビュアーは、アプリケーションの更新がデータベースに触れるたびに必要です。
データベースのレビュアーは、データベース固有のアップデートをレビューし、GitLab.comのスケールでクエリや変更が問題なく実行されることを確認するのが仕事です。
データベースレビュープロセスの詳細については、データベースレビューガイドラインをご覧ください。
データベースレビュアーへの応募方法
チームメンバーは、プロフィールYAMLファイルに追加することで、データベースドメインの専門家であることを自認することが推奨されます:
-
Database reviewer
テンプレートを使ってマージリクエストを行ってください。 -
データベースの専門知識をYAMLファイルに追加します:
projects: gitlab: - reviewer database
- データベースレビュアー」テンプレートを使ってマージリクエストを作成します。
- データベースメンテナーまたはデータベースチームのエンジニアリングマネージャーに割り当てます。
team.yml
の更新がマージされた後、レビュアー ルーレットがあなたをデータベース レビュアーとして推薦することがあります。
データベースレビュアー向けリソース
データベースのレビュアーとして、内部#database
Slack チャンネルに参加し、他のデータベースのレビュアーやメンテナーと、データベースに関連する問題について質問やディスカッションを行ってください。
また、オプションとして隔週で開催されるデータベースオフィスアワーコールがあります。ヨーロッパ/米国とアジア太平洋地域の(APAC) フレンドリーアワーが交互に開催されます。オフィスアワーコールに参加して、データベースのレビュアーやメンテナーの間でより深い議論が必要なトピックを持ち寄ることができます:
postgres.aiのDatabase Labは、開発者に本番データベースのクローンを提供するボットです。
EXPLAIN
プランを理解し、効率的に使用することは、データベースレビュープロセスの中核です。以下のガイドは、簡単な紹介と、より高度なトピックに関するリンクを提供します:
- EXPLAIN計画を理解するためのガイド。
-
depesz
における説明不可能なシリーズの説明。
また、The Art of PostgreSQLへのライセンスアクセスもあります。GitLab チームメンバーがアクセスすることに興味があれば、こちらのイシューをご覧ください:https://gitlab.com/gitlab-org/database-team/team-tasks/-/issues/23
。
最後に、データベースガイドのページでは、より具体的なトピックやユースケースを扱った様々なガイドを見つけることができます。データベースのレビュー中に最も頻繁に必要とされるのは、以下のようなものです:
- 安全なSQLマイグレーションを作成するためのマイグレーションスタイルガイド。
- マイグレーションにおけるダウンタイムの回避
- SQLクエリに関するガイドライン
- データベースマイグレーションでJiHuが貢献するためのガイドライン
データベースメンテナーの申請方法
データベースのメンテナーは、他のプロジェクトと同じプロセスで決定されます。ここに書かれている一般的な手順に従ってください。
データベース固有の要件についてはProject maintainer process for gitlab-database
圧倒されそうなときの対処法
すべての種類のレビューと同様に、他の人のブロックを解除することが常に最優先です。データベースのレビュアーは、割り当てられたマージリクエストをタイムリーにレビューするか、できるだけ早く作成者に知らせ、別のレビュアーやメンテナーを見つける手助けをすることが期待されています。
私たちは GitLab チームの他のメンバーを助けるためにレビューを行っています。同時に、より多くのユースケースに触れ、多くのインサイトを得て、データベースやデータ管理のスキルを磨いています。
もしあなたが圧倒されているように感じ、定員に達していると考え、いくつかのレビューが完了するまでこれ以上レビューを受け付けることができない場合は、GitLabのステータスに:red_circle:
の絵文字を設定し、ステータスのテキストに定員に達していることを記載してください。