Espaces de travail¶

Gérer les fichiers¶

Vous pouvez renommer, supprimer, déplacer et organiser vos espaces de travail, vos fichiers et vos dossiers.

Pour renommer ou supprimer un espace de travail, un fichier ou un dossier :

1. Passez la souris sur la cible et sélectionnez l’ellipse verticale (plus d’actions).

2. Sélectionnez Rename ou Delete. Si vous choisissez de supprimer, vous êtes invité à confirmer.

• Pour créer un dossier dans un espace de travail, sélectionnez l’adresse + en regard de l’espace de travail ou d’un dossier existant.

• Pour organiser les fichiers et les dossiers, faites glisser n’importe quel fichier ou dossier vers un autre emplacement dans le même espace de travail. Vous pouvez également faire glisser une feuille de calcul dans un espace de travail.

Voir plusieurs fichiers ou résultats en une seule fois¶

Le fait de gérer plusieurs fichiers à l’aide d’onglets et de volets divisés présente plusieurs avantages :

• Comparer du code ou des résultats côte à côte : référencez rapidement une requête de feuille de calcul tout en travaillant sur une autre feuille de calcul.

• Effectuer plusieurs tâches à la fois de manière plus efficace : affichez plusieurs cellules, sorties ou fichiers à la fois, sans avoir à passer d’une cellule à l’autre.

Pour ajuster la disposition de votre espace de travail, sélectionnez l’ellipse verticale (plus d’actions) dans le volet Workspaces et choisissez l’option appropriée :

1. Split right

2. Split down

3. Close others

Créer un espace de travail Git¶

Vous pouvez créer un espace de travail connecté à un référentiel Git pour développer et gérer des fichiers directement dans Snowsight.

Pour créer un nouvel espace de travail synchronisé avec Git :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Dans le menu Workspaces, sélectionnez From Git repository.

4. Copiez l’URL de votre référentiel Git (par exemple, https://www.github.com/my-user/my-repo-name), puis collez-la dans le champ Repository URL.

5. Facultatif : renommez le nouvel espace de travail synchronisé avec Git.

6. Dans le menu API Integration, sélectionnez une intégration API.

   Les intégrations API sont créées par l’administrateur de compte et doivent permettre l’accès à l’URL du référentiel Git que vous utilisez à l’étape 4. Pour plus de détails, voir Créer une intégration API pour interagir avec l’API du référentiel.

   En outre, si vous utilisez GitHub comme fournisseur Git et préférez OAuth pour l’authentification, l’administrateur de compte doit créer une intégration API qui prend en charge OAuth. Par exemple :

   CREATE OR REPLACE API INTEGRATION api_integration_name
      API_PROVIDER = git_https_api
      API_ALLOWED_PREFIXES = ('https://github.com/')
      API_USER_AUTHENTICATION = (
         TYPE = snowflake_github_app
      )
      ENABLED = TRUE;
   

   Copy

7. Sous API integration, sélectionnez une méthode d’authentification :

   • OAuth2 - Sélectionnez Sign in pour vous authentifier auprès de votre référentiel GitHub. Une fois connecté, vous n’aurez plus besoin de fournir d’identifiants de connexion lors des sessions suivantes. Notez qu’OAuth2 n’est pas disponible pour les environnements PrivateLink.

   • Personal access token - Sélectionnez la base de données et le schéma dans lesquels l’objet contenant votre jeton est stocké. Pour créer un nouveau secret, sélectionnez + Secret et entrez les détails requis. L’intégration API doit être configurée pour autoriser l’accès à ce secret ou à tous les secrets.

   • Public repository - Sélectionnez cette option si vous utilisez un référentiel public qui ne requiert pas d’authentification. Notez qu’il n’est pas possible de valider et de transférer des modifications de votre espace de travail vers ce référentiel public.

8. Sélectionnez Create.

Mettre à jour les détails et les identifiants de connexion d’un auteur pour une branche¶

Par défaut, votre adresse e-mail et votre nom d’utilisateur Snowflake sont utilisés pour valider les modifications dans votre référentiel Git. Vous pouvez les mettre à jour à tout moment.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Sélectionnez l’onglet Changes.

4. Sélectionnez l’ellipse, puis Edit credentials.

5. Indiquez le nom et l’adresse e-mail de l’auteur.

6. Sélectionnez Update.

Créer une nouvelle branche¶

Vous pouvez créer une nouvelle branche à partir de votre branche actuelle pour travailler sur des modifications de manière indépendante.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Sélectionnez l’onglet Changes.

4. Sélectionnez le référentiel dans la liste déroulante.

5. Sélectionnez + New.

6. Spécifiez un nouveau nom de branche, puis sélectionnez Create.

Changer de branche¶

Si vous avez enregistré des modifications non validées, vous devrez choisir comment les traiter avant de changer de branche.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Dans la vue de l’espace de travail Git, sélectionnez Changes.

4. Dans le menu de la branche, sélectionnez la branche vers laquelle vous souhaitez basculer.

   Conseil : pour filtrer la liste, commencez à taper le nom d’une branche.

Récupérer des branches distantes¶

Si une nouvelle branche a été créée en dehors de Snowsight (par exemple, une branche créée dans votre fournisseur Git), vous pouvez la récupérer dans votre espace de travail synchronisé avec Git en utilisant l’option Fetch All. Cette opération met à jour votre liste de branches distantes disponibles.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Dans la vue de l’espace de travail Git, sélectionnez Changes.

4. Sélectionnez la flèche vers le bas à côté du menu Pull, puis sélectionnez Fetch All. Lorsque la récupération est terminée, les branches distantes nouvellement créées apparaissent dans la liste des branches et sont disponibles à l’extraction.

Voir les fichiers mis à jour¶

Pour voir tous les fichiers qui ont été ajoutés, supprimés ou modifiés depuis le dernier commit et push mené à bien :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. En haut de la vue des dossiers, sélectionnez Changes. Les fichiers modifiés sont signalés par un M, les fichiers ajoutés par un A, et les fichiers supprimés par un D.

4. Pour voir un diff visuel des modifications dans l’éditeur, sélectionnez un fichier.

Valider et transférer des mises à jour¶

Après avoir examiné vos modifications, vous pouvez les valider et les transférer vers votre référentiel Git distant depuis l’espace de travail.

Pour valider et transférer vos fichiers mis à jour vers le référentiel Git distant :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Projects » Workspaces.

3. Sélectionnez Changes en haut de la vue des dossiers.

4. Rédigez un message de validation dans le champ Commit message.

5. Sélectionnez Push.

6. Rédigez un message de validation et sélectionnez Push pour publier vos mises à jour dans le référentiel Git.

   Note

   Si des conflits sont détectés, vous êtes invité à faire un pull d’abord. Sélectionnez Pull pour consulter la liste des fichiers en conflit.

Voir et résoudre les conflits¶

Si un conflit survient au cours d’un envoi, vous pouvez le voir et le résoudre directement dans l’espace de travail avant d’effectuer un nouvel envoi.

1. Dans Workspaces, en haut de la vue des dossiers, sélectionnez Changes. Si un ou plusieurs fichiers sont en conflit, un message s’affiche en haut de la vue. Les fichiers présentant un conflit sont signalés par un M rouge.

2. Pour voir un diff visuel du conflit dans l’éditeur, sélectionnez un fichier. Sous File with conflicts, les différences sont mises en évidence en ligne.

3. Acceptez le changement en cours, un changement à venir ou les deux changements. Le résultat de la fusion est affiché.

4. Sous Diff View, vous pouvez voir côte à côte la version actuelle et la version distante.

5. Sélectionnez Accept all current ou Accept all remote.

6. Après avoir résolu les conflits, sélectionnez Push.

7. Rédigez un message de validation.

8. Sélectionnez Push.