Documentation sur Oracle Cloud Infrastructure

À propos de l'extension de code Visual Studio d'Oracle NoSQL Database

Oracle NoSQL Database Cloud Service fournit une extension pour Microsoft Visual Studio Code qui vous permet de vous connecter à une instance en cours d'exécution d'Oracle NoSQL Database Cloud Service.

Vous pouvez utiliser l'extension de code Visual Studio (VS) d'Oracle NoSQL Database pour :
  • Affichez les tables dans une structure arborescente bien définie avec l'explorateur de tables.
  • Voir les informations sur les colonnes, les index, les clés primaires et les clés de partition pour une table.
  • Voir les données de colonne dans une structure JSON bien formatée.
  • Créez des tables à l'aide d'une entrée de schéma basée sur un formulaire ou fournissez des instructions LDD.
  • Supprimer des tables.
  • Exécutez les interrogations SQL SELECT sur une table et consultez les résultats des interrogations sous forme de tableau.
  • Exécutez des instructions LMD pour mettre à jour, insérer et supprimer des données d'une table.

Cet article contient les rubriques suivantes :

Installation de l'extension de code Visual Studio d'Oracle NoSQL Database

Vous pouvez installer l'extension VS Code d'Oracle NoSQL Database de deux façons. Installez-le à partir de Visual Studio Marketplace pour une installation en ligne ou à partir de l'ensemble VSIX à l'aide du fichier *.vsix pour une installation hors ligne.

Pour pouvoir installer l'extension de code Visual Studio (VS) d'Oracle NoSQL Database, vous devez installer Visual Studio Code. Vous pouvez télécharger Visual Studio Code à partir d'ici.
  1. Dans Visual Studio Code, cliquez sur l'icône Extensions dans la barre de navigation de gauche.


    Barre d'activité de code Visual Studio

    Vous pouvez également ouvrir la vue Extensions en appuyant sur :
    • (Windows et Linux) Contrôle + Maj + X
    • (macOS) Commande + Maj + X.
  2. Recherchez Oracle NoSQL Database Connector dans le marché des extensions.
  3. Cliquez sur Installer dans l'extension Connecteur Oracle NoSQL Database
  1. Téléchargez le fichier VSIX pour Oracle NoSQL Database à partir du site de Téléchargements Oracle NoSQL Database.
  2. Dans Visual Studio Code, cliquez sur l'icône Extensions dans la barre de navigation de gauche.


    Barre d'activité de code Visual Studio

    Vous pouvez également ouvrir la vue Extensions en appuyant sur :
    • (Windows et Linux) Contrôle + Maj + X
    • (macOS) Commande + Maj + X.
  3. Dans la vue Extensions, cliquez sur le menu Plus d'actions (...), puis cliquez sur Installer à partir de VSIX....


    Installer à partir de l'action VSIX

  4. Accédez à l'emplacement où le fichier *.vsix est stocké et cliquez sur Installer.

Connexion à Oracle NoSQL Database Cloud Service à partir du code Visual Studio

L'extension de code Visual Studio (VS) d'Oracle NoSQL Database fournit deux méthodes pour se connecter à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud.

Vous pouvez fournir un fichier de configuration avec les informations de connexion ou remplir les informations de connexion dans les champs spécifiques. Si vous utilisez un pilote Node.js et que des détails de connexion sont déjà enregistrés dans un fichier, utilisez l'option Connexion au moyen du fichier de configuration pour vous connecter à Oracle NoSQL Database Cloud Service. Sinon, si vous créez une connexion, utilisez l'option Remplir champs individuels.
  1. Dans Visual Studio Code, cliquez sur la vue Oracle NoSQL DB dans la barre d'activité.


    Barre d'activité de code Visual Studio

  2. Ouvrez la page Afficher les paramètres de connexion d'Oracle NoSQL DB à partir de la palette de commandes ou de la vue Oracle NoSQL DB dans la barre d'activité.
    • Ouvrir à partir de la palette de commandes
      1. Ouvrez la Palette de commandes en appuyant sur :
        • (Windows et Linux) Contrôle + Maj + P
        • (macOS) Commande + Maj + P
      2. Dans la palette de commandes, sélectionnez OracleNoSQL : Afficher les paramètres des connexions.

        Conseil :

        Entrez oraclenosql dans la palette de commandes pour afficher toutes les commandes Oracle NoSQL DB que vous pouvez utiliser.


        Commande Afficher les paramètres de connexion pour Oracle NoSQL DB

    • Ouvrir à partir de la vue Oracle NoSQL DB
      1. Développez le volet TABLE EXPLORER dans la barre de navigation de gauche s'il est réduit.
      2. Cliquez sur Ajouter une connexion pour ouvrir la page Afficher les paramètres de connexion d'Oracle NoSQL DB.


      EXPLORATEUR DE TABLE Oracle NoSQL DB

  3. Dans la page Afficher les paramètres de connexion, cliquez sur Nuage ou sur CloudSim pour vous connecter à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud.


    NoSQL Paramètres de connexion à la base de données pour Oracle NoSQL Database Cloud Service

  4. Entrez les informations de connexion.

    Tableau 5-4 Paramètres de connexion au nuage

    Champ Description Exemple de valeur
    Région : Sélectionnez l'identificateur de région du point d'extrémité Oracle NoSQL Database Cloud Service. us-ashburn-1
    Fichier de configuration : Naviguez jusqu'à l'emplacement où le fichier de configuration OCI est stocké. /home/user/security/config/oci.config
    Profil : Nom du profil de configuration à utiliser pour la connexion à Oracle NoSQL Database Cloud Service.

    Si vous ne spécifiez pas cette valeur, le champ prend par défaut le profil DEFAULT.

    		ADMIN_USER
    Compartiment : Nom ou OCID du compartiment pour votre schéma Oracle NoSQL Database Cloud Service.

    Si vous n'indiquez aucune valeur, le champ prend par défaut la valeur du compartiment root.

    Les compartiments sont créés dans le service de gestion des identités et des accès pour Oracle Cloud Infrastructure (IAM). Voir Configuration de votre location et Gestion des compartiments dans la documentation sur Oracle Cloud Infrastructure.

    • Nom du compartiment

      moncompartiment

    • Nom du compartiment qualifié avec son compartiment parent

      parent.childcompartment

    • OCID du compartiment

      ocid1.tenancy.oc1...<unique_ID>
    OCID du locataire : OCID de la location de votre service Oracle NoSQL Database Cloud. Voir Où obtenir l'OCID de la location et l'OCID de l'utilisateur dans la documentation sur Oracle Cloud Infrastructure ocid1.tenancy.oc1..<unique_ID>
    OCID d'utilisateur : OCID de l'utilisateur de votre service Oracle NoSQL Database Cloud. Voir Où obtenir l'OCID de la location et l'OCID de l'utilisateur dans la documentation sur Oracle Cloud Infrastructure. ocid1.user.oc1..<unique_ID>
    Empreinte numérique : Empreinte numérique de la clé privée ajoutée à cet utilisateur.

    L'empreinte numérique de la clé de signature est créée lors de la génération et du chargement de la clé de signature d'API. Voir Comment obtenir l'empreinte numérique de la clé dans la documentation sur Oracle Cloud Infrastructure.

    		12:34:56:78:90 :ab:cd:ef :12:34:56:78:90
    Fichier de la clé privée : Naviguez jusqu'à l'emplacement où la clé privée est stockée. Voir Générer une clé de signature d'API pour savoir comment générer la clé de signature avec une phrase secrète facultative. /home/user/.oci/oci_api_key.pem
    Phrase secrète : Phrase secrète que vous avez spécifiée lors de la création de la clé privée. La phrase secrète de la clé de signature est créée lors de la génération et du chargement de la clé de signature d'API. Voir Comment obtenir l'empreinte numérique de la clé dans la documentation sur Oracle Cloud Infrastructure.

    Obligatoire, uniquement si la clé est chiffrée.

    		 
    Compartiment : Nom ou OCID du compartiment pour votre schéma Oracle NoSQL Database Cloud Service.

    Si vous n'indiquez aucune valeur, le champ prend par défaut la valeur du compartiment root.

    Les compartiments sont créés dans le service de gestion des identités et des accès pour Oracle Cloud Infrastructure (IAM). Voir Configuration de votre location et Gestion des compartiments dans la documentation sur Oracle Cloud Infrastructure.

    • Nom du compartiment

      moncompartiment

    • Nom du compartiment qualifié avec son compartiment parent

      parent.childcompartment

    • OCID du compartiment

      ocid1.tenancy.oc1...<unique_ID>

    Tableau 5-5 CloudSim Paramètres de connexion

    Champ Description Exemple de valeur
    Point d'extrémité : URL du point d'extrémité du service de l'instance du simulateur Oracle NoSQL Database Cloud. http://myinstance.cloudsim.com:8080

    Si vous ne spécifiez pas de valeur, la valeur par défaut est http://localhost:8080.

    Identificateur de locataire : Identificateur unique du locataire. Tenant01

    Si vous ne spécifiez pas de valeur, la valeur par défaut est TestTenant.

  5. Cliquez sur Connexion.
  6. Cliquez sur Réinitialiser pour effacer les détails de connexion enregistrés de l'espace de travail.
  1. Créez le fichier de configuration, par exemple config.json ou un fichier avec l'objet JSON. Le format du fichier de configuration pour la connexion au service Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud est indiqué ci-dessous.

    Tableau 5-6 Modèles de configuration

    Service Oracle NoSQL Database Cloud Simulateur Oracle NoSQL Database Cloud
    Modèle de configuration pour la connexion à l'aide du fichier de configuration OCI
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "configFile": "<path-to-OCI-config-file>", 
     "profileName": "<oci-credentials-profile-name>"
    }
  }
}
    Modèle de configuration pour la connexion à l'aide des données d'identification d'authentification IAM
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "tenantId": "<tenancy-ocid>",
     "userId": "<user-ocid>",
     "fingerprint": "<fingerprint-for-the-signing-key>",
     "privateKeyFile": "<path-to-the-private-key>",
     "passphrase": "<passphrase-of-the-signing-key>"
     }
   }
}
    		 
    {
 "endpoint": "http://myinstance.cloudsim.com:8080",
 "auth" : "Bearer<tenant-id>"
}
  2. Ouvrez la palette de commandes en appuyant sur :
    • (Windows et Linux) Contrôle + Maj + X
    • (macOS) Commande + Maj + X
  3. Dans la palette de commandes, sélectionnez Oracle NoSQL : Se connecter au moyen du fichier de configuration.

    Conseil :

    Entrez oraclenosql dans la palette de commandes pour afficher toutes les commandes Oracle NoSQL DB que vous pouvez utiliser.


    Se connecter au moyen d'un fichier de configuration

  4. Accédez à l'emplacement où le fichier *.config est stocké et cliquez sur Sélectionner.

Gestion des tables à l'aide de l'extension Visual Studio Code

Une fois que vous vous êtes connecté à votre déploiement à l'aide de l'extension de code Visual Studio (VS) d'Oracle NoSQL Database, utilisez l'EXPLORER DE TABLE situé dans le menu de navigation de gauche pour :
  • Explorez vos tables, colonnes, index, clés primaires et clés de partition.
  • Créez de nouvelles tables.
  • Supprimez les tables existantes.
  • Exécutez des interrogations SQL SELECT et des instructions LMD sur une table.

EXPLORATEUR DE TABLE Oracle NoSQL DB

Lorsque vous développez une connexion active, le code VS d'Oracle NoSQL Database affiche les tables de ce déploiement.
  • Cliquez sur le nom de la table pour voir ses colonnes, ses index, ses clés primaires et ses clés de partition. Le nom de la colonne s'affiche avec son type de données.
  • Vous pouvez actualiser le schéma ou la table à tout moment pour interroger de nouveau votre déploiement et alimenter Oracle NoSQL Database Cloud Service avec les données les plus à jour.
    • Dans EXPLORATEUR DE TABLE, localisez la connexion et cliquez sur l'icône Actualiser pour recharger le schéma. Vous pouvez également cliquer avec le bouton droit de la souris sur la connexion et sélectionner Actualiser le schéma.


      Schéma d'actualisation d'extension de code VS d'Oracle NoSQL DB

    • Dans EXPLORATEUR DE TABLE, localisez le nom de la table et cliquez sur l'icône Actualiser pour recharger la table. Vous pouvez également cliquer avec le bouton droit de la souris sur le nom de la table et sélectionner Refresh Table (Actualiser la table).


      Table d'actualisation du code VS d'Oracle NoSQL DB

Exécuter des interrogations SQL et des instructions LMD pour une table

  1. Cliquez avec le bouton droit de la souris sur la table cible et sélectionnez Browse Table.
  2. Dans la fenêtre SQL, spécifiez l'interrogation SELECT dans la zone de texte et cliquez sur
    Interrogation d'exécution de code VS d'Oracle NoSQL DB

    . Le résultat de l'interrogation est affiché sous forme de tableau. Vous pouvez ajuster le nombre de rangées par page. Vous pouvez également exécuter des instructions LMD pour mettre à jour, insérer et supprimer des données d'une table.
  3. Pour voir les données d'une cellule individuelle séparément, cliquez sur la cellule de la table.

Suppression d'une table

  1. Cliquez avec le bouton droit de la souris sur la table cible.
  2. Cliquez sur Supprimer une table.
  3. Cliquez sur Oui pour supprimer la table.

Création d'une table Oracle NoSQL Database Cloud Service à partir du code Visual Studio

Vous pouvez créer la table Oracle NoSQL Database Cloud Service en deux modes :
  • Entrée LDD simple : Vous pouvez utiliser ce mode pour créer une table Oracle NoSQL Database Cloud Service de manière déclarative, c'est-à-dire sans écrire d'énoncé LDD.
  • Entrée LDD avancée : Vous pouvez utiliser ce mode pour créer une table Oracle NoSQL Database Cloud Service à l'aide d'un énoncé LDD.
  1. Positionnez la souris sur la connexion à Oracle NoSQL Database Cloud Service pour ajouter la nouvelle table.
  2. Cliquez sur l'icône Plus qui s'affiche.
  3. Dans la page Créer une table, sélectionnez Entrée LDD simple.


    Créer une table Oracle NoSQL Database Cloud Service à l'aide du mode d'entrée LDD simple

    Tableau 5-7 : Créer un tableau Oracle NoSQL Database Cloud Service

    Champ Description
    Capacité de lecture (unités de lecture) Entrez le nombre d'unités de lecture. Voir Estimation de la capacité pour en savoir plus sur les unités de lecture.
    Capacité d'écriture (unités d'écriture) Entrez le nombre d'unités d'écriture. Voir Estimation de la capacité pour en savoir plus sur les unités d'écriture.
    Stockage sur disque (Go) Indiquez l'espace disque en gigaoctets (Go) utilisé par la table. Voir Estimation de la capacité pour en savoir plus sur la capacité de stockage.
    Nom de la table : Spécifiez un nom de table unique dans votre location. Les noms de table doivent être conformes aux conventions d'attribution de nom d'Oracle NoSQL Database Cloud Service. Voir Limites de service.
    Nom de colonne Spécifiez un nom de colonne pour la clé primaire de votre table. Voir Limites de service pour en savoir plus sur les exigences d'attribution de nom de colonne.
    Type de colonne Sélectionnez le type de données pour la colonne de clé primaire.
    Définir en tant que clé de partition Sélectionnez cette option pour définir cette colonne de clé primaire comme clé de partition. La clé de partition permet de répartir les données dans la grappe Oracle NoSQL Database Cloud Service afin d'améliorer l'efficacité et de positionner les enregistrements qui partagent la clé de partition localement pour faciliter les références et l'accès. Les enregistrements qui partagent la clé de partition sont stockés dans le même emplacement physique et sont accessibles individuellement et de manière efficace.
    Supprimer Cliquez sur ce bouton pour supprimer une colonne existante.
    + Ajouter une colonne de clé primaire Cliquez sur ce bouton pour ajouter des colonnes lors de la création d'une clé primaire composite (colonnes multiples).
    Nom de colonne Indiquez le nom de la colonne. Assurez-vous de respecter les exigences d'attribution de nom de colonne décrites dans Limites de service.
    Type de colonne Sélectionnez le type de données pour la colonne de clé primaire.
    Valeur par défaut (Facultatif) Spécifiez une valeur par défaut pour la colonne.
    Note

    Vous ne pouvez pas définir de valeur par défaut pour les colonnes dont le type de données est binaire ou JSON.
    Non nul Sélectionnez cette option pour indiquer qu'une colonne doit toujours avoir une valeur.
    Supprimer Cliquez sur ce bouton pour supprimer une colonne existante.
    + Ajouter une colonne Cliquez sur ce bouton pour ajouter d'autres colonnes.
    Unité Sélectionnez l'unité (Jours ou Heures) à utiliser pour la valeur de durée de vie des rangées de la table.
    Valeur Indiquez la durée d'expiration des lignes de la table. Après le nombre de jours ou d'heures, les rangées expirent automatiquement et ne sont plus disponibles. La valeur par défaut est zéro (pas de délai d'expiration).
    Note

    La mise à jour de la durée de vie de la table ne modifie pas la durée de vie des données de la table. La nouvelle valeur de durée de vie s'applique uniquement aux rangées ajoutées à la table après la modification de cette valeur et aux rangées pour lesquelles aucune valeur de remplacement propre à la rangée n'a été fournie.
  4. Cliquez sur Afficher le code LDD pour voir l'énoncé LDD formé en fonction des valeurs entrées dans les champs en mode Entrée LDD simple. Cet énoncé LDD est exécuté lorsque vous cliquez sur Créer.
  5. Cliquez sur Créer.
  1. Positionnez la souris sur la connexion à Oracle NoSQL Database Cloud Service pour ajouter la nouvelle table.
  2. Cliquez sur l'icône Plus qui s'affiche.
  3. Dans la page Créer une table, sélectionnez Entrée LDD avancée.


    Créer une table Oracle NoSQL Database Cloud Service à l'aide du mode d'entrée LDD avancé

    Tableau 5-8 : Créer un tableau pour Oracle NoSQL Database Cloud Service

    Champ Description
    Capacité de lecture (unités de lecture) Entrez le nombre d'unités de lecture. Voir Estimation de la capacité pour en savoir plus sur les unités de lecture.
    Capacité d'écriture (unités d'écriture) Entrez le nombre d'unités d'écriture. Voir Estimation de la capacité pour en savoir plus sur les unités d'écriture.
    Stockage sur disque (Go) Indiquez l'espace disque en gigaoctets (Go) utilisé par la table. Voir Estimation de la capacité pour en savoir plus sur la capacité de stockage.
    Énoncé LDD Indiquez l'instruction LDD de création de table. Voir Informations de référence SQL sur Oracle NoSQL Database.
  4. Cliquez sur Créer.

Suppression d'une connexion

Oracle NoSQL Database Connector fournit deux méthodes pour supprimer une connexion de Visual Studio (VS) Code.

Vous pouvez :
  • Supprimer une connexion avec la palette de commandes, ou
  • Supprimez une connexion de la vue Oracle NoSQL DB dans la barre d'activités.
Note

La suppression d'une connexion de Visual Studio Code supprime les détails de connexion persistants de l'espace de travail courant.
  1. Développez le volet TABLE EXPLORER dans la barre de navigation de gauche s'il est réduit.
  2. Cliquez avec le bouton droit de la souris sur la connexion à supprimer, puis cliquez sur Supprimer la connexion.


Explorateur de table

  1. Ouvrez la Palette de commandes en appuyant sur :
    • (Windows et Linux) Contrôle + Maj + P
    • (macOS) Commande + Maj + P
  2. Dans la palette de commandes, sélectionnez OracleNoSQL : Supprimer la connexion.

    Conseil :

    Entrez oraclenosql dans la palette de commandes pour afficher toutes les commandes Oracle NoSQL DB que vous pouvez utiliser.


    Supprimer la connexion