Usando a Extensão de Código do Visual Studio para Desenvolvimento

O Oracle NoSQL Database Cloud Service fornece uma extensão para o Microsoft Visual Studio Code que permite estabelecer conexão com uma instância em execução do Oracle NoSQL Database Cloud Service.

Você pode usar a extensão do Código do Visual Studio (VS) do Oracle NoSQL Database para:

Este artigo tem os seguintes tópicos:

Instalando a Extensão de Código do Visual Studio do Oracle NoSQL Database

Você pode instalar a extensão do Oracle NoSQL Database VS Code no Visual Studio Marketplace para instalação on-line.

Para poder instalar a extensão do Oracle NoSQL Database Visual Studio (VS) Code, instale o Visual Studio Code. Você pode fazer download do Visual Studio Code aqui.

Para instalação:

  1. No Visual Studio Code, clique no ícone Extensões na navegação à esquerda.

    Barra de Atividades de Código do Visual Studio

    Como alternativa, você pode abrir a exibição Extensões pressionando:

    • (Windows e Linux) Controle + Shift + X

    • (macOS) Comando + Shift + X.

  2. Pesquise o Oracle NoSQL Database Connector no mercado de extensões.

  3. Clique em Instalar na extensão do Oracle NoSQL Database Connector

Estabelecendo Conexão com o Oracle NoSQL Database Cloud Service ou o Oracle NoSQL Database Cloud Simulator pelo Visual Studio Code

A extensão do Código do Visual Studio (VS) do Oracle NoSQL Database fornece dois métodos para estabelecer conexão com o Oracle NoSQL Database Cloud Service ou o Oracle NoSQL Database Cloud Simulator.

É possível fornecer um arquivo de configuração com as informações de conexão ou preencher as informações de conexão nos campos específicos. Se você estiver usando um driver, por exemplo, um driver Node.js e já tiver detalhes de conexão salvos em um arquivo ou quiser criar um, use a opção Usar Arquivo de Configuração para estabelecer conexão com o Oracle NoSQL Database Cloud Service. Caso contrário, se você estiver criando uma nova conexão, use a opção Avançado.

  1. No Visual Studio Code, clique na exibição Oracle NoSQL DB na Barra de Atividades.

    Barra de Atividades de Código do Visual Studio

  2. Abra a página Mostrar Definições de Conexão do Oracle NoSQL DB na Paleta de Comandos ou na exibição Oracle NoSQL DB na Barra de Atividades.

    • Abrir na Paleta de Comandos

      1. Abra a Paleta de Comandos pressionando:

        • (Windows e Linux) Controle + Shift + P

        • (macOS) Comando + Shift + P

      2. Na Paleta de Comandos, selecione OracleNoSQL: Mostrar Definições de Conexões.

        Dica:

        Digite oraclenosql na Paleta de Comandos para exibir todos os comandos do Oracle NoSQL DB que você pode usar.

- 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. Na página Mostrar Definições de Conexão, clique em Cloud ou CloudSim para estabelecer conexão com o Oracle NoSQL Database Cloud Service ou o Oracle NoSQL Database Cloud Simulator.

  2. Clique em Adicionar Nova Conexão e especifique as informações de conexão. Clique em Adicionar.

    Tabela - Parâmetros de Conexão da Nuvem

    Campo Descrição Amostra de Valor
    Nome da Conexão: Um nome exclusivo para a especificação de conexão é obrigatório a partir do plug-in versão 4.0.0. A atualização do campo Nome da Conexão é recomendada após o upgrade do plug-in da versão 3.0.0 ou inferior.

    Observação: Você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.    		  
    Região/Ponto Final: Um Identificador de Região ou um Ponto Final de Serviço para acessar o Oracle NoSQL Database Cloud Service. Consulte Regiões dos Dados e URLs de Serviço Associados para ver uma lista de Identificadores de Região e Pontos Finalizados de Serviço. us-ashburn-1 ou https://nosql.us-ashburn-1.oci.oraclecloud.com (para o identificador da região Ashburn do Oracle NoSQL Database Cloud Service na região da América do Norte).
    OCID do Tenant: O OCID da Tenancy para o Oracle NoSQL Database Cloud Service. Consulte Onde Obter o OCID da Tenancy e o OCID do Usuário na Documentação do Oracle Cloud Infrastructure. ocid1.tenancy.oc1..<unique_ID>
    OCID do Usuário: O OCID do usuário para o Oracle NoSQL Database Cloud Service. Consulte Onde Obter o OCID da Tenancy e o OCID do Usuário na Documentação do Oracle Cloud Infrastructure. ocid1.user.oc1..<unique_ID>
    Impressão Digital: Impressão digital da chave privada que foi adicionada a este usuário.<p>A impressão digital da chave de assinatura é criada ao gerar e fazer upload de uma Chave de Assinatura de API. Consulte Como Obter a Impressão Digital da Chave na Documentação do Oracle Cloud Infrastructure. 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
    Arquivo de Chave Privada: Navegue até o local onde a chave privada está armazenada. Consulte Como Gerar uma Chave de Assinatura da API para gerar a chave de assinatura com uma frase-senha opcional. /home/user/.oci/oci_api_key.pem
    Frase-senha: A frase-senha especificada ao criar a chave privada. A frase-senha da chave da assinatura é criada ao gerar e carregar a Chave de Assinatura de API. Consulte Como Obter a Impressão Digital da Chave na Documentação do Oracle Cloud Infrastructure.
    Obrigatório, somente se a chave for criptografada.    		  
    Compartimento: O nome ou o OCID do compartimento do seu esquema do Oracle NoSQL Database Cloud Service.

    Se você não fornecer nenhum valor, o campo assumirá como padrão o compartimento root.

    Você cria compartimentos no serviço Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configurando sua Tenancy e Gerenciando Compartimentos na Documentação do Oracle Cloud Infrastructure .

    		- Nome do compartimento: mycompartment

    - Nome do compartimento qualificado com seu compartimento pai: parent.childcompartment

    - OCID do Compartimento: ocid1.tenancy.oc1...<unique_ID>

    Tabela - Parâmetros de Conexão CloudSim

    Campo Descrição Amostra de Valor
    Nome da Conexão: Um nome exclusivo para a especificação de conexão é obrigatório a partir do plug-in versão 4.0.0. A atualização do campo Nome da Conexão é recomendada após o upgrade do plug-in da versão 3.0.0 ou inferior.

    Observação: você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.    		  
    Ponto Final: URL do Ponto Final do Serviço da instância do Oracle NoSQL Database Cloud Simulator. http://myinstance.cloudsim.com:8080

    Se você não especificar o valor, o padrão será http://localhost:8080.
    Identificador de Tenant: Identificador exclusivo para identificar o tenant. Tenant01

    Se você não especificar o valor, ele será padronizado como TestTenant.

    Observação: O processamento da conexão foi alterado a partir da versão 4.0.0. Se você estiver usando uma versão mais antiga do plug-in, somente a conexão usada mais recentemente será migrada durante o processo de upgrade para a versão 4.0.0. O plug-in designará automaticamente o nome cloud_old0 à conexão migrada. Você pode alterar o nome da conexão usando a opção Modificar Conexão na página Configuração de Conexões.

  3. Os detalhes da conexão são salvos. Para modificar conexões existentes, selecione a conexão na lista drop-down Conexões. Clique em Modificar Conexão. Faça as alterações desejadas nos Parâmetros de Conexão e clique em Salvar.

  4. Clique no Ícone da Web no TABLE EXPLORER para exibir a lista de todas as conexões (on-premises e na Nuvem) presentes no plug-in. As conexões são exibidas no menu suspenso no formato: Connection Name:Endpoint: Compartment (se especificado).

    Escolha a conexão na lista e selecione Conectar. O plug-in do Visual Studio Code se conecta ao Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator e exibe todas as suas tabelas na janela Explorador de Tabelas.

  1. Se você não tiver um arquivo de configuração, crie um, por exemplo, config.json ou um arquivo com o objeto JSON. O formato do arquivo de configuração para conexão com o Oracle NoSQL Database Cloud Service ou o Oracle NoSQL Database Cloud Simulator é o mostrado abaixo.

    Tabela - Modelos de Configuração

    Oracle NoSQL Database Cloud Service Oracle NoSQL Database Cloud Simulator
    Modelo de configuração para conexão usando o arquivo de configuração do OCI
    { "region": "", "compartment": "", "auth": { "iam": { "configFile": "",  "profileName": "" } } }
    Modelo de configuração para conexão usando credenciais de autenticação do IAM
    { "region": "", "compartment": "", "auth": { "iam": { "tenantId": "", "userId": "", "fingerprint": "", "privateKeyFile": "", "passphrase": "" } } }
    		 
    { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer" }

  2. Abra a página Mostrar Definições de Conexão do Oracle NoSQL DB na Paleta de Comandos ou na exibição do Oracle NoSQL DB na Barra de Atividades.

    • Abrir na View do Oracle NoSQL DB

      • Expanda o painel Explorador de Tabelas na navegação esquerda se ele estiver recolhido.

      • Clique em Adicionar Conexão para abrir a página Mostrar Definições de Conexão do Oracle NoSQL DB.

      • Na página Mostrar Definições de Conexão, clique em Nuvem para estabelecer conexão com o Oracle NoSQL Database.

      • Especifique as informações de conexão e clique em Adicionar.

        Tabela - Parâmetros de Conexão da Nuvem

        Campo Descrição Amostra de Vaue
        Nome da Conexão: Um nome exclusivo para a especificação de conexão é obrigatório a partir do plug-in versão 4.0.0. A atualização do campo Nome da Conexão é recomendada após o upgrade do plug-in da versão 3.0.0 ou inferior.

        Observação: você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.        		  
        Região/Ponto Final: Um Identificador de Região ou um Ponto Final de Serviço para acessar o Oracle NoSQL Database Cloud Service. Consulte Regiões dos Dados e URLs de Serviço Associados para ver uma lista de Identificadores de Região e Pontos Finalizados de Serviço. us-ashburn-1 ou https://nosql.us-ashburn-1.oci.oraclecloud.com (para o identificador da região Ashburn do Oracle NoSQL Database Cloud Service na região da América do Norte).
        Arquivo de Configuração: Navegue até o local onde o arquivo de configuração do OCI está armazenado. /home/user/security/config/oci.config
        Perfil: Nome do perfil de configuração a ser usado para estabelecer conexão com o Oracle NoSQL Database Cloud Service. Se você não especificar esse valor, o campo assumirá como padrão o perfil DEFAULT ADMIN_USER
        Compartimento: O nome ou o OCID do compartimento do seu esquema do Oracle NoSQL Database Cloud Service.

        Se você não fornecer nenhum valor, o campo assumirá como padrão o compartimento root.

        Você cria compartimentos no serviço Oracle Cloud Infrastructure Identity and Access Management (IAM). Consulte Configurando sua Tenancy e Gerenciando Compartimentos na Documentação do Oracle Cloud Infrastructure

        • Nome do compartimento

          meucompartimento

        • Nome do compartimento qualificado com seu compartimento pai

          parent.childcompartment

        • OCID do Compartimento

          ocid1.tenancy.oc1...

Observação: O processamento da conexão foi alterado a partir da versão 4.0.0. Se você estiver usando uma versão mais antiga do plug-in, somente a conexão usada mais recentemente será migrada durante o processo de upgrade para a versão 4.0.0. O plug-in designará automaticamente o nome cloud_old0 à conexão migrada. Você pode alterar o nome da conexão usando a opção Modificar Conexão na página Configuração de Conexões.

  • Abrir na Paleta de Comandos:

    • Abra a Paleta do Comando pressionando:

      • (Windows e Linux) Controle + Shift + P

      • (macOS) Comando + Shift + P

    • Na Paleta de Comandos, selecione Oracle NoSQL: Connect via Config File.

      Observação: Digite oraclenosql na Paleta de Comandos para exibir todos os comandos do Oracle NoSQL DB que você pode usar.

    • Navegue até o local onde o arquivo *.config está armazenado e clique em Selecionar.

  1. Os detalhes da conexão são salvos. Para modificar conexões existentes, selecione a conexão na lista drop-down Conexões. Clique em Modificar Conexão. Faça as alterações desejadas nos Parâmetros de Conexão e clique em Salvar.

  2. Clique no Ícone da Web no TABLE EXPLORER para exibir a lista de todas as conexões (on-premises e na Nuvem) presentes no plug-in. As conexões são exibidas no menu suspenso no formato: Connection Name:Endpoint: Compartment (se especificado).

    Escolha a conexão na lista e selecione Conectar. O plug-in do Visual Studio Code se conecta ao Oracle NoSQL Database Cloud Serviceor Oracle NoSQL Database Cloud Simulator e exibe todas as suas tabelas na janela Explorador de Tabelas.

Criando aplicativos usando o Oracle NoSQL Java SDK do Visual Studio Code

Aprenda a criar aplicativos com base na extensão do Visual Studio Code usando o pacote Oracle NoSQL Java SDK.

Depois de se conectar ao Oracle NoSQL Database Cloud Simulator ou ao Oracle NoSQL Database Cloud Service, você poderá criar aplicativos usando o Oracle NoSQL Java SDK.

Faça o seguinte:

Configurar o Projeto Maven

  1. Abra o Visual Studio Code.

  2. Instale o Java Extension Pack:

    1. Abra a exibição Extensões clicando no ícone Extensões na barra lateral esquerda.

    2. Procure o Java Extension Pack no Extensions Marketplace.

    3. Clique no botão Instalar para instalar o Pacote de Extensões Java

  3. Na guia Exibir, selecione Paleta de Comandos e pressione Ctrl+Shift+P.

  4. Procure Java: Novo Projeto.

  5. Escolha o modelo do projeto como Maven.

  6. Informe os detalhes do projeto:

    • O nome do projeto.

    • Local do projeto (o padrão é a pasta do espaço de trabalho atual).

    • Nome do pacote (Por exemplo, com.example.myproject).

  7. Defina o caminho Java na variável de ambiente.

  8. O Visual Studio Code cria a estrutura e os arquivos do diretório do projeto.

  9. Abra o arquivo pom.xml no diretório do projeto e adicione a dependência do Oracle NoSQL Java SDK da seguinte forma. Use a versão mais recente. Consulte Oracle NoSQL Java SDK.

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

Criar e executar um programa aplicativo de amostra

  1. Crie um exemplo de código de aplicativo da seguinte forma: Atualize sua região em <your_region_identifier> e no OCID do compartimento nos placeholders <ocid_of_your_compartment>.

    Observação: Este aplicativo recupera detalhes de autenticação do arquivo de configuração do OCI. Para obter mais informações sobre o arquivo de configuração e seu conteúdo, consulte Autenticação para estabelecer conexão com o 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. Execute o programa Java. Você pode pressionar F5 ou selecionar a opção desejada no menu Executar.

    Observação: Se você tiver proxies de rede, inclua-os no arquivo settings.xml localizado no diretório maven.

  3. Você pode exibir a saída no terminal do Visual Studio Code.

O código do aplicativo acima cria a tabela TestSDK, adiciona uma linha à tabela e lê a linha da tabela.

Amostra de saída:

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

Você também pode exibir a tabela no Explorador de Tabelas do Visual Studio Code. Para obter detalhes, consulte Gerenciando Tabelas Usando a Extensão do Visual Studio Code.

Gerenciando Tabelas com a Extensão do Visual Studio Code

Depois de se conectar à sua implantação usando a extensão do Código do Visual Studio (VS) do Oracle NoSQL Database, use o TABLE EXPLORER localizado na navegação esquerda para:

Você também pode:

Explorar tabelas, colunas, índices e chaves

Quando você expande uma conexão ativa, o Código VS do Oracle NoSQL Database mostra as tabelas nessa implantação.

Executar operações DDL usando o Visual Studio Code

Você pode usar o Visual Studio Code para executar operações DDL.

Algumas das operações DDL que podem ser executadas de dentro do plug-in do Visual Studio Code são:

CREATE TABLE

Você pode criar a tabela do Oracle NoSQL Database de dois modos:

  1. Passe o mouse sobre a conexão do Oracle NoSQL Database para adicionar a nova tabela.

  2. Clique no ícone Mais que aparece ou clique com o botão direito do mouse no nome da conexão de banco de dados e clique em Criar Tabela

    mesa-explorador

  3. Na página Criar Tabela, selecione Entrada de DDL Simples.

    Tabela - Criar uma Tabela do Oracle NoSQL Database

    Campo Descrição
    Nome da Tabela: Especifique um nome de tabela exclusivo.
    Nome da Coluna Especifique um nome de coluna para a chave primária em sua tabela.
    Tipo de Coluna Selecione o tipo de dados da coluna de chave primária.
    Definir como Chave de Shard Selecione esta opção para definir esta coluna da chave primária como chave de partição A chave de shard é distribuir dados entre o cluster do Oracle NoSQL Database para aumentar a eficiência e posicionar registros que compartilham a chave de shard localmente para facilitar a referência e o acesso. Os registros que compartilham a chave de shard são armazenados no mesmo local físico e podem ser acessados de maneira atômica e eficiente.
    Remover Clique neste botão para excluir uma coluna existente.
    + Adicionar Coluna de Chave Primária Clique neste botão para adicionar mais colunas ao criar uma chave primária composta (múltiplas colunas).
    Nome da Coluna Especifique o nome da coluna.
    Tipo de Coluna Selecione o tipo de dados da sua coluna.
    Valor Padrão (opcional) Especifique um valor padrão para a coluna.

    Observação: Os valores padrão não podem ser especificados para colunas de tipo de dados binário e JSON.
    Não Nulo Selecione esta opção para especificar que uma coluna deve sempre ter um valor.
    Remover Clique neste botão para excluir uma coluna existente.
    + Adicionar Coluna Clique neste botão para adicionar mais colunas.
    Unidade Selecione a unidade (Dias ou Horas) a ser usada para o valor TTL das linhas na tabela.
    Valor Especifique a duração da expiração para as linhas na tabela. Após o número de dias ou horas, as linhas expiram automaticamente e não estão mais disponíveis. O valor padrão é zero, indicando que não há tempo de expiração.

    Observação: A atualização do TTL (Table Time to Live) não altera o valor de TTL de nenhum dado existente na tabela. O novo valor de TTL aplica-se somente às linhas adicionadas à tabela após a modificação desse valor e às linhas para as quais nenhum valor específico da linha de substituição foi fornecido.

  4. Clique em Criar.

  5. Você tem uma opção para exibir a instrução DDL antes e depois de criar uma tabela.

    • Antes de criar a tabela - Clique em Mostrar DDL na tela Criar Tabela para exibir a instrução DDL formada com base nos valores informados nos campos no modo Entrada DDL Simples. Essa instrução DDL é executada quando você clica em Create.

    • Depois de criar a tabela, clique com o botão direito do mouse na tabela existente. Escolha Exibir DDL da Tabela.

CRIAR TABELA FILHO

Para criar uma tabela filho, clique com o botão direito do mouse na tabela desejada e escolha Criar Tabela Filho. Você pode criar uma tabela filho para uma tabela já existente do Oracle NoSQL Database em um dos dois modos:

Para obter mais detalhes sobre tabelas filhas, consulte Hierarquias de Tabelas no Oracle NoSQL Database Cloud Service Guide.

DROP TABLE

  1. Clique em Tabela de destino com o botão direito do mouse.

  2. Clique em Eliminar Tabela.

  3. Clique em Sim para eliminar a tabela.

CREATE INDEX

DROP INDEX

ADICIONAR COLUNA

ELIMINAR COLUNA

Congelar/Descongelar Esquema

Para tornar uma tabela única uma tabela Global Ativa, você deve primeiro congelar o esquema. Para obter mais informações, consulte Congelando o esquema de uma tabela.

Para Congelar/Descongelar esquema, siga as etapas abaixo:

  1. Clique com o botão direito do mouse na tabela desejada e clique em Congelar/Descongelar esquema.

  2. Uma caixa de diálogo é exibida. Clique em Sim para confirmar a ação.

Gerenciar réplicas

Consulte Réplicas de Tabela Regional para entender o que são réplicas e como converter uma tabela singleton em uma tabela Ativa Global.

Adicionar réplicas

O plug-in do Visual Studio Code permite adicionar uma réplica de tabela em diferentes regiões. Ele também permite que você adicione réplicas a uma tabela Global Active existente.

  1. Clique com o botão direito do mouse na tabela desejada, na seção Replicas, selecione Adicionar Réplicas.

  2. No painel Adicionar Réplica, selecione uma região no menu suspenso Região de replicação.

  3. Informe a Capacidade de Leitura, a Capacidade de Gravação e o Armazenamento em Disco, dependendo dos seus requisitos.

  4. Clique em Adicionar Réplica.

  5. Quando você receber uma notificação de que réplicas foram adicionadas, feche o painel clicando em 'x' ou pressionando 'Ctrl+F4'.

Eliminar réplicas

  1. Clique com o botão direito do mouse na tabela desejada cuja réplica da tabela você deseja excluir. Nas seções Replicas, selecione Eliminar Réplicas.

  2. No painel Réplicas Regionais Suspensas, selecione a réplica na lista drop-down Nome da Réplica que deseja excluir. Para excluir muitas réplicas simultaneamente, clique em +Adicionar e selecione o Nome da Réplica.

    Observação: para remover qualquer réplica, você não deseja excluir, basta clicar em Remover ao lado do nome da réplica.

  3. Clique em Eliminar Réplicas.

  4. Quando você receber uma notificação de que réplicas foram eliminadas, feche o painel clicando em 'x' ou pressionando 'Ctrl+F4'.

Exibir Réplicas

  1. Clique com o botão direito do mouse na tabela desejada para exibir suas réplicas. Na seção Replicas, selecione Exibir Réplicas.

  2. No painel Exibir Réplicas Regionais, você pode exibir uma lista de réplicas regionais com sua Capacidade de Gravação.

  3. Depois de exibir as réplicas, feche o painel clicando em 'x' ou pressionando 'Ctrl+F4'.

Editar Capacidade Reservada

  1. Clique com o botão direito no quadro desejado e clique em Editar Capacidade Reservada.

  2. No painel Editar Capacidade Reservada, você pode atualizar a Capacidade Provisionada ou a Capacidade Sob Demanda.

    1. Capacidade Provisionada: Você pode editar a Capacidade de Leitura, a capacidade de Gravação e o Armazenamento em Disco de acordo com seus requisitos.

    2. Capacidade Sob Demanda: Você só pode modificar o Armazenamento em Disco. A Capacidade de Leitura e a Capacidade de Gravação estão no modo Somente Leitura.

  3. Quando você receber uma notificação de que a capacidade reservada foi atualizada, feche o painel clicando em 'x' ou pressionando 'Ctrl+F4'.

Executar operações DML usando o Visual Studio Code

Você pode adicionar dados, modificar dados existentes e consultar dados de tabelas usando o plug-in Visual Studio Code.

Inserir Dados

Modificar Dados - UPDATE ROW/DELETE ROW:

Executando Consultas SQL de uma Tabela

Observação: A lista suspensa mostrará apenas instruções SQL relacionadas à tabela com a qual você está lidando.

Removendo uma Conexão

O Oracle NoSQL Database Connector fornece dois métodos para remover uma conexão do Visual Studio (VS) Code.

Você pode:

Observação: Para remover uma conexão permanentemente do plug-in, selecione a conexão na lista drop-down Conexões. Clique em Excluir Conexão. Você recebe uma confirmação para excluir o plug-in e clica em Sim para remover a conexão do plug-in. A remoção de uma conexão do Visual Studio Code exclui os detalhes da conexão persistente do espaço de trabalho atual.

  1. Expanda o painel TABLE EXPLORER na navegação esquerda se ele estiver recolhido.

  2. Clique com o botão direito do mouse na conexão que deseja remover e, em seguida, clique em Remover Conexão.

  1. Abra a Paleta de Comandos pressionando:

    • (Windows e Linux) Controle + Shift + P

    • (macOS) Comando + Shift + P

  2. Na Paleta de Comandos, selecione OracleNoSQL: Remover Conexão.

    Observação: Digite oraclenosql na Paleta de Comandos para exibir todos os comandos do Oracle NoSQL DB que você pode usar.

Requisitos de Autorização para o Visual Studio Code

Saiba mais sobre os requisitos de autorização necessários no Oracle NoSQL Database Cloud Service para usar o Visual Studio Code.

A extensão Visual Studio Code permite acessar o banco de dados Oracle NoSQL Cloud Service usando o método de autenticação de chave de API. O acesso a recursos no Oracle NoSQL Database Cloud Service, como tabelas, tablespaces e APIs, é gerenciado por meio de políticas do IAM (Identity and Access Management). Isso garante que somente usuários autenticados, que são membros de grupos com as permissões apropriadas de inspecção, leitura, uso ou gerenciamento de tabelas em um determinado compartimento, possam interagir com esses recursos. Para obter mais informações, consulte Gerenciando o Acesso a Tabelas do NDCS.

Ao usar o Visual Studio Code para gerenciar tabelas em tabelas do Oracle NoSQL Database Cloud Service, suas permissões efetivas do IAM determinam quais recursos você pode ler ou gravar. Se um usuário tentar uma ação para a qual não tenha autorização, o Visual Studio Code retornará o erro de autorização correspondente conforme fornecido pelo OCI IAM.

Por exemplo, o OCI IAM negará qualquer operação de inserção em uma tabela do Oracle NoSQL Database Cloud Service se seu grupo de usuários tiver apenas a permissão "ler" para tabelas NoSQL. A seguinte mensagem de erro é exibida na extensão do Visual Studio Code:

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