Trabalhando com o banco de dados Java DB (Derby)

Este documento demonstra como configurar uma conexo com o banco de dados Java DB da Sun no NetBeans IDE. Quando uma conexo for estabelecida, voc poder comear a trabalhar com o banco de dados no IDE, podendo criar tabelas, preench-las com dados, executar instrues SQL e consultas e mais. O banco de dados Java DB uma distribuio da Sun com suporte do Apache Derby. O Java DB um servidor de banco de dados com base em padres, seguro e totalmente transacional, escrito inteiramente em Java, e d suporte total a SQL, JDBC API e tecnologia Java EE. O banco de dados Java DB empacotado com o servidor de aplicativo GlassFish e est includo no JDK 6 tambm. Para obter mais informaes sobre o banco de dados Java DB, consulte a documentao oficial. Durao esperada: 30 minutos Contedo

Configurando banco de dados Registrando banco de dados no NetBeans IDE Iniciando o servidor e criando um banco de dados Conectando ao banco de dados Criando tabelas Adicionando dados de tabela Excluindo tabelas Utilizando um script SQL externo Recriando tabelas de um banco de dados diferente Consulte tambm

Para seguir este tutorial, voc precisa dos seguintes recursos e softwares. Software ou recurso Verso necessria NetBeans IDE 6.8, 6.9 ou 7.0, download Java Java Development Kit (JDK) Verso 6 ou verso 5 Java DB verso 10.4.x Observao:Java DB includo no JDK 6 e o servidor de aplicativo GlassFish (v2 e v3). instalado quando voc instala qualquer um desses produtos de software.

Configurando banco de dados

Se voc tem o servidor GlassFish Enterprise registrado na instalao NetBeans IDE, Java DB j estar registrado. Portanto, possvel pular para Iniciando servidor e criando um banco de dados. Se baixar o servidor de aplicativo GlassFish separadamente e necessitar de ajuda ao registrar no NetBeans IDE, consulte Registrando uma instncia do servidor de aplicativo GlassFish no contedo de ajuda IDE (F1). Se voc tiver apenas baixado o Java DB, faa o seguinte: 1. Execute o arquivo de autoextrao. Uma pasta denominada 'javadb' ser criada no mesmo local do arquivo. Se voc tiver apenas baixado o Java DB e desejar que o servidor de banco de dados fique em um local diferente de onde ele foi extrado, dever realoc-lo agora. 2. No sistema, crie um novo diretrio para ser utilizado como diretrio original para as instncias individuais do servidor de banco de dados. Por exemplo, possvel criar esta pasta no diretrio raiz Java DB (javadb) ou em qualquer outra localizao. Antes de prosseguir, importante compreender os componentes encontrados no diretrio raiz do Java DB:

O subdiretrio demo contm os programas de demonstrao. O subdiretrio bin contm os scripts para executar utilitrios e configurar o ambiente. O subdiretrio javadoc contm a documentao da API que foi gerada de comentrios de cdigo-fonte. O subdiretrio docs contm a documentao do Java DB. O subdiretrio lib contm os arquivos jar do Java DB.

Registrando banco de dados no NetBeans IDE

Agora que o banco de dados est configurado, voc pode registr-lo no IDE: 1. Na janela Servios, clique com o boto direito do mouse no n do Banco de dados Java DB e escolha Propriedades. A caixa de dilogo Configuraes de Java DB aberta. 2. No campo de texto Instalao de Java DB, insira o caminho para o diretrio raiz de Java DB (javadb) especificado na etapa anterior. 3. Para a localizao do banco de dados, defina o caminho para o diretrio de origem que foi criado ou deixe as configuraes padro. A captura de tela abaixo exibe configuraes exemplo para o servidor Java DB. Quando tiver terminado,

clique em OK.

Iniciando o servidor e criando um banco de dados

As opes de menu do banco de dados Java DB so exibidas quando voc clica com o boto direito do mouse no n Java DB na janela Servios. Os itens desse menu contextual permitem o incio e a interrupo do servidor de banco de dados, a criao de uma nova instncia de banco de dados e o registro de servidores de bancos de dados no IDE (como demonstrado na etapa anterior). Para iniciar o servidor de banco de dados: 1. Na janela Servios, clique com o boto direito do mouse no n Java DB e escolha Iniciar servidor. Observe a sada a seguir na janela de Sada, indicando que o servidor foi iniciado:

2. Clique com o boto direito no n Java DB e escolha Criar banco de dados. A caixa de dilogo Criar Java DB se abre. 3. No campo de texto Nome do banco de dados, digite contact. Tambm defina o nome de usurio e senha para nbuser. Observe que Local do banco de dados o local padro definido durante a instalao do Java DB do GlassFish. Se j foi instalado o Java DB separadamente, essa localizao deve diferir. Clique em OK.

Conexo ao banco de dados

At agora, voc iniciou com xito o servidor de banco de dados e criou uma instncia de banco de dados denominada contact no IDE. O banco de dados Explorer do NetBeans IDE, disponvel a partir da janela Servios, fornece funcionalidade para tarefas comuns em estruturas de bancos de dados. Isto inclui:

criando, exclundo e modificando tabelas preenchimento de tabelas com dados visualizao de dados tabulares execuo de consultas e instrues SQL

Para comear a trabalhar com o banco de dados contact, voc precisa criar uma conexo com o mesmo. Para se conectar a contact: 1. Expanda o banco de dados Explorer na janela Servios e localiza o novo banco de dados.

Observe que amostra [app on APP] o esquema de banco de dados padro. 2. Clique com o boto direito do mouse no n da conexo do banco de dados (jdbc:derby://localhost:1527/contact [nbuser em NBUSER]) e escolha Conectar. O cone do n da conexo agora aparece por inteiro ( conexo foi bem sucedida. ), o que significa que a

3. Crie um nome de exibio conveniente para o banco de dados. Clique com o boto direito do mouse no n da conexo do banco de dados (jdbc:derby://localhost:1527/contact [nbuser em NBUSER]) e escolha Propriedades. Clique no boto elipse (...) prximo ao nome de exibio e insira Contato DB no campo de texto. Agora o banco de dados tem um nome de exibio mais conveniente no IDE.

Criando tabelas
O banco de dados contact recm-criado est vazio no momento. Ele no contm ainda tabelas ou dados. No NetBeans IDE, voc pode adicionar uma tabela de banco de dados usando a caixa de dilogo Criar tabela ou inserindo uma instruo SQL e executando-a diretamente do Editor SQL. possvel explorar ambos os mtodos:

Utilizando a caixa de dilogo Criar tabela Utilizando o editor SQL

Utilizando a caixa de dilogo Criar tabela

1. Expanda o n de conexo contact e observe que existem vrios esquemas de subns. O esquema app o nico esquema que se aplica a este tutorial. Clique com o boto direito do mouse no n APP e escolha Definir como esquema padro.

2. Expanda o n APP e observe que existem trs subpastas: Tabelas, Visualizao e Procedimentos. Clique com o boto direito do mouse no n Tabelas e escolha Criar tabela. A caixa de dilogo Criar tabela aberta. 3. No campo de texto Nome da tabela, digite AMIGOS. 4. Clique em Adicionar coluna. A caixa de dilogo Adicionar coluna aparece. 5. Para Nome de coluna, insira id. Para Tipo de dados, selecione INTEIRO da lista suspensa. 6. Em Restries, selecione caixa de verificao Chave primria para especificar que essa coluna a chave primria para a tabela. Todas as tabelas de bancos de dados relacionais devem conter uma chave primria. Observe que quando voc marca a caixa de verificao Chave primria, as caixas de verificao ndice e Exclusivo so automaticamente marcadas e a caixa de verificao Nulo desmarcada. Isso ocorre porque as chaves primrias so usadas para identificar uma linha exclusiva no banco de dados e por padro so usadas como o ndice da tabela. Como todas as linhas devem ser identificadas, as chaves primrias no podem conter um valor Nulo.

7. Repita este procedimento agora especificando campos conforme exibido na tabela abaixo: 8. Nome da coluna [marcada] [marcada] [marcada] id [marcada] firstName [marcada] lastName [marcada] nickName [marcada] friendSince Chave ndice Nulo Exclusiva Tipo de dados INTEIRO VARCHAR VARCHAR VARCHAR DATA Tamanho 0 20 20 30 0

[marcada]

email

VARCHAR 60

9. Voc est criando uma tabela chamada AMIGOS que contm os seguintes dados para cada registro de contato: o Nome o Sobrenome o Apelido o Amigo desde o Endereo de e-mail

10. Quando tiver certeza que a caixa de dilogo Criar tabela contm as mesmas especificaes que as exibidas acima, clique em OK. O IDE gera a tabela
AMIGOS

no banco de dados e voc pode ver o n da nova tabela AMIGOS ( ) exibido em Tabelas no banco de dados Explorer. Abaixo do n da tabela, as colunas (campos) so listadas, comeando pela chave primria ( ).

Usando o editor SQL:

1. No banco de dados Explorer, clique com o boto direito no n de conexo DB Contato ou no n Tabelas embaixo e escolha o Comando executar. Uma tela em branco aberta no Editor SQL na janela principal. 2. Insira a seguinte consulta no Editor SQL. Esta uma definio da tabela COLEGAS que voc ir criar:
3. CREATE TABLE "COLEGAS" ( 4. "ID" INTEGER not null primary key, 5. "NOME" VARCHAR(30), 6. "SOBRENOME" VARCHAR(30), 7. "CARGO" VARCHAR(10), 8. "DEPARTAMENTO" VARCHAR(20), 9. "EMAIL" VARCHAR(60) );

Observao: instrues e consultas formadas no Editor SQL so analisadas em SQL. A linguagem SQL utiliza regras de sintaxe estritas com as quais voc deve estar familiarizado ao trabalhar no editor do IDE. A sintaxe do SQL tambm pode diferir dependendo do sistema de gerenciamento de banco de dados. Consulte o Manual de referncia do JavaDB para obter instrues especficas. 10. Clique no boto Executar SQL ( ) na barra de tarefas na parte superior do editor (Ctrl-Shift-E) para executar a consulta. Na janela de Sada (Ctrl-4), uma mensagem exibida indicando que uma instruo foi executada com xito.

11. Para verificar as alteraes, clique com o boto direito do mouse no n de conexo DB Contato no banco de dados Explorer e escolha Atualizar. Isso atualiza o componente UI de tempo de execuo para o status atual do banco de dados especificado. Esta etapa necessria ao executar consultas do Editor SQL no NetBeans IDE. Observe que o n da nova tabela COLEGAS ( exibido em Tabelas na janela Servios. ) agora

Adio de dados na tabela

Agora que voc criou uma ou mais tabelas no banco de dados contact, pode comear a preench-lo com dados. Existem vrias maneiras de adicionar registros na tabela:

Escreva uma instruo SQL no editor SQL que fornece um valor para cada campo presente no esquema da tabela. Utilize o editor SQL para adicionar registros tabela. Utilize um script externo SQL para importar registros para a tabela.

Leia as sees abaixo para aprender como utilizar todos os mtodos de preenchimento da tabela AMIGOS com dados.

Executando uma instruo SQL

1. Expanda o n Tabelas no banco de dados Explorer, clique com o boto direito na tabela AMIGOS e escolha o comando Executar. Uma tela em branco aberta no Editor SQL na janela editor SQL. 2. No Editor SQL, insira a seguinte instruo. Enquanto estiver digitando, possvel utilizar o autocompletar cdigo do editor SQL.
INSERT INTO APP.AMIGOS VALUES (1,'Theodore','Bagwell','TBag','2004-12-25','tbag@foxriver.com')

3. Clique com o boto direito do mouse no Editor SQL e escolha Executar instruo. A janela de Sada exibe uma mensagem indicando que uma instruo foi executada com xito. 4. Para verificar se o novo registro foi adicionado tabela AMIGOS, clique com o boto direito do mouse no n da tabela AMIGOS na janela Servios e escolha Visualizar dados. Ao escolher Visualizar dados, gerada automaticamente no painel superior do Editor SQL uma consulta para selecionar todos os dados da tabela. Os resultados da instruo so exibidos no painel inferior do Editor de SQL. Nesse caso, a

tabela AMIGOS exibida no painel inferior. Observe que uma nova linha foi adicionada com os dados que voc acabou de fornecer da instruo SQL.

Usando o editor SQL

1. Clique com o boto direito no n da tabela AMIGOS e escolha Visualizar dados (se no tiver feito isso na ltima etapa da seo anterior). 2. Clique no boto Inserir registro(s) (Alt-I) para adicionar uma linha. A caixa de dilogo Inserir registros aparece. 3. Clique em cada clula e insira registros. Observe que para clulas com tipo de dados Data, possvel escolher uma data do calendrio. Clique em OK quando tiver acabado.

No editor SQL, possvel ordenar os resultados clicando na linha de cabealho, modifique e exclua registros existentes e veja o script SQL para aes que esto sendo feitas no editor (o comando Exibir script SQL do menu pop-up).

Excluso de tabelas
Na etapa a seguir, use um script SQL externo para criar uma nova tabela COLEGAS. Entretanto, uma tabela COLEGAS acabou de ser criada na seo Utilizando o editor SQL acima. Para deixar claro que o script SQL realmente cria uma nova tabela, voc pode excluir a tabela COLEGAS j criada agora. Para excluir uma tabela de banco de dados: 1. Clique com o boto direito do mouse no n do banco de dados Explorer e escolha Excluir. Observe que o n da tabela imediatamente removido do Explorer do banco de dados sem confirmao.

Utilizao de um script SQL externo

A emisso de comandos de um script SQL externo uma forma popular de gerenciar o banco de dados. possvel j ter sido criado um script SQL em outro lugar, e deseja import-lo para o NetBeans IDE para execut-lo em um banco de dados especfico. Com a finalidade de demonstrao, copie o SQL de colleagues.sql em um arquivo de texto e salve-o no computador. Esse script cria uma nova tabela chamada COLEGAS e a preenche com dados. Para executar este script no banco de dados contact: 1. Escolha Arquivo > Abrir arquivo no menu principal do IDE. No navegador de arquivos, v at o local do arquivo colleagues.sql salvo e clique em Abrir. O script se abre automaticamente no Editor SQL. 2. Certifique-se que a conexo com Contato DB est selecionada na caixa suspensa Conexo na barra de ferramentas na parte superior do editor.

3. Clique no boto Executar SQL ( ) na barra de tarefas do Editor SQL. O script executado no banco de dados selecionado e qualquer comentrio gerado na janela de Sada. 4. Para verificar as alteraes, clique com o boto direito no n de conexo DB Contato na janela Servios e escolha Atualizar. Observe que a nova tabela COLEGAS do script SQL agora exibida como um n de tabela em contact na janela Servios. 5. Para visualizar os dados contidos nas novas tabelas, clique com o boto direito na tabela COLEGAS e escolha Visualizar dados. Dessa maneira, voc tambm

pode comparar os dados tabulares com os dados contidos no script SQL para ver se eles coincidem.

Recriando tabelas de um banco de dados diferente

Se voc tiver uma tabela de outro banco de dados que deseja recriar no banco de dados em que est trabalhando do NetBeans IDE, o IDE oferece uma ferramenta til para isso. necessrio primeiro registrar o segundo banco de dados no IDE, de forma similar que foi descrita no incio deste tutorial. Para a finalidade deste tutorial, use o banco de dados de exemplo includo com o Java DB ao instalar o servidor de aplicativos GlassFish com o NetBeans IDE. Esse processo realizado essencialmente em duas partes: primeiro voc 'captura' a definio da tabela selecionada, depois pode recriar a tabela no banco de dados escolhido: 1. Conecte ao banco de dados de exemplo clicando com o boto direito no n de conexo no banco de dados Explorer e escolhendo Conectar (usurio e senha app). 2. Expanda o n Tabelas. Clique com o boto direito do mouse no n da tabela CLIENTE e escolha Capturar estrutura.

3. Na caixa de dilogo Capturar tabela exibida, especifique um local no computador para salvar o arquivo de captura que ser criado. Clique em Salvar. O arquivo de captura registra a definio de tabela da tabela selecionada. 4. No banco de dados Explorer, clique com o boto direito no n Tabelas, embaixo da conexo do banco de dados DB Contato, e escolha Recriar tabela.

5. Na caixa de dilogo Recriar tabela que aberta, navegue para o local onde voc salvou o arquivo de captura de CLIENTE e clique em Abrir. A caixa de dilogo Nome da tabela aberta.

6. Neste ponto, possvel alterar o nome da tabela ou editar a definio da tabela. Do contrrio, clique em OK para criar imediatamente a tabela no banco de dados contact. Um novo n de tabela CLIENTE exibido abaixo do n de conexo DB Contato.

Envie-nos seus comentrios

Consulte tambm