{"id":248588,"date":"2022-03-15T09:51:20","date_gmt":"2022-03-15T08:51:20","guid":{"rendered":"https:\/\/blog.jetbrains.com\/datagrip\/2022\/03\/15\/working-with-source-code-in-datagrip\/"},"modified":"2022-05-24T15:56:22","modified_gmt":"2022-05-24T14:56:22","slug":"travailler-avec-le-code-source-dans-datagrip","status":"publish","type":"datagrip","link":"https:\/\/blog.jetbrains.com\/fr\/datagrip\/2022\/03\/15\/travailler-avec-le-code-source-dans-datagrip\/","title":{"rendered":"Travailler avec le code source dans DataGrip"},"content":{"rendered":"
\"Travailler<\/figure>\n

<\/span>Les Bases<\/h2>\n

Le code source de l’objet est la partie principale<\/strong> du script DDL qui est n\u00e9cessaire pour cr\u00e9er cet objet. En d’autres termes, l’instruction CREATE<\/em> ne fait pas partie du code source de l’objet. Le code source est stock\u00e9 dans la base de donn\u00e9es. Les objets les plus courants dans le code source sont les vues, les fonctions et les proc\u00e9dures stock\u00e9es.<\/p>\n

Pour mettre \u00e0 jour le code source, de nombreux outils requi\u00e8rent de g\u00e9n\u00e9rer le script CREATE OR REPLACE<\/em>, d’effectuer les modifications n\u00e9cessaires et d’ex\u00e9cuter le script. Dans Datagrip, cela fonctionne diff\u00e9remment. Il vous suffit d’effectuer les modifications et le script sera g\u00e9n\u00e9r\u00e9 pour vous.<\/p>\n

Les personnes utilisant d’autres outils font toutes la m\u00eame chose : elles ouvrent le DDL, le copient, le modifient, ajustent la d\u00e9claration CREATE<\/em> (g\u00e9n\u00e9ralement en ajoutant la partie OR REPLACE<\/em>) et ex\u00e9cutent le nouveau script. Ce n’est pas la mani\u00e8re de proc\u00e9der pour mettre \u00e0 jour le code source<\/strong><\/p>\n

<\/span>Chargement des sources<\/h2>\n

Quelle que soit la source de donn\u00e9es, DataGrip ex\u00e9cute un processus \u00ab d’introspection \u00bb \u2013 l’IDE r\u00e9cup\u00e8re toutes les m\u00e9tadonn\u00e9es des objets \u00e0 l’avance. Ainsi, l’ensemble du code source est charg\u00e9 lorsque l’introspection est effectu\u00e9e.<\/p>\n

Vous pouvez g\u00e9rer ce processus en choisissant la valeur requise dans les options Load Sources for<\/em> des propri\u00e9t\u00e9s de la source de donn\u00e9es.<\/p>\n

\"\"<\/figure>\n

Dans Oracle, il est possible de ne pas charger les sources en choisissant un niveau d’introspection inf\u00e9rieur :<\/p>\n

\"\"<\/figure>\n

Vous vous demandez peut-\u00eatre : si le code source est charg\u00e9 lors de l’introspection, cela ne signifie-t-il pas qu’il est obsol\u00e8te ?<\/p>\n

En effet, il l’est. Nous verrons comment g\u00e9rer cette situation plus tard dans ce tutoriel.<\/p>\n

<\/span>Le flux<\/h2>\n

Pour ouvrir l’\u00e9diteur DDL, double-cliquez sur l’objet dans l’explorateur de base de donn\u00e9es ou appuyez sur Cmd\/Ctrl+B<\/em> dans le script SQL. Double-cliquer sur la vue dans l’explorateur de bases de donn\u00e9es ouvrira les donn\u00e9es. Pour ouvrir l’explorateur DDL, cliquez sur le bouton DDL dans la barre d’outils.<\/p>\n

L’\u00e9diteur DDL s’ouvrira. L\u00e0, vous trouverez le script CREATE<\/em> pour l’objet.<\/p>\n

\"\"<\/figure>\n

Important ! <\/strong>Les r\u00e9f\u00e9rences de l’objet dans le script g\u00e9n\u00e9r\u00e9 ne sont pas qualifi\u00e9es. En d’autres termes, %view_name%<\/em> est utilis\u00e9 \u00e0 la place de %schema_name%.%view_name%<\/em>. Vous avez ainsi la possibilit\u00e9 de copier le script et de l’appliquer dans un autre contexte. Si vous voulez un script avec des r\u00e9f\u00e9rences qualifi\u00e9es, utilisez le g\u00e9n\u00e9rateur SQL<\/a>.<\/p>\n

Le code source peut \u00eatre modifi\u00e9 dans l’\u00e9diteur DDL. Lorsque vous modifiez le code source d’un objet, DataGrip suit les modifications et les met en \u00e9vidence dans la goutti\u00e8re.<\/p>\n

\"\"<\/figure>\n

Ajoutez par exemple une ligne de commentaire \u00e0 une proc\u00e9dure ou \u00e0 une fonction. La ligne que vous avez ajout\u00e9e est mise en \u00e9vidence. Si vous cliquez sur la ligne mise en \u00e9vidence dans la goutti\u00e8re, une petite barre d’outils avec le bouton Show Diff<\/em> s’affiche. Pour voir la diff\u00e9rence entre le code que vous avez ajout\u00e9 et le code source, cliquez sur le bouton Show Diff<\/em>.<\/p>\n

\"\"<\/figure>\n

Apr\u00e8s avoir effectu\u00e9 les modifications, cliquez sur le bouton Submit<\/em>.<\/p>\n

\"\"<\/figure>\n

DataGrip g\u00e9n\u00e8re alors le script de modification et vous en montre un aper\u00e7u.<\/p>\n

\"\"<\/figure>\n

Si le r\u00e9sultat vous convient, cliquez sur OK et le script sera ex\u00e9cut\u00e9 dans la base de donn\u00e9es. Le code source concern\u00e9 sera alors modifi\u00e9. <\/p>\n

DataGrip ne fait pas qu’ajouter OR REPLACE<\/em> au script de cr\u00e9ation, il peut \u00e9galement g\u00e9rer des situations plus complexes, telles que la modification de la signature de l’objet ou le renommage de l’objet. Des scripts DROP<\/em> et CREATE<\/em> seront cr\u00e9\u00e9s quand cela sera n\u00e9cessaire.<\/p>\n

\"\"<\/figure>\n

<\/span>Modification de plusieurs objets simultan\u00e9ment<\/h2>\n

Lorsque des modifications ont \u00e9t\u00e9 effectu\u00e9es dans l’\u00e9diteur DDL mais qu’elles ne sont pas encore valid\u00e9es, DataGrip les stocke jusqu’\u00e0 ce que vous le fassiez. Par exemple, si vous avez modifi\u00e9 plusieurs objets, plusieurs DDL modifi\u00e9s sont mis en cache en attendant d’\u00eatre appliqu\u00e9s. Dans la fen\u00eatre d’outils Database Changes<\/em>, vous pouvez voir toutes les modifications de code source en attente et toutes les valider simultan\u00e9ment.<\/p>\n

\"\"<\/figure>\n

<\/span>Objets en cache obsol\u00e8tes<\/h2>\n

Comme nous l’avons mentionn\u00e9 plus haut, DataGrip met en cache le code source qui a \u00e9t\u00e9 charg\u00e9 lors de l’introspection. Si un objet que vous avez ouvert a \u00e9t\u00e9 mis \u00e0 jour depuis un emplacement tiers, vous recevrez une notification indiquant que l’objet mis en cache diff\u00e8re du code source du m\u00eame objet dans la base de donn\u00e9es.<\/p>\n

\"\"<\/figure>\n

Si cet avertissement appara\u00eet dans l’IDE, vous pouvez choisir l’une des actions suivantes :<\/p>\n

    \n
  • Synchronize<\/em> : r\u00e9cup\u00e8re les modifications de la base de donn\u00e9es et met \u00e0 jour l’objet local mis en cache.<\/li>\n
  • Disable check<\/em> : d\u00e9sactive cette notification.<\/li>\n<\/ul>\n

    Il est aussi possible qu’il y ait un conflit entre votre version du code source de l’objet et celle de la base de donn\u00e9es. Cela peut se produire lorsque vous avez modifi\u00e9 le m\u00eame code source qu’une autre personne, puis cliqu\u00e9 sur Submit<\/strong> par exemple.<\/p>\n

    \"\"<\/figure>\n

    Vous pouvez forcer le remplacement du code source de l’objet dans la base de donn\u00e9es en utilisant Force Refactoring<\/em> ou synchroniser l’\u00e9tat de l’objet et proc\u00e9der ensuite aux modifications en cliquant sur Abort Refactoring and Synchronize<\/em>.<\/p>\n

    Si vous avez s\u00e9lectionn\u00e9 Abort Refactoring and Synchronize<\/em>, DataGrip abandonne l’op\u00e9ration d’envoi et r\u00e9cup\u00e8re les modifications de la base de donn\u00e9es, tout comme si vous aviez cliqu\u00e9 sur Synchronize<\/em>. Si le conflit existe toujours, vous verrez la notification suivante.<\/p>\n

    \"\"<\/figure>\n

    Dans cette notification, vous pouvez choisir entre plusieurs options :<\/p>\n

      \n
    • Revert local changes<\/em> : pour annuler toutes vos modifications et les remplacer par la version de la base de donn\u00e9es.<\/li>\n
    • Keep local changes<\/em> : pour utiliser vos modifications et \u00e9craser les modifications dans la base de donn\u00e9es.<\/li>\n
    • Merge<\/em> : pour afficher la bo\u00eete de dialogue Diff et fusionner les versions du code source de l’objet.<\/li>\n<\/ul>\n

      <\/span>Historique locale<\/h2>\n

      Toutes les modifications que vous apportez au code source sont stock\u00e9es localement. Pour revenir en arri\u00e8re et v\u00e9rifier le code source de la fonction avant les derni\u00e8res mises \u00e0 jour, utilisez Local History.<\/em><\/p>\n

      \"\"<\/figure>\n

      Dans Local History <\/em>, les r\u00e9visions contiennent toutes vos modifications locales et incluent \u00e9galement les versions r\u00e9cup\u00e9r\u00e9es dans la base de donn\u00e9es lors des introspections. Ainsi, les versions de l’objet qui ont \u00e9t\u00e9 introduites \u00e0 partir de sources tierces et qui n’ont pas \u00e9t\u00e9 \u00ab charg\u00e9es \u00bb pendant l’introspection peuvent manquer. Vous pouvez comparer toute r\u00e9vision historique avec la version actuelle du code source.<\/p>\n

      \"\"<\/figure>\n

      Si vous \u00eates la seule personne qui travaille avec une base de donn\u00e9es particuli\u00e8re et que vous modifiez les sources uniquement \u00e0 partir de DataGrip, vous disposez d’un historique complet des modifications des objets dans Local History<\/em>. <\/p>\n

      Et voil\u00e0 ! Nous avons conscience que ce flux peut para\u00eetre surprenant, surtout si vous avez l’habitude d’utiliser un outil diff\u00e9rent, mais il vous simplifiera la t\u00e2che en supprimant les op\u00e9rations r\u00e9p\u00e9titives.<\/p>\n

      L’\u00c9quipe DataGrip.<\/p>\n

      P.S. Le mod\u00e8le de couleurs utilis\u00e9 pour les captures d’\u00e9cran est Monocai<\/em>.<\/p>\n

      Auteur de l’article original en anglais<\/em> :<\/p>\n\n

      \n
      \n
      \n
      \n \"\"\n <\/div>\n
      \n <\/div>\n <\/div>\n <\/div>\n <\/div>\n","protected":false},"author":813,"featured_media":248594,"comment_status":"closed","ping_status":"closed","template":"","categories":[2347],"tags":[91,792],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/datagrip\/248588"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/datagrip"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/types\/datagrip"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/users\/813"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/comments?post=248588"}],"version-history":[{"count":7,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/datagrip\/248588\/revisions"}],"predecessor-version":[{"id":248619,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/datagrip\/248588\/revisions\/248619"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/media\/248594"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/media?parent=248588"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/categories?post=248588"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/tags?post=248588"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/fr\/wp-json\/wp\/v2\/cross-post-tag?post=248588"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}