Préparer l’exécution du collecteur dans le cloud DBT

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Configurez dbt Cloud et créez des jetons d’authentification avant d’exécuter le module de collection.

    Avant de commencer

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Effectuez ces tâches de préparation avant d’exécuter le collecteur dbt Cloud.

    Procédure

    1. Obtenez les ID requis auprès de dbt Cloud.

      Consultez Obtenir les ID de compte, de projet, de tâche et d’exécution.

    2. Créez un jeton d’API basé sur votre plan dbt Cloud.
    3. Activer la génération de documentation dans les paramètres de la tâche.

      Consultez Mettre à jour les paramètres d’exécution de la tâche.

    Obtenir les ID de compte, de projet, de tâche et d’exécution

    Obtenir les ID requis à partir des URL dans le cloud dbt pour la configuration du collecteur.

    Avant de commencer

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Vous utiliserez ces informations lors de la configuration du collecteur pour la collecte des métadonnées.

    Procédure

    1. Obtenez l’ID de compte et l’ID de projet.
      1. Accédez à la Déployer > Tâches.
      2. Copiez l’ID de compte et l’ID de projet à partir de l’URL.

        Format de l’URL :

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs
    2. Obtenez l’ID et le nom de l’environnement.
      1. Accédez à la Déployer > Environnements.
      2. Sélectionnez l’environnement sur lequel vous souhaitez exécuter le module de collection.
      3. Copiez l’ID d’environnement à partir de l’URL ou notez le nom de l’environnement dans le titre de la page.

        Format de l’URL :

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/environments/<environmentID>
    3. Obtenez l’ID de la tâche.
      1. Dans la section Tâches, sélectionnez la tâche associée à votre environnement.
      2. Copiez l’ID de la tâche à partir de l’URL ou notez le nom de la tâche dans le titre de la page.

        Format de l’URL :

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs/<jobID>
    4. Facultatif : : obtenir un ID d’exécution de tâche spécifique.

      Par défaut, le collecteur effectue une collecte à partir de la dernière exécution de tâche réussie. Pour effectuer une récolte à partir d’une exécution spécifique, effectuez ces étapes.

      1. Sur la page Tâche, sélectionnez une exécution de tâche spécifique.
      2. Copiez l’ID d’exécution du travail à partir de l’URL.

        Format de l’URL :

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

    Créer un jeton utilisateur

    Créez un jeton d’accès personnel pour la collecte de métadonnées.

    Avant de commencer

    Rôle requis : admin

    Plan requis : Équipe.

    Pourquoi et quand exécuter cette tâche

    Le plan d’équipe ne prend pas en charge les jetons de compte de service. Vous devez créer un jeton d’accès personnel à l’aide d’un compte d’utilisateur dédié.

    Procédure

    1. Créez un compte d’utilisateur dédié pour le collecteur.
    2. Affectez le rôle d’administrateur au compte d’utilisateur.
    3. Connectez-vous en tant qu’utilisateur dédié.
    4. Accédez à la Profil > Jetons d'accès.
    5. Générez un jeton d’accès personnel.
    6. Copiez la valeur du jeton.

      Vous utiliserez cette valeur de jeton pour la clé API dbt Cloud lors de la configuration du collecteur.

    Que faire ensuite

    Consultez la documentation sur les jetons d’utilisateur dbt Cloud pour plus d’informations.

    Créer un jeton de service

    Créez un jeton de compte de service avec les autorisations requises pour la collecte des métadonnées.

    Avant de commencer

    Rôle requis : admin

    Plan requis : Entreprise.

    Pourquoi et quand exécuter cette tâche

    Pour les comptes d’entreprise, les jetons de compte de service sont couramment utilisés pour les systèmes de production.

    Procédure

    1. Créez un jeton de compte de service.

      Suivez les étapes de la documentation relative aux jetons de service dbt Cloud.

    2. Affectez des rôles au jeton du compte de service.
      • Visionneuse de compte : affectée au niveau du compte
      • Visionneuse de tâches : affectée au niveau du projet pour chaque projet à partir duquel collecter les métadonnées
    3. Copiez la valeur du jeton.

      Vous utiliserez cette valeur de jeton pour la clé API dbt Cloud lors de la configuration du collecteur.

    Mettre à jour les paramètres d’exécution de la tâche

    Activez la génération de documentation dans dbt Paramètres de la tâche dans le cloud. Ce paramètre doit être activé pour que les ressources DBT soient collectées avec succès.

    Avant de commencer

    Rôle requis : admin

    Ce paramètre doit être activé pour que les ressources DBT soient collectées avec succès.

    Procédure

    1. Accédez à la Déployer > Tâches.
    2. Dans la liste Environnement , sélectionnez l’environnement sur lequel vous souhaitez exécuter le module de collection.
    3. Sélectionnez la tâche associée à votre environnement.
    4. Sélectionnez Paramètres.
    5. Sous Paramètres d’exécution, sélectionnez Générer des documents à l’exécution.