バージョン: 3.17

ScalarDB で使用されるデータベースのバックアップと復元方法

注記

このページは英語版のページが機械翻訳されたものです。英語版との間に矛盾または不一致がある場合は、英語版を正としてください。

ScalarDB は非トランザクションデータベースまたはトランザクションデータベース上で非侵入的にトランザクション機能を提供するため、トランザクション的に一貫性のある方法でデータベースをバックアップおよび復元するには特別な注意が必要です。

このガイドでは、ScalarDB がサポートするデータベースをバックアップおよび復元する方法について説明します。

バックアップを作成する

バックアップの作成方法は、使用しているデータベースと、複数のデータベースを使用しているかどうかによって異なります。次の決定ツリーは、どのアプローチを取るべきかを示しています。

明示的に一時停止せずにバックアップする

トランザクションをサポートする単一のデータベースで ScalarDB を使用している場合は、ScalarDB がトランザクションを受け入れ続けている間でも、データベースのバックアップを作成できます。

警告

バックアップを作成する前に、データベースのトランザクション的に一貫性のあるバックアップを作成する最も安全な方法を検討し、バックアッププロセスに関連するリスクを理解する必要があります。

ScalarDB でバックアップを作成するための要件の1つは、ScalarDB が管理するすべてのテーブル (Coordinator テーブルを含む) のバックアップがトランザクション的に一貫しているか、トランザクション的に一貫した状態に自動的に回復可能である必要があることです。つまり、すべてのテーブルを1回のトランザクションでダンプして、一貫性のあるバックアップを作成する必要があります。

トランザクション的に一貫性のあるバックアップを作成する方法は、使用しているデータベースの種類によって異なります。データベースを選択して、ScalarDB のトランザクション的に一貫性のあるバックアップを作成する方法を確認してください。

注記

以下にリストされているデータベース別のバックアップ方法は、ScalarDB がサポートするデータベースの一部の例にすぎません。

Amazon RDS または Azure Database for MySQL または PostgreSQL
MySQL
PostgreSQL
SQLite
YugabyteDB Managed
Db2

自動バックアップ機能を使用すると、バックアップ保持期間内の任意の時点に復元できます。

--single-transaction オプションを指定した mysqldump コマンドを使用します。

pg_dump コマンドを使用します。

Special commands to sqlite3 (dot-commands) で指定されているように、.backup コマンドを .timeout コマンドとともに使用します。

例については、BASH: SQLite3 .backup command を参照してください。

backup コマンドを使用します。バックアップの実行の詳細については、Db2: バックアップの概要を参照してください。

明示的に一時停止してバックアップする

トランザクション的に一貫性のあるバックアップを作成する別の方法は、ScalarDB インスタンスのクラスターに未処理のトランザクションがないときにバックアップを作成することです。バックアップの作成は、次の条件によって異なります。

基盤となるデータベースにポイントインタイムスナップショットまたはバックアップ機能がある場合は、未処理のトランザクションが存在しない期間にバックアップを作成できます。
基盤となるデータベースにポイントインタイムリストアまたはリカバリ (PITR) 機能がある場合は、一時停止期間内の未処理のトランザクションが存在しない時間 (できれば中間時間) にリストアポイントを設定できます。

注記

PITR 機能を使用する場合は、NTP などのクロック同期を使用して、クライアントとサーバー間のクロックのずれを最小限に抑える必要があります。そうしないと、一時停止期間として取得される時間が、一時停止が実際に行われた時間と大きく異なる可能性があり、バックアップが進行中のトランザクションが存在する時点に復元される可能性があります。

また、クロック同期ではノード間のクロックを完全に同期できないため、十分な時間 (たとえば、5秒) 一時停止し、一時停止期間の中間時間を復元ポイントとして使用する必要があります。

ScalarDB が未処理のリクエストを排出し、新しいリクエストの受け入れを停止して一時停止期間を作成できるようにするには、ScalarDB を使用するアプリケーションで Scalar Admin インターフェースを適切に実装するか、Scalar Admin インターフェースを実装する ScalarDB Cluster を使用する必要があります。

Scalar Admin クライアントツールを使用すると、進行中のトランザクションを失うことなく、Scalar Admin インターフェースを実装するノード、サーバー、またはアプリケーションを一時停止できます。

トランザクション的に一貫性のあるバックアップを作成する方法は、使用しているデータベースの種類によって異なります。データベースを選択して、ScalarDB のトランザクション的に一貫性のあるバックアップを作成する方法を確認します。

注記

以下にリストされているデータベース別のバックアップ方法は、ScalarDB がサポートするデータベースの一部の例にすぎません。

Cassandra にはレプリケーション機能が組み込まれているため、必ずしもトランザクション的に一貫性のあるバックアップを作成する必要はありません。たとえば、レプリケーション係数が 3 に設定されていて、Cassandra クラスター内のノードの1つのデータのみが失われた場合、通常のトランザクション的に一貫性のないバックアップ (スナップショット) と修復機能を使用してノードを回復できるため、トランザクション的に一貫性のあるバックアップ (スナップショット) は必要ありません。

ただし、クラスターノードのクォーラムでデータが失われた場合は、クラスターを特定のトランザクション的に一貫性のあるポイントに復元するために、トランザクション的に一貫性のあるバックアップ (スナップショット) が必要になります。

トランザクション的に一貫性のあるクラスター全体のバックアップ (スナップショット) を作成するには、ScalarDB Cluster または ScalarDB を使用しているアプリケーションを一時停止し、明示的に一時停止してバックアップするの説明に従ってノードのバックアップ (スナップショット) を作成するか、Cassandra クラスターを停止してノード内のすべてのデータのコピーを作成し、クラスターを起動します。

バックアップを復元する

トランザクション的に一貫性のあるバックアップを復元する方法は、使用しているデータベースの種類によって異なります。データベースを選択して、ScalarDB のトランザクション的に一貫性のあるバックアップを作成する方法を確認してください。

注記

以下にリストされているデータベース別の復元方法は、ScalarDB がサポートするデータベースの一部の例にすぎません。

Amazon RDS または Azure Database for MySQL または PostgreSQL
Cassandra
Cosmos DB for NoSQL
DynamoDB
MySQL
PostgreSQL
SQLite
YugabyteDB Managed
Db2
S3
Blob Storage
Cloud Storage

自動バックアップ機能を使用すると、バックアップ保持期間内の任意の時点に復元できます。

まず、Cassandra クラスターのすべてのノードを停止します。次に、data、commitlog、hints ディレクトリをクリーンアップし、各ノードにバックアップ (スナップショット) を配置します。

各ノードにバックアップ (スナップショット) を配置したら、Cassandra クラスターのすべてのノードを起動します。

Azure portal を使用してアカウントを復元するについては、Azure の公式ドキュメントに従ってください。バックアップを復元した後、復元されたデータベースの既定の整合性レベルを構成するを STRONG に設定します。さらに、前述のように、一時停止期間の中間時点を復元ポイントとして使用する必要があります。

ScalarDB は、ScalarDB Schema Loader を使用してスキーマを作成するときにインストールされるストアドプロシージャを使用して、Cosmos DB アダプターを実装します。ただし、Cosmos DB の PITR 機能では、ストアドプロシージャは復元されません。このため、復元後にすべてのテーブルに必要なストアドプロシージャを再インストールする必要があります。これは、ScalarDB Schema Loader を --repair-all オプションとともに使用することで実行できます。詳細については、名前空間とテーブルを修復するを参照してください。

mysqldump を使用してバックアップファイルを作成した場合は、Reloading SQL-Format Backups で指定されているように、mysql コマンドを使用してバックアップを復元します。

pg_dump を使用してバックアップファイルを作成した場合は、Restoring the Dump で指定されているように、psql コマンドを使用してバックアップを復元します。

Special commands to sqlite3 (dot-commands) で指定されているように、.restore コマンドを使用します。

restore コマンドを使用します。データベースの復元の詳細については、Db2: リストアの概要を参照してください。

AWS Backup を使用してバケットのバックアップを作成した場合は、AWS Backup を使用した S3 データの復元に従ってください。バックアップを別バケットに復元する場合、ScalarDB 設定の scalar.db.contact_points プロパティの値を更新して、コピーされたバケットを新しいバケットとして使用します。

Azure Backup を使用してコンテナーのバックアップを作成した場合は、Azure の BLOB を復元するに従ってください。バックアップを別コンテナーに復元する場合、ScalarDB 設定の scalar.db.contact_points プロパティの値を更新して、コピーされたコンテナーを新しいコンテナーとして使用します。

ScalarDB 設定の scalar.db.contact_points プロパティの値を更新して、コピーされたバケットを新しいバケットとして使用します。

バックアップを作成する​

明示的に一時停止せずにバックアップする​

明示的に一時停止してバックアップする​

バックアップを復元する​

バックアップを作成する

明示的に一時停止せずにバックアップする

明示的に一時停止してバックアップする

バックアップを復元する