> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Looker を Profound に接続する

[Looker](https://cloud.google.com/looker) は、Google Cloud のエンタープライズ向けビジネスインテリジェンスプラットフォームです。チームは Looker をデータウェアハウス (BigQuery、Snowflake、Redshift など) に接続し、**LookML** で指標を定義して、Looker の UI でデータの探索、レポートの作成、ダッシュボードの共有を行います。

これは [Looker Studio](https://lookerstudio.google.com/) (旧 Google データポータル) **ではありません**。また、Profound のアナリティクスを Tableau にエクスポートする Profound の Tableau コネクタとも**異なります**。Profound の Looker インテグレーションは逆方向に動作し、**Profound の Agents が Looker インスタンスからデータをクエリします**。

## Looker の用語の意味

| 用語 | 内容 |
| - | - |
| **LookML** | Looker のモデリング言語です。アナリティクスチームはこれを使用して、ウェアハウスの生テーブルの上にディメンション、メジャー、結合、ビジネスロジックを定義します。 |
| **Model** | クエリ用に公開された LookML プロジェクトです (例: `marketing` や `core`)。Agent のインラインクエリでは、モデルを名前で参照します。 |
| **Explore** | モデル内でアドホック分析を行うための出発点で、ユーザーがクエリできる関連テーブルとフィールドを厳選したセットです。インラインクエリには、モデル名と Explore 名の両方が必要です。 |
| **Look** | Looker に保存されたレポートまたはクエリです。チームがすでに Looker で指標を作成している場合、Agents は **Run Look** でそれを直接実行できます。 |
| **Dashboard** | Look とビジュアライゼーションのコレクションです。Profound はダッシュボードを埋め込みません。Agents は個々の Look またはインラインクエリを実行し、基になるデータを受け取ります。 |

## このインテグレーションでできること

Profound は、API 認証情報 (`client_id`、`client_secret`、インスタンス URL) を使用して**お客様の** Looker インスタンスに接続します。接続すると、Profound の Agents で次のことができるようになります。

* **保存済みの Look を実行する** — 既存の Look を実行し、後続の Agent ステップ用に結果を JSON として返します
* **インラインクエリを実行する** — カスタムのフィールド、フィルタ、並べ替え、詳細オプションを指定して、特定のモデルと Explore をクエリします

<Note>
  このインテグレーションは**読み取り専用**で、**組織レベル**です。Profound は Looker に対してクエリを実行して結果を返しますが、Looker のコンテンツを作成、更新、削除することはありません。1 つの Looker 接続が組織全体で共有され、必要な任意の Agent で選択できます。
</Note>

## Profound で Looker を使用できる場所

| 利用箇所 | 内容 |
| - | - |
| **Profound Agents** | **Run Look** または **Run Inline Query** ステップを追加して、Looker のデータを Agent のワークフローに取り込みます |
| **Sheets** | 保存済みの Look の行をスプレッドシートにインポートし、分析や Agent の一括実行に使用します |

どちらも、同じ組織レベルの Looker 接続と、同じ読み取り専用のクエリ機能を使用します。

## 前提条件

Looker を Profound に接続する前に、次の点を確認してください。

* Google Cloud の Looker インスタンス (例: `https://your-company.cloud.looker.com`) にアクセスできること
* API 認証情報を持つ Looker ユーザーを作成または使用できること
* そのユーザーが、Agents がクエリする保存済みの Look、モデル、Explore、フィールドにアクセスする権限を持っていること

<Accordion title="Looker の API 認証情報を作成する方法">
  1. Looker で **Admin → Users** に移動し、Profound が API アクセスに使用するユーザーを選択します
  2. ユーザーの **API credentials** セクションで、新しい API キーペアを作成します
  3. ページを離れる前に、生成された **Client ID** と **Client Secret** をコピーします。Looker ではシークレットが再表示されない場合があります。
  4. Agents が必要とする Look、モデル、Explore、ディメンション、メジャーにそのユーザーがアクセスできることを確認します
</Accordion>

## アカウントを接続する

1. Profound で、プラットフォームの左上にある組織名を選択し、**Settings** を選択します。
2. 左サイドバーで、**Account** の下にある **Integrations** を選択します。
3. **Looker** を検索して選択し、**+ Add account** を選択します。
4. **Connect Looker** ダイアログで、接続の詳細を入力します。
   * **Client Secret**: Looker API の `client_secret`
   * **Looker Base URL**: インスタンスの URL (例: `https://your-company.cloud.looker.com`)
   * **Client ID**: Looker API の `client_id`
5. **Connect account** を選択します。

Profound は、Looker (Looker API 4.0) で認証し、API ユーザーを確認することで認証情報を検証します。接続すると、Looker は Agents と Sheets で利用可能なインテグレーションとして表示されます。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="接続を保存できない">
    ベース URL が Looker インスタンスのルート URL (例: `https://your-company.cloud.looker.com`) であることを確認してください。Profound は `/api` や `/api/4.0` を含む URL も受け付け、ルートのインスタンス URL に正規化します。
  </Accordion>

  <Accordion title="Agent ノードに Look が表示されない">
    Looker の API ユーザーが、使用する予定のフォルダと保存済みの Look にアクセスできることを確認してください。最近権限を変更した場合は、少し時間をおいてから再試行してください。
  </Accordion>

  <Accordion title="クエリで Looker の権限エラーが返される">
    Looker ユーザーのロール、モデルセット、フィールドレベルの権限を確認してください。Profound が実行できるのは、接続した Looker ユーザーが実行を許可されているクエリのみです。
  </Accordion>
</AccordionGroup>