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

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

Looker 管理者は、Looker の [管理] メニューから [セルフサービス Explore] オプションを選択して、セルフサービス 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 を有効にする

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

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

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

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

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

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

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

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

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

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

    BigQuery API に移動

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

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

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

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

    Google Sheets API に移動

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

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

    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 を有効にする

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

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

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

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

    コンソールに移動 Google Cloud

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

  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 インスタンスで、[管理] パネルの [一般] セクションから [セルフサービス Explore] を選択します。

  10. [セルフサービス Explore] ページの [クライアント 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 の [Explore] メニューの [セルフサービス Explore] セクションには、自分が所有しているか、オーナーが明示的に共有しているセルフサービス Explore のみが表示されます。Looker 管理者向けの [Explore] メニューには、インスタンス上のすべてのセルフサービス Explore が表示されるわけではありません。これは、[Explore] メニューが煩雑になる可能性があるためです。

データ アップロードを削除する

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

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