ノートブックを管理する

このドキュメントでは、ノートブックの表示、比較、復元、削除の方法など、BigQuery で Colab Enterprise ノートブックを管理する方法について説明します。

このドキュメントでは、Dataplex でノートブック メタデータを表示および管理する方法についても説明します。

ノートブックは、Dataform が提供する BigQuery Studio コードアセットです。

始める前に

  1. ノートブックを作成します。
  2. Dataplex でノートブックのメタデータを管理するには、Google Cloud プロジェクトで Dataplex API が有効になっていることを確認します。

必要な権限

ノートブックを共有するには、次の Identity and Access Management（IAM）ロールが必要です。

ノートブックの保存と削除を行うには、次の IAM ロールが必要です。

ノートブックのリビジョンを操作するには、次の IAM ロールが必要です。

BigQuery IAM の詳細については、IAM でのアクセス制御をご覧ください。

Dataplex でノートブック メタデータを管理するには、必要な Dataplex ロールがあることを確認します。

ノートブックへのアクセス権を付与する

他のユーザーにノートブックへのアクセス権を付与するには、そのユーザーを適切な IAM ロールに追加します。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [ノートブック] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。アクセス権を付与するノートブックを見つけます。

  3. ノートブックの横にある （アクションを表示）をクリックし、[共有] > [権限の管理] をクリックします。

  4. [権限を管理] ペインで、[ユーザー / グループの追加] をクリックします。

  5. [新しいプリンシパル] フィールドに、プリンシパルを入力します。

  6. [ロール] リストで、次のいずれかのロールを選択します。

  7. 省略可: ロールと詳細な共有設定の完全なリストを表示するには、[詳細な共有] をクリックします。

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

  9. ノートブック情報ページに戻るには、[閉じる] をクリックします。

ノートブックを共有する

ノートブックを他のユーザーと共有するには、ノートブックへのリンクを生成して共有します。共有したノートブックを他のユーザーに表示するには、最初にノートブックへのアクセス権を付与する必要があります。

ノートブックを実行するには、ノートブックがアクセスするデータにユーザーがアクセスできる必要があります。詳細については、データセットへのアクセス権を付与するをご覧ください。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [ノートブック] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。共有するノートブックを見つけます。

  3. ノートブックの横にある （アクションを表示）をクリックし、[共有] > [リンクをコピー] をクリックします。

  4. リンクを他のユーザーと共有します。

すべてのノートブックを表示する

プロジェクト内のすべてのノートブックのリストを表示するには、次の手順を行います。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、[Notebooks] の横にある （アクションを表示）をクリックし、次のいずれかを行います。

  • 現在のタブでリストを開くには、[すべて表示] をクリックします。
  • リストを新しいタブで開くには、[すべてを表示] > [新しいタブ] をクリックします。
  • 分割タブでリストを開くには、[すべてを表示] > [タブを分割] をクリックします。

ノートブックのメタデータを表示する

ノートブックのメタデータを表示する手順は次のとおりです。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。メタデータを表示するノートブックの名前をクリックします。

  3. [概要] ペインで、データに使用するリージョンや最終更新日など、ノートブックに関する情報を確認します。

ノートブックのバージョンを操作する

以降のセクションでは、ノートブックのバージョンを表示、比較、復元する方法について説明します。

ノートブックのバージョンを表示する

ノートブックのバージョンを表示する手順は次のとおりです。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。アクティビティを表示するノートブックの名前をクリックします。

  3. [アクティビティ] タブをクリックすると、ノートブックのバージョンが日付の降順で表示されます。

ノートブックのバージョンを比較する

ノートブックのバージョンを比較する手順は次のとおりです。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。バージョン情報を比較するノートブックの名前をクリックします。

  3. [アクティビティ] タブで、ノートブック バージョンの横にある （アクションを表示）をクリックし、[比較] をクリックします。比較ペインが開き、選択したノートブックのバージョンと現在のノートブックのバージョンが比較されます。

  4. 省略可: 個別のペインではなくインラインでバージョンを比較するには、[比較]、[インライン] の順にクリックします。

  5. 省略可: バージョンのソースコードを比較するには、[比較]、[元の形式のソースを表示] の順にクリックします。

  6. 省略可: ノートブックのコマンド出力を非表示にするには、[比較] をクリックし、[出力を表示] の選択を解除します。

ノートブックのバージョンを復元する

ノートブックのバージョンを復元するには、次のいずれかのオプションを使用します。比較ペインから復元すると、以前のバージョンの復元を選択する前に、ノートブックの現在のバージョンと以前のバージョンを比較できます。ノートブックを復元すると、現在のバージョンを上書きするのではなく、新しいバージョンのノートブックが作成されます。変更履歴が失われることはありません。

アクティビティ ペイン

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。以前のバージョンを復元するノートブックの名前をクリックします。

  3. [アクティビティ] ペインを選択します。

  4. 復元するノートブックのバージョンの横にある （アクションを表示）をクリックし、[復元] をクリックします。

  5. [確認] をクリックします。

比較ペイン

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。以前のバージョンを復元するノートブックの名前をクリックします。

  3. [アクティビティ] ペインを選択します。

  4. ノートブック バージョンの横にある （アクションを表示）をクリックし、[比較] をクリックします。比較ペインが開き、選択したノートブックのバージョンと最新のノートブックのバージョンを比較します。

  5. 比較後に以前のノートブック バージョンを復元する場合は、[復元] をクリックします。

  6. [確認] をクリックします。

ノートブックをダウンロードする

ノートブックをダウンロードする手順は次のとおりです。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。ダウンロードするノートブックの名前をクリックします。

  3. [ダウンロード] をクリックします。

ノートブックを削除する

ノートブックの削除方法は次のとおりです。

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

    [BigQuery] に移動

  2. [エクスプローラ] ペインで、プロジェクトと [Notebooks] フォルダを開き、必要に応じて [共有ノートブック] フォルダを開きます。削除するノートブックを見つけます。

  3. ノートブックの横にある （アクションを表示）をクリックし、[削除] をクリックします。

  4. 削除を確定するには、ダイアログで「delete」と入力します。

  5. [削除] をクリックします。

Dataplex でメタデータを管理する

Dataplex を使用すると、ノートブックのメタデータを保存して管理できます。ノートブックは、追加の設定をせずにデフォルトのまま Dataplex で使用できます。

Dataplex を使用すると、すべての BigQuery のロケーションでノートブックを管理できます。Dataplex でノートブックを管理する場合は、Dataplex の割り当てと上限および Dataplex の料金が適用されます。

Dataplex は、ノートブックから次のメタデータを自動的に取得します。

  • データアセット名
  • データアセットの親
  • データアセットのロケーション
  • データアセットのタイプ
  • 対応する Google Cloud プロジェクト

Dataplex は、ノートブックを次の値を持つエントリとしてログに記録します。

システム エントリ グループ
ノートブックのシステム エントリ グループは @dataform です。Dataplex でノートブック エントリの詳細を表示するには、dataform システム エントリ グループを表示する必要があります。エントリ グループ内のすべてのエントリのリストを表示する方法については、Dataplex のドキュメントのエントリ グループの詳細を表示するをご覧ください。
システム エントリのタイプ
ノートブックのシステム エントリタイプは dataform-code-asset です。ノートブックの詳細を表示するには、dataform-code-asset システム エントリ タイプを表示して、アスペクトベースのフィルタで結果をフィルタし、dataform-code-asset アスペクト内の type フィールドを NOTEBOOK に設定する必要があります。選択したノートブックのエントリを選択します。選択したエントリタイプの詳細を表示する手順については、Dataplex ドキュメントのエントリタイプの詳細を表示するをご覧ください。選択したエントリの詳細を表示する手順については、Dataplex ドキュメントのエントリの詳細を表示するをご覧ください。
システム アスペクト タイプ
ノートブックのシステム アスペクト タイプは dataform-code-asset です。ノートブック エントリにアスペクトをアノテーションして Dataplex のノートブックにコンテキストを追加するには、dataform-code-asset アスペクト タイプを表示して、アスペクトベースのフィルタで結果をフィルタし、dataform-code-asset アスペクト内の type フィールドを NOTEBOOK に設定します。エントリにアスペクトをアノテーションする方法については、Dataplex ドキュメントのアスペクトを管理してメタデータを拡充するをご覧ください。
タイプ
データ キャンバスのタイプは NOTEBOOK です。このタイプでは、アスペクトベースのフィルタで aspect:dataplex-types.global.dataform-code-asset.type=NOTEBOOK クエリを使用して、dataform-code-asset システム エントリ タイプと dataform-code-asset アスペクト タイプのノートブックをフィルタできます。

Dataplex でアセットを検索する方法については、Dataplex ドキュメントの Dataplex でデータアセットを検索するをご覧ください。

トラブルシューティング

詳細については、Colab Enterprise のトラブルシューティングをご覧ください。

次のステップ