Uso de la extensión Visual Studio Code para el desarrollo

Oracle NoSQL Database Cloud Service proporciona una extensión para Microsoft Visual Studio Code que permite conectarse a una instancia en ejecución de Oracle NoSQL Database Cloud Service.

Puede utilizar la extensión de código de Oracle NoSQL Database Visual Studio (VS) para:

En este artículo se incluyen los siguientes temas:

Instalación de la extensión de Visual Studio Code de Oracle NoSQL Database

Puede instalar la extensión de VS Code de Oracle NoSQL Database desde Visual Studio Marketplace para su instalación en línea.

Para poder instalar la extensión de código de Oracle NoSQL Database Visual Studio (VS), debe instalar Visual Studio Code. Puede descargar Visual Studio Code aquí.

Para la instalación:

  1. En Visual Studio Code, haga clic en el icono Extensiones en la navegación izquierda.

    Barra de actividades de código de Visual Studio

    También puede abrir la vista Extensiones pulsando:

    • (Windows y Linux) Control + Mayús + X

    • (macOS) Comando + Mayús + X.

  2. Busque Oracle NoSQL Database Connector en el mercado de extensiones.

  3. Haga clic en Install en la extensión Oracle NoSQL Database Connector.

Conexión a Oracle NoSQL Database Cloud Service o a Oracle NoSQL Database Cloud Simulator desde Visual Studio Code

La extensión de código de Oracle NoSQL Database Visual Studio (VS) proporciona dos métodos para conectarse a Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator.

Puede proporcionar un archivo de configuración con la información de conexión o rellenar la información de conexión en los campos específicos. Si utiliza un controlador, por ejemplo, un controlador Node.js y ya tiene los detalles de conexión guardados en un archivo o desea crear uno, utilice la opción Usar archivo de configuración para conectarse a Oracle NoSQL Database Cloud Service. De lo contrario, si está creando una nueva conexión, utilice la opción Avanzado.

  1. En Visual Studio Code, haga clic en la vista Oracle NoSQL DB en la barra de actividad.

    Barra de actividades de código de Visual Studio

  2. Abra la página Mostrar configuración de conexión de Oracle NoSQL DB desde la paleta de comandos o la vista de Oracle NoSQL DB en la barra de actividad.

    • Abrir desde la paleta de comandos

      1. Para abrir la paleta de comandos, pulse:

        • (Windows y Linux) Control + Mayús + P

        • (macOS) Comando + Mayús + P

      2. En la paleta de comandos, seleccione OracleNoSQL: Mostrar configuración de conexiones.

        Sugerencia:

        Introduzca oraclenosql en la paleta de comandos para mostrar todos los comandos de Oracle NoSQL DB que puede utilizar.

- 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. En la página Mostrar configuración de conexión, haga clic en Cloud o CloudSim para conectarse a Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator.

  2. Haga clic en Agregar Nueva Conexión e introduzca la información de conexión. Haga clic en Agregar.

    Tabla - Parámetros de conexión a la nube

    Campo Descripción Valor de ejemplo
    Nombre de conexión: Un nombre único para la especificación de conexión es obligatorio a partir de la versión 4.0.0 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 3.0.0 o inferior.

    Nota: puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.    		  
    Región/Punto Final: Identificador de región o punto final de servicio para acceder a Oracle NoSQL Database Cloud Service. Consulte Regiones de Datos y Direcciones URL de Servicio Asociadas para ver una lista de identificadores de región y puntos finales del servicio. us-ashburn-1 o https://nosql.us-ashburn-1.oci.oraclecloud.com (para el identificador a la región Oracle NoSQL Database Cloud Service de Ashburn en la región Norteamérica).
    OCID de arrendatario: OCID de arrendamiento para Oracle NoSQL Database Cloud Service. Consulte Dónde obtener el OCID del arrendamiento y el OCID del usuario en la documentación de Oracle Cloud Infrastructure. ocid1.tenancy.oc1..<unique_ID>
    OCID de usuario: OCID del usuario para su Oracle NoSQL Database Cloud Service. Consulte Dónde obtener el OCID del arrendamiento y el OCID del usuario en la documentación de Oracle Cloud Infrastructure. ocid1.user.oc1..<unique_ID>
    Huella: Huella digital de la clave privada que se ha agregado a este usuario.<p>Se crea la huella digital de la clave de firma al generar la clave de firma y cargarla. Consulte Cómo obtener la huella de la clave en la documentación de Oracle Cloud Infrastructure. 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
    Archivo de Claves Privadas: Vaya a la ubicación donde se almacena la clave privada. Consulte Cómo generar una clave de firma de API para generar la clave de firma con una contraseña opcional. /home/user/.oci/oci_api_key.pem
    Contraseña: Frase de contraseña que especificó al crear la clave privada. La frase de contraseña de la clave de firma se crea al generar la clave de firma y cargarla. Consulte Cómo obtener la huella de la clave en la documentación de Oracle Cloud Infrastructure.
    Necesario, solo si la clave está cifrada.    		  
    Compartimiento: Nombre u OCID del compartimento para el esquema de Oracle NoSQL Database Cloud Service.

    Si no proporciona ningún valor, el campo toma por defecto el compartimento root.

    Los compartimentos se crean en Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configuración de arrendamiento y Gestión de compartimentos en la documentación de Oracle Cloud Infrastructure .

    		- Nombre de compartimento: mycompartment

    - Nombre de compartimento cualificado con su compartimento principal: parent.childcompartment

    - OCID de compartimento: ocid1.tenancy.oc1...<unique_ID>

    Tabla - Parámetros de conexión de CloudSim

    Campo Descripción Valor de ejemplo
    Nombre de conexión: Un nombre único para la especificación de conexión es obligatorio a partir de la versión 4.0.0 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 3.0.0 o inferior.

    Nota: Puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.    		  
    Punto Final: URL de punto final de servicio de la instancia de Oracle NoSQL Database Cloud Simulator. http://myinstance.cloudsim.com:8080

    Si no especifica el valor, se define por defecto en http://localhost:8080.
    Identificador de inquilino: Identificador único para identificar al inquilino. Tenant01

    Si no especifica el valor, el valor por defecto es TestTenant.

    Nota: El procesamiento de la conexión ha cambiado a partir de la versión 4.0.0. Si utiliza una versión anterior del plugin, solo se migrará la conexión utilizada más recientemente durante el proceso de actualización a la versión 4.0.0. El plugin asignará automáticamente el nombre cloud_old0 a la conexión migrada. Puede cambiar el nombre de la conexión mediante la opción Modify Connection de la página Connections Setting.

  3. Se guardan los detalles de conexión. Para modificar las conexiones existentes, seleccione la conexión en la lista desplegable Conexiones. Haga clic en Modificar conexión. Realice los cambios que desee en los parámetros de conexión y haga clic en Guardar.

  4. Haga clic en el icono Web de TABLE EXPLORER para ver la lista de todas las conexiones (locales y en la nube) presentes en el plugin. Las conexiones se muestran en la lista desplegable con el formato: Connection Name:Endpoint: Compartment (si se especifica).

    Seleccione la conexión de la lista y seleccione Conectar. El plugin de Visual Studio Code se conecta a Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator y muestra todas sus tablas en la ventana Explorador de tablas.

  1. Si no tiene un archivo de configuración, cree uno, por ejemplo, config.json o un archivo con el objeto JSON. El formato de archivo de configuración para conectarse a Oracle NoSQL Database Cloud Service u Oracle NoSQL Database Cloud Simulator es el que se muestra a continuación.

    Tabla - Plantillas de configuración

    Oracle NoSQL Database Cloud Service Simulador de Oracle NoSQL Database Cloud
    Plantilla de configuración para conectarse mediante el archivo de configuración de OCI
    { "region": "", "compartment": "", "auth": { "iam": { "configFile": "",  "profileName": "" } } }
    Plantilla de configuración para conectarse mediante credenciales de autenticación de IAM
    { "region": "", "compartment": "", "auth": { "iam": { "tenantId": "", "userId": "", "fingerprint": "", "privateKeyFile": "", "passphrase": "" } } }
    		 
    { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer" }

  2. Abra la página Mostrar configuración de conexión de Oracle NoSQL DB desde la paleta de comandos o la vista de Oracle NoSQL DB en la barra de actividad.

    • Abrir desde la vista de Oracle NoSQL DB

      • Amplíe el panel Table Explorer de la navegación izquierda si está contraído.

      • Haga clic en Agregar Conexión para abrir la página Mostrar Valores de Conexión de Oracle NoSQL DB.

      • En la página Mostrar configuración de conexión, haga clic en Nube para conectarse a Oracle NoSQL Database.

      • Introduzca la información de conexión y haga clic en Agregar.

        Tabla - Parámetros de conexión a la nube

        Campo Descripción Vaue de muestra
        Nombre de conexión: Un nombre único para la especificación de conexión es obligatorio a partir de la versión 4.0.0 del plugin. Se recomienda actualizar el campo Nombre de conexión después de actualizar el plugin de la versión 3.0.0 o inferior.

        Nota: Puede agregar varias conexiones y las especificaciones de conexión almacenadas son persistentes.        		  
        Región/Punto Final: Identificador de región o punto final de servicio para acceder a Oracle NoSQL Database Cloud Service. Consulte Regiones de Datos y Direcciones URL de Servicio Asociadas para ver una lista de identificadores de región y puntos finales del servicio. us-ashburn-1 o https://nosql.us-ashburn-1.oci.oraclecloud.com (para el identificador a la región Oracle NoSQL Database Cloud Service de Ashburn en la región Norteamérica).
        Archivo de Configuración: Busque la ubicación donde se almacena el archivo de configuración de OCI. /home/user/security/config/oci.config
        Perfil: Nombre del perfil de configuración que se utilizará para conectarse a Oracle NoSQL Database Cloud Service. Si no especifica este valor, el valor predeterminado del campo es el perfil DEFAULT. USUARIO_ADMINISTRADOR
        Compartimiento: Nombre u OCID del compartimento para el esquema de Oracle NoSQL Database Cloud Service.

        Si no proporciona ningún valor, el campo toma por defecto el compartimento root.

        Los compartimentos se crean en Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configuración de arrendamiento y Gestión de compartimentos en la documentación de Oracle Cloud Infrastructure.

        • Nombre de compartimento

          mi compartimento

        • Nombre de compartimento cualificado con su compartimento principal

          parent.childcompartment

        • OCID de compartimento

          ocid1.tenancy.oc1...

Nota: El procesamiento de la conexión ha cambiado a partir de la versión 4.0.0. Si utiliza una versión anterior del plugin, solo se migrará la conexión utilizada más recientemente durante el proceso de actualización a la versión 4.0.0. El plugin asignará automáticamente el nombre cloud_old0 a la conexión migrada. Puede cambiar el nombre de la conexión mediante la opción Modify Connection de la página Connections Setting.

  • Abrir desde la paleta de comandos:

    • Para abrir la paleta de comandos, pulse:

      • (Windows y Linux) Control + Mayús + P

      • (macOS) Comando + Mayús + P

    • En la paleta de comandos, seleccione Oracle NoSQL: Connect via Config File.

      Nota: Introduzca oraclenosql en la paleta de comandos para mostrar todos los comandos de Oracle NoSQL DB que puede utilizar.

    • Busque la ubicación donde se almacena el archivo *.config y haga clic en Seleccionar.

  1. Se guardan los detalles de conexión. Para modificar las conexiones existentes, seleccione la conexión en la lista desplegable Conexiones. Haga clic en Modificar conexión. Realice los cambios que desee en los parámetros de conexión y haga clic en Guardar.

  2. Haga clic en el icono Web de TABLE EXPLORER para ver la lista de todas las conexiones (locales y en la nube) presentes en el plugin. Las conexiones se muestran en la lista desplegable con el formato: Connection Name:Endpoint: Compartment (si se especifica).

    Seleccione la conexión de la lista y seleccione Conectar. El plugin de Visual Studio Code se conecta a Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator y muestra todas sus tablas en la ventana Explorador de tablas.

Creación de aplicaciones mediante el SDK de Java de Oracle NoSQL desde Visual Studio Code

Descubra cómo crear aplicaciones a partir de la extensión Visual Studio Code con el paquete Oracle NoSQL Java SDK.

Después de conectarse a Oracle NoSQL Database Cloud Simulator u Oracle NoSQL Database Cloud Service, puede crear aplicaciones mediante el SDK de Java de Oracle NoSQL.

Realice los siguientes pasos:

Configurar el proyecto de Maven

  1. Abra Visual Studio Code.

  2. Instale Java Extension Pack:

    1. Abra la vista Extensiones haciendo clic en el icono Extensiones en la barra lateral izquierda.

    2. Busca Java Extension Pack en Extensions Marketplace.

    3. Haga clic en el botón Install (Instalar) para instalar el paquete de extensiones Java

  3. En la ficha View (Ver), seleccione Command Palette (Paleta de comandos) y pulse Ctrl+Mayús+P.

  4. Busque Java: New Project.

  5. Seleccione la plantilla del proyecto como Maven.

  6. Introduzca los detalles del proyecto:

    • Nombre del proyecto.

    • Ubicación del proyecto (por defecto, es la carpeta del espacio de trabajo actual).

    • Nombre del paquete (por ejemplo, com.example.myproject).

  7. Defina la ruta de Java en la variable de entorno.

  8. Visual Studio Code crea la estructura de directorios y los archivos del proyecto.

  9. Abra el archivo pom.xml desde el directorio del proyecto y agregue la dependencia de Oracle NoSQL Java SDK de la siguiente manera. Utilice la última versión. Consulte SDK de Java de Oracle NoSQL.

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

Crear y ejecutar un programa de aplicación de ejemplo

  1. Cree un código de aplicación de ejemplo de la siguiente manera. Actualice la región en <your_region_identifier> y el OCID del compartimento en los marcadores de posición <ocid_of_your_compartment>.

    Nota: Esta aplicación recupera los detalles de autenticación del archivo de configuración de OCI. Para obtener más información sobre el archivo de configuración y su contenido, consulte Autenticación para conectarse a 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. Ejecute el programa Java. Puede pulsar F5 o seleccionar la opción deseada en el menú Run (Ejecutar).

    Nota: Si tiene proxies de red, inclúyalos en el archivo settings.xml ubicado en el directorio maven.

  3. Puede ver la salida en el terminal de Visual Studio Code.

El código de aplicación anterior crea la tabla TestSDK, agrega una fila a la tabla y lee la fila de la tabla.

Salida de ejemplo:

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

También puede ver la tabla desde el Explorador de tablas de Visual Studio Code. Para obtener detalles, consulte Gestión de tablas mediante la extensión Visual Studio Code.

Gestión de tablas mediante la extensión Visual Studio Code

Después de conectarse al despliegue mediante la extensión de código de Oracle NoSQL Database Visual Studio (VS), utilice el TABLE EXPLORER situado en la navegación izquierda para:

También puede:

Explorar tablas, columnas, índices y claves

Al ampliar una conexión activa, Oracle NoSQL Database VS Code muestra las tablas de ese despliegue.

Realizar operaciones DDL con Visual Studio Code

Puede utilizar Visual Studio Code para realizar operaciones DDL.

Algunas de las operaciones DDL que se pueden realizar desde el plugin de Visual Studio Code son:

CREATE TABLE

Puede crear la tabla de Oracle NoSQL Database en dos modos:

  1. Pase el mouse sobre la conexión de Oracle NoSQL Database para agregar la nueva tabla.

  2. Haga clic en el icono Más que aparece o haga clic con el botón derecho en el nombre de la conexión a la base de datos y haga clic en Crear Tabla

    explorador de tablas

  3. En la página Crear Tabla, seleccione Entrada DDL Simple.

    Tabla: Creación de una Tabla de Oracle NoSQL Database

    Campo Descripción
    Nombre de tabla: Especifique un nombre de tabla único.
    Nombre de la Columna Especifique un nombre de columna para la clave primaria de la tabla.
    Tipo de columna Seleccione el tipo de datos para su columna de clave primaria.
    Definir como clave de partición Seleccione esta opción para definir esta columna de clave primaria como clave de Partición. La clave de partición es distribuir los datos en el cluster de Oracle NoSQL Database para una mayor eficacia y ubicar localmente los registros que comparten de forma local la clave de partición para facilitar el acceso y la referencia. Los registros que comparten la clave de partición horizontal se almacenan en la misma ubicación física y se puede acceder a ella de manera atómica y eficiente.
    Eliminar Haga clic en este botón para suprimir una columna existente.
    + Agregar Columna de Clave Primaria Haga clic en este botón para agregar más columnas al crear una clave primaria compuesta (de varias filas).
    Nombre de la Columna Especifique el nombre del columna.
    Tipo de columna Seleccione el tipo de datos para su columna.
    Valor por Defecto (Opcional) Especifique un valor por defecto para la columna.

    Nota: No se puede especificar los valores por defecto para las columnas del tipo JSON y binarios.
    No Nulo Seleccione esta opción para especificar que una columna siempre debe tener un valor.
    Eliminar Haga clic en este botón para suprimir una columna existente.
    + Agregar columna Haga clic en este botón para agregar más columnas.
    Unidad Seleccione la unidad (Días u Horas) que se utilizará para el valor de TTL para las filas de la tabla.
    Valor Especifique la duración de caducidad de las filas de la tabla. Después del número de días u horas, las filas caducan automáticamente y ya no están disponibles. El valor por defecto es cero, lo que indica que no hay tiempo de caducidad.

    Nota: La actualización de la hora de duración de la tabla (TTL) no cambia el valor TTL de ningún dato existente en la tabla. El nuevo valor de TTL se aplica solo a las filas que se agregan a la tabla después de modificar este valor y a las filas para las que no se ha proporcionado ningún valor específico de fila de sustitución.

  4. Haga clic en Crear.

  5. Tiene la opción de ver la sentencia DDL antes y después de crear una tabla.

    • Antes de crear la tabla, haga clic en Mostrar DDL en la pantalla Crear Tabla para ver la sentencia DDL formada en función de los valores introducidos en los campos en el modo entrada DDL simple. Esta sentencia DDL se ejecuta al hacer clic en Crear.

    • Después de crear la tabla, haga clic con el botón derecho en la tabla existente. Seleccione Ver DDL de Tabla.

CREAR TABLA SECUNDARIA

Para crear una tabla secundaria, haga clic con el botón derecho en la tabla deseada y seleccione Crear Tabla Secundaria. Puede crear una tabla secundaria para una tabla de Oracle NoSQL Database ya existente en uno de los dos modos siguientes:

Para obtener más información sobre las tablas secundarias, consulte Jerarquías de tablas en Oracle NoSQL Database Cloud Service Guide.

DROP TABLE

  1. Haga clic con el botón secundario en la tabla de destino.

  2. Haga clic en Borrar tabla.

  3. Haga clic en Sí para borrar la tabla.

CREATE INDEX

DROP INDEX

AGREGAR COLUMNA

BORRAR COLUMNA

Congelar/Descongelar Esquema

Para convertir una tabla singleton en una tabla activa global, primero debe congelar el esquema. Para obtener más información, consulte Congelamiento del Esquema de una Tabla.

Para congelar/descongelar el esquema, siga los siguientes pasos:

  1. Haga clic con el botón derecho en la tabla deseada y haga clic en Congelar/Descongelar esquema.

  2. Aparece un cuadro de diálogo, haga clic en Sí para confirmar la acción.

Gestionar réplicas

Consulte Regional Table Replicas para comprender qué son las réplicas y cómo convertir una tabla única en una tabla activa global.

Agregar réplicas

El plugin Visual Studio Code le permite agregar una réplica de tabla en diferentes regiones. También permite agregar réplicas a una tabla activa global existente.

  1. Haga clic con el botón derecho en la tabla deseada, en la sección Replicas, seleccione Agregar réplicas.

  2. En el panel Agregar réplica, seleccione una región de la lista desplegable Región de replicación.

  3. Introduzca Read Capacity (Capacidad de lectura), Write Capacity (Capacidad de escritura) y Disk Storage (Almacenamiento de disco) según sus requisitos.

  4. Haga clic en Agregar réplica.

  5. Cuando reciba una notificación de que se han agregado réplicas, cierre el panel haciendo clic en 'x' o pulsando 'Ctrl+F4'.

Borrar réplicas

  1. Haga clic con el botón derecho en la tabla deseada cuya réplica de tabla desea suprimir. En las secciones Replicas, seleccione Borrar réplicas.

  2. En el panel Borrar réplicas regionales, seleccione la réplica en la lista desplegable Nombre de réplica que desea suprimir. Para suprimir muchas réplicas simultáneamente, haga clic en +Agregar y seleccione el nombre de réplica.

    Nota: Para eliminar cualquier réplica, no desea suprimirla, simplemente haga clic en Eliminar junto al nombre de la réplica.

  3. Haga clic en Borrar réplicas.

  4. Cuando reciba una notificación de que se han borrado las réplicas, cierre el panel haciendo clic en 'x' o pulsando 'Ctrl+F4'.

Ver réplicas

  1. Haga clic con el botón derecho en la tabla deseada para ver sus réplicas. En la sección Replicas, seleccione Ver réplicas.

  2. En el panel Ver réplicas regionales, puede ver una lista de réplicas regionales con su capacidad de escritura.

  3. Después de ver las réplicas, cierre el panel haciendo clic en 'x' o pulsando 'Ctrl+F4'.

Editar capacidad reservada

  1. Haga clic con el botón derecho en la tabla deseada y haga clic en Editar capacidad reservada.

  2. En el panel Editar capacidad reservada, puede actualizar la capacidad aprovisionada o la capacidad bajo demanda.

    1. Capacidad aprovisionada: puede editar la capacidad de lectura, la capacidad de escritura y el almacenamiento en disco según sus requisitos.

    2. Capacidad bajo demanda: solo puede modificar el almacenamiento en disco. La capacidad de lectura y la capacidad de escritura están en modo de solo lectura.

  3. Cuando reciba una notificación de que se ha actualizado la capacidad reservada, cierre el panel haciendo clic en 'x' o pulsando 'Ctrl+F4'.

Realizar operaciones DML con Visual Studio Code

Puede agregar datos, modificar datos existentes y consultar datos de tablas mediante el plugin Visual Studio Code.

Insertar Datos

Modificar datos - UPDATE ROW/DELETE ROW:

Ejecución de Consultas SQL para una Tabla

Nota: La lista desplegable solo mostrará las sentencias SQL relacionadas con la tabla con la que está tratando.

Eliminación de una Conexión

Oracle NoSQL Database Connector proporciona dos métodos para eliminar una conexión de Visual Studio (VS) Code.

Puede:

Nota: Para eliminar una conexión permanentemente del plugin, seleccione la conexión en la lista desplegable Conexiones. Haga clic en Suprimir conexión. Obtendrá una confirmación para suprimir el plugin y haga clic en Sí para eliminar la conexión del plugin. Al eliminar una conexión de Visual Studio Code, se suprimen los detalles de conexión persistentes del espacio de trabajo actual.

  1. Expanda el panel TABLE EXPLORER en la navegación izquierda si está reducido.

  2. Haga clic con el botón derecho en la conexión que desea eliminar y, a continuación, haga clic en Eliminar conexión.

  1. Para abrir la paleta de comandos, pulse:

    • (Windows y Linux) Control + Mayús + P

    • (macOS) Comando + Mayús + P

  2. En la paleta de comandos, seleccione OracleNoSQL: Eliminar conexión.

    Nota: Introduzca oraclenosql en la paleta de comandos para mostrar todos los comandos de Oracle NoSQL DB que puede utilizar.

Requisitos de autorización para Visual Studio Code

Obtenga información sobre los requisitos de autorización necesarios en Oracle NoSQL Database Cloud Service para utilizar Visual Studio Code.

La extensión Visual Studio Code le permite acceder a la base de datos Cloud Service de Oracle NoSQL mediante el método de autenticación de clave de API. El acceso a los recursos de Oracle NoSQL Database Cloud Service, como tablas, tablespaces y API, se gestiona mediante políticas de gestión de identidad y acceso (IAM). Esto garantiza que solo los usuarios autenticados, que son miembros de grupos con los permisos de inspección, lectura, uso o gestión adecuados de la tabla en un compartimento determinado, puedan interactuar con estos recursos. Para obtener más información, consulte Gestión de acceso a tablas de NDCS.

Al utilizar Visual Studio Code para gestionar tablas en tablas de Oracle NoSQL Database Cloud Service, los permisos de IAM efectivos determinan los recursos desde los que puede leer o escribir. Si un usuario intenta una acción para la que carece de autorización, Visual Studio Code devolverá el error de autorización correspondiente proporcionado por OCI IAM.

Por ejemplo, OCI IAM deniega cualquier operación de inserción en una tabla de Oracle NoSQL Database Cloud Service si su grupo de usuarios solo tiene el permiso de "lectura" para las tablas NoSQL. Aparecerá el siguiente mensaje de error en la extensión de Visual Studio Code:

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