dbt クラウドコレクターの実行を準備する

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • コレクターを実行する前に、dbt Cloud を設定し、認証トークンを作成します。

    始める前に

    必要なロール：なし

    このタスクについて

    dbt クラウドコレクターを実行する前に、これらの準備タスクを完了してください。

    手順

    1. dbt Cloud から必要な ID を取得します。

      「アカウント、プロジェクト、ジョブ、および実行 ID を取得」を参照してください。

    2. dbt Cloud プランに基づいて API トークンを作成します。
    3. ジョブ設定でドキュメントの生成を有効にします。

      「ジョブ実行設定を更新」を参照してください。

    アカウント、プロジェクト、ジョブ、および実行 ID を取得

    コレクター構成に必要な ID を dbt クラウド URL から取得します。

    始める前に

    必要なロール：なし

    このタスクについて

    この情報は、メタデータ収集用にコレクターを構成するときに使用します。

    手順

    1. アカウント ID とプロジェクト ID を取得します。
      1. 移動先 展開 > ジョブ.
      2. URL からアカウント ID とプロジェクト ID をコピーします。

        URL 形式：

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs
    2. 環境 ID と環境名を取得します。
      1. 移動先 展開 > 環境.
      2. コレクタを実行する環境を選択します。
      3. URL から環境 ID をコピーするか、ページタイトルから環境名をメモします。

        URL 形式：

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/environments/<environmentID>
    3. ジョブ ID を取得します。
      1. [ジョブ] セクションから、環境に関連付けられたジョブを選択します。
      2. URL からジョブ ID をコピーするか、ページタイトルからジョブ名をメモします。

        URL 形式：

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs/<jobID>
    4. オプション: :特定のジョブ実行 ID を取得します。

      デフォルトでは、コレクターは直近の成功したジョブ実行から収集します。特定の実行から収集するには、次の手順を実行します。

      1. [ジョブ] ページから、特定のジョブ実行を選択します。
      2. URL からジョブ実行 ID をコピーします。

        URL 形式：

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/runs/<jobRunID>

    ユーザートークンを作成

    メタデータ収集用の個人アクセストークンを作成します。

    始める前に

    必要なロール：admin

    必要な計画:チーム。

    このタスクについて

    チームプランでは、サービスアカウントトークンはサポートされていません。専用のユーザーアカウントを使用して個人アクセストークンを作成する必要があります。

    手順

    1. コレクター専用のユーザーアカウントを作成します。
    2. admin ロールをユーザーアカウントに割り当てます。
    3. 専用ユーザーとしてログインします。
    4. 移動先 プロファイル > アクセストークン.
    5. 個人アクセストークンを生成します。
    6. トークン値をコピーします。

      このトークン値は、コレクターを構成するときに dbt クラウド API キーに使用します。

    次のタスク

    詳細については、 dbt クラウドユーザートークンのドキュメント を参照してください。

    サービストークンの作成

    メタデータ収集に必要な権限を持つサービスアカウントトークンを作成します。

    始める前に

    必要なロール：admin

    必要なプラン:エンタープライズ。

    このタスクについて

    エンタープライズアカウントの場合、サービスアカウントトークンは一般に本番システムで使用されます。

    手順

    1. サービスアカウントトークンを作成します。

      dbt クラウドサービストークンのドキュメントの手順に従います。

    2. サービスアカウントトークンにロールをアサインします。
      • アカウントビューアー:アカウントレベルでアサインされます
      • ジョブビューアー:プロジェクトレベルでアサインされ、そこからメタデータを収集します
    3. トークン値をコピーします。

      このトークン値は、コレクターを構成するときに dbt クラウド API キーに使用します。

    ジョブ実行設定を更新

    dbt クラウドジョブ設定でドキュメントの生成を有効にします。dbt リソースを正常に収集するには、この設定を有効にする必要があります。

    始める前に

    必要なロール：admin

    dbt リソースを正常に収集するには、この設定を有効にする必要があります。

    手順

    1. 移動先 展開 > ジョブ.
    2. [ 環境] リストから、コレクターを実行する環境を選択します。
    3. 環境に関連付けられたジョブを選択します。
    4. [設定] を選択します。
    5. [ 実行設定] で、[ 実行時にドキュメントを生成] を選択します。