Looker–Tableau BI コネクタ

Looker–Tableau BI コネクタを使用すると、Looker Explore を Tableau のデータソースとして使用できます。Looker–Tableau BI コネクタは Looker Open SQL インターフェースを基盤として構築されており、JDBC を使用してデータソースに接続するアプリケーションから、LookML モデルと Explore にアクセスできます。詳細については、Open SQL インターフェース のドキュメントをご覧ください。

注: Looker–Tableau BI コネクタの非公開プレビューに参加している場合は、Looker–Tableau BI コネクタの公開プレビューからのアップグレード セクションをご覧ください。

始める前に

Looker–Tableau BI コネクタを使用するには、Looker インスタンスが次の要件を満たしている必要があります。

• Looker 24.14 以降を実行している。
• Tableau Desktop BI コネクタで有効になっている。Looker 管理者は、Looker の [BI コネクタ] ページで [Tableau Desktop] トグルを有効にする必要があります。
• Google BigQuery 接続のデータを使用する LookML プロジェクトが含まれている。
  • LookML プロジェクトは、少なくとも 1 つの Google BigQuery 接続が選択された状態で、[許可された接続] フィールドが [これらの接続のみ] オプションに設定されているように構成する必要があります。モデルの構成とモデルに対して許可された接続の確認については、プロジェクト情報へのアクセスと編集のドキュメント ページをご覧ください。
  • LookML プロジェクトには、connection パラメータで BigQuery 接続を指定するモデルファイルが必要です。

また、Looker–Tableau BI コネクタを使用する各ユーザーには、Tableau からアクセスする LookML モデルに対する explore 権限を含むユーザーロールを持つ Looker アカウントが必要です。

Looker に接続するための Tableau Desktop の設定

すべての要件が満たされたら、Looker データに接続するように Tableau Desktop を設定できます。

注: この手順は、パソコンに Tableau Desktop がインストールされていることを前提としています。

Looker–Tableau BI コネクタにアクセスする各ユーザーは、avatica-<release_number>-looker.jar ファイルとパッケージ化された Tableau コネクタ（TACO）ファイルをダウンロードして、パソコンの特定のディレクトリにファイルを保存する必要があります。以降のセクションでは、これらのファイルをダウンロードする手順と、パソコンに保存する場所について説明します。

• Tableau Connector（TACO）ファイルをダウンロードして保存する
• JDBC ドライバ（looker.jar）ファイルをダウンロードして保存する

Tableau コネクタ（TACO）ファイル

Tableau コネクタ ファイルは looker_v1.0.0.taco と呼ばれます。各ユーザーは、次の手順に沿って TACO ファイルをダウンロードし、パソコンに保存する必要があります。

1. Tableau コネクタ ファイルをダウンロードするには、次のリンクをクリックします: looker_v1.0.0.taco

2. ダウンロードが完了したら、looker_v1.0.0.taco ファイルを My Tableau Repository ディレクトリの Connectors サブディレクトリに移動します。デフォルトのディレクトリ パスは次のとおりです。

   • Windows:

     C:\Users\\Windows user\Documents\My Tableau Repository\Connectors
     

   • MacOS:

     /Users/Mac user/Documents/My Tableau Repository/Connectors
     

     注: 設定で My Tableau Repository ディレクトリに対してデフォルトの保存場所を使用しない場合、パソコン上の Tableau Desktop アプリから [ファイル] > [リポジトリの場所]を選択して、実際の場所を取得できます。

JDBC ドライバ（looker.jar）ファイル

JDBC ドライバは avatica-<release_number>-looker.jar と呼ばれます。各ユーザーは、GitHub から looker.jar ファイルをダウンロードし、次の手順に沿ってパソコンに保存する必要があります。

1. https://github.com/looker-open-source/calcite-avatica/releases に移動します。
2. avatica-<release_number>-looker.jar ファイルの最新バージョンをダウンロードします。

3. avatica-<release_number>-looker.jar ファイルを各ユーザーのパソコンで次の場所に保存します。

   • Windows: C:\Program Files\Tableau\Drivers

   • macOS: /Library/JDBC または ~/Library/JDBC

     注: macOS の場合、JDBC ディレクトリがまだ存在しない場合は、手動で作成します。

Tableau Desktop から Looker のデータに接続する

looker_v1.0.0.taco ファイルと avatica-<release_number>-looker.jar ファイルをダウンロードして保存したら、次の手順に従って Tableau Desktop を使用し、Looker インスタンスからデータに接続できます。

1. Tableau Desktop の左側の [接続] ペインから、[サーバーに接続] セクションで [その他] オプションを選択します。
2. 検索ボックスに「Looker by Google」と入力します。
3. [Looker by Google] オプションを選択します。
4. ダイアログ ウィンドウで、次のパラメータを入力します。
   • サーバー: https:// を除いた Looker インスタンスの URL を入力します。例: example.cloud.looker.com
   • ポート: 443
   • 認証: OAuth
   • OAuth インスタンス URL: https:// を含む完全な Looker インスタンス URL を入力します。例: https://example.cloud.looker.com
5. [ログイン] を選択します。Tableau はブラウザ ウィンドウを開き、Looker インスタンスに接続し、OAuth でアカウントを認証します。
6. プロンプトが表示されたら、Looker にログインします。すでにログインしている場合、Tableau がブラウザ ウィンドウを使用して Looker に認証したことと、ブラウザ ウィンドウを閉じることができるようになったことを示すメッセージがブラウザ ウィンドウに表示されます。
7. Looker に認証されると、Tableau は Looker インスタンスへの接続を含むデータソース ページを開きます。
8. [スキーマ] プルダウン メニューを使用して、Tableau Desktop に表示するデータが含まれる Looker モデルを選択します。 Tableau の [テーブル] リストに、選択した Looker モデルの Looker Explore が表示されます。
9. データ探索を開始するには、[テーブル] リストからオブジェクトを選択してキャンバスにドラッグします。

Looker UI での Looker–Tableau BI コネクタ クエリの特定

Tableau からのクエリは Open SQL インターフェースを介して行われます。Open SQL インターフェース のドキュメントで説明されているように、Looker 管理者は Looker UI を使用して、Open SQL インターフェースから発信されたクエリを識別できます。

Looker–Tableau BI コネクタからのクエリでは、ソース値が「sql_interface」または「SQL Interface」です。

Tableau Server で Looker–Tableau BI コネクタを使用する

Looker–Tableau BI コネクタは Tableau Exchange では使用できませんが、次のセクションの手順に沿って Tableau Server に Looker–Tableau BI コネクタをインストールできます。

• Looker–Tableau BI コネクタの OAuth を設定する
• Tableau Server に Looker–Tableau BI コネクタをインストールする
• Tableau Server で設定を完了する

始める前に

Tableau Server で Looker–Tableau BI コネクタを使用するには、Looker インスタンスが次の要件を満たしている必要があります。

• Looker 24.14 以降を実行している。
• Google BigQuery 接続のデータを使用する LookML プロジェクトが含まれている。
  • LookML プロジェクトは、少なくとも 1 つの Google BigQuery 接続が選択された状態で、[許可された接続] フィールドが [これらの接続のみ] オプションに設定されているように構成する必要があります。モデルの構成とモデルに対して許可された接続の確認については、プロジェクト情報へのアクセスと編集のドキュメント ページをご覧ください。
  • LookML プロジェクトには、connection パラメータで BigQuery 接続を指定するモデルファイルが必要です。

また、Looker–Tableau BI コネクタを使用する各ユーザーには、Tableau からアクセスする LookML モデルに対する explore 権限を含むユーザーロールを持つ Looker アカウントが必要です。

Looker–Tableau BI コネクタの OAuth を設定する

Tableau Server 用の Looker–Tableau BI コネクタを使用するには、Looker インスタンスで OAuth 統合を設定する必要があります。

Looker API Explorer を使用して、Looker–Tableau BI コネクタの OAuth 統合を設定できます。

• Looker インスタンスに API Explorer がすでにインストールされている場合は、次の URL 形式でアクセスできます。

  https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
  

• Looker インスタンスに API Explorer がない場合は、Looker Marketplace からインストールできます。詳細については、API Explorer の使用ページをご覧ください。

API Explorer を使用して Looker インスタンスで OAuth 統合を設定するには、次の操作を行います。

1. Looker API Explorer を開きます（詳細については、API Explorer の使用ページをご覧ください）。
2. API Explorer の [検索] フィールドに、「OAuth アプリを登録」と入力します。
3. 検索結果で [OAuth アプリを登録] をクリックします。
4. [OAuth アプリを登録] ページで、[実行] ボタンをクリックします。

5. [実行] ダイアログの [リクエスト] タブで、対応するフィールドに次の情報を入力します。

   • client_guid:

   tableau-server
   

   • body:

   {
     "redirect_uri": TABLEAU_SERVER_INSTANCE_URL/auth/add_oauth_token,
     "display_name": "Looker-Tableau-Server (manual)",
     "description": "Client for Looker-Tableau Server integration (manually added)",
     "enabled": true,
     "group_id": ""
   }
   

6. [この API エンドポイントがデータを変更することを理解しています] チェックボックスをオンにします。

7. [実行] をクリックします。

8. API Explorer の Get OAuth Client App メソッドを使用して、認証が正常に設定されたことを確認できます。

   • API Explorer の [検索] フィールドに、「OAuth Client アプリ」と入力します。
   • [実行] をクリックします。
   • [client_guid] フィールドに値 tableau-server を入力します。

   OAuth が正常に設定されると、[レスポンス] タブに、アプリの登録時に入力した値が返されます。

Tableau Server に Looker–Tableau BI コネクタをインストールする

Tableau Server に Looker–Tableau BI コネクタをインストールするには、次の操作を行います。

1. Tableau コネクタ ファイルをダウンロードするには、次のリンクをクリックします。looker_v1.0.0.taco
2. https://github.com/looker-open-source/calcite-avatica/releases から avatica-<release_number>-looker.jar ファイルの最新バージョンをダウンロードします。
3. Tableau Server ホストマシンに TACO ファイルと JAR ファイルをインストールします。ファイルの場所は、サーバーのオペレーティング システムによって異なります。Tableau のデフォルトのインストール パスを次の表に示します。

	TACO ファイルの場所	JAR ファイルの場所
Linux サーバー	/opt/tableau/connectors	/opt/tableau/tableau_driver/jdbc
Windows Server	C:\Program Files\Tableau\Connectors	C:\Program Files\Tableau\Drivers

Tableau Server で設定を完了する

Looker–Tableau BI コネクタの OAuth を設定し、Looker–Tableau BI コネクタをインストールしたら、Tableau Server ホストマシンで次の手順を実行して設定を完了します。

• Looker–Tableau BI コネクタの OAuth を設定するときに指定した OAuth クライアント ID と OAuth インスタンス URL（リダイレクト URL）を登録します。同様のコネクタを使用した例については、Tableau のドキュメントをご覧ください。
• 保存されている認証情報を検証して更新します。同様のコネクタを使用した例については、Tableau のドキュメントをご覧ください。

注意点

Tableau Desktop で Looker データを探索する場合は、次の点に注意してください。

• Looker–Tableau BI コネクタは Looker Open SQL インターフェースに基づいて構築されており、Open SQL インターフェースと同じ LookML の制限と SQL の制限があります。詳細については、Open SQL インターフェース のドキュメントをご覧ください。
• Tableau は、Looker–Tableau BI コネクタを使用してフィールドの追加や削除を行う場合を含めて、クエリが変更されるたびに自動的にデータベースに対してクエリを実行します。Tableau で自動更新をオフにできます。詳細については、Tableau のドキュメントをご覧ください。
• Tableau を使用して 2 つの Looker Explore を結合することはできません。Explore を結合する場合は、Looker を使用して Looker モデルで結合を作成します。Looker での結合の使用については、Looker のLookML での結合の使用と結合パラメータのドキュメント ページをご覧ください。
• Looker–Tableau BI コネクタは、Tableau のライブ接続で動作するように設計されています。Tableau のデータ抽出モードでは、値が「null」の Looker の測定値が抽出されるため、正確な結果は得られません。抽出モードを使用する場合は、Looker 測定値を使用する代わりに、Looker ディメンション フィールドから直接 Tableau で集計フィールドを作成できます。

Looker–Tableau BI コネクタの公開プレビューからのアップグレード

Looker–Tableau BI コネクタの公開プレビューに参加していた場合、既存の設定はそのまま機能します。ただし、Looker–Tableau BI コネクタの最新バージョンにアップグレードすることをおすすめします。

Looker–Tableau BI コネクタの最新バージョンにアップグレードするには、Looker 管理者が次のタスクを行う必要があります。

1. Looker インスタンスが要件を満たしていることを確認します。
2. Looker インスタンスで、[BI コネクタ] ページの [Tableau Desktop] 切り替えを有効にします。

Looker 管理者が Looker インスタンスで Tableau Desktop の切り替えを有効にしてから、Looker インスタンス ユーザーは次の操作を行って、最新の Looker–Tableau BI コネクタを使用できます。

• Tableau コネクタ ファイルをダウンロードして保存する
• JDBC ドライバ（looker.jar）ファイルをダウンロードして保存する

ユーザーは、Tableau コネクタ ファイルと JDBC ドライバ ファイルの両方をダウンロードして保存した後で、Tableau Desktop から Looker データに接続できます。ユーザーは、アップグレードされた Looker–Tableau BI コネクタで Looker アカウントに認証する必要があります。

すべての Looker インスタンス ユーザーが新しい Looker–Tableau BI コネクタにアップグレードした後で、手順に沿ってパブリック プレビューの設定の一環として、Looker インスタンスに追加した Tableau OAuth アプリを削除できます。

注: Looker インスタンスから非公開プレビュー版の Tableau OAuth アプリを削除すると、ユーザーは Tableau Desktop を使用して Looker のデータに接続するために、最新バージョンの Tableau コネクタ ファイルが必要になります。

Tableau OAuth アプリを削除する（省略可）

この手順は必須ではありません。ただし、すべての Looker インスタンス ユーザーが looker_v1.0.0.taco Tableau コネクタ ファイルにアップグレードしたら、次の手順を実行して、Looker インスタンスから Tableau OAuth アプリの非公開プレビュー版を削除できます。

注: Looker インスタンスから非公開プレビュー版の Tableau OAuth アプリを削除すると、ユーザーは Tableau Desktop を使用して Looker のデータに接続するために、最新バージョンの Tableau コネクタ ファイルが必要になります。

1. Looker API Explorer を開きます（詳細については、API Explorer の使用ページをご覧ください）。
2. API Explorer の [Search] フィールドに、「OAuth Client App　を削除」と入力します。
3. 検索結果で、[OAuth クライアント アプリを削除] をクリックします。
4. [OAuth クライアント アプリの削除] ページで、[実行] ボタンをクリックします。

5. [実行] ダイアログの [リクエスト] タブで、Tableau OAuth アプリの [client_guid] 値を入力します。公開プレビューの Looker–Tableau BI コネクタ バージョン（v0.2.0）の場合、client_guid 値は次のとおりです。

     35FBB268-0CB0-4822-AFE3-28638C1C6269
   

6. [この API エンドポイントがデータを変更することを理解しています] チェックボックスをオンにします。

7. API Explorer の Get OAuth Client App メソッドを使用して、Tableau OAuth アプリが正常に削除されたことを確認できます。

   • API Explorer の [Search] フィールドに、「OAuth Client App」と入力します。
   • [実行] をクリックします。
   • client_guid フィールドに Tableau OAuth アプリの値「35FBB268-0CB0-4822-AFE3-28638C1C6269」を入力します。

   Tableau OAuth アプリが正常に削除された場合、[レスポンス] タブから空の本文値が返されます。