Skip to main content
外部バケットへの自動バックアップは、24 時間ごとに「フル」バックアップが実行されるよう設定されており、頻度は変更できません。

AWS

AWS へのバックアップの作成

1. AWS で実施する手順

これらの手順は、“Accessing S3 data securely” で説明されているセキュアな S3 の設定と似ていますが、ロールの権限には追加で必要なアクションがあります
以下の手順を AWS アカウントで実施してください。
1
AWS S3 バケットを作成する
バックアップのエクスポート先となる AWS S3 バケットを、アカウント内に作成します。
2
IAM ロールを作成する
AWS はロールベースの認証を使用するため、ClickHouse Cloud サービスが引き受けてこのバケットに書き込める IAM ロールを作成します。
  • a. ClickHouse Cloud サービスの設定ページにある Network security information から ARN を取得します。次のような形式です。
  • b. このロールに対して、次のような信頼ポリシーを作成します。
3
ロールの権限を更新する
この ClickHouse Cloud サービスが S3 バケットに書き込めるように、このロールの権限も設定する必要があります。 これを行うには、このような JSON の権限ポリシーをロール用に作成します。両方の resource には、自身のバケット ARN を指定してください。

2. ClickHouse Cloud で行う手順

外部バケットを設定するには、ClickHouse Cloud コンソールで以下の手順に従ってください。
1
外部バックアップを変更する
Settings ページで、Set up external backup をクリックします。
2
AWS IAM Role ARN と S3 バケットの詳細を設定する
次の画面で、先ほど作成した AWS IAM Role ARN と、以下の形式の S3 バケット URL を入力します。
3
変更を保存する
設定を保存するには、“Save External Bucket” をクリックします。
4
デフォルトのスケジュールからバックアップスケジュールを変更する
以降、外部バックアップはデフォルトのスケジュールでお使いのバケットに対して実行されます。 また、“Settings” ページからバックアップスケジュールを設定することもできます。 別のスケジュールを設定した場合は、そのカスタムスケジュールに従ってお使いの バケットにバックアップが書き込まれ、デフォルトのスケジュール (24 時間ごとのバックアップ) は ClickHouse Cloud が所有するバケット内のバックアップに使用されます。
5
お使いのバケットに保存されているバックアップを表示する
バックアップページには、以下のように、お使いのバケット内のこれらのバックアップが 別のテーブルに表示されます。

AWS からバックアップを復元する

以下の手順に従って、AWS からバックアップを復元します。
1
復元先の新しいサービスを作成する
バックアップの復元先となる新しいサービスを作成します。
2
サービス ARN を追加する
新しく作成したサービスの ARN (ClickHouse Cloud Console のサービス設定ページにあります) を IAM ロールの信頼ポリシーに追加します。これは、上記の AWS の手順セクションにある2 番目の手順と同じです。これにより、新しいサービスが S3 バケットにアクセスできるようになります。
3
バックアップの復元に使用する SQL コマンドを取得する
UI のバックアップ一覧の上にある「バックアップにアクセスまたは復元」リンクをクリックすると、バックアップの復元に使用する SQL コマンドを取得できます。コマンドは次のようになります。
バックアップを別の場所に移動する場合バックアップを別の場所に移動した場合は、新しい場所を参照するように復元コマンドを調整する必要があります。
ASYNC コマンド復元コマンドでは、大規模な復元向けに末尾へ ASYNC コマンドを追加することもできます。 これにより復元は非同期で実行されるため、接続が失われても処理は継続します。 重要なのは、ASYNC コマンドは即座に成功ステータスを返すという点です。 ただし、これは復元が成功したことを意味するわけではありません。 復元が完了したかどうか、また成功したか失敗したかを確認するには、system.backups テーブルを監視する必要があります。
4
復元コマンドを実行する
新しく作成したサービスの SQL コンソール で復元コマンドを実行し、バックアップを復元します。

GCP

GCP へのバックアップの作成

GCP にバックアップを作成するには、以下の手順に従ってください。

GCP で実施する手順

1
GCP のストレージ バケットを作成する
バックアップのエクスポート先として、GCP アカウントにストレージ バケットを作成します。
2
HMACキーとシークレット を生成する
パスワードベースの認証に必要な HMACキーとシークレット を生成します。キーを生成するには、以下の手順に従ってください。
  • a. サービス アカウントを作成する
    • I. Google Cloud Console の IAM & Admin セクションに移動し、Service Accounts を選択します。
    • II. Create Service Account をクリックし、名前と ID を入力します。Create and Continue をクリックします。
    • III. このサービス アカウントに Storage Object User ロールを付与します。
    • IV. Done をクリックして、サービス アカウントの作成を完了します。
  • b. HMAC key を生成する
    • I. Google Cloud Console の Cloud ストレージに移動し、Settings を選択します
    • II. Interoperability タブに移動します。
    • III. Service account HMAC セクションで、Create a key for a service account をクリックします。
    • IV. ドロップダウンメニューから、前の手順で作成したサービス アカウントを選択します。
    • V. Create key をクリックします。
  • c. 認証情報を安全に保存する:
    • I. システムに Access ID (HMAC key) と Secret (HMAC secret) が表示されます。これらの値を保存してください。 このウィンドウを閉じると、secret は再表示されません。

ClickHouse Cloud での手順

外部バケットを設定するには、ClickHouse Cloudコンソールで以下の手順を実行してください。
1
外部バックアップを変更する
Settings ページで、Change external backup をクリックします。
2
GCP HMACキーとシークレットを設定する
ポップアップダイアログで、前のセクションで作成した GCP バケットのパス、HMACキー、シークレットを入力します。
3
外部バケットを保存する
Save External Bucket をクリックして設定を保存します。
4
デフォルトのスケジュールからバックアップスケジュールを変更する
以降、外部バックアップはデフォルトのスケジュールに従ってお使いのバケットに保存されます。 また、Settings ページからバックアップスケジュールを設定することもできます。 別のスケジュールを設定した場合、バケットにバックアップを書き込む際にはカスタムスケジュールが使用され、 デフォルトのスケジュール (24時間ごとのバックアップ) は ClickHouse Cloud が管理するバケット内のバックアップに使用されます。
5
バケットに保存されているバックアップを表示する
以下のように、バックアップページにはお使いのバケット内のバックアップが別のテーブルに表示されます。

GCP からバックアップを復元する

以下の手順に従って、GCP からバックアップを復元します。
1
復元先となる新しいサービスを作成する
バックアップの復元先となる新しいサービスを作成します。
2
バックアップの復元に使用する SQL コマンドを取得する
UI のバックアップ一覧の上にある バックアップにアクセスまたは復元 リンクをクリックして、バックアップを復元するための SQL コマンドを取得します。コマンドは次のように表示され、ドロップダウンから適切なバックアップを選択すると、そのバックアップ用の復元コマンドを取得できます。コマンドにはシークレットアクセスキーを追加する必要があります。
バックアップを別の場所に移動するバックアップを別の場所に移動した場合は、新しい場所を参照するように復元コマンドを調整する必要があります。
ASYNC コマンド大規模な復元では、必要に応じて復元コマンドの末尾に ASYNC コマンドを追加できます。 これにより復元は非同期で実行されるため、接続が失われても処理は継続されます。 重要なのは、ASYNC コマンドは直ちに成功ステータスを返すという点です。 これは、復元が成功したことを意味するわけではありません。 復元が完了したかどうか、および成功したか失敗したかを確認するには、system.backups テーブルを監視する必要があります。
3
バックアップを復元する SQL コマンドを実行する
新しく作成したサービスの SQL コンソールで復元コマンドを実行し、バックアップを復元します。

Azure

Azure へのバックアップの作成

Azure にバックアップを作成するには、以下の手順に従ってください。

Azure での手順

1
ストレージ アカウントを作成する
Azure portal でストレージ アカウントを作成するか、バックアップの保存先として既存のストレージ アカウントを選択します。
2
接続文字列を取得する
  • a. ストレージ アカウントの概要で、Security + networking セクションを探し、Access keys をクリックします。
  • b. ここに key1key2 が表示されます。各キーの下に Connection string フィールドがあります。
  • c. Show をクリックして接続文字列を表示します。ClickHouse Cloud での設定に使用するため、この接続文字列をコピーします。

ClickHouse Cloud で行う手順

外部バケットを設定するには、ClickHouse Cloud コンソールで以下の手順に従ってください。
1
外部バックアップを変更する
Settings ページで、Change external backup をクリックします。
2
Azure ストレージアカウントの接続文字列とコンテナー名を指定する
次の画面で、前のセクションで作成した Azure ストレージアカウントの接続文字列とコンテナー名を入力します。
3
外部バケットを保存する
Save External Bucket をクリックして設定を保存します。
4
デフォルトのスケジュールからバックアップスケジュールを変更する
これで、外部バックアップはデフォルトのスケジュールに従ってお使いのバケットに作成されます。必要に応じて、 Settings ページからバックアップスケジュールを設定することもできます。別のスケジュールを設定した場合は、 カスタムスケジュールに従ってバケットにバックアップが書き込まれ、デフォルトのスケジュール (24 時間ごとのバックアップ) は ClickHouse Cloud 所有のバケット内のバックアップに使用されます。
5
バケットに保存されているバックアップを表示する
バックアップページには、以下のように、バケット内のバックアップが 別のテーブルに表示されます。

Azure からバックアップを復元する

Azure からバックアップを復元するには、以下の手順に従ってください。
1
復元先となる新しいサービスを作成する
バックアップの復元先となる新しいサービスを作成します。現在、バックアップの復元先としてサポートされているのは新しいサービスのみです。
2
バックアップの復元に使用する SQL コマンドを取得する
UI のバックアップ一覧の上にある バックアップにアクセスまたは復元 リンクをクリックすると、バックアップを復元するための SQL コマンドを取得できます。コマンドは次のような形式です。ドロップダウンから適切なバックアップを選択すると、そのバックアップ専用の復元コマンドを取得できます。このコマンドには、Azure ストレージアカウントの接続文字列を追加する必要があります。
バックアップを別の場所に移動する場合バックアップを別の場所に移動した場合は、新しい場所を参照するように復元コマンドを調整する必要があります。
ASYNC コマンド大規模な復元では、復元コマンドの末尾に ASYNC コマンドを任意で追加することもできます。 これにより復元は非同期で実行されるため、接続が失われても復元処理は継続されます。 重要なのは、ASYNC コマンドは即座に成功ステータスを返すという点です。 これは、復元が成功したことを意味するわけではありません。 復元が完了したかどうか、および成功したか失敗したかを確認するには、system.backups テーブルを監視する必要があります。
3
バックアップを復元する SQL コマンドを実行する
新しく作成したサービスの SQL コンソールで復元コマンドを実行し、バックアップを復元します。
最終更新日 2026年6月29日