Looker の用語の意味
このインテグレーションでできること
Profound は、API 認証情報 (client_id、client_secret、インスタンス URL) を使用してお客様の Looker インスタンスに接続します。接続すると、Profound の Agents で次のことができるようになります。
- 保存済みの Look を実行する — 既存の Look を実行し、後続の Agent ステップ用に結果を JSON として返します
- インラインクエリを実行する — カスタムのフィールド、フィルタ、並べ替え、詳細オプションを指定して、特定のモデルと Explore をクエリします
このインテグレーションは読み取り専用で、組織レベルです。Profound は Looker に対してクエリを実行して結果を返しますが、Looker のコンテンツを作成、更新、削除することはありません。1 つの Looker 接続が組織全体で共有され、必要な任意の Agent で選択できます。
Profound で Looker を使用できる場所
どちらも、同じ組織レベルの Looker 接続と、同じ読み取り専用のクエリ機能を使用します。
前提条件
Looker を Profound に接続する前に、次の点を確認してください。- Google Cloud の Looker インスタンス (例:
https://your-company.cloud.looker.com) にアクセスできること - API 認証情報を持つ Looker ユーザーを作成または使用できること
- そのユーザーが、Agents がクエリする保存済みの Look、モデル、Explore、フィールドにアクセスする権限を持っていること
Looker の API 認証情報を作成する方法
Looker の API 認証情報を作成する方法
- Looker で Admin → Users に移動し、Profound が API アクセスに使用するユーザーを選択します
- ユーザーの API credentials セクションで、新しい API キーペアを作成します
- ページを離れる前に、生成された Client ID と Client Secret をコピーします。Looker ではシークレットが再表示されない場合があります。
- Agents が必要とする Look、モデル、Explore、ディメンション、メジャーにそのユーザーがアクセスできることを確認します
アカウントを接続する
- Profound で、プラットフォームの左上にある組織名を選択し、Settings を選択します。
- 左サイドバーで、Account の下にある Integrations を選択します。
- Looker を検索して選択し、+ Add account を選択します。
- Connect Looker ダイアログで、接続の詳細を入力します。
- Client Secret: Looker API の
client_secret - Looker Base URL: インスタンスの URL (例:
https://your-company.cloud.looker.com) - Client ID: Looker API の
client_id
- Client Secret: Looker API の
- Connect account を選択します。
トラブルシューティング
接続を保存できない
接続を保存できない
ベース URL が Looker インスタンスのルート URL (例:
https://your-company.cloud.looker.com) であることを確認してください。Profound は /api や /api/4.0 を含む URL も受け付け、ルートのインスタンス URL に正規化します。Agent ノードに Look が表示されない
Agent ノードに Look が表示されない
Looker の API ユーザーが、使用する予定のフォルダと保存済みの Look にアクセスできることを確認してください。最近権限を変更した場合は、少し時間をおいてから再試行してください。
クエリで Looker の権限エラーが返される
クエリで Looker の権限エラーが返される
Looker ユーザーのロール、モデルセット、フィールドレベルの権限を確認してください。Profound が実行できるのは、接続した Looker ユーザーが実行を許可されているクエリのみです。