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.
- 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.
Criando um Projeto NoSQL em IntelliJ
Saiba como criar um projeto NoSQL em IntelliJ.
- Abra o IntelliJ IDEA. Clique em Arquivo > Novo > Projeto.
- Informe um valor para Nome do Projeto e Local do Projeto e clique em Criar.
- Depois que seu projeto NoSQL for criado, você poderá procurar os arquivos java de exemplo na janela do Project Explorer.
- 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.
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
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.
Gerenciando Tabelas com o Plug-in IntelliJ
Saiba como criar tabelas e exibir dados de tabelas no Oracle NoSQL Database Cloud Service ou no Oracle NoSQL Database Cloud Simulator por meio de IntelliJ.
Execute operações DDL usando IntelliJ
Você pode usar IntelliJ para executar operações DDL.
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.
- **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 "
- 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 campoSize
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.
- 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
- 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
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.
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.
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.
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.
- 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 Schema Explorer 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.
- 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.
- Clique em Inserir Linha.
Modificar Dados - UPDATE ROW/DELETE ROW
- Localize o Schema Explorer 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 consulta.
- 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.
- Atualizar Linha: Um painel HTML separado é aberto abaixo das linhas listadas, contendo os nomes de coluna e seu valor correspondente em uma entrada baseada em form e como um objeto de par de chaves JSON. Você pode escolher um dos dois métodos e fornecer novos valores.
Observação:
Em qualquer linha, as colunas PRIMARY KEY e GENERATED ALWAYS AS IDENTITY não podem ser atualizadas.
Tabelas da consulta
- Localize o Schema Explorer 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 sua tabela.
- Clique em Executar para executar a consulta. Os dados correspondentes são recuperados da tabela.
- 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:
O menu suspenso mostrará apenas instruções SQL relacionadas à tabela em que você está trabalhando.
Schema Explorer
- Na janela Schema Explorer, você pode verificar o tipo de dados completo de uma determinada coluna. Localize a coluna específica e o tipo de dados é seguido do nome da coluna.
Usando o Plug-in IntelliJ para Desenvolvimento