CREATE DBT PROJECT¶

Syntaxe¶

CREATE [ OR REPLACE ] DBT PROJECT [ IF NOT EXISTS ] <name>
  [ FROM '<source_location>' ]
  [ COMMENT = '<string_literal>' ]
  [ DEFAULT_TARGET = <default_target> ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

Parameters¶

name

Chaîne qui spécifie l’identificateur (c’est-à-dire le nom) de l’objet de projet dbt dans Snowflake ; doit être unique pour le schéma dans lequel le projet dbt est créé.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

FROM 'source_location'

Chaîne qui spécifie l’emplacement dans Snowflake des fichiers sources de l’objet de projet dbt. Il peut s’agir d’un répertoire parent contenant plusieurs projets dbt, ou d’un sous-répertoire spécifique contenant un projet dbt et un fichier:file:dbt_project.yml.

Si l’emplacement spécifié ne contient pas de fichier dbt_project.yml, la commande EXECUTE DBT PROJECT doit utiliser le paramètre PROJECT_ROOT pour spécifier le chemin du sous-répertoire vers un fichier dbt_project.yml.

Si aucune valeur n’est spécifiée, Snowflake crée un projet dbt vide.

Les fichiers sources du projet dbt peuvent se trouver à l’un des emplacements suivants :

• Une zone de préparation de référentiel Git, par exemple :

  '@my_db.my_schema.my_git_repository_stage/branches/my_branch/path/to/dbt_project_or_projects_parent'

  For more information about creating a Git repository object in Snowflake that connects a Git repository to a workspace for dbt Projects on Snowflake, see Créer un espace de travail connecté à votre dépôt Git. For more information about creating and managing a Git repository object and stage without using a workspace, see Utilisation d’un référentiel Git dans Snowflake and CREATE GIT REPOSITORY.

• Une zone de préparation de projet dbt existante, par exemple :

  'snow://dbt/my_db.my_schema.my_existing_dbt_project_object/versions/last'

  Le spécificateur de version est obligatoire et peut être last (comme dans l’exemple précédent), first ou le spécificateur de toute version existante sous la forme version$<nb>. Pour plus d’informations, voir Gestion des versions pour les objets et fichiers de projet dbt.

• Une zone de préparation interne nommée, par exemple :

  '@my_db.my_schema.my_internal_named_stage/path/to/dbt_projects_or_projects_parent'

  Les zones de préparation d’utilisateur internes et les zones de préparation de table ne sont pas prises en charge.

• Un espace de travail pour dbt sur Snowflake, par exemple :

  'snow://workspace/user$.public."my_workspace_name"/versions/live/path/to/dbt_projects_or_projects_parent'

  Il est recommandé de mettre le nom de l’espace de travail entre guillemets doubles, car les noms d’espace de travail sont sensibles à la casse et peuvent contenir des caractères spéciaux.

  Le spécificateur de version est obligatoire et peut être last, first, live ou le spécificateur de toute version existante sous la forme version$<nb>. Pour plus d’informations, voir Gestion des versions pour les objets et fichiers de projet dbt.

Par défaut : aucune valeur

COMMENT = 'string_literal'

Spécifie un commentaire pour l’objet de projet dbt.

Par défaut : aucune valeur

DEFAULT_TARGET = default_target

Spécifie le profil utilisé pour la compilation et les exécutions suivantes (par exemple, prod) de l’objet du projet dbt. Vous pouvez remplacer ce paramètre en utilisant la commande EXECUTE DBT PROJECT avec ARGS = --target.

Par défaut : aucune valeur

EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] )

Spécifie l’intégration d’accès externe utilisée pour accorder des autorisations afin d’extraire des dépendances distantes du hub de paquets dbt ou de Github. Lorsqu’elle est déclarée sur un objet, dbt deps s’exécutera automatiquement pendant le déploiement. Pour plus d’informations, voir Comprendre les dépendances des projets dbt sur Snowflake.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

• Les clauses OR REPLACE et IF NOT EXISTS s’excluent mutuellement. Elles ne peuvent pas toutes les deux être utilisées dans la même instruction.

• Les instructions CREATE OR REPLACE <objet> sont atomiques. En d’autres termes, lorsqu’un objet est remplacé, l’ancien objet est supprimé et le nouvel objet est créé dans une seule transaction.

• Concernant les métadonnées :

  Attention

  Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

• Créer un objet de projet dbt à partir d’une zone de préparation du référentiel Git dans Snowflake

• Créer un objet de projet dbt à partir d’un sous-répertoire au sein d’une zone de préparation de référentiel Git dans Snowflake

• Créer un objet de projet dbt à partir d’une version spécifique d’un objet de projet dbt existant

• Créer un objet de projet dbt à partir d’un espace de travail contenant plusieurs projets dbt

CREATE DBT PROJECT sales_db.dbt_projects_schema.sales_model
  FROM '@sales_db.integrations_schema.sales_dbt_git_stage/branches/main'
  DEFAULT_TARGET = 'prod'
  EXTERNAL_ACCESS_INTEGRATIONS = 'my_external_access_integration'
  COMMENT = 'Generates sales data models.';

CREATE DBT PROJECT sales_db.dbt_projects_schema.sw_region_sales_model
  FROM '@sales_db.integrations_schema.sales_dbt_git_stage/branches/main/sales_dbt_projects_parent/sw_region_dbt_project'
  DEFAULT_TARGET = 'prod'
  EXTERNAL_ACCESS_INTEGRATIONS = 'my_external_access_integration'
  COMMENT = 'Generates data models for SW sales region.';

CREATE DBT PROJECT sales_db.dbt_projects_schema.sales_model_nw_region
  FROM 'snow://dbt/sales_db.dbt_projects_schema.sales_model/versions/version$2'
  DEFAULT_TARGET = 'prod'
  EXTERNAL_ACCESS_INTEGRATIONS = (my_ext_integration_1, my_ext_integration_2)
  COMMENT = 'Generates data models for the NW sales region.';

CREATE DBT PROJECT sales_db.dbt_projects_schema.sales_model_from_workspace
  FROM 'snow://workspace/user$.public."My dbt Project Workspace"/versions/live/project2'

EXECUTE DBT PROJECT sales_db.dbt_projects_schema.sales_model_from_workspace
  ARGS = 'run --target prod';