Snowflake

{{< details >}}

• Édition : GitLab Premium, GitLab Ultimate
• Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

• Introduit pour les événements d'audit dans GitLab 17.1.

{{< /history >}}

Le GitLab Data Connector Snowflake extrait des données dans Snowflake.

Dans Snowflake, vous pouvez ensuite afficher, combiner, manipuler et générer des rapports sur toutes les données. Le GitLab Data Connector est basé sur les API REST GitLab et nécessite une configuration Snowflake et GitLab.

Prérequis {#prerequisites}

1. Si vous ne possédez pas de jeton d'accès personnel GitLab :
   1. Connectez-vous à GitLab.
   2. Suivez les étapes décrites pour créer un jeton d'accès personnel.
2. Créez une external access integration dans Snowflake. Pour plus d'informations, consultez la documentation de configuration dans le projet snowflake-connector.
3. Créez un warehouse dans Snowflake.

Configurer le GitLab Data Connector {#configure-the-gitlab-data-connector}

1. Connectez-vous à Snowflake.
2. Sélectionnez Data Products > Marketplace.
3. Recherchez GitLab Data Connector.
4. Sélectionnez Data Products > Apps.
5. Sélectionnez GitLab Data Connector.
6. Sélectionnez un warehouse sur lequel le GitLab Data Connector s'exécute.
7. Sélectionnez Start Configuration.
8. Sélectionnez Grant privileges.
9. Saisissez un warehouse et un schéma de destination. Il peut s'agir de n'importe quel warehouse et schéma de votre choix.
10. Sélectionnez Configurer.
11. Saisissez une External access integration.
12. Saisissez le chemin où le secret du jeton d'accès personnel GitLab est stocké.
13. Saisissez le domaine de votre instance GitLab. Par exemple, gitlab.com.
14. Sélectionnez Connecter.
15. Saisissez un nom de groupe. Par exemple, my-group.
16. Sélectionnez Finalize configurator.
17. Sélectionnez Configurer.

Activer les projets et les groupes {#enable-projects-and-groups}

Après avoir configuré le GitLab Data Connector, vous devez spécifier quels projets ou groupes verront leurs événements d'audit ingérés dans Snowflake. Si vous n'ajoutez pas au moins un projet ou un groupe, aucune donnée n'est ingérée.

Activer les projets {#enable-projects}

Pour ajouter des projets dont vous souhaitez ingérer les événements d'audit :

1. Connectez-vous à Snowflake.
2. Sélectionnez Data Products > Apps.
3. Sélectionnez GitLab Data Connector.
4. Sélectionnez l'onglet Enabled Projects.
5. Saisissez le chemin du projet que vous souhaitez activer. Par exemple, my-group/my-project.
6. Sélectionnez Ajouter.
7. Répétez l'opération pour chaque projet supplémentaire.

Activer les groupes {#enable-groups}

Pour ajouter des groupes dont vous souhaitez ingérer les événements d'audit :

1. Connectez-vous à Snowflake.
2. Sélectionnez Data Products > Apps.
3. Sélectionnez GitLab Data Connector.
4. Sélectionnez l'onglet Enabled Groups.
5. Saisissez le chemin du groupe que vous souhaitez activer. Par exemple, my-group.
6. Sélectionnez Ajouter.
7. Répétez l'opération pour chaque groupe supplémentaire.

Afficher les données dans Snowflake {#view-data-in-snowflake}

1. Connectez-vous à Snowflake.
2. Sélectionnez Data > Bases de données.
3. Sélectionnez le warehouse précédemment configuré.

Dépannage {#troubleshooting}

Aucune donnée n'apparaît dans Snowflake {#no-data-appearing-in-snowflake}

Si aucune donnée n'apparaît dans Snowflake, vérifiez les points suivants :

• Vous n'avez pas ajouté au moins un projet ou un groupe dans l'onglet Enabled Projects ou Enabled Groups. Pour plus d'informations, consultez Activer les projets et les groupes.
• Le jeton d'accès personnel GitLab ne dispose pas des portées requises pour lire les événements d'audit.
• Le warehouse Snowflake configuré pour le GitLab Data Connector est suspendu.