Chapter 02

dbt Cloudのセットアップ

dbt-tokyo
dbt-tokyo
2021.12.01に更新
このチャプターの目次
  1. BigQueryの準備
  2. BigQueryにアクセスできるサービスアカントの発行
  3. dbt Cloucdのアカウント登録
  4. プロジェクトの作成
  5. GITHUBのアカウントとレポジトリの準備
  6. レポジトリの設定

BigQueryの準備

このコンテンツでは既にBigQueryが使用できるようになっており、データも入っている状態の方を対象としています。BigQueryのプロジェクト作成やBigQueryに対してのデータロード等は以下の記事を参考にしてください。

BigQueryにアクセスできるサービスアカントの発行

コンソール画面へのアクセスし、サービスアカウント画面へ遷移する
まずBigQueryのコンソール画面にアクセスし、左上のハンバーガーメニューを選択し、「IAMと管理」＞「サービスアカウント」に遷移してください。

サービスアカウントの発行
上部中央にある「サービスアカウント」を選択します

サービスアカウント、説明を以下のように入力し、「作成して続行」を選択します

BigQueryへのアクセスをすべてできるように「BigQuery管理者」の権限を付与します

ロールの部分に「BigQuery管理者」というのが選択されている事を確認し、「完了」を押します。

キーの発行
次の工程のdbt Cloudの設定時に上記で作成したアカウント情報をアップロードする必要があり、「キー」を発行しておきます。

サービスアカウント一覧に作成したアカウントが表示されていると思いますが、右端の操作の3点マークのボタンを選択し、「鍵を管理」を選択

「鍵を追加」＞「新しい鍵を作成」を選択

キーのタイプはJSONのまま、「作成」ボタンを押してしばらくすると、キー情報が含まれたJSONファイルがダウンロードされます

dbt Cloucdのアカウント登録

BigQueryの準備が完了したところで、dbtを使った作業をブラウザ上で実行できる環境の「dbt Cloud」のアカウント登録をします。

アカウント作成

以下の登録画面に進み、必要な情報を入力して完了ボタン（Create my account）を選択してください。

メールに届いている認証ボタンをクリック
アカウント作成後メールアドレスにメールアドレス認証のためのボタンがメール本文に表示されているので、それをクリック。

画面に「Set Up "Analytics"」と表示されればアカウント作成完了

プロジェクトの作成

プロジェクトのセットアップを進める
Continueを押して下さい。

接続先のデータ環境を設定
BigQueryを選択します

接続先情報の入力
先程作成したサービスアカウントに紐づくキー情報をアップロードします。
「Upload a Service Account JSON file」というボタンをクリックし、先程ダウンロードしたキー情報が入ったJSONファイルをダイアログで選択します。

認識が終わると上部に「Uploaded file successfully!」と表示され、「Test」というボタンが押せるようになっているので、ボタンを押して接続ができるかテストを行います。

接続にも問題がなければ、以下のような表示になるので「Continue」を選択してください

GITHUBのアカウントとレポジトリの準備

dbt Cloudでは作成したクエリ等を保管するための環境を提供してくれるオプションも有りつつ、CI/CDの開発手法を取り入れられる点、Managedで作成した場合他に切り替えようとすると大変という理由で個人的にはGithubをおすすめしています。

Githubの始め方とレポジトリ作成（5分）
こちらの記事を参考に「1-4. リモートリポジトリを作成する」まで進めてみてください。

  • レポジトリ名を迷う人は「dbt-tutorial」等で問題ありません
  • 作成するレポジトリは「Private」を選択し、非公開にしておきましょう。

レポジトリの設定

  • 前のステップでGithubのアカウントを作った人＆持っている人はGithubを選択することをおすすめします
  • それ以外の方はManagedもしくは状況に合わせGitやGitLabを選択してみてください

Githubを選択
Githubを選択するとGithubとの認証ページに移動します。
規約を確認し、「Authorize dbt Cloud」を選択してください。

認可が終わったら
プロジェクトに紐付けるレポジトリを選択します。

画面に戻るので、「Continue」を押しましょう。

プロジェクトへの招待
他の作業者がいる場合招待することができます。
dbt Cloudでは作業者が1人までの場合Developerライセンスと呼ばれる形態で無料で使用することができます（2021年11月29日時点）

必要に合わせて選択し、Sikp&Continueに進みましょう。

セットアップの完了
お疲れさまでした、これで開発に移れます。