Usando o Plug-in IntelliJ para Desenvolvimento
Procure tabelas e execute consultas na sua instância do Oracle NoSQL Database Cloud Service ou no Oracle NoSQL Database Cloud Simulator do IntelliJ.
O plug-in IntelliJ do Oracle NoSQL Database Cloud Service se conecta a uma instância em execução do Oracle NoSQL Database Cloud Service ou do Oracle NoSQL Database Cloud Simulator e permite que você:
-
Visualize as tabelas em uma estrutura de á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 dados da coluna em uma Estrutura JSON bem formatada.
-
Crie tabelas usando entrada de esquema baseada em form ou forneça instruções DDL.
-
Elimine tabelas.
-
Adicione novas colunas usando entrada baseada em form ou forneça instruções DDL.
-
Eliminar Colunas.
-
Criar Índices.
-
Eliminar Índices.
-
Execute consultas SELECT SQL em uma tabela e visualize 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 o Oracle NoSQL Database Cloud Service ou o Oracle NoSQL Database Cloud Simulator.
Pré-Requisito:
Instale o IntelliJ IDEA. Você pode fazer download do IntelliJ IDEA em JetBrains.
Procedimento:
Você pode instalar o plug-in da seguinte forma:
-
Abra a página Oracle NoSQL DatabaseConnector, repositório de plug-ins JetBrains.
- Selecione Obter.
- No menu Versões, selecione Fazer Download para a versão mais recente do Oracle NoSQL Database Connector.
- Na janela pop-up, siga as instruções na tela em Como Instalar o 'Oracle NoSQL Database Connector.
Reinicie o IDE. Você verá o ícone do Schema Explorer no painel direito.
Depois de configurar com sucesso o seu plug-in IntelliJ, crie um projeto NoSQL e conecte-o à sua instância do Oracle NoSQL Database Cloud Service ou ao Oracle NoSQL Database Cloud Simulator.
Criando um Projeto NoSQL no IntelliJ
Saiba como criar um projeto do NoSQL no IntelliJ.
Faça o seguinte:
- Abra o IntelliJ IDEA. Clique em Arquivo > Novo > Projeto.
- Informe um valor para Nome do Projeto e Local do Projeto. Selecione Criar.
- Selecione um sistema de build e um caminho do JDK.
- O IntelliJ cria seu diretório de projeto NoSQL, que inclui um arquivo Java de amostra. Se você tiver selecionado Maven como o sistema de compilação, o diretório do projeto também incluirá um arquivo pom.xml.
- Certifique-se de que o Notifications esteja ativado para seu projeto do Oracle NoSQL. Para ativar Notificações, pressione
Alt+\para abrir o Menu Principal. Clique em Exibir, expanda Janelas de Ferramentas > Notificações. Um Ícone de Notificação
é exibido na barra de janela da ferramenta direita.
Depois de criar com sucesso um projeto NoSQL no IntelliJ, você poderá conectar seu projeto ao Oracle NoSQL Database Cloud Service ou ao Oracle NoSQL Database Cloud Simulator.
Estabelecendo Conexão com o Oracle NoSQL Database Cloud Service por meio do IntelliJ
Saiba como conectar o seu projeto do NoSQL ao Oracle NoSQL Database Cloud Service usando o plug-in do IntelliJ
Faça o seguinte:
-
Abra seu projeto NoSQL no IntelliJ.
-
Clique no ícone de tarefa
na janela Explorador de Esquemas para abrir o diálogo Definições do plug-in. -
Expanda Ferramentas > Oracle NoSQL no Explorador de Definições e clique em Conexões.
-
Selecione Nuvem no menu suspenso para o tipo de Perfil. Você pode exibir todas as conexões existentes para o tipo de perfil Nuvem no menu suspenso Conexões.
-
Clique em Adicionar Conexão. Você tem duas opções para criar uma conexão.
-
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 da chave privada.
Informe os valores obrigató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 é 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_con1Arquivo 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/configPerfil Nome do perfil.
Observação: Você pode criar vários perfis com valores diferentes para essas entradas e, em seguida, especificar qual perfil será carregado.DEFAULTCompartimento (Opcional) O OCID/nome do compartimento para seu esquema de banco de dados NoSQL.
Observação: Quando você especifica o nome do compartimento, é necessário especificar toda a hierarquia com dois-pontos separando cada entrada.developers:dev1.Aqui,
dev1é um compartimento no compartimentodevelopers.
Observação: Se nenhum valor for especificado, ele assumirá 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.
-
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. 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_con1Ponto Final O ponto de acesso regional à rede para o Oracle NoSQL Database Cloud Service. 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. 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 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 Frase Secreta (Opcional) A impressão digital e a frase-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:
- Para gerar a chave de assinatura com uma frase-senha opcional, consulte Como Gerar uma Chave de Assinatura de API.
- Para obter a impressão digital da chave, consulte Como 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 Como Gerar uma Chave de Assinatura da API para gerar a chave de assinatura com uma frase-senha opcional. Compartimento (Opcional) O OCID/nome do compartimento para seu esquema de banco de dados NoSQL.
Observação: Quando você especifica o nome do compartimento, é necessário especificar toda a hierarquia com dois-pontos separando cada entrada.developers:dev1.Aqui,
dev1é um compartimento no compartimentodevelopers.
Observação: Se um valor não for especificado, ele assumirá como padrão o compartimento Raiz.Observação:
-
A partir da versão 1.5.4, o plug-in do IntelliJ faz download automaticamente do Oracle NoSQL Java SDK mais recente e define o caminho do SDK ao criar uma conexão.
-
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.
-
-
O Plug-in do IntelliJ salva os detalhes da conexão no nome da conexão especificado. Para modificar os detalhes da conexão, escolha o nome da conexão no menu suspenso 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 configurações. Para remover um nome de conexão do plug-in, escolha o nome da conexão e clique em Excluir Conexão. Depois de confirmar a ação a ser excluída, o nome da conexão será removido do plug-in.
-
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 Exibido na janela da ferramenta NoSQL AdvancedConnection Name:Endpoint:Compartment Name/OCID(se não for raiz)Use Configuration FileConnection Name:Configuration file path:Profile:Compartment Name/OCID(se não for raiz)Escolha a conexão e clique em OK. O plug-in do IntelliJ conecta seu projeto ao Oracle NoSQL Database Cloud Service e exibe seu esquema na janela Schema Explorer.
Depois de conectar com sucesso seu projeto ao Oracle NoSQL Database Cloud Service, você poderá gerenciar as tabelas e dados em seu esquema.
Estabelecendo Conexão com o Oracle NoSQL Database Cloud Simulator por meio do IntelliJ
Saiba como conectar o seu projeto do NoSQL com o Oracle NoSQL Database Cloud Simulator usando o plug-in do IntelliJ.
Faça o seguinte:
-
Faça download do Oracle NoSQL Database Cloud Simulator e inicie o mesmo. Consulte Download do Oracle NoSQL Database Cloud Simulator.
-
Abra seu projeto NoSQL no IntelliJ.
-
Clique no ícone de tarefa
na janela Explorador de Esquemas para abrir o diálogo Definições do plug-in. -
Expanda Ferramentas > Oracle NoSQL no Explorador de Definições e clique em Conexões. Você pode exibir todas as conexões existentes para o tipo de perfil Cloudsim no menu suspenso Conexões.
-
Selecione Cloudsim no menu drop-down do tipo de Perfil.
-
Clique em Adicionar Conexão. Informe valores para os seguintes parâmetros da conexão 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 é fornecido a uma especificação de conexão específica, é obrigatório do plug-in 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.nosql_sim1URL de Serviço O endereço IP e porta em que o Oracle NoSQL Database Cloud Simulator está sendo executado. O valor-padrão é http://localhost:8080Identificador de Tenant Identificador exclusivo para identificar o tenant. O valor padrão é exampleId. Mantenha esse valor se quiser testar os exemplos. Observação:
-
A partir da versão 1.5.4, o plug-in do IntelliJ faz download automaticamente do SDK Java NoSQL mais recente e define o caminho do SDK ao criar uma conexão.
-
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.
-
-
O Plug-in do IntelliJ salva os detalhes da conexão no nome da conexão especificado. Para modificar os detalhes da conexão, escolha o nome da conexão no menu suspenso 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 configurações. Para remover um nome de conexão do plug-in, escolha o nome da conexão e clique em Excluir Conexão. Depois de confirmar a ação a ser excluída, o nome da conexão será removido do plug-in.
-
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 IdentifierEscolha a conexão e clique em OK. O plug-in do IntelliJ conecta seu projeto ao Oracle NoSQL Database Cloud Simulator e exibe seu esquema na janela Schema Explorer.
Observação: Antes de conectar seu projeto ao Oracle NoSQL Database Cloud Simulator, ele deve ser iniciado e em execução. Caso contrário, a sua solicitação de conexão falhará no IntelliJ.
Depois de conectar com sucesso seu projeto ao seu Oracle NoSQL Database Cloud Simulator, você poderá gerenciar as tabelas e dados em seu esquema.
Criando aplicativos com o Oracle NoSQL Java SDK do IntelliJ
Aprenda a criar aplicativos com base no plug-in do IntelliJ 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.
Neste tópico, você executará um aplicativo de amostra disponível no pacote Oracle NoSQL Java SDK para criar uma tabela no Oracle NoSQL Database Cloud Simulator ou no Oracle NoSQL Database Cloud Service.
Faça o seguinte:
-
Faça download do Oracle NoSQL Database Java SDK mais recente no GitHub.
-
Extraia (descompacte) o arquivo baixado em um repositório local.
-
Inicie o IntelliJ IDEA e abra seu projeto NoSQL.
-
Se você estiver usando o sistema de build do Maven, certifique-se de ter adicionado as dependências necessárias no pom.xml. Para obter detalhes, consulte GitHub do Oracle NoSQL Java SDK.
-
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 javaBasicTableExampleeCommonpara o diretório do seu projeto NoSQL.O programa
BasicExampleTablecria uma tabela chamadaaudienceData, adiciona duas linhas a essa tabela, consulta as linhas inseridas, exclui as linhas inseridas e, por fim, elimina a tabelaaudienceData. -
Antes de executar o programa aplicativo, você deve fornecer os argumentos necessários para estabelecer conexão:
a. No menu, selecione Executar > Editar Configurações.
b. Selecione Adicionar Nova Configuração e, em seguida, Aplicativo.
c. Na janela que aparece à direita, informe sua classe principal no campo Nome.
d. Em Criar e executar, especifique o caminho do JDK Java e informe a classe principal.
e. Informe os argumentos do 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:8080Se 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\configO 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 arquivoconfig, o script usará o construtor padrão para a classeSignatureProvider, que procura o arquivoconfigem:$HOME/.oci -
Para executar este programa, selecione Executar ou pressione Shift + 10.
Observação: Se você quiser executar o programa em um terminal, use os seguintes exemplos de comando:
Compile o programa usando o sistema de compilação maven usando:
mvn compileExecute 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" -
Exiba a saída na janela da 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, não é possível 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 do IntelliJ
Saiba como criar tabelas e exibir dados de tabela no Oracle NoSQL Database Cloud Service ou Oracle NoSQL Database Cloud Simulator com o Schema Explorer .
Faça o seguinte:
-
Localize o Explorador de Esquema e clique no ícone
para recarregar o esquema. -
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ê tiver criado um aplicativo de amostra conforme descrito no tópico Criando aplicativos usando o Oracle NoSQL Java SDK do IntelliJ, poderá ver a tabela
audienceData. -
Clique duas vezes no nome da tabela para exibir seus dados. Se preferir, você pode clicar com o botão direito do mouse na tabela e selecionar Procurar Tabela.
-
Uma janela de visualizador de registros aparecerá no editor principal. Clique em Executar para executar a consulta e exibir dados de tabela.
-
Para exibir dados de células individuais separadamente, clique duas vezes na célula.
Executar operações DDL usando o IntelliJ
Você pode usar o IntelliJ para executar operações DDL.
Algumas das operações DDL que podem ser executadas de dentro do plug-in do IntelliJ são
CREATE TABLE
-
Localize o Explorador de Esquema 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 de DDL Simples : Você pode usar esse modo para criar a tabela declarativamente, ou seja, sem gravar uma instrução DDL.
-
Entrada de 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 da criação. 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. Você pode 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 com outros detalhes necessários.
-
Entrada de DDL Avançada : Você pode usar esse modo para criar uma tabela filha usando uma instrução DDL.
Para obter mais detalhes sobre tabelas filho, consulte Hierarquias de Tabela.
-
-
Clique em Criar para criar uma tabela filha.
-
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.
DROP TABLE
-
Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
-
Clique com o botão direito do mouse na tabela que deseja eliminar. Escolha Eliminar Tabela.
-
Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltura.
CREATE INDEX
-
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 o índice precisa ser criado. Escolha Criar Índice.
-
No painel Criar Índice, você tem a opção de criar índice em dois modos:
-
Criação de Índice com Base 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 do índice. 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. Ele também pode incluir um tipo de dados complexo, ou seja, matriz, mapa e registro.
-
-
Clique em Adicionar Índice.
DROP INDEX
-
Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
-
Clique na tabela de destino para ver as colunas listadas, as Chaves Primárias, os Índices e as Chaves de Fragmento.
-
Localize o índice de destino que deve ser eliminado e clique com o botão direito sobre ele. Clique em Eliminar Índice.
-
Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltura.
ADICIONAR COLUNA
-
Localize o Explorador de Esquema 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 em dois modos:
-
Entrada de DDL Simples: Você pode usar esse modo para adicionar novas colunas sem escrever 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 campoSizee mantenha o campo nulo em caso de tipo de dados binário. -
Entrada de 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 coluna com suas propriedades - tipo de dados, valor padrão e se ela pode ser anulada.
-
Clique em Adicionar Coluna.
ELIMINAR COLUNA
-
Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
-
Clique na tabela de destino para ver as colunas listadas, as Chaves Primárias, os Índices e as Chaves de Fragmento.
-
Localize a coluna de destino que deve ser eliminada e clique com o botão direito sobre ela. Clique em Eliminar Coluna.
-
Uma janela de confirmação é exibida. Clique em Ok para confirmar a ação de soltura.
Congelar/Descongelar Esquema
Você precisa congelar o esquema de uma tabela singleton antes de torná-la uma tabela Global Ativa. Depois de congelar o esquema da tabela, você não poderá fazer nenhuma alteração no esquema. Para congelar o esquema de uma tabela singleton, ele deve ter pelo menos uma coluna JSON. Clique com a tecla direito do mouse na tabela e escolha Congelar/Descongelar. Quando você confirma, o esquema da tabela é 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 pode 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 Réplicas de Tabela Regional para entender o que são réplicas e como converter uma tabela singleton 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 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 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 eliminada ao mesmo tempo. 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 a tecla 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 Global Ativa:
-
A alteração na capacidade de armazenamento tem um escopo global (a alteração em uma réplica de tabela regional é automaticamente propagada para todas as réplicas de tabela regionais).
-
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 somente na réplica da tabela regional em que é iniciada).
Executar operações DML usando o IntelliJ
Você pode adicionar dados, modificar dados existentes e consultar dados de tabelas usando o plug-in do 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 em que uma linha precisa ser inserida. Escolha Inserir Linha.
-
No painel Inserir Linha, insira 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 escrever 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ários, a string digitada deve ser uma codificação Base64 válida de um valor binário ou selecione o arquivo a ser carregado na coluna desejada.
-
Para o tipo de dados binários fixos, 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 que você carrega para o tipo de dados binário deve ter apenas 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 do 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 em que 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 individuais da célula 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 que aparece.
-
Excluir Linha: Uma janela de confirmação é exibida e 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 de entrada DDL avançada, 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 de consulta
-
Localize o Explorador de Esquema e clique no ícone Atualizar para recarregar o esquema.
-
Clique com a tecla direita 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 Download JSON. Na caixa de diálogo, navegue até o local onde deseja salvar o arquivo, e clique em Salvar. Quando o arquivo é baixado, uma notificação é exibida no canto inferior direito da tela. Clique no link para abrir o arquivo baixado. O arquivo é aberto no navegador.
Observação: no caso de 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 onde deseja salvar o arquivo, e clique em Salvar. No caso de várias linhas, uma barra de progresso aparece no canto inferior direito da tela para mostrar o número de linhas baixadas em tempo real. Quando o arquivo é baixado, uma notificação é exibida no canto inferior direito 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 suspensa mostrará apenas instruções SQL relacionadas à tabela na qual você está trabalhando.
Explorador de esquemas
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 Plug-in do 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 do 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 do 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 do 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 do IntelliJ:
Error executing Insert Row : Authorization failed or requested resource not found (5.4.18)