BigQuery とデータポータルでデータアプリを使用する

プレビュー

この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前のサービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

注: フィードバックやご質問がございましたら、[e-mail] までお問い合わせください。

Data Apps を公開すると、BigQuery ノートブックの分析を洗練されたインタラクティブなアプリケーションに変換できます。これらの共有可能なエクスペリエンスを構築することで、ビジネス ユーザーはコードを表示したりGoogle Cloud コンソール環境を設定したりすることなく、リンクを介してパラメータを調整し、分析情報を探索できます。Data Apps には次の利点があります。

• セルフサービスの分析情報。ビジネス ユーザーは、コードを編集することなく、期間やフィルタなどのパラメータを調整して、必要なデータを表示できます。
• アプリ閲覧者の設定は不要。消費者は URL を使用してアプリにアクセスします。 Google Cloud コンソールを操作したり、ノートブックを実行したりする必要はありません。
• 柔軟性。Python の可視化ライブラリやウィジェットを統合して、カスタムの複雑なデータアプリを簡単に構築できます。時間を節約するには、統合エージェントを使用してコードを生成します。
• マネージド ライフサイクル。管理者と作成者は、共有、バージョン、リソースの使用状況を管理できます。

始める前に

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. BigQuery API と Dataform API を有効にします（まだ有効になっていない場合）。

   API を有効にするために必要なロール

   API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法を確認する。

   API を有効にする

   新しいプロジェクトでは、BigQuery API が自動的に有効になります。

必要なロール

データアプリの作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

• BigQuery 読み取りセッション ユーザー （roles/bigquery.readSessionUser）
• BigQuery Studio ユーザー （roles/bigquery.studioUser）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

BigQuery の Colab Enterprise を初めて使用する場合は、ノートブックを作成するページで必要な権限をご覧ください。

制限事項

Data Apps には次の制限があります。

• アプリを初めて開くときは、アプリの複雑さに応じて、読み込みに 2 ～ 5 分かかることがあります。

• インタラクティブ セッションは 30 分間継続します。30 分が経過すると、アプリはカーネルとの接続を失い、静的になります。新しい 30 分間のセッションを開始するには、ページを再読み込みするか、データを更新します。

• アプリに表示されるセルに関係なく、すべてのセルが最初から最後まで順番に実行されます。表示されていないセルが実行されてカーネル リソースを消費している場合、カーネル リソースが解放されるまで、アプリが応答していないように見えることがあります。

• データアクセスや Data Apps の表示にサービス アカウントやエンドユーザー認証情報（EUC）を使用することはできません。

データアプリのコンポーネント

データアプリに追加できるコンポーネントは、基盤となるノートブックから派生します。既存のノートブックを使用している場合は、既存のセルをデータアプリに追加できます。

SQL セル、コードセル、テキストセル、可視化セルなど、Colab ノートブックで作成できるサポートされているセルタイプを Data Apps に追加できます。セルタイプは手動で作成することも、Colab データ サイエンス エージェントまたは Gemini を使用してセルを生成することもできます。

ノートブックにさまざまなセルタイプを追加する方法については、次のチュートリアルをご覧ください。

• クエリ結果を可視化する
• BigQuery DataFrames を試す

サードパーティ ライブラリを使用して作成されたコントロール

データアプリは、サードパーティのウィジェット ライブラリを使用して作成されたコントロールをサポートしています。次に例を示します。

• ipywidgets パッケージまたは anywidget ライブラリを使用して、ノートブックにインタラクティブなコントロールを追加できます。ウィジェットは、Colab データ サイエンス エージェントを使用して生成できます。
• ノートブック レベルでは、ウィジェット セルをチェーンできます。ノートブックの先頭でウィジェットを定義すると、その出力は可視化セルなどの他のセルで使用できます。この設定により、データアプリのグローバル フィルタを設定できます。

データアプリを作成して公開する

データアプリは、既存のノートブックを使用するか、新しいノートブックを作成して作成できます。次の例では、Python ユーザー向けノートブックのスタートガイド テンプレートを使用してノートブックを生成し、そこからデータアプリを作成します。

データアプリを作成したら、データポータルに公開して、データ分析を共有可能でインタラクティブなエクスペリエンスに変えます。

注: データアプリにデータポータル Pro は必要ありません。

データアプリを公開するときに、既存の Colab ランタイムに接続することも、テンプレートを使用して新しいランタイムを作成することもできます。テンプレートを使用すると、ワークロードに応じてランタイムのサイズを調整できます。また、アイドル状態のシャットダウン時間を設定して、費用とアプリの起動時間のバランスを取ることができます。

データアプリを作成して公開する手順は次のとおりです。

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

   Studio に移動

2. テンプレート ギャラリーを開くには、次のいずれかを行います。

   • 左側のペインで、 [エクスプローラ] をクリックしてプロジェクトを開き、[Notebook] > [アクションを表示] > [ノートブックを作成] > [すべてのテンプレート] を選択します。

     

     左側のペインが表示されていない場合は、 左ペインを開くをクリックしてペインを開きます。

   • [Studio] ページで、[ノートブック ギャラリーを表示] をクリックします。

     

3. [Getting started with notebooks for Python users] カードをクリックするか、ギャラリーで検索します。

4. テンプレートが開いたら、[このテンプレートを使う] をクリックして、テンプレートを実行可能なノートブックに変換します。

5. [dashboard] Data app をクリックします。

6. 省略可: [コンポーネント] ペインで、チェックボックスを使用してアプリのセルを追加または削除します。

   

7. 新しいコンポーネントを作成する手順は次のとおりです。

   1. ノートブックに戻るには、arrow_back [ノートブック] をクリックします。
   2. 新しいセルを追加するには、 [コード] または [テキスト] の横にあるプルダウン矢印をクリックします。
   3. [保存] をクリックします。
   4. アプリに戻るには、ダッシュボードの [Data app] をクリックします。

8. アプリのレイアウトに問題がなければ、[Publish] をクリックします。

9. [Publish] ページで、次の情報を入力します。

   1. [名前] フィールドに、アプリの名前を入力します。アプリ名は、アプリの作成に使用したノートブックの名前と同じにする必要はありません。

   2. [ランタイム] セクションで、[既存のランタイムに接続] を選択し、[ランタイム] リストからランタイムを選択するか、[新しいランタイムを作成] を選択して、[ランタイム テンプレート] リストから適切なテンプレートを選択します。

      [既存のランタイムに接続する] を選択した場合は、アプリを公開する前にノートブックをランタイムに接続する必要があります。

      

   3. [公開] をクリックします。

   4. データポータルから Google アカウントへのアクセスを許可するよう求められたら、[許可] をクリックします。

10. ソース ノートブックとアプリに変更を加えた場合は、[変更を公開] をクリックしてアプリを更新します。

    または、データポータルから more_vert [その他のオプション> 編集] をクリックしてアプリを編集することもできます。

    ソース ノートブックが BigQuery Studio で開きます。

データアプリを表示して共有する

データポータルを使用して、Colab データアプリを表示し、アプリを他のユーザーと共有します。

アプリを表示すると、インタラクティブ性は、含まれているコンポーネントによって異なります。たとえば、Matplotlib グラフは静的で、Colab の可視化セルまたは Plotly などのライブラリを使用して作成されたグラフはインタラクティブです。

コードで定義されたウィジェットを操作して、出力のフィルタリングや変更などのタスクに使用できます。これらのインタラクションはユーザー固有のものです。

データポータルでアプリを表示して共有する手順は次のとおりです。

1. データポータルでアプリを表示するには、[View Data App] をクリックします。

2. アプリを共有するには、データポータルで person_add [共有] をクリックします。

3. [ユーザーやグループと共有] ページで、次の操作を行います。

   1. [ユーザーやグループを追加] フィールドに、アクセス権を付与するグループと個人を入力します。

   2. 指定したユーザーまたはグループのアクセス権限を選択します。

      • 編集者: ユーザーはアプリの編集、スケジュールとアラートの作成と編集、アプリの他のユーザーとの共有を行うことができます。
      • 閲覧者: ユーザーはアプリを表示できますが、編集したり他のユーザーと共有したりすることはできません。

   3. [送信] をクリックします。

4. 他のユーザーを招待する、レポートリンクを取得する、アプリを共有またはダウンロードするには、[共有] オプションの横にある arrow_drop_down をクリックし、次のいずれかを選択します。

   • ユーザーを招待する
   • レポートへのリンクを取得
   • レポートをダウンロード

   

データポータルでのアセットの共有について詳しくは、他のユーザーをレポートに招待するをご覧ください。

データアプリの再接続と更新

インタラクティブ セッションは 30 分間継続します。30 分が経過すると、アプリはカーネルとの接続を失い、静的になります。新しい 30 分間のセッションを開始するには、ページを再読み込みするか、データを更新します。

データポータルでデータを更新する手順は次のとおりです。

• アプリを開いた状態で、more_vert [その他のレポート操作] > [データを更新] をクリックします。

データアプリでセルを実行するために使用される認証情報

デフォルトでは、データアプリはアプリ作成者の認証情報を使用してデータにアクセスし、ビジュアリゼーションをレンダリングします。すべての閲覧者は、作成者のアクセス権に基づいてレンダリングされたデータアプリを表示します。機密データにアクセスできる Data Apps を共有する前に、この結果を考慮してください。

データアプリを削除する

データアプリはデータポータルを使用して削除できます。アプリの作成に使用したノートブックを削除しても、アプリは削除されず、アプリの機能も停止しません。

データポータルでデータアプリを削除する手順は次のとおりです。

1. データポータルにログインします。

2. [最近] ページでアプリを見つけます。

3. 行の末尾にある more_vert [その他のオプション] > [削除] をクリックします。

   

料金

ノートブックのランタイムで実行されたコードと、使用した BigQuery スロットに対して課金されます。詳細については、Colab Enterprise の料金をご覧ください。