Aucun résultat trouvé

Votre recherche n’a donné aucun résultat.

Nous vous suggérons d’essayer ce qui suit pour trouver ce que vous recherchez :

  • Vérifiez l’orthographe de votre recherche par mot clé.
  • Utilisez des synonymes pour le mot clé que vous avez tapé, par exemple, essayez “application” au lieu de “logiciel”.
  • Essayez l’une des recherches populaires ci-dessous.
  • Lancer une nouvelle recherche.
Questions tendances

Mise en route avec Oracle Developer Tools for VS Code

Bienvenue ! Oracle Developer Tools for VS Code permet aux développeurs Visual Studio Code de se connecter à Oracle Database et Oracle Autonomous Database, de modifier les instructions SQL et PL/SQL à l’aide de la saisie semi-automatique, intellisense, de la coloration syntaxique et des extraits de code, d’exécuter SQL et PL/SQL, ainsi que d’enregistrer les résultats dans des formats tels que .CSV et JSON. Le contrôle d’arborescence Oracle Database Explorer vous permet d’explorer rapidement votre schéma de base de données, d’afficher les données de la table et de modifier, d’exécuter et d’enregistrer le code PL/SQL.

Ce guide de démarrage rapide vous aidera à installer, connecter et configurer Oracle Developer Tools for VS Code.

Remarque : Ce document suppose que vous utilisez la version 19.3.2 (publiée le 30/09/2019). Si vous utilisez une version plus ancienne, suivez les instructions ci-dessous pour effectuer une mise à jour. Nous envisageons de publier de nouvelles versions fréquemment.

Problème connu :

ORA-12154 lors de la reconnexion à partir de’Oracle Database Explorer après la mise à niveau vers la version 19.3.2 : Une connexion à la base de données Oracle Explorer créée avec la version 19.3.1 renvoie une erreur ORA-12154 TNS : impossible de résoudre l’identificateur de connexion spécifié  après la mise à niveau vers la version 19.3.2. Pour résoudre le problème, cliquez avec le bouton droit sur n’importe quelle connexion et sélectionnez Mettre à jour la connexion. Appuyez ensuite sur le bouton Mettre à jour la connexion dans la boîte de dialogue de connexion.

Démarrage rapide

 

Installer

  • Installez .NET Core Runtime version 2.1 ou 2.2 :
    • Linux
    • macOS
    • Windows (x64)
    • Plus d’options
    • Remarque : l’installation ne fonctionnera pas si vous n’avez installé que .NET Core 3.0 ou version ultérieure - cependant plusieurs versions de .NET Core peuvent être installées sur votre ordinateur si nécessaire.
  • Cliquez sur l’icône Extensions dans la barre d’activité sur le côté de VS Code ou utilisez la commande Vue : Afficher les extensions (Ctrl+Shift+X)
  • Entrez Oracle dans la barre de recherche d’extension.
  • Repérez Oracle Developer Tools for VS Code, puis cliquez sur Installer.
  • Une fois l’installation terminée, redémarrez Visual Studio Code.

Mettre à jour cette extension

  • Visual Studio Code recherche automatiquement les mises à jour d’extensions et les installe. Après la mise à jour, vous serez invité à redémarrer Visual Studio Code.
  • Si vous avez désactivé les mises à jour automatiques, appuyez sur F1 pour ouvrir la palette de commandes et entrez la commande Vérifier les mises à jour d’extension, puis cliquez sur le bouton Mettre à jour... qui s’affiche dans la liste des extensions installées. Pour plus d’informations cliquez ici.

Explorer le schéma de base de données avec Oracle Database Explorer

  • Pour afficher l’explorateur de base de données, cliquez sur l’icône de la base de données dans la barre d’activité à l’extrême gauche de Visual Studio Code.
    • Connexion : Cliquez sur le bouton du signe plus pour créer une nouvelle connexion, en suivant les étapes ci-dessous pour vous connecter à Oracle Database ou vous connecter via un alias de connexion TNSNAMES.ORA. Une fois les nœuds de connexion affichés, vous pouvez cliquer sur le nœud pour afficher le schéma de base de données.
    • Supprimer la connexion : Cliquez avec le bouton droit sur n’importe quel nœud de connexion et sélectionnez Supprimer la connexion.
    • Mettre à jour les informations de connexion : Cliquez avec le bouton droit sur n’importe quel nœud de connexion et sélectionnez Mettre à jour la connexion.
    • Déconnecter : Cliquez avec le bouton droit sur n’importe quel nœud de connexion et sélectionnez Déconnecter.
    • Afficher et enregistrer une table/afficher des données : Dans le menu de nœuds Table et Vue, sélectionnez Afficher les données. Pour plus d’informations, consultez Affichage et enregistrement des ensembles de résultats ci-après.
    • Modifier le code PL/SQL : Sur les procédures stockées, les fonctions, les packs ou les nœuds de déclencheur, sélectionnez Modifier/Modifier le corps du pack/Modifier la spécification pour ouvrir le code PL/SQL dans un fichier pour le modifier. Pour plus de détails, consultez la section Modification de codes PL/SQL existants dans votre base de données ci-dessous.
    • Enregistrer le code PL/SQL dans la base de données : Cliquez avec le bouton droit dans le code PL/SQL et sélectionnez Enregistrer dans la base de données.
    • Enregistrer le code PL/SQL dans un fichier : Sélectionnez l’onglet contenant le code PL/SQL. Dans le menu Visual Studio Code, sélectionnez Fichier->Enregistrer sous.
    • Exécuter le code PL/SQL : Dans le menu, sélectionnez Exécuter pour exécuter une fonction ou une procédure stockée.
    • Rafraîchir :  Cliquez avec le bouton droit sur n’importe quel nœud et sélectionnez Rafraîchir pour actualiser ce nœud et tous les nœuds enfants.
    • Filtrer : Après avoir développé une longue liste de nœuds (par exemple, toutes les tables relationnelles), vous pouvez les filtrer en déplaçant la souris sur n’importe quelle partie d’Oracle Database Explorer, en entrant une chaîne, puis en appuyant sur la touche Entrée. Toutes les correspondances pour cette chaîne sont mises en évidence. Vous pouvez ensuite cliquer sur l’icône de hamburger pour afficher uniquement les correspondances dans Oracle Database Explorer.

Connexion à Oracle Database

  • (Si votre base de données est dans le répertoire Oracle Cloud, accédez à  Connect to Oracle Autonomous Database  ci-dessous.)
  • Pour vous connecter à Oracle Database à partir d’un fichier .SQL ou .PL/SQL, appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Connect dans le menu déroulant.
  • Pour vous connecter depuis Oracle Database Explorer, cliquez sur le bouton du signe plus.
  • Une boîte de dialogue de connexion s’ouvrira. Dans le menu déroulant Type de connexion, sélectionnez Basic.
  • Entrez le nom d’hôte de la base de données, le numéro de port et le nom du service.
  • Sélectionnez le rôle de la base de données dans la liste déroulante Rôle.
  • Entrez le nom d’utilisateur et le mot de passe.
  • Indiquez un nom de connexion à utiliser pour référencer cette connexion dans l’explorateur de bases de données et ailleurs.
  • Cliquez sur le bouton Créer une connexion.

Connexion à l’aide d’un alias de connexion TNSNAMES.ORA

  • Copiez le fichier TNSNAMES.ORA que vous souhaitez utiliser dans le répertoire défini en tant que "Emplacement des fichiers de configuration" dans les paramètres d’extension Oracle Developer Tools for VS Code, ou modifiez ce paramètre à votre guise. Par défaut, cet emplacement est %USERPROFILE%\Oracle\network\admin sous Windows et ~/Oracle/network/admin sous Linux et Mac.
  • Si vous n’avez pas de fichier TNSNAMES.ORA mais souhaitez en créer un, consultez l’exemple situé dans %USERPROFILE%\.vscode\extensions\oracle.oracledevtools-19.3.2\sample\network sous Windows ou dans ~/.vscode/extensions/oracle.oracledevtools-19.3.2/sample/network sous Linux et Mac.
  • Pour vous connecter à Oracle Database à partir d’un fichier .SQL ou .PL/SQL, appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Connect dans le menu déroulant.
  • Pour vous connecter depuis Oracle Database Explorer, cliquez sur le bouton du signe plus.
  • Une boîte de dialogue de connexion s’ouvrira. Dans le menu déroulant Type de connexion, sélectionnez Alias TNS.
  • Assurez-vous que le champ TNS Admin Location est défini sur le répertoire où se trouve votre fichier TNSNAMES.ORA. Sinon, changez-le.
  • Sélectionnez un alias dans le menu déroulant Alias TNS.
  • Sélectionnez le rôle de la base de données dans la liste déroulante Rôle.
  • Entrez le nom d’utilisateur et le mot de passe.
  • Indiquez un nom de connexion à utiliser pour référencer cette connexion dans l’explorateur de bases de données et ailleurs.
  • Cliquez sur le bouton Créer une connexion.

Connexion à Oracle Autonomous Database

  • Obtenez votre Fichier d’informations d’identification du client : Accédez à la console d’administration pour votre Oracle Autonomous Database et cliquez sur Télécharger les informations d’identification du client.  Vous pouvez également vous procurer le fichier d’informations d’identification auprès de votre administrateur.
  • Décompressez les fichiers d’identifiants dans le répertoire défini comme "Emplacement des fichiers de configuration" dans les paramètres d’extension Oracle Developer Tools for VS Code. Par défaut, cet emplacement est %USERPROFILE%\Oracle\network\admin sous Windows et ~/Oracle/network/admin sous Linux et Mac.
  • Pour vous connecter à Oracle Database à partir d’un fichier .SQL ou .PL/SQL, appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Connect dans le menu déroulant.
  • Pour vous connecter depuis Oracle Database Explorer, cliquez sur le bouton du signe plus.
  • Une boîte de dialogue de connexion s’ouvrira. Dans le menu déroulant Type de connexion, sélectionnez Alias TNS.
  • Assurez-vous que le champ TNS Admin Location est défini sur le répertoire où vous avez décompressé vos fichiers d’identifiants. Sinon, changez-le.
  • Sélectionnez le nom d’alias auquel vous souhaitez vous connecter, par exemple mydb_high, dans le menu déroulant Alias TNS. (Notez que s’il existe plusieurs instances Autonomous Database dans votre compte Cloud, vous verrez des alias pour toutes les instances.)
  • Sélectionnez Non-administrateur dans le menu déroulant Rôle.
  • Entrez le nom d’utilisateur et le mot de passe. (Si vous êtes nouveau sur Oracle Autonomous Database, utilisez le nom d’utilisateur admin.)
  • Indiquez un nom de connexion à utiliser pour référencer cette connexion dans l’explorateur de bases de données et ailleurs.
  • Cliquez sur le bouton Créer une connexion.

Connexion à l’aide de l’authentification du système d’exploitation

  • Si vous utilisez Windows Client et Windows Database Server, définissez SQLNET.AUTHENTICATION_SERVICES=(NTS) dans un fichier SQLNET.ORA situé dans le répertoire défini comme "Emplacement des fichiers de configuration" dans les paramètres d’extension Oracle Developer Tools for VS Code. Par défaut, cet emplacement est %USERPROFILE%\Oracle\network\admin.
  • Suivez les étapes de la section Connexion à Oracle Database ou  Connexion à l’aide d’un alias de connexion TNSNAMES.ORA ci-dessus, sauf
  • Lorsque vous êtes invité à entrer un identifiant d’utilisateur, entrez "/" (sans les guillemets).

Connexion à l’aide d’un utilisateur proxy

  • Pour vous connecter à Oracle Database à partir d’un fichier .SQL ou .PL/SQL, appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Connect dans le menu déroulant.
  • Pour vous connecter depuis Oracle Database Explorer, cliquez sur le bouton du signe plus.
  • Une boîte de dialogue de connexion s’ouvrira. Dans le menu déroulant Type de connexion, sélectionnez Chaîne de connexion ODP.NET.
  • Dans le champ Chaîne de connexion, entrez une chaîne avec ce format si vous fournissez explicitement le nom d’hôte, le port et le nom du service :  User Id=myuser;Data Source=dbhostname:1521/DBSERVICENAME;Proxy User Id=myproxyuser;Proxy Password=myproxypass;.
  • Si vous utilisez un alias TNS, entrez une chaîne de connexion au format suivant :  User Id=myuser;Data Source=mytnsalias;Proxy User Id=myproxyuser;Proxy Password=myproxypass;.
  • Indiquez un nom de connexion à utiliser pour référencer cette connexion dans l’explorateur de bases de données et ailleurs.
  • Cliquez sur le bouton Créer une connexion.

Modification des codes PL/SQL existants dans votre base de données

  • Affichez l’explorateur de base de données en cliquant sur l’icône de la base de données dans la barre d’activité à l’extrême gauche de Visual Studio Code.
  • Si le volet de l’explorateur de base de données est vide (absence de nœuds de connexion affichés), cliquez sur le bouton du signe plus pour créer une nouvelle connexion, en suivant les étapes ci-dessus de la section Connexion à Oracle Database ou Connexion à l’aide d’un alias de connexion TNSNAMES.ORA. Une fois les nœuds de connexion affichés, vous pouvez cliquer sur le nœud pour afficher le schéma de base de données.
  • Naviguez dans le contrôle d’arborescence jusqu’au pack PL/SQL, à la fonction/procédure stockée ou au déclencheur que vous souhaitez modifier.
  • Cliquez avec le bouton droit sur le pack PL/SQL, la fonction/procédure stockée ou le déclencheur et sélectionnez Modifier/Modifier le corps du pack/Modifier la spécification pour ouvrir le code PL/SQL dans un fichier pour le modifier.
  • Une fois l’édition terminée, cliquez avec le bouton droit sur le code PL/SQL et sélectionnez Enregistrer dans la base de données.

Ouverture d’un fichier .SQL ou .PL/SQL existant

  • (Remarque : vous pouvez enregistrer le code PL/SQL de votre base de données dans un fichier en accédant à Oracle Database Explorer, en ouvrant un pack, une procédure, une fonction ou un déclencheur dans l’Explorateur, puis en sélectionnant, dans le menu Visual Studio Code, Fichier->Enregistrer sous.)
  • Dans le menu VS Code, sélectionnez Fichier->Ouvrir fichier ou appuyez sur (Ctrl-O).
  • Sélectionnez le fichier que vous souhaitez ouvrir.
  • Appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Connecter dans le menu déroulant.
  • Si vous y êtes invité, sélectionnez Oracle-SQL et PLSQL dans le menu déroulant de langues.
  • Sélectionnez un profil de connexion existant dans la liste ou créez-en un en suivant les étapes décrites dans la section Connexion à Oracle Database ou Connexion à l’aide d’un alias de connexion TNSNAMES.ORA ci-dessus.

Création d’un fichier .SQL ou .PLSQL

  • Appuyez sur F1 pour ouvrir la palette de commandes et sélectionnez Oracle:Développer une nouvelle requête dans le menu déroulant.
  • Sélectionnez un profil de connexion existant dans la liste ou créez-en un en suivant les étapes décrites dans la section Connexion à Oracle Database ou Connexion à l’aide d’un alias de connexion TNSNAMES.ORA ci-dessus.
  • Une fois l’édition terminée, dans le menu VS Code, sélectionnez Fichier->Enregistrer sous pour enregistrer le fichier.

Exécution de code SQL ou PL/SQL

  • Entrez le code SQL ou PL/SQL que vous souhaitez exécuter dans le fichier .SQL ou .PL/SQL.
  • Lors de la saisie, des suggestions de complétion automatique apparaissent au fur et à mesure que vous tapez, par exemple des noms de colonnes. Vous pouvez cliquer sur l’icône i dans les suggestions pour obtenir plus de détails tels que les objets de schéma auxquels la suggestion est associée. Utilisez les touches fléchées pour parcourir les suggestions et la touche Entrée pour sélectionner une suggestion.
  • Entrez un nom de schéma suivi d’un point, par exemple HR. pour utiliser la fonction intellisense pour afficher et sélectionner des objets de base de données.
  • Lors de la saisie, des suggestions d’extrait de code peuvent s’afficher. Vous pouvez voir plus d’extraits en entrant oracle sur une nouvelle ligne.
  • Placez le curseur sur une ligne contenant le code SQL ou PL/SQL que vous souhaitez exécuter. Vous pouvez également sélectionner (mettre en surbrillance) une ou plusieurs instructions SQL ou PL/SQL. Cliquez avec le bouton droit et sélectionnez Exécuter SQL dans le menu. Sélectionnez Tout exécuter si vous souhaitez exécuter l’ensemble du code SQL et PL/SQL dans le fichier actuel.

Affichage et enregistrement des ensembles de résultats

  • Si votre exécution SQL renvoie des lignes, un nouveau document s’ouvre avec le jeu de résultats. Le nombre de lignes initialement extraites est contrôlé par le paramètre d’extension Taille de lot de données. Au fur et à mesure que vous faites défiler les lignes, d’autres seront récupérées.
  • Pour enregistrer les résultats, choisissez le format : .CSV ou JSON. Cliquez ensuite sur l’icône pour enregistrer les lignes sélectionnées ou enregistrer toutes les lignes. Après avoir fourni un nom de fichier et un emplacement, le fichier s’ouvre dans Visual Studio Code.
  • Pour copier les lignes sélectionnées dans le Presse-papiers, cliquez sur l’icône Copier les lignes sélectionnées dans le Presse-papiers.

Utilisation d’une disposition horizontale de l’éditeur

  • Pour modifier la disposition de la fenêtre par défaut de Visual Studio Code afin de diviser l’écran horizontalement, par exemple pour avoir un fichier .SQL dans un volet supérieur et que l’exécution SQL s’affiche dans un volet inférieur, procédez comme suit :
  • Dans le menu VS Code, sélectionnez Affichage->Mise en page de l’éditeur>Deux rangées.
  • Exécutez un code SQL ou PL/SQL comme décrit ci-dessus dans la section Exécution de code SQL ou PL/SQL
  • Faites glisser l’onglet de résultats SQL dans le volet inférieur.
  • Toutes les exécutions SQL supplémentaires continueront à s’afficher dans cet onglet du volet inférieur jusqu’à ce qu’il soit fermé.

Création ou modification de raccourcis clavier

  • Pour créer des raccourcis clavier ou modifier des raccourcis existants, accédez au menu Fichier dans VS Code et sélectionnez Préférences->Raccourcis clavier.
  • Dans la zone de texte de recherche, entrez une partie du nom de l’extension dont vous souhaitez modifier le raccourci, par exemple "Oracle".
  • Une liste de commandes et leurs raccourcis s’affiche. Cliquez sur l’icône en forme de crayon située à gauche d’une ligne pour modifier un raccourci ou sur + (signe plus) pour en créer un nouveau.
  • Lorsque vous y êtes invité, entrez la combinaison de touches et, si vous ne l’utilisez pas, appuyez sur la touche Entrée. Si elle est utilisée par une autre extension, appuyez sur la touche Échap et réessayez.
  • Pour supprimer un raccourci, cliquez avec le bouton droit sur le raccourci et sélectionnez Supprimer le raccourci clavier.

Obtention d’aide ou fourniture de commentaires

Didacticiels
  • Bientôt disponible !
Ressources
  • Bientôt disponible !

Vous avez une question ? Contactez-nous sur les réseaux sociaux