BigQuery API V2(Java)を使用して、
BigQueryでゴミ箱に移動されたデータセットを復元する方法
についてご紹介します。

ゴミ箱に移動されたデータセットを復元する場合、
そのデータセットに対しIAM権限が付与されている必要があります。

権限付与に関しては
⧉[BigQuery API(V2)] JavaでBigQueryを使う(2.権限付与)
を参照ください。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[BigQuery API(V2)] JavaでBigQueryを使う
を参照ください。

No		目次
1		データセットを復元
	1	スコープ
	2	実行
	3	レスポンスの内容

1. データセットを復元

ゴミ箱に移動されたデータセットを復元します。
削除されたデータセットは、タイムトラベル期間内であれば復元できます。

1.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

BigqueryScopes.BIGQUERY
BigqueryScopes.CLOUD_PLATFORM

⧉[BigQuery API(V2)] JavaでBigQueryを使う(3.2. BigQueryインスタンスを取得)
でスコープを指定してください。

1.2. 実行

作成するデータセットIDの設定は必須です。

public static void main(String[] args) throws Exception{
    Bigquery bigquery = getBigquery();
    Bigquery.Datasets datasets = bigquery.datasets();
    
    UndeleteDatasetRequest content = new UndeleteDatasetRequest();
    Bigquery.Datasets.Undelete undelete = datasets.undelete("プロジェクトID","データセットID",content);
    
    Dataset res = undelete.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

POST:　https://bigquery.googleapis.com/bigquery/v2/projects/{プロジェクトID}/datasets/{データセットID}:undelete
が実行されます。

1.2.2. クエリパラメータ

クエリパラメータはありません。

1.2.2. リクエストボディ

Bigquery.Datasets.Undeleteのsetメソッドにより、リクエストボディを追加できます。

メソッド	引数	説明
setDeletionTime	String	データセットが削除された時刻指定しない場合は、最後に削除されたバージョンを復元

1.3. レスポンスの内容

Dataset

メソッド	戻り値	説明
getId	String	プロジェクト名を含むデータセットID 形式：「プロジェクト名:データセットID」
getEtag	String	結果ページのハッシュ値
getKind	String	リソースの種類固定文字列："bigquery#dataset"
getLocation	String	データセットのロケーション
getSelfLink	String	リソースにアクセスするために使用できるURL
getLabels	Map<String,String>	このデータセットに関連付けられたラベル
getDatasetReference	DatasetReference	データセット参照
getFriendlyName	String	データセットの代替名
getDescription	String	データセットのわかりやすい説明
getType	String	データセットのタイプ
getDefaultTableExpirationMs	Long	データセット内のすべてのテーブルのデフォルトの存続期間(ミリ秒)
getDefaultPartitionExpirationMs	Long	デフォルトのパーティションの有効期限(ミリ秒)
getAccess	List<Dataset.Access>	エンティティのデータセット
getCreationTime	Long	データセットが作成された時刻(ミリ秒)
getLastModifiedTime	Long	データセットが最後に変更された日付(ミリ秒)
getDefaultEncryptionConfiguration	EncryptionConfiguration	データセット内のすべてのテーブルのデフォルトの暗号化キー
getLinkedDatasetSource	LinkedDatasetSource	【getType()がLINKEDの場合】データセット参照
getExternalDatasetReference	ExternalDatasetReference	【getType()がEXTERNALの場合】データセット参照
getIsCaseInsensitive	Boolean	データセットとそのテーブル名が大文字と小文字を区別しないか
getDefaultCollation	String	データセット内に今後作成されるテーブルのデフォルトの照合仕様 "und:ci"(ロケールは不明、文字の大小区別なし)、""(空の文字列。文字の大小区別あり)
getDefaultRoundingMode	RoundingMode(enum)	このデータセット内で作成される新しいテーブルのデフォルトの丸めモード仕様
getMaxTimeTravelHours	Long	タイムトラベルウィンドウの定義(時間)
getTags	List<Dataset.Tags>	データセットのタグ
getStorageBillingModel	StorageBillingModel(enum)	課金モデル

DatasetReference

メソッド	戻り値	説明
getDatasetId	String	データセットID
getProjectId	String	プロジェクトID

Dataset.Access

メソッド	戻り値	説明
getRole	String	IAMロールID
getUserByEmail	String	アクセス許可するメールアドレス(サービスアカウントメールアドレス or OAuth2.0認証を行うメールアドレス)
getGroupByEmail	String	アクセス許可するグループのメールアドレス
getDomain	String	アクセス許可するドメイン
getSpecialGroup	String	アクセス許可する特別なグループ
getIamMember	String	IAMポリシーに表示されるユーザー、グループ、ドメイン、または特別なグループではない他のタイプのメンバー
getView	TableReference	アクセスを許可する別のデータセットからのビュー
getRoutine	RoutineReference	アクセスを許可する別のデータセットのルーティン
getDataset	DatasetAccessEntry	データセットへの読み取りアクセス許可

TableReference

メソッド	戻り値	説明
getProjectId	String	プロジェクトID
getDatasetId	String	データセットID
getTableId	String	テーブルID

RoutineReference

メソッド	戻り値	説明
getProjectId	String	プロジェクトID
getDatasetId	String	データセットID
getRoutineId	String	ルーティンID

DatasetAccessEntry

メソッド	戻り値	説明
getDataset	DatasetReference	このエントリが適用されるデータセット
getTargetTypes	List<TargetType(enum)>	このエントリが適用されるデータセット内のリソース

Dataset.Tags

メソッド	戻り値	説明
getTagKey	String	タグキーの名前空間付きフレンドリ名
getTagValue	String	タグ値の短縮名

EncryptionConfiguration

メソッド	戻り値	説明
getKmsKeyName	String	CloudKMS暗号化キー

LinkedDatasetSource

メソッド	戻り値	説明
getSourceDataset	DatasetReference	ソースデータセット参照

ExternalDatasetReference

メソッド	戻り値	説明
getExternalSource	String	このデータセットを裏付ける外部ソース
getConnection	String	externalSourceへのアクセスに使用される接続ID

RoundingMode

定義値	内容
ROUNDING_MODE_UNSPECIFIED	設定なし
ROUND_HALF_AWAY_FROM_ZERO	NUMERIC値とBIGNUMERIC値の書き込み時に精度と位取りを適用するときに、半分の値をゼロから四捨五入する
ROUND_HALF_EVEN	NUMERIC値とBIGNUMERIC値の書き込み時に精度と位取りを適用するときに、半分の値を最も近い偶数値に丸める

StorageBillingModel

定義値	内容
STORAGE_BILLING_MODEL_UNSPECIFIED	設定なし
LOGICAL	論理バイトに対する課金
PHYSICAL	物理バイトに対する課金

TargetType

定義値	内容
TARGET_TYPE_UNSPECIFIED	未使用(使用不可)
VIEWS	このエントリはデータセット内のビューに適用

データセットのタイプ

定義値	内容
DEFAULT	所有者と承認されたアカウントのみがアクセス可能なデータセット
PUBLIC	誰でもアクセス可能なデータセット
LINKED	リンクされたデータセット
EXTERNAL	外部メタデータカタログに定義されているデータセット

おしまい。。