メインコンテンツまでスキップ

ある時点でのデータのクエリ

ポイントインタイム ブランチを使用すると、復元ウィンドウ内の任意の時点で存在していたデータベースをクエリできます。この機能は、特定の時点のデータを使用して新しいブランチを作成するため、本番運用データに影響を与えずに履歴状態を分析できます。

ポイントインタイムブランチを使用する場合

次の場合にポイントインタイム ブランチを使用します。

  • 過去の特定の時点で存在していたデータを分析する
  • 時間の経過とともにデータベースに加えられた変更を調査する
  • 現在のデータと過去の状態を比較してデータの進化を理解する

ある時点でのデータのクエリ

特定の時点でデータをクエリするには:

  1. ワークスペースの右上隅にあるアプリスイッチャーをクリックして、Lakebase アプリに移動します。

  2. リスト内でプロジェクトを特定します。

  3. プロジェクト名をクリックすると、 プロジェクト ダッシュボード に移動します。

  4. 左側のナビゲーションの [ブランチ] セクションで、 [ブランチの作成] をクリックします。

  5. 新しいブランチの作成 ダイアログで次の操作を行います。

    • ブランチ名を入力してください(必須、例: historical-analysisまたはpast-data-query
    • 過去の時点からブランチのデータとスキーマ を選択
    • 日付と時刻の選択ツールを使用して、クエリを実行する日付と時刻を選択します。

    過去のデータからブランチを作成する

  6. 選択した時点のデータを使用して新しいブランチを作成するには、 [作成] をクリックします。

注記

これにより、本番運用ブランチに影響を与えることなく、選択した時点で存在していたデータで新しいブランチが作成されます。

  1. ブランチが作成されると、新しいポイントインタイム ブランチの ブランチ概要 ページに自動的に移動します。このブランチの接続文字列を含む 接続詳細 モーダルが表示されます。

    次の2つのオプションがあります。

    • 外部ツールの使用 : psql 、DBeaver、pgAdmin、またはその他のPostgresクライアントを使用して接続するための接続文字列をコピーします
    • SQLエディタを使用する :接続詳細モーダルを閉じて次のステップに進みます
  2. SQL エディタを使用するには、 閉じる をクリックして接続詳細モーダルを閉じます。

  3. 左側のナビゲーションで、 SQL エディター をクリックします。

  4. 選択した時点で存在していたデータベースをクエリします。

  5. SQLクエリを作成して実行し、履歴データを分析します。

    SQLエディターの使用に関する詳細情報については、 「Lakebase SQLエディターからのクエリ」を参照してください。 外部ツールとの接続の詳細については、 「Postgres クライアント」を参照してください。

ポイントインタイムブランチをクリーンアップする

分析が終了し、ポイントインタイムブランチが不要になったら、次の手順を実行します。

  1. 左側のナビゲーションから 「ブランチ」 ページに移動します。
  2. 作成したポイントインタイムブランチを見つけます。
  3. ブランチ名の横にあるケバブメニューアイコン。メニューをクリックします。
  4. ドロップダウンメニューから 「削除」 を選択します。
  5. 削除を確認してブランチを削除し、ストレージスペースを解放します。

重要な考慮事項

  • 復元ウィンドウ : 構成された復元ウィンドウ内からのみデータを照会できます。この設定を調整する方法については、「復元ウィンドウの構成」を参照してください。
  • ブランチの分離 : ポイントインタイム ブランチは本番運用 ブランチとは分離されているため、現在の操作に影響を与えることなく、安全にクエリと分析を実行できます。
  • ブランチ管理 : 分析が完了したら、不要なストレージの使用を避けるために、ポイントインタイム ブランチを削除します。
  • 完全なデータベース状態 : ブランチには、選択した時点で存在していたすべてのデータベースとスキーマが含まれます。