dbt Semantic Layer
dbt Semantic LayerをSquadbaseに接続するための手順と必要情報の取得方法
このコネクターは、dbtプロジェクトで定義したメトリクスやディメンションをdbt Semantic Layer経由でSquadbase AIが取得し、分析やダッシュボード作成に活用するためのものです。
必要情報
| 項目 | 説明 |
|---|---|
| Semantic LayerのホストURL | dbt CloudのSemantic Layer設定画面に表示されるホストURLです。 |
| 環境ID | Semantic Layerを有効にしたdbt Cloud環境の数値IDです。 |
| サービストークン | dbt CloudのAccount settingsで発行した、Semantic Layer Only権限セットを持つサービストークンです。 |
取得方法
Semantic LayerのホストURL
- dbt Cloud にログインする
- Account settings → Semantic Layer に移動する
- 設定画面に表示されるホストURLをコピーする
ホストはリージョンによって異なります：
| リージョン | ホストの例 |
|---|---|
| US（マルチテナント） | semantic-layer.cloud.getdbt.com |
| EMEA | semantic-layer.emea.dbt.com |
| APAC | semantic-layer.au.dbt.com |
シングルテナント（例：pe571.us1.dbt.com） | pe571.semantic-layer.us1.dbt.com |
/api/graphql まで含めたURLをそのまま貼り付けても構いません。
環境ID
- dbt Cloudで Orchestration → Environments に移動する
- Semantic Layerを有効にした環境をクリックする
- ブラウザのURLに含まれる数値が環境ID：
https://cloud.getdbt.com/accounts/{account_id}/environments/{environment_id}/...
Semantic Layerの設定画面にも直接表示されます。
サービストークン
- dbt Cloudで Account settings → Service tokens に移動する
- + New token をクリックする
- 権限セットに Semantic Layer Only を選択する
- 生成されたトークンをコピーし、安全な場所に保存する
サービストークンの代わりに個人アクセストークンも使用できます。