スケジュールされたクエリでテーブル スナップショットを作成する

コンソール

1. Google Cloud Console で、[サービス アカウント] ページに移動します。

   [サービス アカウント] に移動

2. PROJECT プロジェクトを選択します。

3. snapshot-bot サービス アカウントを作成します。

   1. [サービス アカウントを作成] をクリックします。

   2. [サービス アカウント名] フィールドに、[snapshot-bot] と入力します。

   3. [作成して続行] をクリックします。

4. BigQuery ジョブの実行に必要な権限をサービス アカウントに付与します。

   1. [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[BigQuery ユーザー] ロールを選択します。

   2. [完了] をクリックします。

BigQuery によって、メールアドレス snapshot-bot@PROJECT.iam.gserviceaccount.com でサービス アカウントが作成されます。

コンソール

BigQuery によってサービス アカウントが作成されていることを確認します。

1. Google Cloud Console で、[サービス アカウント] ページに移動します。

   [サービス アカウント] に移動

2. PROJECT プロジェクトを選択します。

3. snapshot-bot@PROJECT.iam.gserviceaccount.com をクリックします。

4. [サービス アカウントのステータス] メッセージで、サービス アカウントがアクティブになっていることを確認します。

BigQuery がクエリの実行に必要な権限をサービス アカウントに付与していることを確認します。

1. Google Cloud コンソールで [リソースの管理] ページに移動します。

   [リソースの管理] に移動

2. [PROJECT] をクリックします。

3. [情報パネルを表示] をクリックします。

4. [権限] タブで、[BigQuery ユーザー] ノードを開きます。

5. snapshot-bot サービス アカウントがリストにあることを確認します。

コンソール

1. Google Cloud コンソールで、[BigQuery] ページを開きます。

   BigQuery に移動

2. [エクスプローラ] ペインで、PROJECT プロジェクト ノードを展開します。

3. DATASET データセット ノードを開きます。

4. TABLE テーブルを選択します。

5. [共有] をクリックします。 [共有] ペインが開きます。

6. [プリンシパルを追加] をクリックします。アクセス権の付与ペインが開きます。

7. [新しいプリンシパル] に、サービス アカウントのメールアドレス（snapshot-bot@PROJECT.iam.gserviceaccount.com）を入力します。

8. [ロールを選択] プルダウンで、BigQuery データ編集者のロールを選択します。

9. [保存] をクリックします。

10. [共有] ペインで、[BigQuery データ編集者] ノードを開き、snapshot-bot@PROJECT.iam.gserviceaccount.com サービス アカウントが表示されていることを確認します。

11. [閉じる] をクリックします。

bq

1. Google Cloud Console で、Cloud Shell をアクティブにします。

   Cloud Shell をアクティブにする

2. 次の bq add-iam-policy-binding コマンドを入力します。

   bq add-iam-policy-binding \
   --member=serviceAccount:snapshot-bot@PROJECT.iam.gserviceaccount.com \
   --role=roles/bigquery.dataEditor DATASET.TABLE

BigQuery は、新しいポリシー バインディングが追加されたことを確認します。

コンソール

1. Google Cloud コンソールで [BigQuery] ページに移動します。

   BigQuery に移動

2. [エクスプローラ] ペインで、PROJECT プロジェクト ノードを展開します。

3. BACKUP データセット ノードのメニューをクリックして、[開く] を選択します。

4. [共有データセット] をクリックします。[データセットの権限] ペインが表示されます。

5. [メンバーを追加] フィールドに、サービス アカウントのメールアドレス（snapshot-bot@PROJECT.iam.gserviceaccount.com）を入力します。

6. [ロールを選択] プルダウンで、BigQuery データオーナーのロールを選択します。

7. [追加] をクリックします。

8. [データセットの権限] ペインで、snapshot-bot@PROJECT.iam.gserviceaccount.com サービス アカウントが [BigQuery データオーナー] ノードに表示されていることを確認します。

9. [完了] をクリックします。

bq

1. Google Cloud Console で、Cloud Shell をアクティブにします。

   Cloud Shell をアクティブにする

2. 次の bq query コマンドを入力します。

   bq query --use_legacy_sql=false --display_name="Monthly snapshots of the TABLE table" \
   --location="us" --schedule="1 of month 05:00" \
   --project_id=PROJECT \
   'DECLARE snapshot_name STRING;
   DECLARE expiration TIMESTAMP;
   DECLARE query STRING;
   SET expiration = DATE_ADD(@run_time, INTERVAL 40 DAY);
   SET snapshot_name = CONCAT("BACKUP.TABLE_",
     FORMAT_DATETIME("%Y%m%d", @run_date));
   SET query = CONCAT("CREATE SNAPSHOT TABLE ", snapshot_name,
     " CLONE PROJECT.DATASET.TABLE OPTIONS(expiration_timestamp=TIMESTAMP \"",
     expiration, "\");");
   EXECUTE IMMEDIATE query;'

3. BigQuery によってクエリがスケジュール設定されます。

コンソール

1. Google Cloud コンソールで、[スケジュールされたクエリ] ページに移動します。

   [スケジュールされたクエリ] に移動

2. [Monthly snapshots of the TABLE table] をクリックします。

3. [構成] をクリックします。

4. クエリ文字列にクエリが含まれていることと、クエリが毎月 1 日に実行されるようスケジュールされていることを確認します。

コンソール

1. Google Cloud コンソールで、[スケジュールされたクエリ] ページに移動します。

   [スケジュールされたクエリ] に移動

2. [Monthly snapshots of the TABLE table] というクエリの説明をクリックします。

3. [実行履歴] をクリックします。

クエリの実行日時、実行の成否、失敗した場合は発生したエラーを確認できます。特定の実行の詳細を表示するには、[実行履歴] テーブルでその行をクリックします。[実行の詳細] ペインに詳細が表示されます。

コンソール

1. Google Cloud コンソールで [BigQuery] ページに移動します。

   BigQuery に移動

2. [エクスプローラ] ペインで、BACKUP データセットを開き、TABLE_YYYYMMDD スナップショットが作成されていることを確認します。ここで、YYYYMMDD は毎月 1 日です。

   次に例を示します。

   • TABLE_20220601
   • TABLE_20220701
   • TABLE_20220801