Usando o Plug-in IntelliJ para Desenvolvimento

Procurar tabelas e executar consultas na sua instância ou no seu simulador do Oracle NoSQL Database Cloud Service a partir de IntelliJ.

O plug-in IntelliJ do Oracle NoSQL Database Cloud Service conecta-se com uma instância em execução do Oracle NoSQL Database Cloud Service ou com um simulador e permite que você:

• Visualize as tabelas em uma estrutura em árvore bem definida com o Table Explorer.
• Exiba informações sobre colunas, índices, chave(s) primária(s) e chave(s) de partição de uma tabela.
• Exiba os dados da coluna em uma Estrutura JSON bem formatada.
• Crie tabelas usando entrada de esquema baseada em form ou forneça instruções DDL.
• Eliminar tabelas.
• Adicione novas colunas usando entrada baseada em form ou forneça instruções DDL.
• Eliminar Colunas.
• Criar Índices.
• Eliminar índices.
• Execute consultas SQL SELECT em uma tabela e exiba os resultados da consulta em formato tabular.
• Executar instruções DML para atualizar, inserir e excluir dados de uma tabela.

Este artigo tem os seguintes tópicos:

Configurando o Plug-in IntelliJ

Saiba como configurar o plug-in IntelliJ para a instância do Oracle NoSQL Database Cloud Service.

Como pré-requisito, primeiro instale o IntelliJ IDEA. Você pode fazer download do IntelliJ IDEA em JetBrains.

Você pode instalar o plug-in usando uma das seguintes opções:

1. Opção 1: pesquise o Oracle NoSQL Database Cloud Service Connector no repositório de plug-ins do JetBrains e instale-o.
2. Opção 2: Instale a partir do Oracle Technology Network.

   Observação:

   É possível fazer download da versão mais atualizada do Oracle Technology Network.

   1. Faça download do plug-in IntelliJ no Oracle Technology Network. Não extraia os arquivos.
   2. Inicie o IntelliJ IDEA e navegue até Arquivo > Configurações > Plug-ins. Você também pode acessar as definições selecionando o ícone Definições do IDE e do Projeto localizado no canto superior direito da barra de menus principal.
   3. Selecione o ícone Gerenciar Repositórios, Configurar Proxy ou Instalar Plug-in do Disco no canto superior direito e selecione Instalar Plug-in do disco.
   4. Selecione o arquivo zip do plug-in baixado.

Reinicie o IDE. Você verá o ícone do Schema Explorer no painel direito.

Depois de configurar com sucesso seu plug-in IntelliJ, crie um projeto NoSQL e conecte-o à sua instância ou simulador do Oracle NoSQL Database Cloud Service.

Criando um Projeto NoSQL em IntelliJ

Saiba como criar um projeto NoSQL em IntelliJ.

Faça o seguinte:

1. Abra o IntelliJ IDEA. Clique em Arquivo > Novo > Projeto.
2. Informe um valor para Nome do Projeto e Local do Projeto. Selecione Criar.
3. Selecione um sistema de build e um caminho do JDK.
4. IntelliJ cria o diretório de projeto NoSQL, que inclui um arquivo Java de amostra. Se você tiver selecionado o Maven como o sistema de build, o diretório do projeto também incluirá um arquivo pom.xml.
5. Certifique-se de que o Notifications esteja ativado para seu projeto Oracle NoSQL. Para ativar o Notifications, pressione Alt+\ para abrir o Menu Principal. Clique em Exibir, expanda Janelas de Ferramentas > Notificações. Um Ícone de Notificação é exibido na barra da janela da ferramenta à direita.

Após a criação bem-sucedida de um projeto NoSQL no IntelliJ, você poderá conectar seu projeto ao Oracle NoSQL Database Cloud Service ou ao simulador.

Conexão com o Oracle NoSQL Database Cloud Service por meio de IntelliJ

Saiba como conectar seu projeto do NoSQL ao Oracle NoSQL Database Cloud Service usando o plug-in do IntelliJ

Faça o seguinte:

1. Abra seu projeto NoSQL em IntelliJ.
2. Clique no ícone de tarefa na janela do Schema Explorer para abrir a caixa de diálogo Definições do plug-in.
3. Expanda Ferramentas > Oracle NoSQL no Settings Explorer e clique em Conexões.
4. Selecione Nuvem no menu suspenso para o tipo de Perfil. Você pode exibir todas as conexões existentes para o tipo de perfil do Cloud na lista drop-down Conexões.
5. Clique em Adicionar Conexão. Você tem duas opções para criar uma conexão.

   1. Usando o arquivo de configuração: Você especifica o caminho do arquivo de configuração, que aponta para o local do arquivo de configuração do OCI armazenado no sistema local. Esse arquivo contém os parâmetros essenciais necessários para estabelecer conexão com o Oracle NoSQL Database Cloud Service, como região, ID do tenant, ID do usuário, impressão digital, frase-senha e caminho de chave privada.

      Informe os valores necessários para os seguintes parâmetros de conexão e selecione ADD. Depois, selecione OK.

      Tabela - Opção de Arquivo de Configuração dos Parâmetros de Conexão

      Parâmetro	Descrição	Amostra de Valor
      Nome da Conexão	Um nome exclusivo, que é dado a uma especificação de conexão específica, é obrigatório na versão 1.5.1 do plug-in. É recomendável atualizar o campo Nome da Conexão após o upgrade do plug-in da versão 1.4.0 ou inferior. Observação: Você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.	ndcs_con1
      Arquivo de Configuração	Caminho de um diretório no qual o arquivo de configuração é armazenado no sistema local. Para obter mais informações sobre o arquivo de configuração e seu conteúdo, consulte o método User Principals em Authentication to connect to Oracle NoSQL Database.	~/.oci/config
      Perfil	Nome do perfil. Observação: Você pode criar vários perfis com valores específicos para essas entradas. Depois, poderá especificar qual perfil deverá ser carregado.	DEFAULT
      Compartimento (Opcional)	O OCID/nome do compartimento do seu esquema de banco de dados NoSQL. Observação: Ao especificar o nome do compartimento, você precisa especificar toda a hierarquia com dois-pontos separando cada entrada.	developers:dev1. Aqui, dev1 é um compartimento no compartimento developers. Observação: Se nenhum valor for especificado, será assumido como padrão o compartimento Raiz.

      O plug-in se conecta à região especificada no arquivo de configuração.

      Se você usar Autenticação baseada em token de sessão, seu arquivo de configuração incluirá o perfil designado para token de sessão juntamente com o caminho do token. Para estabelecer conexão com o Oracle NoSQL Database Cloud Service, você deve selecionar a opção de arquivo de configuração e especificar o perfil apropriado.

   2. Avançado: Você especifica diretamente os parâmetros de conexão necessários para estabelecer conexão com o Oracle NoSQL Database Cloud Service. Informe os valores obrigatórios para os parâmetros a seguir e selecione ADD. Depois, selecione OK.

   Tabela - Opção Avançada de Parâmetros de Conexão

   Parâmetro	Descrição	Amostra de Valor
   Nome da Conexão	Um nome exclusivo, que é fornecido a uma especificação de conexão específica, é obrigatório a partir do plugin versão 1.5.1. A atualização do campo Nome da Conexão é recomendada após o upgrade do plug-in da versão 1.4.0 ou inferior. Observação: Você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.	ndcs_con1
   Ponto Final	O acesso à rede regional aponta para o Oracle NoSQL Database Cloud Service.	https://nosql.us-ashburn-1.oci.oraclecloud.com (para o identificador de região Ashburn do Oracle NoSQL Database Cloud Service na região América do Norte. Consulte Regiões de Dados e Pontos finais de Serviço Associados para obter uma lista de pontos finais de serviço.
   ID do Tenant e ID do Usuário	OCID da Tenancy e OCID do Usuário para o seu 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.
   Impressão digital e senha (Opcional)	A impressão digital e a senha da chave de assinatura criada durante a geração e o upload da Chave de Assinatura da API.	Consulte os seguintes recursos na Documentação do Oracle Cloud Infrastructure: How to Generate an API Signing Key to generate the signed key with an Optional passphrase. Consulte Como Obter a Impressão Digital da Chave para obter a impressão digital da chave
   Chave Privada	A chave privada gerada para o usuário.	Para o usuário do aplicativo, uma chave de assinatura da API deve ser gerada e carregada. Consulte How to Generate an API Signing Key para gerar a chave de assinatura com uma frase secreta opcional.
   Compartimento (Opcional)	O OCID/nome do compartimento para seu esquema de banco de dados NoSQL. Observação: Ao especificar o nome do compartimento, você precisa especificar toda a hierarquia com dois-pontos separando cada entrada.	developers:dev1. Aqui, dev1 é um compartimento no compartimento developers. Observação: Se nenhum valor for especificado, será assumido como padrão o compartimento Raiz.

   Observação:

   1. A partir da versão 1.5.4, o plug-in IntelliJ faz download automaticamente do Oracle NoSQL Java SDK mais recente e define o caminho do SDK ao criar uma conexão.
   2. Se você estiver atualizando o plug-in da versão 1.4.0 ou inferior, todas as conexões armazenadas migrarão para a nova versão. Nesse caso, o Nome da Conexão será igual ao Ponto Final. Siga a etapa abaixo para alterar o Nome da Conexão.
6. O Plug-in IntelliJ salva os detalhes da conexão no nome especificado. Para modificar os detalhes da conexão, escolha o nome da conexão no menu suspenso para Conexões. Clique em Modificar Conexão. Você pode alterar qualquer um dos parâmetros de conexão (mencionados acima) e clicar em OK para salvar as definições. Para remover um nome de conexão do plug-in, escolha o nome da conexão e clique em Excluir Conexão. Depois que você confirmar a ação a ser excluída, o nome da conexão será removido do plug-in.
7. Clique no ícone da Web no Schema Explorer. A lista de conexões existentes é exibida na caixa suspensa. O nome da conexão será exibido na janela da ferramenta NoSQL no seguinte formato:

   Tabela - Exibição da Conexão

   Opção usada para criar uma conexão	Exibir na janela da ferramenta NoSQL
   Advanced	Connection Name:Endpoint:Compartment Name/OCID (se não for raiz)
   Use Configuration File	Connection Name:Configuration file path:Profile:Compartment Name/OCID(se não for raiz)

   Escolha a conexão e clique em OK. O plug-in IntelliJ conecta seu projeto ao Oracle NoSQL Database Cloud Service e exibe seu esquema na janela Schema Explorer.

Após conectar com sucesso o seu projeto com o Oracle NoSQL Database Cloud Service, você poderá gerenciar as tabelas e os dados do seu esquema.

Conectando-se ao Simulador do Oracle NoSQL Database Cloud por meio de IntelliJ

Saiba como conectar o seu projeto NoSQL com o Oracle NoSQL Database Cloud Simulator usando o plug-in IntelliJ.

Faça o seguinte:

1. Download e início do Oracle NoSQL Database Cloud Simulator. Consulte Download do Oracle NoSQL Database Cloud Simulator.
2. Abra seu projeto NoSQL em IntelliJ.
3. Clique no ícone de tarefa na janela do Schema Explorer para abrir a caixa de diálogo Definições do plug-in.
4. Expanda Ferramentas > Oracle NoSQL no Settings Explorer e clique em Conexões. Você pode exibir todas as conexões existentes para o tipo de perfil Cloudsim no menu suspenso Conexões.
5. Selecione Cloudsim no menu suspenso para o tipo de Perfil.
6. Clique em Adicionar Conexão. Informe valores para os parâmetros de conexão a seguir e clique em OK.

   Tabela - Parâmetros de Conexão

   Parâmetro	Descrição	Amostra de Valor
   Nome da Conexão	Um nome exclusivo, que é dado a uma especificação de conexão específica, é obrigatório a partir do plug-in versão 1.5.1. É recomendável atualizar o campo Nome da Conexão após o upgrade do plug-in da versão 1.4.0 ou inferior. Observação: Você pode adicionar várias conexões e as especificações de conexão armazenadas são persistentes.	nosql_sim1
   URL de Serviço	O endereço IP e a porta em que o Oracle NoSQL Database Cloud Simulador está sendo executado.	O valor padrão é http://localhost:8080
   Identificador de Tenant	Identificador exclusivo para identificar o tenant.	O valor padrão é exampleId. Mantenha esse valor se quiser testar os exemplos.

   Observação:

   1. A partir da versão 1.5.4, o plug-in IntelliJ faz download automaticamente do Java SDK NoSQL mais recente e define o caminho do SDK ao criar uma conexão.
   2. Se você estiver atualizando o plug-in da versão 1.4.0 ou inferior, todas as conexões armazenadas migrarão para a nova versão. Nesse caso, o Nome da Conexão será igual ao Ponto Final. Siga a etapa abaixo para alterar o Nome da Conexão.
7. O Plug-in IntelliJ salva os detalhes da conexão no nome especificado. Para modificar os detalhes da conexão, escolha o nome da conexão no menu suspenso para Conexões. Clique em Modificar Conexão. Você pode alterar qualquer um dos parâmetros de conexão (mencionados acima) e clicar em OK para salvar as definições. Para remover um nome de conexão do plug-in, escolha o nome da conexão e clique em Excluir Conexão. Depois que você confirmar a ação a ser excluída, o nome da conexão será removido do plug-in.
8. Clique no ícone da Web no Schema Explorer. A lista de conexões existentes é exibida na caixa suspensa. O nome da conexão será exibido na janela da ferramenta NoSQL no seguinte formato:

   Connection Name:service Url : Tenant Identifier

   Escolha a conexão e clique em OK. O plug-in IntelliJ conecta seu projeto ao Oracle NoSQL Database Cloud Simulator e exibe seu esquema na janela Schema Explorer.

   Observação:

   Antes de conectar o seu projeto com o Oracle NoSQL Database Cloud Simulator, ele deve ser iniciado e estar em execução. Caso contrário, a sua solicitação de conexão falhará em IntelliJ.

Após ter conectado com sucesso o seu projeto com o Oracle NoSQL Database Cloud Simulator, você poderá gerenciar as tabelas e os dados do seu esquema.

Criando aplicativos usando o Java SDK do Oracle NoSQL em IntelliJ

Aprenda a criar aplicativos com base no plug-in IntelliJ usando o pacote Java SDK do Oracle NoSQL.

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.

Neste tópico, você executará uma amostra de aplicativo disponível no pacote Java SDK do Oracle NoSQL para criar uma tabela no Oracle NoSQL Database Cloud Simulator ou no Oracle NoSQL Database Cloud Service.

Faça o seguinte:

1. Faça download do SDK Java mais recente do Oracle NoSQL Database em GitHub.
2. Extraia (descompacte) o arquivo baixado em um repositório local.
3. Inicie o IntelliJ IDEA e abra seu projeto NoSQL.
4. Se você estiver usando o sistema de build do Maven, certifique-se de ter adicionado as dependências necessárias em pom.xml. Para obter detalhes, consulte Oracle NoSQL Java SDK GitHub.
5. No diretório Java SDK do Oracle NoSQL Database Cloud Service extraído, navegue até a pasta oracle-nosql-java-sdk > examples. Copie os arquivos java BasicTableExample e Common para o diretório de projeto NoSQL.
   O programa BasicExampleTable cria uma tabela chamada audienceData, adiciona duas linhas a essa tabela, consulta as linhas inseridas, exclui as linhas inseridas e, por fim, elimina a tabela audienceData.
6. Antes de executar o programa aplicativo, você deve fornecer os argumentos necessários para estabelecer conexão:
   1. No menu, selecione Executar > Editar Configurações.
   2. Selecione Adicionar Nova Configuração e selecione Aplicativo.
   3. Na janela que aparece à direita, informe sua classe principal no campo Nome.
   4. Em Criar e executar, especifique o caminho do JDK do Java e informe a classe principal.
   5. Informe os argumentos de programa necessários. Selecione Aplicar e, em seguida, Ok.

   Tabela - Argumentos do Programa

   Tipo de Conexão	Argumentos do Programa	Mais informações
   Cloudsim	http://localhost:8080	Se você tiver iniciado o Oracle NoSQL Database Cloud Simulator em outra porta, substitua 8080 por esse número de porta.
   Cloud	Region [-configFile <path-to-config-file] Por exemplo: us-ashburn-1 -configFile D:\OCI_PROP\config	O primeiro argumento indica a região de dados do Oracle NoSQL Database Cloud Service. O segundo argumento passa um arquivo de configuração que contém as credenciais para estabelecer conexão com o Oracle NoSQL Database Cloud Service. Para obter informações sobre o conteúdo do arquivo de configuração, consulte Autenticação para estabelecer conexão com o Oracle NoSQL Database. Se você não especificar o arquivo config, o script usará o construtor padrão para a classe SignatureProvider, que procura o arquivo config em: $HOME/.oci

7. Para executar este programa, selecione Executar ou pressione Shift + 10.

   Observação:

   Se você quiser executar o programa em um terminal, use os seguintes comandos de amostra:

   Compile o programa usando o sistema de compilação maven usando:

   mvn compile

   Execute o programa fornecendo os argumentos do programa:

   mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="<region>"

   Exemplo: mvn exec:java -Dexec.mainClass=BasicTableExample -Dexec.args="us-ashburn-1"

8. Exiba a saída na janela Ferramenta Run na parte inferior. Verifique os logs para confirmar se a execução do código foi bem-sucedida. Você pode ver as mensagens de exibição que indicam a criação da tabela, a inserção de linhas etc.
   Amostra de saída:

   Creating table audienceData
   Created table audienceData
   Put row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}} result=non-null Version
   Got row: {"cookie_id":123,"audience_data":{"audience_segment":{"sports_lover":"2018-11-30","book_reader":"2018-12-01"},"ipaddr":"10.0.00.xxx"}}
   Inserted row via query, result:
       {"NumRowsInserted":1}
   Got row inserted by query: {"cookie_id":106,"audience_data":{"audience_segment":{"foodie":"2020-06-01","sports_lover":"2020-05-10"},"ipaddr":"10.0.00.xxx"}}
   Put row from json: {"cookie_id":456,"audience_data":{"ipaddr":"10.0.00.yyy","audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"}}}
   Got row inserted as JSON: {"cookie_id":456,"audience_data":{"audience_segment":{"sports_lover":"2019-01-05","foodie":"2018-12-31"},"ipaddr":"10.0.00.yyy"}}
   Query results for SELECT * from audienceData WHERE cookie_id = 456: 
       {"cookie_id":456,"audience_data":{"audience_segment":{"foodie":"2018-12-31","sports_lover":"2019-01-05"},"ipaddr":"10.0.00.yyy"}}
   Deleted key {"cookie_id":456} result=true
   Dropping table audienceData
   
   Process finished with exit code 0

   Observação:

   Como o BasicExampleTable exclui as linhas inseridas e elimina a tabela audienceData, você não pode exibir essa tabela no Schema Explorer. Se quiser ver a tabela no Schema Explorer, comente o código que exclui as linhas inseridas e elimina a tabela, e execute novamente o programa.

Gerenciando Tabelas com o Plug-in IntelliJ

Saiba como criar tabelas e exibir dados de tabela no Oracle NoSQL Database Cloud Service ou Oracle NoSQL Database Cloud Simulator no Schema Explorer .

Faça o seguinte:

1. Localize o Explorador de Esquema e clique no ícone para recarregar o esquema.
2. Localize sua tabela sob o identificador do tenant e expanda-a para exibir suas colunas, chave primária e detalhes da chave de shard. Se você criou um aplicativo de amostra conforme descrito no tópico Criando aplicativos usando o Java SDK do Oracle NoSQL no IntelliJ, poderá ver a tabela audienceData.
3. Clique duas vezes no nome da tabela para exibir seus dados. Se preferir, clique com o botão direito do mouse na tabela e selecione Pesquisar Tabela.
4. Uma janela de visualizador de registros aparecerá no editor principal. Clique em Executar para executar a consulta e exibir os dados da tabela.
5. Para exibir dados de células individuais separadamente, clique duas vezes na célula.

Execute operações DDL usando IntelliJ

Você pode usar IntelliJ para executar operações DDL.

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

• CREATE TABLE
• ELIMINAR TABELA
• CRIAR ÍNDICE
• ELIMINAR ÍNDICE
• ADICIONAR COLUNA
• ELIMINAR COLUNA
• Congelar/Cancelar esquema
• Gerenciar réplicas regionais
• Editar Capacidade Reservada

CREATE TABLE

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse no nome da conexão e escolha Criar Tabela.
• No prompt, insira os detalhes da nova tabela. Você pode criar a tabela do Oracle NoSQL Database de dois modos:
  • **Entrada DDL Simples**: você pode usar este modo para criar a tabela de forma declarativa, ou seja, sem criar uma instrução DDL.
  • **Entrada DDL Avançada**: você pode usar esse modo para criar a tabela usando uma instrução DDL.
• Você tem a opção de exibir a instrução DDL antes de criar. Clique em Mostrar DDL para exibir a instrução DDL formada com base nos valores informados nos campos no modo de entrada DDL Simples. Essa instrução DDL é executada quando você clica em Create.
• Clique em Criar para criar a tabela.
• Para criar uma tabela filho, clique com o botão direito do mouse na tabela desejada e escolha Criar Tabela Filho. É possível criar uma tabela filho de dois modos:
  • **Entrada DDL Simples**: você pode usar esse modo para criar uma tabela filho simplesmente informando um nome de tabela juntamente com outros detalhes necessários.
  • **Entrada DDL Avançada**: você pode usar esse modo para criar uma tabela filho usando uma instrução DDL.

  Para obter mais detalhes sobre tabelas filho, consulte Table Hierarchies no Oracle NoSQL Database Cloud Service Guide.

• Clique em Criar para criar uma tabela secundária.
• Você tem uma opção para exibir a instrução DDL após a criação de uma tabela. Clique com o botão direito do mouse na tabela existente. Escolha Exibir DDL da Tabela. Para copiar a instrução DDL, clique em Copy to Clipboard. Clique em OK para fechar a caixa de diálogo.

ELIMINAR TABELA

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela que você deseja eliminar. Escolha Eliminar Tabela.
• Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltar.

CRIAR ÍNDICE

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela em que o índice precisa ser criado. Escolha Criar Índice.
• No painel Criar Índice, você tem uma opção para criar o índice de dois modos:
  • **Criação de Índice Baseado em Formulário (Entrada DDL Simples)** : Informe os detalhes para criar um índice sem gravar nenhuma instrução DDL. Especifique o nome do índice e as colunas a serem parte dele. Se a coluna for do tipo de dados JSON, você verá um campo adicional chamado "JSON Path to Index Field" aparecer. Informe o caminho para o local do campo JSON e escolha o tipo de dados para ele.
  • **Criar Índice como Instrução DDL (Para entrada DDL Avançada)** : Informe uma instrução DDL válida para criar um índice. Também pode incluir tipo de dados complexo, ou seja, matriz, mapa e registro.
• Clique em Adicionar Índice.

ELIMINAR ÍNDICE

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique na tabela de destino para ver as colunas listadas, Primary Keys, Indexes e Shard Keys.
• Localize o índice de destino que precisa ser eliminado e clique com o botão direito do mouse nele. Clique em Eliminar Índice.
• Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltar.

ADICIONAR COLUNA

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela em que a coluna precisa ser adicionada. Escolha Adicionar Coluna.
• Você pode adicionar novas COLUMNs de dois modos:
  • Entrada DDL Simples: Você pode usar esse modo para adicionar novas colunas sem gravar uma instrução DDL. No caso de binário ou binário fixo, selecione o tipo de dados como Binary. Para binário fixo, informe o tamanho do arquivo no campo Size e mantenha o campo nulo no caso do tipo de dados binários.
  • Entrada DDL Avançada: Você pode usar esse modo para adicionar novas colunas à tabela fornecendo uma instrução DDL válida. Esse modo também pode criar colunas de tipo de dados complexo. Por exemplo, matriz, mapa ou registro e também em formato aninhado.
• Nos dois modos, especifique o nome da coluna e defina-a com suas propriedades: tipo de dados, valor padrão e se é anulável.
• Clique em Adicionar Coluna.

ELIMINAR COLUNA

• Localize o Schema Explorer e clique no ícone Atualizar para recarregar o esquema.
• Clique na tabela de destino para ver as colunas listadas, Primary Keys, Indexes e Shard Keys.
• Localize a coluna de destino que precisa ser eliminada e clique com o botão direito do mouse nela. Clique em Eliminar Coluna.
• Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltar.

Esquema Freeze/UnFreeze

Você precisa congelar o esquema de uma tabela singleton antes de torná-la uma tabela Global Active. Depois de congelar o esquema da tabela, você não poderá fazer alterações no esquema. Para congelar o esquema de uma tabela singleton, ela deve ter pelo menos uma coluna JSON. Clique com o botão direito do mouse na tabela e escolha Congelar/Descongelar. Depois que você confirmar, o esquema da tabela será congelado. Da mesma forma, para descongelar o esquema da tabela, clique com o botão direito do mouse na tabela e escolha Congelar/Descongelar. Depois que você confirmar, o esquema da tabela será alterado de volta para mutável, o que significa que o esquema poderá ser alterado.

Observação:

As réplicas regionais da tabela precisam ser eliminadas (a tabela deve ser uma tabela única) para que a operação de descongelamento possa ser executada.

Gerenciar réplicas

Consulte Replicas de Tabela Regional para entender o que são réplicas e como converter uma tabela única em uma tabela ativa Global adicionando réplicas regionais.

Adicionar Réplica

Você pode adicionar uma réplica regional a uma tabela única para torná-la uma tabela ativa Global ou adicionar uma réplica a uma tabela ativa Global existente. A tabela deve ser congelada antes de você adicionar uma réplica a ela. Clique com o botão direito do mouse na tabela e escolha Adicionar Réplica em Réplicas Regionais. Você pode escolher uma réplica na lista drop-down da Região de replicação. Você pode decidir sobre as Unidades de Leitura e as Unidades de Gravação da tabela nessa região de replicação. O valor de Armazenamento em Disco para a tabela não pode ser alterado/editado na réplica. Clique em Adicionar Réplica. A tabela é replicada na região.

Exibir réplica

Clique com o botão direito do mouse na tabela e escolha Exibir Réplicas em Réplicas Regionais. Você pode exibir a lista de réplicas da tabela.

Eliminar Réplicas

Clique com o botão direito do mouse na tabela e escolha Eliminar Réplicas em Réplicas Regionais. Clique em Adicionar e escolha uma réplica a ser removida. Você pode escolher mais de uma réplica a ser descartada por vez. Clique em Remover se quiser remover a réplica da lista de réplicas que precisam ser eliminadas. Clique em Eliminar Réplicas. Depois que você confirmar, a tabela será eliminada de todas as réplicas selecionadas.

Editar Capacidade Reservada

Você pode editar a capacidade reservada e o modelo de uso de uma tabela. Clique com o botão direito do mouse na tabela e escolha Editar Capacidade Reservada. Você pode escolher um dos dois modos de capacidade - Capacidade provisionada ou Capacidade sob demanda. Edite os valores e clique em Aplicar Alterações.

Se a tabela editada for uma tabela Ativa Global:

• A alteração na capacidade de armazenamento tem um escopo global (a alteração em uma réplica de tabela regional é propagada automaticamente para todas as réplicas de tabela regional).
• A alteração nas unidades de leitura, unidades de gravação ou alteração no modo de capacidade do On-Demand para provisionado ou vice-versa tem um escopo local (alteração apenas na réplica da tabela regional em que é iniciada).

Executar operações DML usando IntelliJ

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

Inserir dados

• Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela na qual uma linha precisa ser inserida. Escolha Inserir Linha.
• No painel Inserir Linha, informe os detalhes para inserir uma nova linha. Você pode inserir uma nova linha em dois modos:
  • Entrada Simples: Você pode usar esse modo para inserir a nova linha sem gravar uma instrução DML. Aqui uma entrada de campos de linha baseada em formulário é carregada, onde você pode inserir o valor de cada campo na linha.
    • Para o tipo de dados binário, a string digitada deve ser uma codificação Base64 válida de um valor binário ou selecionar o arquivo para upload na coluna desejada.
    • Para o tipo de dados binário fixo, a string digitada deve ser uma codificação Base64 válida de um valor binário ou fazer upload do arquivo de tamanho definido durante a criação da coluna específica.

    Observação:

    O formato de arquivo carregado para o tipo de dados binário só deve ter a extensão .bin.
  • Entrada JSON Avançada: Você pode usar esse modo para inserir uma nova linha na tabela fornecendo um Objeto JSON contendo o nome da coluna e seu valor correspondente como pares de chave/valor. A entrada também pode ser de tipo de dados complexo, ou seja, matriz, mapa, registro.
• Clique em Inserir Linha.

Modificar Dados - UPDATE ROW/DELETE ROW

• Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela na qual uma linha precisa ser inserida. Escolha Procurar Tabela.
• Na caixa de texto à esquerda, informe a instrução SQL para extrair dados da tabela. Clique em Executar para executar a instrução.
• Para exibir dados de células individuais separadamente, clique na célula da tabela.
• Para executar operações DML como Atualizar e Excluir Linha, clique com o botão direito do mouse na linha específica. Escolha sua opção no menu de contexto exibido.
  • Excluir Linha: Uma janela de confirmação é exibida, clique em Ok para excluir a linha.

  • Update Row: Uma janela HTML separada é aberta exibindo os nomes das colunas e seus valores correspondentes. Você pode informar novos valores para dados de linha em dois modos: entrada de campos de linha baseada em form (entrada DDL Simples) e Fornecer conteúdo de linha como objeto JSON (entrada DDL Avançada). No modo avançado de entrada DDL, os dados JSON são apresentados como uma estrutura em árvore para simplificar a exibição e a atualização.

    Selecione Executar para atualizar e exibir os dados atualizados.

    Observação:

    Em qualquer linha, as colunas PRIMARY KEY e GENERATED ALWAYS AS IDENTITY não podem ser atualizadas.

Tabelas da consulta

• Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
• Clique com o botão direito do mouse na tabela e escolha Procurar Tabela.
• Na caixa de texto à esquerda, digite a instrução SELECT para extrair dados da tabela. Quando você começar a digitar a consulta, será solicitada a lista de palavras possíveis para preencher automaticamente a instrução SQL. Todas as palavras-chave SQL e nomes de coluna para a tabela fornecida são fornecidos no prompt para concluir automaticamente a instrução SQL.
• A sintaxe SQL é realçada em todas as consultas, o que proporciona uma melhor experiência de gravação de SQL.
• Você pode formatar a consulta para melhorar sua legibilidade. Selecione sua consulta, clique com o botão direito do mouse e selecione Retificar. A consulta é formatada e as linhas são encapsuladas para melhorar a legibilidade.
• Clique em Executar para executar a consulta. Os dados correspondentes são recuperados da tabela. Quando você clica duas vezes nos dados recuperados, os dados da coluna são abertos em uma nova janela. Todos os dados JSON são exibidos em uma estrutura de árvore na nova janela. Clique em '+' para expandir ou em '-' para contrair a estrutura de árvore. Clique em Ctrl ^F na nova janela para ativar a opção de pesquisa, que permite procurar qualquer valor na árvore JSON. Clique na seta para cima ou para baixo para ir para a ocorrência de pesquisa anterior ou seguinte, respectivamente.
• Clique com o botão direito do mouse em qualquer linha e clique em Fazer Download de JSON. Na caixa de diálogo, navegue até o local em que deseja salvar o arquivo e clique em Salvar. Depois que o arquivo é baixado, uma notificação é exibida na parte inferior direita da tela. Clique no link para abrir o arquivo baixado. O arquivo é aberto no navegador.
  • No caso do tipo de dados Binário, basta clicar em Fazer Download do Objeto Binário na saída.
• Clique em Fazer Download do Resultado da Consulta para fazer download de todos os dados no resultado da consulta. Na caixa de diálogo, navegue até o local em que deseja salvar o arquivo e clique em Salvar. No caso de várias linhas, uma barra de progresso é exibida na parte inferior direita da tela para mostrar o número de linhas baixadas em tempo real. Depois que o arquivo é baixado, uma notificação é exibida na parte inferior direita da tela. Clique no link para abrir o arquivo baixado. O arquivo é aberto no navegador.
• Clique em Mostrar Plano de Consulta para exibir o plano de execução da consulta.
• Clique na lista drop-down Comandos Anteriores para exibir as 20 principais instruções SQL executadas recentemente que forneceram uma saída.

  Observação:

  A lista drop-down mostrará apenas instruções SQL relacionadas à tabela na qual você está trabalhando.

Schema Explorer

• Na janela Explorador de Esquemas, você pode verificar o tipo de dados completo de uma determinada coluna. Localize a coluna específica e o tipo de dados será seguido do nome da coluna.

Requisitos de Autorização para o Plug-in IntelliJ

Saiba mais sobre os requisitos de autorização necessários no Oracle NoSQL Database Cloud Service para usar o Plug-in IntelliJ.

O plug-in IntelliJ permite acessar o Oracle NoSQL Database Cloud Service usando a autenticação de chave de API ou métodos de autenticação de token de sessão. 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 plug-in IntelliJ para gerenciar tabelas nas 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 plug-in IntelliJ 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 no plug-in IntelliJ:

Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)

---

Título e Informações de Copyright

Copyright ©2022,2025,

Oracle e/ou suas empresas afiliadas.