ブランチを管理する
ベータ版
Lakebase Postgres (オートスケール Beta) は、 Lakebase の次のバージョンであり、評価のみに利用できます。 本番運用ワークロードの場合は、 Lakebase Public Previewを使用します。 どのバージョンが適しているかを判断するには、バージョンの選択を参照してください。
データベース ブランチを作成および管理して、さまざまな開発ワークフロー、テスト シナリオ、本番運用環境をサポートします。 ブランチを使用すると、本番運用に影響を与えることなく、分離されたデータベース環境で作業できます。
親子関係、コピーオンライトストレージ、ブランチ戦略など、データベース ブランチの仕組みの詳細については、 「データベース ブランチ」を参照してください。次のセクションでは、ブランチを作成および管理する手順に焦点を当てます。
支店概要
Lakebase Postgres のブランチは、コピーオンライトを通じて親ブランチとストレージを共有する独立したデータベース環境です。ブランチを使用すると次のことが可能になります。
- 分離された開発環境とテスト環境を作成する
- 現実的なデータセットに対してアプリケーションをテストする
- データベース開発ワークフローを実装する
ブランチを作成する
ブランチを作成するときは、特定のニーズに応じていくつかのオプションから選択できます。各オプションは、異なるデータ特性とユースケースを持つブランチを作成します。
ブランチを作成するには:
-
Lakebase アプリでプロジェクトの ブランチ ページに移動します。
-
「ブランチの作成」 をクリックし、ブランチ オプションを構成します。
- わかりやすいブランチ名を入力してください
- 希望するブランチタイプ（現在のデータまたは過去のデータ）を選択します
- オプションで、「次の時間 が経過したらブランチを期限切れにする」 をチェックし、プリセット (1 時間、1 日、または 7 日) を選択して、自動削除の有効期限を設定します。詳細については、ブランチの有効期限を参照してください。
- 選択したオプションの追加設定を構成します
-
「作成」 をクリックしてブランチを作成します。
ブランチ作成オプション
ユースケースに最適なオプションを選択してください。
オプション | 説明 |
|---|---|
現在のデータ | 親ブランチの最新の状態からブランチを作成します。開発、現在のデータを使用したテスト、機能ブランチに最適です。 |
過去のデータ | 復元ウィンドウ内の特定の時点からブランチを作成します。ポイントインタイムリカバリ、履歴分析、ロールバックシナリオ、タイムトラベルクエリに最適です。日付ピッカーを使用して、希望する時点を選択します。 |
ブランチの有効期限
ブランチの有効期限により、ブランチに自動削除タイムスタンプを設定できます。ブランチの有効期限が切れると、自動的に削除されます。この機能は、一時的なブランチを管理し、ストレージ コストを削減するのに役立ちます。
ブランチの有効期限を使用する理由
ブランチの有効期限は、存続期間が予測可能な一時ブランチに最適です。
- CI/CD 環境: パイプラインの完了後にクリーンアップする必要があるブランチをテストします。
- 機能開発: 期限がわかっている、時間制限のある機能ブランチ。
- 自動テスト: スクリプトによって作成された一時的なテスト環境。
- 開発ワークフロー: 無期限に存続する必要のない一時的な環境。
自動的に期限切れにならないと、これらのブランチは時間の経過とともに蓄積され、ストレージ コストが増加し、プロジェクトが乱雑になります。
有効期限の例: CI/CD パイプライン (2 ～ 4 時間)、デモ (24 ～ 48 時間)、機能開発 (1 ～ 7 日間)、長期テスト (30 日間)。
ブランチの有効期限の仕組み
ブランチの有効期限には、Time-To-Live (TTL) モデルが使用されます。ブランチに有効期限を設定すると、自動的に削除されるまでのブランチの存在期間が定義されます。
ブランチに有効期限のタイムスタンプを設定する場合:
- システムは、有効期限のタイムスタンプ（ブランチが削除される予定の日時）とTTL間隔（作成または更新から有効期限までの期間）の両方を保存します。
- バックグラウンドプロセスはブランチを監視し、有効期限が切れるとブランチを削除します。
- 親からブランチをリセットすると、TTLのカウントダウンは元の間隔で再開されます。
ブランチの削除は永続的であり、回復することはできません。関連するすべてのデータとコンピュート リソースも削除されます。 有効期限を設定する前に慎重に確認してください。
ブランチの有効期限を設定する
ブランチを作成するときに有効期限のタイムスタンプを設定したり、後で更新したりできます。
ブランチを作成するとき
- Lakebase アプリでプロジェクトの ブランチ ページに移動します。
- [ブランチの作成] をクリックし、ブランチ オプションを構成し、 [ブランチの有効期限をオンにする] をオンに してプリセット (1 時間、1 日、または 7 日) を選択します。
- 作成 をクリックします。
ブランチの有効期限の更新
既存のブランチの有効期限タイムスタンプを更新または削除するには:
- Lakebase アプリでプロジェクトの ブランチ ページに移動します。
- クリック
ブランチの横にあるメニューをクリックし、 [有効期限の更新] を選択します。 - 新しい日時を選択するか、 「Expire branch on」の チェックを外して有効期限を削除し、 「Save」 をクリックします。
ブランチの有効期限を表示
ブランチに有効期限が設定されているかどうかを確認するには、プロジェクトの ブランチ ページに移動し、目的のブランチをクリックします。有効期限情報はブランチの詳細に表示されます。
ブランチの有効期限制限
システムの整合性を維持するために、有効期限のタイムスタンプを次のものに追加することはできません。
- 保護されたブランチ: 保護されたブランチを期限切れにしたり、有効期限が切れたブランチを保護したりすることはできません。
- 大丈夫ブランチ: 大丈夫ブランチを期限切れにしたり、期限切れになるブランチを安全として設定したりすることはできません。
- 親ブランチ: 子を持つブランチを期限切れにしたり、期限切れになるブランチから子を作成したりすることはできません。
ブランチの有効期限が切れて削除されると、関連するすべてのコンピュート リソースも削除されます。 重要なワークロードが有効期限前に移行されていることを確認します。
最大有効期限
最大有効期限は現在時刻から 30 日間です。ブランチを 30 日間以上存続させる必要がある場合は、有効期限が切れる前に有効期限のタイムスタンプを更新して、ブランチの存続期間を延長することができます。
ブランチを表示
Lakebase プロジェクト内のすべてのブランチを表示するには、Lakebase アプリでデータベース プロジェクトを選択し、左側のナビゲーションで [ ブランチ] に移動します。
ブランチ テーブルには、各ブランチに関する重要な情報が表示されます。
ブランチ ページには、プロジェクト内の各ブランチに関する情報を含む包括的な表が表示されます。
列 | 説明 |
|---|---|
ブランチ | ブランチ名。大丈夫のブランチには「大丈夫」というラベルが表示されます。 |
親 | このブランチが作成された親ブランチを示し、ブランチ階層を追跡するのに役立ちます。 |
活動時間 | ブランチのコンピュートがアクティブであった時間数。 |
プライマリコンピュート | ブランチのコンピュートの現在のコンピュート サイズとステータス (IDLE または ACTIVE など) を表示します。 |
データサイズ | ブランチの論理データ サイズを示します。データサイズには履歴は含まれません。 |
作成者 | ブランチを作成したユーザーまたはサービス。 |
最終アクティブ | ブランチのコンピュートが最後にアクティブであった時期を示します。 |
支店概要
テーブル内の任意のブランチをクリックすると、ブランチの概要ページが表示され、選択したブランチの詳細情報が表示されます。
ブランチ概要ページの上部には、主要なメトリクスやメタデータなどの詳細な情報が表示されます。
フィールド | 説明 |
|---|---|
ID | 一意のブランチ識別子（br-プレフィックス付き） |
作成日 | ブランチが作成された日時 |
コンピュート時間 | ブランチが使用した合計コンピュート時間 |
アクティブ時間 | 特定の日付以降に使用された時間のコンピュート |
データサイズ | ブランチの論理データサイズ（履歴は含まれません） |
作成者 | ブランチを作成したユーザー |
ブランチの概要ページには、ブランチのさまざまな側面を管理するためのいくつかのタブが含まれています。
Tab | 説明 |
|---|---|
コンピュート | ブランチのプライマリ コンピュートを表示および管理します。 「コンピュートの管理」を参照してください。 |
ロールとデータベース | ブランチに関連付けられたデータベース ロールとデータベースを管理します。「データベースの管理」および「ロールの管理」を参照してください。 |
子ブランチ | このブランチから作成されたブランチを表示します |
ブランチスキーマを比較する
変更をマージする前に、子ブランチとその親ブランチ間のスキーマの違いを確認します。スキーマ diff では、テーブル、列、インデックス、制約などの追加、削除、または変更されたデータベース オブジェクトを強調表示する、並べて表示された SQL DDL 比較が表示されます。
ブランチ間でスキーマを比較するには:
-
Lakebase アプリの子ブランチの概要ページに移動します。
-
親ブランチ セクションで、 スキーマ差分 をクリックします。
-
スキーマ相違ダイアログで次の操作を実行します。
- ベース : 比較するベース ブランチを選択します (デフォルトは親ブランチ)。
- データベース : 比較するデータベースを選択します。
- 比較 : ベースと比較するブランチを選択します (デフォルトは現在の子ブランチ)。
-
比較 をクリックします。
差分結果を理解する
スキーマが異なる場合、差分ビューには SQL DDL ステートメントの横並びの比較が表示されます。
赤い線はベース ブランチから削除または変更された内容を示し、緑の線は比較ブランチで追加または変更された内容を示します。diff は、テーブル定義、列、制約、インデックス、およびその他のデータベース オブジェクトへの変更をキャプチャします。
選択したブランチ間に違いがない場合、スキーマが同期されていることを確認する成功メッセージが表示されます。
マージ前の検証、開発の追跡、ドリフトの検出、変更のドキュメント化にはスキーマ diff を使用します。完全な開発ワークフローでスキーマの相違を確認するには、 「チュートリアル: ブランチベースの開発ワークフロー」を参照してください。
スキーマ diff では、データの内容ではなく、データベース スキーマ (DDL) のみを比較します。比較には、両方のブランチから利用可能な最新のデータ (ヘッド) が使用されます。
親からのブランチをリセット
ブランチをリセットすると、親ブランチの最新のスキーマとデータで即座に更新できます。これにより、問題から回復したり、新しい機能の開発を開始したり、環境内のさまざまなブランチを同期させたりすることができます。
シナリオ例
データベース ブランチを操作しているときに、作業ブランチを本番運用ブランチの最新データに更新する必要がある状況に遭遇することがあります。
たとえば、 productionブランチから分岐した 2 つの子ブランチstagingとdevelopmentがあるとします。developmentブランチで作業していたところ、本番運用ではあまりにも古くなっていることがわかりました。
developmentには考慮または保存する必要があるスキーマ変更はありません。必要なのはデータの簡単な更新だけです。1 回の操作で親から最新のデータにクリーンかつ即座にリセットできるため、手動でブランチを作成して復元する煩雑さが省けます。
親からのリセットの仕組み
ブランチを親にリセットすると、データとスキーマは親の最新のデータとスキーマに完全に置き換えられます。
要点:
- ブランチをリセットできるのは、親からの最新のデータのみです。タイムスタンプに基づくポイントインタイム リセットは、ポイントインタイム リストアを使用して実行できます。これは、いくつかの違いがある類似の機能です。ポイントインタイム リストアでは新しいブランチが作成され、開発ワークフローよりもデータの回復を目的としています。
- このリセットは、更新やマージではなく、完全な上書きです。このリセット中に、子ブランチに対して行われたローカルの変更はすべて失われます。
- リセット中は既存の接続が一時的に中断されます。ただし、接続の詳細は変更されません。リセットが完了するとすぐにすべての接続が再確立されます。
- ルート ブランチ (プロジェクトの
productionブランチなど) は、リセットする親ブランチがないためリセットできません。
親からブランチをリセットする
ブランチを親にリセットするには:
- Lakebase アプリでプロジェクトの ブランチ ページに移動します。
- クリックリセットしたいブランチの横にあるメニューをクリックし、 親からリセットを 選択します。
- リセット操作を確認します。
ブランチに独自の子ブランチがある場合、リセットはブロックされます。親ブランチをリセットする前に、まず子ブランチを削除する必要があります。
ブランチをデフォルトとして設定する
各 Lakebase プロジェクトは、 productionと呼ばれるデフォルトのブランチを使用して作成されますが、任意のブランチをデフォルトとして指定できます。もちろんブランチは同時アクティブなコンピュート制限から免除されており、常に利用可能な状態が維持されます。
ブランチをデフォルトとして設定するには:
- Lakebase アプリでプロジェクトの ブランチ ページに移動します。
- クリックデフォルトとして設定するブランチの横にあるメニューをクリックします。
- 「デフォルトとして設定」を 選択し、操作を確認します。
ブランチを保護済みに設定する
保護されたブランチは、重要なデータベース ブランチを偶発的な変更や削除から保護するのに役立ちます。保護されたブランチは非アクティブのため、削除、リセット、またはアーカイブできません。保護されたブランチを持つプロジェクトとそれに関連付けられたコンピュートも削除できません。
ブランチを保護済みとして設定するには:
- Lakebase アプリの ブランチ に移動し、保護するブランチを選択します。
- 「保護」 をクリックして選択内容を確認します。
ブランチ名の横に表示されるシールド アイコンによって示されるように、ブランチは保護されていると指定されました。
子ブランチのパスワード管理を含む、保護されたブランチの詳細については、 「保護されたブランチ」を参照してください。
ブランチを削除する
ブランチの削除は元に戻すことのできない永続的なアクションです。ブランチを削除すると、以下も削除されます。
- ブランチに属するすべてのデータベース
- ブランチに関連付けられたすべての役割
- ブランチに関連付けられたコンピュート リソース
- そのブランチに固有のすべてのデータと変更
子ブランチを持つブランチは削除できません。最初に子ブランチを削除する必要があります。
ブランチを削除するには:
- Lakebase アプリでプロジェクトの ブランチ ページに移動します。
- クリック削除したいブランチの横にあるメニューをクリックし、 ブランチの削除を 選択します。
- ブランチ名を入力して削除を確認し、 「削除」 をクリックします。