管理者設定 - セルフサービス エクスプローラ

セルフサービス Explore 機能を使用すると、Looker ユーザーは CSV、XLS、XLSX ファイルを Looker にアップロードし、LookML モデルを構成したり Git バージョン管理を設定したりすることなく、Looker Explore でデータをクエリして可視化できます。

Looker 管理者は、Looker の [管理] メニューから [セルフサービス Explore] オプションを選択して、セルフサービス Explore 機能を構成し、インスタンスでのデータ アップロードを表示できます。

始める前に

セルフサービス探索を使用するには、Looker インスタンスが次の要件を満たしている必要があります。

  • BigQuery 接続の場合は Looker 25.20 以降、Snowflake 接続の場合は Looker 26.8 以降を実行している。
  • BigQuery または Snowflake データベースへの接続があり、接続が次の方法で構成されている必要があります。
    • 接続は [すべてのプロジェクト] スコープで構成する必要があります。接続のスコープを確認するには、Looker 管理メニューの [接続] ページの [データベース] タブの [スコープ] 列をご覧ください。接続の作成後に、接続の [プロジェクト スコープ] の値を編集することはできません。
    • 永続的な派生テーブル(PDT)に対して接続が有効になっている必要があります。接続で PDT が有効になっていることを確認するには、Looker の [接続] ページを開き、接続の [編集] ボタンをクリックして [オプション設定] タブを開き、[PDT を有効にする] 切り替えボタンがオンになっていることを確認します。
    • Snowflake 接続の場合、データベース管理者は Looker ロールに CREATE STAGE を付与する必要があります。詳細については、Snowflake への Looker 接続の作成に関するドキュメント ページをご覧ください。
  • セルフサービス Explore を作成するユーザーは、Looker ユーザー アカウントに upload_data 権限が必要です。この権限により、ユーザーは CSV ファイルをインスタンスにアップロードできます。

Google スプレッドシートからデータをアップロードする際の制限事項は次のとおりです。

セルフサービス Explore を有効にする

ユーザーがセルフサービスでデータ探索を作成できるようにするには、Looker 管理者が次の手順で機能を設定する必要があります。

  1. Looker の [管理者] メニューの [全般] セクションで、[セルフサービス分析] 管理ページを選択します。
  2. [セルフサービス探索] 管理ページで、[デフォルトの接続] プルダウン メニューから、セルフサービス探索のデータの保存に使用する BigQuery または Snowflake の接続を選択します。Looker は、インスタンスのセルフサービス Explore 用にこのデータベースにデータを保存します。
  3. [データ アップロード] 切り替えボタンの横にある [テスト] ボタンをクリックして、デフォルトの接続が有効であり、永続的な派生テーブル(PDT)で接続が有効になっていることを確認します(接続要件については、始める前にのセクションをご覧ください)。テストに失敗した場合は、データ アップロードを有効にできません。接続の管理ページに移動して、接続のトラブルシューティングを行います。
  4. テストに合格したら、[データ アップロード] 切り替えボタンをオンにして、セルフサービスのデータ探索機能を有効にします。
  5. Looker インスタンスで Google スプレッドシートからのデータのアップロードをサポートする場合は、次の操作を行います。
    • セルフサービス Explore 用の BigQuery 接続が構成されていることを確認します(Google スプレッドシートのアップロードは BigQuery 接続でのみサポートされています)。
    • Google Cloud コンソールを使用して、Google スプレッドシートのアップロードをサポートするために必要な API を有効にします。
    • ユーザーが Google ドライブのナビゲーションを使用してデータ アップロード用の Google スプレッドシート ファイルを選択できるようにする場合は、必要に応じて Google スプレッドシートのアップロードで OAuth を有効にします。
    • [Google スプレッドシートのデータ インポート] 切り替えの横にある [テスト] ボタンをクリックして、Google スプレッドシートのアップロードに固有のテストを実行します。
    • [Google スプレッドシートのデータ インポート] の切り替えをオンにします。(Google スプレッドシートからデータをアップロードするには、[データのアップロード] 切り替えと [Google スプレッドシートのデータ インポート] 切り替えの両方を有効にする必要があります)。

Google スプレッドシートのアップロードをサポートする API を有効にする

Looker が BigQuery 接続の Google スプレッドシートからのデータ アップロードをサポートできるようにするには、IAM roles/serviceusage.serviceUsageAdmin 権限を持つ IAM ユーザーが Google Cloud コンソールで次の API を有効にする必要があります。

  • この API は、[セルフサービス分析] 管理ページの [デフォルトの接続] プルダウン メニューで指定されている BigQuery 接続をホストする Google Cloud プロジェクトで有効にする必要があります。

    • BigQuery API: すべての BigQuery オペレーションに必要
  • これらの API は、データアップロードに使用されるサービス アカウントに関連付けられている Google Cloud プロジェクトで有効にする必要があります(BigQuery 接続の PDT プロセスに使用されるサービス アカウント。セルフサービス エクスプローラの管理ページの [デフォルトの接続] プルダウン メニューで指定されている Google Cloud プロジェクトと同じ場合もあれば、そうでない場合もあります)。

    • BigQuery API: すべての BigQuery オペレーションに必要
    • Google Sheets API: Google スプレッドシート ドキュメント内の各シートの名前を取得するために必要
    • Google Drive API: BigQuery がドライブからファイルを読み取るために必要

API を有効にする手順は次のとおりです。

  1. Google Cloud コンソールのプロジェクト選択ツールを開き、[セルフサービス分析] 管理ページの [デフォルトの接続] プルダウン メニューで指定されている BigQuery 接続をホストするプロジェクトを選択します。

  2. Google Cloud コンソールのナビゲーション メニューで、[API とサービス] > [ライブラリ] に移動して、BigQuery API を開きます。

    BigQuery API に移動

  3. BigQuery API ページで、API がまだ有効になっていない場合は、[有効にする] をクリックします。

  4. BigQuery API ページで、 Google Cloud コンソールのプロジェクト選択ツールを開き、データのアップロードに使用するサービス アカウント(BigQuery 接続の PDT プロセスに使用するサービス アカウント)に関連付けられている Google Cloud プロジェクトを選択します。

  5. BigQuery API ページで、API がまだ有効になっていない場合は、[有効にする] をクリックします。

  6. Google Cloud コンソールのナビゲーション メニューで、[API とサービス] > [ライブラリ] に移動して、Google Sheets API を開きます。

    Google Sheets API に移動

  7. [Google Sheets API] ページで、API がまだ有効になっていない場合は、[有効にする] をクリックします。

  8. Google Cloud コンソールのナビゲーション メニューで、[API とサービス] > [ライブラリ] に移動し、Google Drive API を開きます。

    Google Drive API に移動

  9. [Google Drive API] ページで、API がまだ有効になっていない場合は、[有効にする] をクリックします。

Private Service Connect インスタンスの構成

Looker(Google Cloud コア)インスタンスで Private Service Connect(PSC)を使用している場合は、Google スプレッドシートのアップロードをサポートするために追加の手順を行う必要があります。

Looker が Google Sheets API にアクセスできるようにするには、Private Service Connect を使用して Google スプレッドシートをサービスとして公開し、Looker(Google Cloud コア)構成のローカル FQDN 設定に Google スプレッドシートを追加する必要があります。ローカル FQDN を構成する場合は、[ローカル FQDN] フィールドに sheets.googleapis.com を使用し、[ターゲット サービス アタッチメント URI] フィールドに公開サービスのサービス アタッチメント URI を使用します。手順については、ローカル FQDN を使用して公開サービスに接続するをご覧ください。

Google スプレッドシートのアップロードで OAuth を有効にする

セルフサービス探索を有効にし、Google スプレッドシートのアップロードをサポートする API を有効にし、[Google スプレッドシートのデータ インポート] 切り替えを有効にすると、ユーザーが Google ドライブのナビゲーションを使用してデータ アップロード用の Google スプレッドシート ドキュメントを選択できるようになります。

Looker インスタンスで Google ドライブのナビゲーションを有効にするには、必要なロールを持つ IAM ユーザーが、 Google Cloud コンソールで OAuth クライアントを作成し、このセクションの手順で説明するように、Looker インスタンスの [セルフサービス分析] 管理ページに OAuth 認証情報を入力する必要があります。

OAuth クライアントを作成して Looker インスタンスに認証情報を入力する手順は次のとおりです。

  1. Google Cloud コンソールで、 Google Cloud コンソールのプロジェクト選択ツールを開き、データのアップロードに使用されるサービス アカウント(BigQuery 接続の PDT プロセスに使用されるサービス アカウント)に関連付けられている Google Cloud プロジェクトを選択します。

    Google Cloud コンソールに移動

  2. Google Cloud コンソールのメインメニューで、[API とサービス] > [認証情報] に移動します。

  3. [認証情報] ページで、[認証情報を作成] プルダウン メニューをクリックし、[OAuth クライアント ID] を選択します。

  4. [アプリケーションの種類] プルダウンで、[ウェブ アプリケーション] を選択します。

  5. [名前] フィールドに、OAuth クライアントの名前(Looker upload data from Sheets など)を入力します。

  6. [承認済みの JavaScript 生成元] セクションで、[URI を追加] ボタンをクリックします。Looker インスタンスの URL を入力します。

    https://LOOKER_INSTANCE_URL
    
  7. [作成] をクリックします。

  8. [作成] をクリックすると、[OAuth クライアントを作成しました] ウィンドウが表示されます。このウィンドウには、 Google Cloud コンソールが OAuth クライアント用に作成したクライアント ID とクライアント シークレットが表示されます。これらの値をコピーしてメモします。

  9. Looker インスタンスで、[管理者] パネルの [全般] セクションから [セルフサービス分析] を選択します。

  10. [セルフサービス エクスプローラ] ページの [クライアント ID] フィールドと [クライアント シークレット] フィールドに、 Google Cloud コンソールで OAuth クライアントを作成したときに Google Cloud コンソールからコピーした値を貼り付けます。

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

  12. [Google スプレッドシートのデータ インポート] 切り替えの横にある [テスト] ボタンをクリックして、Google スプレッドシートのアップロード設定に加えて OAuth 構成をテストします。([データ アップロード] 切り替えボタンの横にある [テスト] ボタンをクリックして、Google スプレッドシートの構成に加えて接続を確認することもできます)。

ユーザーが [クラウドからインポート] オプションを使用してデータをアップロードすると、Looker に Google スプレッドシート ドキュメントを選択するための Google ドライブ ナビゲーションが表示されるようになりました。

Looker インスタンスでのデータ アップロードの表示

インスタンスでセルフサービス Explore が有効になっている場合、Looker 管理者は [セルフサービス Explore] 管理ページの [データ アップロード] テーブルを使用して、ユーザーがインスタンスにアップロードしたデータを表示できます。

[データ アップロード] テーブルには、インスタンスのデータ アップロードに関する次の情報が表示されます。

  • セルフサービス Explore の名前。セルフサービス Explore を開くハイパーリンクにもなっています。
  • データ アップロードの所有者
  • データがアップロードされた日付
  • Looker 管理者がファイル アップロードとそれに関連付けられたセルフサービス Explore を削除できる [削除] ボタン

Looker 管理者は、[データのアップロード] テーブルのリンクを使用して、インスタンス上のセルフサービス Explore を開くことができます。ただし、Looker の [データ探索] メニューの [セルフサービス データ探索] セクションには、自分が所有しているセルフサービス データ探索、またはオーナーが自分と明示的に共有しているセルフサービス データ探索のみが表示されます。Looker 管理者にとって [Explore] メニューが煩雑になる可能性があるため、[Explore] メニューには、インスタンス上のすべてのセルフサービス Explore が表示されるわけではありません。

データ アップロードの削除

データ アップロードのオーナーは、[セルフサービス分析を編集] ページからアップロードを削除できます。また、Looker 管理者は、次の手順で [セルフサービス分析] 管理ページからデータアップロードを削除できます。

  1. Looker の [管理者] メニューの [全般] セクションで、[セルフサービス分析] 管理ページを選択します。
  2. [データアップロード] テーブルで、削除するデータアップロードの [削除] ボタンをクリックします。
  3. 確認ダイアログで [Copy] をクリックします。