ノートブックを管理する
このドキュメントでは、ノートブックの表示、比較、復元、削除の方法など、BigQuery で Colab Enterprise ノートブックを管理する方法について説明します。
ノートブックは、Dataform が提供する BigQuery Studio コードアセットです。
始める前に
始める前に、ノートブックを作成します。
必要な権限
ノートブックを共有するには、次の Identity and Access Management（IAM）ロールが必要です。
- BigQuery ジョブユーザー（
roles/bigquery.jobUser） - BigQuery 読み取りセッション ユーザー（
roles/bigquery.readSessionUser） - リソースレベルのコードオーナー（
roles/dataform.codeOwner）
ノートブックの保存と削除を行うには、次の IAM ロールが必要です。
- BigQuery ジョブユーザー（
roles/bigquery.jobUser） - BigQuery 読み取りセッション ユーザー（
roles/bigquery.readSessionUser） - コードオーナー（
roles/dataform.codeOwner）またはコード編集者（roles/dataform.codeEditor）
ノートブックのリビジョンを操作するには、次の IAM ロールが必要です。
- BigQuery ジョブユーザー（
roles/bigquery.jobUser） - BigQuery 読み取りセッション ユーザー（
roles/bigquery.readSessionUser） 次のいずれかのロール:
BigQuery IAM の詳細については、IAM でのアクセス制御をご覧ください。
ノートブックへのアクセス権を付与する
他のユーザーにノートブックへのアクセス権を付与するには、そのユーザーを適切な IAM ロールに追加します。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [ノートブック] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。アクセス権を付与するノートブックを見つけます。
ノートブックの横にある （アクションを表示）をクリックし、[共有] > [権限の管理] をクリックします。
[権限を管理] ペインで、[ユーザー / グループの追加] をクリックします。
[新しいプリンシパル] フィールドに、プリンシパルを入力します。
[ロール] リストで、次のいずれかのロールを選択します。
省略可: ロールと詳細な共有設定の完全なリストを表示するには、[詳細な共有] をクリックします。
[保存] をクリックします。
ノートブック情報ページに戻るには、[閉じる] をクリックします。
ノートブックを共有する
ノートブックを他のユーザーと共有するには、ノートブックへのリンクを生成して共有します。共有したノートブックを他のユーザーに表示するには、最初にノートブックへのアクセス権を付与する必要があります。
ノートブックを実行するには、ノートブックがアクセスするデータにユーザーがアクセスできる必要があります。詳細については、データセットへのアクセス権を付与するをご覧ください。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [ノートブック] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。共有するノートブックを見つけます。
ノートブックの横にある （アクションを表示）をクリックし、[共有] > [リンクをコピー] をクリックします。
リンクを他のユーザーと共有します。
すべてのノートブックを表示する
プロジェクト内のすべてのノートブックのリストを表示するには、次の手順を行います。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、[Notebooks] の横にある （アクションを表示）をクリックし、次のいずれかを行います。
- 現在のタブでリストを開くには、[すべて表示] をクリックします。
- リストを新しいタブで開くには、[すべてを表示] > [新しいタブ] をクリックします。
- 分割タブでリストを開くには、[すべてを表示] > [タブを分割] をクリックします。
ノートブックのメタデータを表示する
ノートブックのメタデータを表示する手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。メタデータを表示するノートブックの名前をクリックします。
[概要] ペインで、データに使用するリージョンや最終更新日など、ノートブックに関する情報を確認します。
ノートブックのバージョンを操作する
以降のセクションでは、ノートブックのバージョンを表示、比較、復元する方法について説明します。
ノートブックのバージョンを表示する
ノートブックのバージョンを表示する手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。アクティビティを表示するノートブックの名前をクリックします。
[アクティビティ] タブをクリックすると、ノートブックのバージョンが日付の降順で表示されます。
ノートブックのバージョンを比較する
ノートブックのバージョンを比較する手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。バージョン情報を比較するノートブックの名前をクリックします。
[アクティビティ] タブで、ノートブック バージョンの横にある （アクションを表示）をクリックし、[比較] をクリックします。比較ペインが開き、選択したノートブックのバージョンと現在のノートブックのバージョンが比較されます。
省略可: 個別のペインではなくインラインでバージョンを比較するには、[比較]、[インライン] の順にクリックします。
省略可: バージョンのソースコードを比較するには、[比較]、[元の形式のソースを表示] の順にクリックします。
省略可: ノートブックのコマンド出力を非表示にするには、[比較] をクリックし、[出力を表示] の選択を解除します。
ノートブックのバージョンを復元する
ノートブックのバージョンを復元するには、次のいずれかのオプションを使用します。比較ペインから復元すると、以前のバージョンの復元を選択する前に、ノートブックの現在のバージョンと以前のバージョンを比較できます。ノートブックを復元すると、現在のバージョンを上書きするのではなく、新しいバージョンのノートブックが作成されます。変更履歴が失われることはありません。
アクティビティ ペイン
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。以前のバージョンを復元するノートブックの名前をクリックします。
[アクティビティ] ペインを選択します。
復元するノートブックのバージョンの横にある （アクションを表示）をクリックし、[復元] をクリックします。
[確認] をクリックします。
比較ペイン
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。以前のバージョンを復元するノートブックの名前をクリックします。
[アクティビティ] ペインを選択します。
ノートブック バージョンの横にある （アクションを表示）をクリックし、[比較] をクリックします。比較ペインが開き、選択したノートブックのバージョンと最新のノートブックのバージョンを比較します。
比較後に以前のノートブック バージョンを復元する場合は、[復元] をクリックします。
[確認] をクリックします。
ノートブックをダウンロードする
ノートブックをダウンロードする手順は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。ダウンロードするノートブックの名前をクリックします。
[ダウンロード] をクリックします。
ノートブックを削除する
ノートブックの削除方法は次のとおりです。
Google Cloud コンソールで [BigQuery] ページに移動します。
[エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。削除するノートブックを見つけます。
ノートブックの横にある （アクションを表示）をクリックし、[削除] をクリックします。
削除を確定するには、ダイアログで「
delete」と入力します。[削除] をクリックします。
トラブルシューティング
詳細については、Colab Enterprise のトラブルシューティングをご覧ください。
次のステップ
- BigQuery での Colab Enterprise ノートブックの詳細を確認する。
- ノートブックの作成方法を学習する。
- ノートブックをオーケストレートする方法を学習する。