Utilisation de Visual Studio Code Extension pour le développement

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 Oracle NoSQL Database Visual Studio (VS) Code pour :

Cet article contient les rubriques suivantes :

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

Vous pouvez installer l'extension Oracle NoSQL Database VS Code à partir de Visual Studio Marketplace pour une installation en ligne.

Avant de pouvoir installer l'extension Visual Studio Code (VS) d'Oracle NoSQL Database, vous devez installer Visual Studio Code. Vous pouvez télécharger Visual Studio Code ici.

Pour l'installation :

  1. Dans Visual Studio Code, cliquez sur l'icône Extensions dans le menu de navigation de gauche.

    Barre d'activités Visual Studio Code

    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 du connecteur Oracle NoSQL Database.

Connexion à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud à partir de Visual Studio Code

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

Vous pouvez soit fournir un fichier de configuration avec les informations de connexion, soit remplir les informations de connexion dans les champs spécifiques. Si vous utilisez un pilote, par exemple, un pilote Node.js et que les détails de connexion sont déjà enregistrés dans un fichier ou si vous voulez en créer un, utilisez l'option Utiliser le fichier de configuration pour vous connecter à Oracle NoSQL Database Cloud Service. Sinon, si vous créez une nouvelle connexion, utilisez l'option Avancé.

  1. Dans Visual Studio Code, cliquez sur la vue Oracle NoSQL DB dans la barre d'activités.

    Barre d'activités Visual Studio Code

  2. Ouvrez la page Afficher les paramètres de connexion d'Oracle NoSQL DB dans la palette de commandes ou dans la vue Oracle NoSQL DB de la barre d'activités.

    • 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 de connexion.

        Conseil :

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

- Open from Oracle NoSQL DB View
  1. Expand the **TABLE EXPLORER** pane in the left navigation if it's collapsed.

  2. Click **Add Connection** to open the Oracle NoSQL DB **Show Connection Settings** page.

  1. 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.

  2. Cliquez sur Ajouter une nouvelle connexion et entrez les informations de connexion. Cliquez sur Ajouter.

    Table - Paramètres de connexion au nuage

    Champ Description Exemple de valeur
    Nom de connexion : Un nom unique est obligatoire pour la spécification de connexion à partir de la version 4.0.0 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 3.0.0 ou inférieure.

    Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.    		  
    Région/Point d'extrémité : Identificateur de région ou point d'extrémité de service pour accéder au service Oracle NoSQL Database Cloud Service. Voir Régions de données et URL de service associé pour obtenir la liste des identificateurs de région et des points d'extrémité de service. us-ashburn-1 ou https://nosql.us-ashburn-1.oci.oraclecloud.com (pour l'identificateur de région Ashburn Oracle NoSQL Database Cloud Service dans la région Amérique du Nord).
    OCID du locataire : OCID de la location pour Oracle NoSQL Database Cloud Service. 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 de l'utilisateur : OCID de l'utilisateur pour Oracle NoSQL Database Cloud Service. 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.<p>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:ab:cd:ef
    Fichier de clé privée : Accédez à 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
    Passphrase (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 root.

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

    		- Nom du compartiment : mycompartment

    - Nom du compartiment qualifié avec son compartiment parent : parent.childcompartment

    - OCID du compartiment : ocid1.tenancy.oc1...<unique_ID>

    Tableau - Paramètres de connexion CloudSim

    Champ Description Exemple de valeur
    Nom de connexion : Un nom unique est obligatoire pour la spécification de connexion à partir de la version 4.0.0 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 3.0.0 ou inférieure.

    Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.    		  
    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 la valeur, la valeur par défaut est http://localhost:8080.
    Identificateur de locataire : Identificateur unique du locataire. Tenant01

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

    Note : Le traitement de la connexion a été modifié à partir de la version 4.0.0. Si vous utilisez une ancienne version du plugiciel, seule la connexion la plus récemment utilisée sera migrée au cours du processus de mise à niveau vers la version 4.0.0. Le plugiciel affectera automatiquement le nom cloud_old0 à la connexion migrée. Vous pouvez modifier le nom de la connexion à l'aide de l'option Modify Connection dans la page Connections Setting.

  3. Les détails de la connexion sont enregistrés. Pour modifier des connexions existantes, sélectionnez la connexion dans la liste déroulante Connexions. Cliquez sur Modifier la connexion. Apportez les modifications voulues dans les paramètres de connexion et cliquez sur Enregistrer.

  4. Cliquez sur l'icône Web dans TABLE EXPLORER pour voir la liste de toutes les connexions (sur place et en nuage) présentes dans le plugiciel. Les connexions sont affichées dans la liste déroulante au format : Connection Name:Endpoint: Compartment (si spécifié).

    Sélectionnez la connexion dans la liste et sélectionnez Connexion. Le plugiciel Visual Studio Code se connecte au simulateur Oracle NoSQL Database Cloud du service de base de données Oracle NoSQL Database Cloud et affiche toutes ses tables dans la fenêtre Explorateur de tables.

  1. Si vous n'avez pas de fichier de configuration, créez-en un, par exemple, config.json ou un fichier avec l'objet JSON. Le format du fichier de configuration pour la connexion à Oracle NoSQL Database Cloud Service ou au simulateur Oracle NoSQL Database Cloud est indiqué ci-dessous.

    Table - 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": "", "compartment": "", "auth": { "iam": { "configFile": "",  "profileName": "" } } }
    Modèle de configuration pour la connexion à l'aide des données d'identification pour l'authentification IAM
    { "region": "", "compartment": "", "auth": { "iam": { "tenantId": "", "userId": "", "fingerprint": "", "privateKeyFile": "", "passphrase": "" } } }
    		 
    { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer" }

  2. Ouvrez la page Oracle NoSQL DB Show Connection Settings à partir de la palette de commandes ou de la vue Oracle NoSQL DB de la barre d'activités.

    • Ouvrir à partir de la vue Oracle NoSQL DB

      • Développez le volet Explorateur de table dans la barre de navigation de gauche s'il est réduit.

      • Cliquez sur Ajouter une connexion pour ouvrir la page Afficher les paramètres de connexion d'Oracle NoSQL DB.

      • Dans la page Afficher les paramètres de connexion, cliquez sur Nuage pour vous connecter à Oracle NoSQL Database.

      • Entrez les informations de connexion et cliquez sur Ajouter.

        Table - Paramètres de connexion au nuage

        Champ Description Échantillon Vaue
        Nom de connexion : Un nom unique est obligatoire pour la spécification de connexion à partir de la version 4.0.0 du plugiciel. La mise à jour du champ Nom de la connexion est recommandée après la mise à niveau du plugiciel à partir de la version 3.0.0 ou inférieure.

        Note : Vous pouvez ajouter plusieurs connexions et les spécifications de connexion stockées sont persistantes.        		  
        Région/Point d'extrémité : Identificateur de région ou point d'extrémité de service pour accéder au service Oracle NoSQL Database Cloud Service. Voir Régions de données et URL de service associé pour obtenir la liste des identificateurs de région et des points d'extrémité de service. us-ashburn-1 ou https://nosql.us-ashburn-1.oci.oraclecloud.com (pour l'identificateur de région Ashburn Oracle NoSQL Database Cloud Service dans la région Amérique du Nord).
        Fichier de configuration : Accédez à 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_UTILISATEUR
        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 root.

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

        • Nom du compartiment

          mycompartiment

        • Nom de compartiment qualifié avec son compartiment parent

          parent.enfantcompartiment

        • OCID du compartiment.

          ocid1.tenancy.oc1...

Note : Le traitement de la connexion a été modifié à partir de la version 4.0.0. Si vous utilisez une ancienne version du plugiciel, seule la connexion la plus récemment utilisée sera migrée au cours du processus de mise à niveau vers la version 4.0.0. Le plugiciel affectera automatiquement le nom cloud_old0 à la connexion migrée. Vous pouvez modifier le nom de la connexion à l'aide de l'option Modify Connection dans la page Connections Setting.

  • Ouvrir à partir de la palette de commandes :

    • Ouvrez la palette de commandes en appuyant sur :

      • (Windows et Linux) Contrôle + Maj + P

      • (macOS) Commande + Maj + P

    • Dans la palette de commandes, sélectionnez Oracle NoSQL : Se connecter au moyen d'un fichier de configuration.

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

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

  1. Les détails de la connexion sont enregistrés. Pour modifier des connexions existantes, sélectionnez la connexion dans la liste déroulante Connexions. Cliquez sur Modifier la connexion. Apportez les modifications voulues dans les paramètres de connexion et cliquez sur Enregistrer.

  2. Cliquez sur l'icône Web dans TABLE EXPLORER pour voir la liste de toutes les connexions (sur place et en nuage) présentes dans le plugiciel. Les connexions sont affichées dans la liste déroulante au format : Connection Name:Endpoint: Compartment (si spécifié).

    Sélectionnez la connexion dans la liste et sélectionnez Connexion. Le plugiciel Visual Studio Code se connecte au simulateur Oracle NoSQL Database Cloud du service de base de données Oracle NoSQL Database Cloud et affiche toutes ses tables dans la fenêtre Explorateur de tables.

Création d'applications à l'aide de la trousse SDK Java pour Oracle NoSQL à partir de Visual Studio Code

Voyez comment créer des applications à partir de l'extension Visual Studio Code à l'aide de l'ensemble de trousse SDK Java pour Oracle NoSQL.

Après vous être connecté au simulateur Oracle NoSQL Database Cloud ou au service Oracle NoSQL Database Cloud Service, vous pouvez créer des applications à l'aide de la trousse SDK Java pour Oracle NoSQL.

Effectuez les étapes suivantes :

Configurer le projet Maven

  1. Ouvrez Visual Studio Code.

  2. Installez le pack d'extension Java :

    1. Ouvrez la vue Extensions en cliquant sur l'icône Extensions dans la barre latérale gauche.

    2. Recherchez Java Extension Pack dans le marché des extensions.

    3. Cliquez sur le bouton Installer pour installer le module d'extension Java.

  3. Dans l'onglet View (Voir), sélectionnez Command Palette (Palette de commandes) et appuyez sur Ctrl+Shift+P.

  4. Recherchez Java : Nouveau projet.

  5. Sélectionnez le modèle de projet Maven.

  6. Entrez les détails du projet :

    • Nom du projet.

    • Emplacement du projet (par défaut, le dossier de l'espace de travail courant).

    • Nom du paquetage (par exemple, com.example.myproject).

  7. Définissez le chemin Java dans votre variable d'environnement.

  8. Visual Studio Code crée la structure et les fichiers du répertoire du projet.

  9. Ouvrez le fichier pom.xml à partir du répertoire du projet et ajoutez la dépendance de la trousse SDK Java pour Oracle NoSQL comme suit. Utiliser la dernière version. Voir Trousse SDK Java pour Oracle NoSQL.

    <dependency>
<groupId>com.oracle.nosql</groupId>
<artifactId>nosqldb-driver</artifactId>
<version>5.4.22</version>
</dependency>

créer et exécuter un exemple de programme d'application

  1. Créez un exemple de code d'application comme suit. Mettez à jour votre région dans <your_region_identifier> et l'OCID du compartiment dans les paramètres fictifs <ocid_of_your_compartment>.

    Note : Cette application extrait les détails d'authentification du fichier de configuration OCI. Pour plus d'informations sur le fichier de configuration et son contenu, voir Authentification pour la connexion à Oracle NoSQL Database.

    package org.oracle.nosqljavasdk;

import oracle.nosql.driver.NoSQLHandle;
import oracle.nosql.driver.NoSQLHandleConfig;
import oracle.nosql.driver.NoSQLHandleFactory;
import oracle.nosql.driver.iam.SignatureProvider;
import oracle.nosql.driver.ops.GetRequest;
import oracle.nosql.driver.ops.GetResult;
import oracle.nosql.driver.ops.PutRequest;
import oracle.nosql.driver.ops.PutResult;
import oracle.nosql.driver.ops.TableLimits;
import oracle.nosql.driver.ops.TableRequest;
import oracle.nosql.driver.ops.TableResult;
import oracle.nosql.driver.values.MapValue;

public class JavaVSCodeCloud {
    /* Name of your table */
    final static String tableName = "TestSDK";
    static NoSQLHandle handle;
    /* replace the placeholder with the name of your region for example Region.US_ASHBURN_1*/
    /* String region ="<your_region_identifier>";  */

    public static void main(String[] args) throws Exception {
      String region ="<your_region_identifier>";
      String compId ="<ocid_of_your_compartment>";
      handle = generateNoSQLHandleCloud(region,compId);
        try {
            createTable(handle);
            writeRows(handle);
            readRows(handle);
                          /* Uncomment this if you want to drop the table */
            //dropTable(handle);
        } catch (Exception e) {
            System.err.print(e);
        } finally {
            handle.close();
        }
    }

   /* Create a NoSQL handle to access the cloud service */
   private static NoSQLHandle generateNoSQLHandleCloud(String region, String compId) throws Exception {
      SignatureProvider ap = new SignatureProvider();
      NoSQLHandleConfig config = new NoSQLHandleConfig(region, ap);
      /* set your default compartment */
      config.setDefaultCompartment(compId);
      NoSQLHandle handle = NoSQLHandleFactory.createNoSQLHandle(config);
      return handle;
   }

    /**
     * Create a simple table with an integer key
     * and a single string data field
     * and set your desired table capacity
     */
    private static void createTable(NoSQLHandle handle) throws Exception {
        String createTableDDL = "CREATE TABLE IF NOT EXISTS " +
            tableName + "(employeeid INTEGER, name STRING, " +
            "PRIMARY KEY(employeeid))";

        TableLimits limits = new TableLimits(1, 2, 1);
        TableRequest treq = new TableRequest()
            .setStatement(createTableDDL).setTableLimits(limits);

        System.out.println("Creating table " + tableName);
        TableResult tres = handle.tableRequest(treq);

        /* The request is async,
         * so wait for the table to become active.
        */
        System.out.println("Waiting for "

            + tableName + " to become active");
        tres.waitForCompletion(handle, 60000, /* wait 60 sec */
            1000); /* delay ms for poll */
        System.out.println("Table " + tableName + " is active");
    }

    /**
     * Construct a row and add it to the table
     */
    private static void writeRows(NoSQLHandle handle) throws Exception {
        MapValue value =
            new MapValue().put("employeeid", 1).put("name", "Tracy");
        PutRequest putRequest =
            new PutRequest().setValue(value).setTableName(tableName);
        PutResult putResult = handle.put(putRequest);
        if (putResult.getVersion() != null) {
            System.out.println("Wrote " + value);
        } else {
            System.out.println("Put failed");
        }
    }

    /**
     * Set a key and read the row from the table
     */
    private static void readRows(NoSQLHandle handle) throws Exception {
        MapValue key = new MapValue().put("employeeid", 1);
        GetRequest getRequest =
            new GetRequest().setKey(key).setTableName(tableName);
        GetResult getRes = handle.get(getRequest);
        System.out.println("Read " + getRes.getValue());
    }

    /**
     * Drop the table and wait for the table to move to dropped state
     */
    private static void dropTable(NoSQLHandle handle) throws Exception {
        System.out.println("Dropping table " + tableName);
        TableRequest treq = new TableRequest()
            .setStatement("DROP TABLE IF EXISTS " + tableName);
        TableResult tres = handle.tableRequest(treq);
        System.out.println("Waiting for " + tableName + " to be dropped");
        tres.waitForCompletion(handle, 60000, /* wait 60 sec */
            1000); /* delay ms for poll */
        System.out.println("Table " + tableName + " has been dropped");
    }
}

  2. Exécutez le programme Java. Vous pouvez appuyer sur F5 ou sélectionner l'option désirée dans le menu Exécuter.

    Note : Si vous avez des mandataires de réseau, incluez-les dans le fichier settings.xml situé dans le répertoire maven.

  3. Vous pouvez afficher la sortie dans le terminal Visual Studio Code.

Le code d'application ci-dessus crée la table TestSDK, ajoute une rangée à la table et lit la rangée de la table.

Exemple de sortie :

----------------< com.oracle.nosql.example:NoSQLOperation >-----------------
Building NoSQLOperation 1.0-SNAPSHOT
  from pom.xml
--------------------------------[ jar ]---------------------------------

--- resources:3.3.1:resources (default-resources) @ NoSQLOperation ---
Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
skip non existing resourceDirectory C:\Users\ramya\javaVSCode\src\main\resources

--- compiler:3.8.0:compile (default-compile) @ HelloWorld ---
Changes detected - recompiling the module!
File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!
Compiling 1 source file to C:\Users\ramya\javaVSCode\target\classes

--- exec:3.1.0:exec (default-cli) @ NoSQLOperation ---
Creating table TestSDK
Waiting for TestSDK to become active
Table TestSDK is active
Wrote {"name":"Tracy","employeeid":1}
Read {"employeeid":1,"name":"Tracy"}
------------------------------------------------------------------------
BUILD SUCCESS
------------------------------------------------------------------------
Total time:  8.013 s
Finished at: 2025-11-24T17:01:24+05:30
------------------------------------------------------------------------

Vous pouvez également voir la table à partir de votre explorateur de tables Visual Studio Code. Pour plus de détails, voir Gestion des tables à l'aide de l'extension Visual Studio Code.

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

Après vous être connecté à votre déploiement à l'aide de l'extension de code Oracle NoSQL Database Visual Studio (VS), utilisez la TABLE TABLE EXPLORER située dans la barre de navigation de gauche pour :

Vous pouvez également :

Explorer les tables, les colonnes, les index et les clés

Lorsque vous développez une connexion active, Oracle NoSQL Database VS Code affiche les tables de ce déploiement.

Effectuer des opérations LDD à l'aide de Visual Studio Code

Vous pouvez utiliser Visual Studio Code pour effectuer des opérations LDD.

Certaines des opérations LDD pouvant être effectuées à partir du plugiciel Visual Studio Code sont les suivantes :

CREATE TABLE

Vous pouvez créer la table Oracle NoSQL Database selon deux modes :

  1. Pointez la connexion à Oracle NoSQL Database pour ajouter la nouvelle table.

  2. Cliquez sur l'icône Plus qui s'affiche ou cliquez avec le bouton droit de la souris sur le nom de la connexion à la base de données et cliquez sur Créer une table

    explorateur de tables

  3. Dans la page Create Table (Créer une table), sélectionnez Simple DDL Input (Entrée LDD simple).

    Table - Créer une table Oracle NoSQL Database

    Champ Description
    Nom de la table : Indiquez un nom de table unique.
    Nom de colonne Spécifiez un nom de colonne pour la clé primaire de votre table.
    Type de colonne Sélectionnez le type de données pour la colonne de clé primaire.
    Définir en tant que clé de partition horizontale Sélectionnez cette option pour définir cette colonne de clé primaire en tant que clé de partition. La clé de partitionnement horizontal consiste à répartir les données dans la grappe Oracle NoSQL Database pour une efficacité accrue et à 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 de manière atomique et 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 (multicolonne).
    Nom de colonne Indiquez le nom de la colonne.
    Type de colonne Sélectionnez le type de données de la colonne.
    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 de type binaire ou JSON.
    Non nul Sélectionnez cette option pour spécifier 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 lignes 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 propre à la rangée de remplacement n'a été fournie.

  4. Cliquez sur Créer.

  5. Vous avez la possibilité d'afficher l'instruction LDD avant et après la création d'une table.

    • Avant de créer la table - Cliquez sur Afficher le LDD dans l'écran Créer une table pour voir l'énoncé LDD formé en fonction des valeurs entrées dans les champs du mode Entrée LDD simple. Cet énoncé LDD est exécuté lorsque vous cliquez sur Créer.

    • Après avoir créé la table - Faites un clic droit sur la table existante. Sélectionnez Voir l'énoncé LDD de la table.

CRÉER UNE TABLE ENFANT

Pour créer une table enfant, cliquez avec le bouton droit de la souris sur la table souhaitée et sélectionnez Créer une table enfant. Vous pouvez créer une table enfant pour une table Oracle NoSQL Database existante dans l'un des deux modes suivants :

Pour plus de détails sur les tables enfants, voir Hiérarchies de tables dans le guide d'Oracle NoSQL Database Cloud Service.

SUPPRIMER LA TABLE

  1. Cliquez avec le bouton droit de la souris sur la table cible.

  2. Cliquez sur Supprimer la table.

  3. Cliquez sur Oui pour supprimer la table.

CRÉER UN INDEX

ABANDONNER L'INDEX

AJOUTER UNE COLONNE

SUPPRIMER LA COLONNE

Geler/dégeler le schéma

Pour faire d'une table singleton une table Global Active, vous devez d'abord geler le schéma. Pour plus d'informations, voir Gel du schéma d'une table.

Pour geler/dégeler le schéma, procédez comme suit :

  1. Cliquez avec le bouton droit de la souris sur la table souhaitée, cliquez sur Geler/Dégeler le schéma.

  2. Une boîte de dialogue s'affiche, cliquez sur Yes (Oui) pour confirmer la suppression.

Gérer les répliques

Voir Répliques régionales de table pour comprendre ce que sont les répliques et comment convertir une table singleton en table active globale.

Ajouter des répliques

Le plugiciel Visual Studio Code vous permet d'ajouter une réplique de table dans différentes régions. Il vous permet également d'ajouter des répliques à une table active globale existante.

  1. Cliquez avec le bouton droit de la souris sur la table souhaitée, dans la section Répliques, sélectionnez Ajouter des répliques.

  2. Dans le panneau Ajouter une réplique, sélectionnez une région dans la liste déroulante Région de réplication.

  3. Entrez Capacité de lecture, Capacité d'écriture, Stockage sur disque selon vos besoins.

  4. Cliquez sur Ajouter une réplique.

  5. Lorsque vous recevez un avis indiquant que des répliques ont été ajoutées, fermez le panneau en cliquant sur 'x' ou en appuyant sur 'Ctrl+F4'.

Supprimer les répliques

  1. Cliquez avec le bouton droit sur la table souhaitée dont vous voulez supprimer la réplique de table. Dans les sections Répliques, sélectionnez Supprimer les répliques.

  2. Dans le panneau Déposer les répliques régionales, sélectionnez la réplique dans la liste déroulante Nom de la réplique à supprimer. Pour supprimer plusieurs répliques simultanément, cliquez sur +Ajouter, sélectionnez le nom de la réplique.

    Note : Pour supprimer une réplique, il vous suffit de cliquer sur Supprimer à côté du nom de la réplique.

  3. Cliquez sur Supprimer des répliques.

  4. Lorsque vous recevez un avis indiquant que des répliques ont été supprimées, fermez le panneau en cliquant sur 'x' ou en appuyant sur 'Ctrl+F4'.

Voir les répliques

  1. Cliquez avec le bouton droit de la souris sur la table souhaitée pour afficher ses répliques. Dans la section Répliques, sélectionnez Voir les répliques.

  2. Dans le panneau Voir les répliques régionales, vous pouvez voir une liste de répliques régionales avec leur capacité d'écriture.

  3. Après avoir consulté les répliques, fermez le panneau en cliquant sur 'x' ou en appuyant sur 'Ctrl+F4'.

Modifier la capacité réservée

  1. Cliquez avec le bouton droit de la souris sur la table voulue et cliquez sur Modifier la capacité réservée.

  2. Dans le panneau Modifier la capacité réservée, vous pouvez mettre à jour la capacité provisionnée ou la capacité sur demande.

    1. Capacité provisionnée : Vous pouvez modifier la capacité de lecture, la capacité d'écriture et le stockage de disque selon vos besoins.

    2. Capacité sur demande : Vous pouvez uniquement modifier le stockage sur disque. La capacité de lecture et la capacité d'écriture sont en mode lecture seule.

  3. Lorsque vous recevez un avis indiquant que la capacité réservée a été mise à jour, fermez le panneau en cliquant sur 'x' ou en appuyant sur 'Ctrl+F4'.

Effectuer des opérations LMD à l'aide de Visual Studio Code

Vous pouvez ajouter des données, modifier des données existantes et interroger des données à partir de tables à l'aide du plugiciel Visual Studio Code.

Insérer des données

Modifier les données - Mettre à jour la rangée/supprimer la rangée :

Exécuter des interrogations SQL pour une table

Note : La liste déroulante affiche uniquement les énoncés SQL liés à la table à laquelle vous avez affaire.

Suppression d'une connexion

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

Vous pouvez :

Note : Pour supprimer définitivement une connexion du plugiciel, sélectionnez-la dans la liste déroulante Connections (Connexions). Cliquez sur Supprimer la connexion. Vous obtenez une confirmation pour supprimer le plugiciel, cliquez sur Oui pour supprimer la connexion du plugiciel. 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.

  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.

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

Exigences d'autorisation pour Visual Studio Code

Découvrez les exigences d'autorisation requises dans Oracle NoSQL Database Cloud Service pour utiliser Visual Studio Code.

L'extension Visual Studio Code vous permet d'accéder à Oracle NoSQL database Cloud Service à l'aide de la méthode d'authentification par clé d'API. L'accès aux ressources d'Oracle NoSQL Database Cloud Service, telles que les tables, les espaces-tables et les API, est géré au moyen des politiques du service de gestion des identités et des accès (IAM). Ainsi, seuls les utilisateurs authentifiés, qui sont membres de groupes disposant des autorisations d'inspection, de lecture, d'utilisation ou de gestion de table appropriées dans un compartiment donné, peuvent interagir avec ces ressources. Pour plus d'informations, voir Gestion de l'accès aux tables NDCS.

Lors de l'utilisation de Visual Studio Code pour gérer les tables dans les tables d'Oracle NoSQL Database Cloud Service, vos autorisations IAM effectives déterminent les ressources dans lesquelles vous pouvez lire ou écrire. Si un utilisateur tente une action pour laquelle il n'a pas d'autorisation, le code Visual Studio Code retourne l'erreur d'autorisation correspondante, comme indiqué par le service OCI IAM.

Par exemple, le service OCI IAM refuse toute opération d'insertion sur une table Oracle NoSQL Database Cloud Service si votre groupe d'utilisateurs n'a que l'autorisation de " lecture " pour les tables NoSQL. Le message d'erreur suivant s'affiche dans l'extension Visual Studio Code :

Error Inserting the row : NoSQLError: [INSUFFICIENT_PERMISSION] Authorization failed or requested resource not found