Looker のドキュメントを表示していることに注意してください。Looker Studio のドキュメントについては、https://support.google.com/looker-studio をご覧ください。

Looker - Tableau コネクタ（公開プレビュー）

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

このガイドは、Looker–Tableau コネクタの公開プレビューを対象としています。ご質問やフィードバックがございましたら、tableau-looker@google.com までメールをお送りください。

要件

Looker - Tableau コネクタを使用するには、次のコンポーネントが必要です。

Looker でホストされ、Looker 23.18 以降を実行している Looker インスタンス。
Google BigQuery 接続のデータを使用する LookML プロジェクト。（LookML プロジェクトには、connection パラメータで Google BigQuery 接続を指定するモデルファイルが必要です。）
Tableau からアクセスする LookML モデルに対する explore 権限を含む Looker ユーザーロール。

また、Looker–Tableau コネクタを設定する前に、次の手順を行う必要があります。

Looker（オリジナル）インスタンスの場合は、Looker インスタンスで SQL インターフェースの試験運用版 Labs 機能を有効にします。
Looker（Google Cloud コア）インスタンスの場合は、Looker SQL インターフェースの一般提供前の契約お問い合わせフォームに記入してください。Google チームが、インスタンスの SQL Interface 機能を有効にします。

Looker に接続するように Tableau Desktop を設定する

公開プレビューで Looker–Tableau コネクタを使用するには、次の操作を行う必要があります。

Tableau OAuth アプリを Looker インスタンスに追加する: Looker 管理者は、Looker API を使用して Looker–Tableau コネクタの Tableau OAuth アプリを Looker インスタンスに登録する必要があります。Tableau OAuth アプリは Looker インスタンスごとに 1 回だけ登録する必要があり、Looker インスタンスのすべてのユーザーに適用されます。
Tableau コネクタファイルと JDBC ドライバファイルをダウンロードして保存する: Looker–Tableau コネクタにアクセスする各ユーザーは avatica-<release_number>-looker.jar ファイルとパッケージ化された Tableau コネクタ（.taco）ファイルをダウンロードして、パソコンの特定のディレクトリにファイルを保存する必要があります。

以降のセクションで、この手順について詳しく説明します。

Looker インスタンスに Tableau OAuth アプリを追加する

Looker–Tableau コネクタを使用するには、Looker インスタンスに Tableau OAuth アプリがインストールされている必要があります。Looker インスタンスに Tableau OAuth アプリを登録する最も簡単な方法は、Looker の API Explorer を使用することです。

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

https://<YOUR LOOKER INSTANCE URL>/extensions/marketplace_extension_api_explorer::api-explorer/

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

以下の手順に沿って、API Explorer を使用して Looker インスタンスに Tableau OAuth アプリを登録します。

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

[Run It] ダイアログの [Request] タブで、対応するフィールドに次の情報を入力します。

client_guid:
```
35FBB268-0CB0-4822-AFE3-28638C1C6269
```

body:

{
"redirect_uri": "http://localhost:55556/Callback",
"display_name": "Tableau Desktop",
"description": "Tableau Desktop client for JDBC Server",
"enabled": true,
"group_id": ""
}

[この API エンドポイントがデータを変更することを理解しています] チェックボックスをオンにします。
[実行] をクリックします。
Tableau OAuth アプリが正常に登録されたことを確認するには、API Explorer で Get OAuth Client App メソッドを使用します。
- API Explorer の [Search] フィールドに、「OAuth Client App」と入力します。
- [実行] をクリックします。
- client_guid フィールドに Tableau OAuth アプリの値を入力します。
```
35FBB268-0CB0-4822-AFE3-28638C1C6269
```
Tableau OAuth アプリが正常に登録されると、[レスポンス] タブに、アプリの登録時に入力した値が返されます。

このステップは必要ありません。ただし、今後 Looker–Tableau コネクタを使用しなくなり、Tableau OAuth アプリを削除する場合は、OAuth アプリを削除するをご覧ください。

コネクタファイルをダウンロードして保存する

Looker–Tableau コネクタを使用するには、各 Tableau ユーザーが次の 2 つのファイルをダウンロードする必要があります。

Tableau コネクタ（.taco）ファイル
JDBC ドライバ（looker.jar）ファイル

以降のセクションでは、これらのファイルのダウンロード手順と、パソコンでのデータの保存場所について説明します。

Tableau コネクタ（`.taco`）ファイル

Tableau コネクタファイルは looker-jdbc-v0.2.0.taco と呼ばれます。各ユーザーは次の手順で .taco ファイルをダウンロードし、自分のパソコンに保存する必要があります。

Tableau コネクタファイルをダウンロードするには、次のリンクをクリックします: looker-jdbc-v0.2.0.taco。
ダウンロードが完了したら、looker-jdbc-v0.2.0.taco ファイルを My Tableau Repository ディレクトリの Connectors サブディレクトリに移動します。デフォルトのディレクトリパスは次のとおりです。
- Windows: C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors
- MacOS: /Users/[user]/Documents/My Tableau Repository/Connectors
  
  注: 設定で My Tableau Repository ディレクトリに対してデフォルトの保存場所を使用しない場合、パソコン上の Tableau Desktop アプリから [ファイル] > [リポジトリの場所]を選択して、実際の場所を取得できます。

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

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

https://github.com/looker-open-source/calcite-avatica/releases にアクセスします。
avatica-<release_number>-looker.jar ファイルの最新バージョンをダウンロードします。
avatica-<release_number>-looker.jar ファイルを各ユーザーのパソコンで次の場所に保存します。
- Windows: C:\Program Files\Tableau\Drivers
- macOS: /Library/JDBC または ~/Library/JDBC
  
  注: macOS の場合、JDBC ディレクトリがまだ存在しない場合は手動で作成します。

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

Tableau OAuth アプリを Looker インスタンスに追加し、looker-jdbc-v0.2.0.taco ファイルと avatica-<release_number>-looker.jar ファイルをダウンロードしたら、次の手順に従って　Tableau Desktop を使用し Looker インスタンスからデータに接続できます。

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

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

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

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

注意点

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

Looker–Tableau コネクタは Looker Open SQL インターフェースに基づいて構築されており、OpenSQL インターフェースと同じ LookML の制限があります。詳細については、Open SQL インターフェースのドキュメントをご覧ください。
Tableau は、Looker – Tableau コネクタを使用してフィールドの追加や削除を行う場合を含めて、クエリが変更されるたびに自動的にデータベースに対してクエリを実行します。Tableau の自動更新は無効にできます。詳しくは、Tableau のドキュメントをご覧ください。
Tableau を使用して 2 つの Looker Explore を結合することはできません。Explore に参加する場合は、Looker を使用して Looker モデルで結合を作成します。Looker での結合の使用については、Looker のLookML での結合の使用と結合パラメータのドキュメントページをご覧ください。

バグを報告する

バグを報告するには、tableau-looker@google.com にメールで次の情報をお知らせください。

実施したステップの詳細なリスト。
想定される動作。
実際の動作（可能であればスクリーンショットを含める）。

Tableau OAuth アプリの削除（省略可）

このステップは必要ありません。ただし、今後 Looker–Tableau コネクタを使用しなくなり、Looker インスタンスから Tableau OAuth アプリを削除する場合は、API Explorer から次の手順で削除できます。

Looker API Explorer を開きます（詳細については、API Explorer の使用ページをご覧ください）。
API Explorer の [Search] フィールドに、「OAuth Client App　を削除」と入力します。
検索結果で、[OAuth クライアントアプリを削除] をクリックします。
[OAuth クライアントアプリの削除] ページで、[実行] ボタンをクリックします。
[Run It] ダイアログの [Request] タブで、Tableau OAuth アプリの [client_guid] 値を入力します。
```
35FBB268-0CB0-4822-AFE3-28638C1C6269
```
[この API エンドポイントがデータを変更することを理解しています] チェックボックスをオンにします。
Tableau OAuth アプリが正常に削除されたことを確認するには、API Explorer で Get OAuth Client App メソッドを使用します。
- API Explorer の [Search] フィールドに、「OAuth Client App」と入力します。
- [実行] をクリックします。
- client_guid フィールドに Tableau OAuth アプリの値を入力します。
```
35FBB268-0CB0-4822-AFE3-28638C1C6269
```
Tableau OAuth アプリが正常に削除された場合、[レスポンス] タブでは空の本文の値が返されます。