corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Conexão a um banco de dados MySQL

Este documento demonstra como configurar uma conexão com um banco de dados MySQL no NetBeans IDE. Uma vez conectado, você pode começar a trabalhar com o MySQL no Explorador de banco de dados do IDE criando novos bancos de dados e tabelas, preenchendo tabelas com dados e executando consultas SQL em conteúdo e estruturas de bancos de dados. Este tutorial é direcionado a iniciantes com um conhecimento básico do gerenciamento de bancos de dados, que desejam utilizar seu conhecimento para trabalhar com o MySQL no NetBeans IDE.

O MySQL é um sistema de gerenciamento de banco de dados relacional de código-fonte aberto (RDBMS) geralmente usado em aplicativos Web devido à sua velocidade, flexibilidade e confiabilidade. O MySQL emprega a linguagem SQL, ou Structured Query Language, para acessar e processar os dados contidos em bancos de dados.

Duração esperada: 30 minutos

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.8, 6.9. 7.0 e 7.1

Para seguir este tutorial, são necessários os seguintes recursos e softwares.

Software ou recurso Versão necessária
NetBeans IDE 6.8, 6.9, 7.0, 7.1, Java
Java Development Kit (JDK) Versão 6
Servidor de banco de dados MySQL versão 5.x

Observação: este tutorial presume que você já possui o RDBMS MySQL instalado e configurado no computador. Se você estiver instalando pela primeira vez, consulte a documentação oficial do MySQL para obter ajuda. Você também pode consultar Configurando o servidor de banco de dados MySQL no sistema operacional Windows.

Configuração das propriedades do servidor MySQL

O NetBeans IDE vem com suporte para o RDBMS MySQL. Antes que você possa acessar o servidor de banco de dados MySQL no NetBeans IDE, você deve configurar as propriedades do servidor MySQL.

  1. Clique com o botão direito do mouse no nó Banco de dados na janela Serviços e escolha Registrar o servidor MySQL para abrir a caixa de diálogo Propriedades do servidor MySQL.
    Caixa de diálogo Propriedades do servidor MySQL: propriedades básicas
  2. Confirme se o nome e a porta do host do servidor estão corretos.

    Observe que o IDE insere localhost como o nome de host de servidor padrão e 3306 como o número de porta de servidor padrão.

  3. Insira o nome de usuário Administrador (se não estiver exibido).

    Observação: você precisa de acesso administrativo para poder criar e remover bancos de dados.

  4. Insira a senha do Administrador. O padrão é definido como em branco.

    Observação: uma senha em branco também pode ser uma senha.

  5. Clique na aba Propriedades de admin na parte superior da caixa de diálogo.

    A aba Propriedades de admin é então exibida, permitindo que você insira informações para controlar o servidor MySQL.
  6. No campo Caminho/URL para ferramenta admin, digite ou navegue para o local do aplicativo de administração do MySQL como a Ferramenta admin de MySQL, PhpMyAdmin, ou outras ferramentas de administração baseadas na Web.

    Observação: mysqladmin é a ferramenta de administração do MySQL encontrada na pasta bin do diretório de instalação do MySQL. Ela é uma ferramenta de linha de comando e não é ideal para uso com o IDE.

    Digite argumentos para a ferramenta admin no campo Argumentos.
  7. Em Caminho para o comando iniciar, digite o local do comando iniciar do MySQL ou navegue até ele. Para encontrar o comando iniciar, procure mysqld na pasta bin do diretório de instalação do MySQL.

    Observação: o binário recomendado para Unix e NetWare é mysql_safe. O comando iniciar também pode variar se o MySQL tiver sido instalado como parte de uma instalação AMP.

    Digite argumentos para o comando iniciar no campo Argumentos.
  8. No campo Caminho para o comando parar, digite o local do comando parar do MySQL ou navegue até ele. Geralmente, é o caminho para o mysqladmin na pasta bin do diretório de instalação do MySQL. Se o comando for mysqladmin, no campo Argumentos, digite -u root stop para conceder permissões root para interromper o servidor.
  9. Quando terminar, a aba Propriedades de admin deve ter a aparência similar à seguinte figura. Se estiver satisfeito com a configuração, clique em OK.

    Caixa de diálogo Propriedades do servidor MySQL: propriedades admin

Início do servidor MySQL

Antes que você possa se conectar a um servidor de banco de dados MySQL, certifique-se de que ele esteja sendo executado no computador. O nó do servidor MySQL em Serviço indica se o servidor de banco de dados MySQL está conectado, conforme exibido na imagem a seguir.

O servidor de banco de dados MySQL não está sendo executado

Após confirmar que o servidor de banco de dados MySQL está em execução na máquina, clique com o botão direito do mouse no nó Bancos de dados > Servidor MySQL na janela Serviços e escolha Conectar.

O servidor de banco de dados MySQL está sendo executado

Quando expandido, o nó do servidor MySQL exibe todos os bancos de dados MySQL disponíveis.

Criando e conectando à instância de banco de dados

Uma forma comum de interagir com banco de dados é através de um Editor SQL. O NetBeans IDE possui um mecanismo Editor SQL para esta finalidade. O Editor SQL geralmente é acessível através da opção Executar comando do menu de contexto do nó da conexão (ou dos nós filhos do nó da conexão). Agora que está conectado ao servidor MySQL, você pode criar uma nova instância de banco de dados usando o Editor SQL. Para a finalidade deste tutorial, crie uma instância chamada MyNewDatabase:

  1. Na janela Serviços do IDE, clique com o botão direito do mouse no nó Servidor MySQL e escolha Criar banco de dados.

    A caixa de diálogo Criar banco de dados MySQL é aberta.
  2. Na caixa de diálogo Criar banco de dados MySQL, digite o nome do novo banco de dados. Será utilizado MyNewDatabase para este tutorial. Deixe a caixa de verificação desmarcada neste momento.

    Caixa de diálogo Criar banco de dados MySQL

    Observação: também é possível conceder acesso total a um determinado usuário. Por padrão, somente o usuário admin possui as permissões para realizar determinados comandos. A lista suspensa permite que você atribua essas permissões a um usuário específico.

  3. Clique em OK.

    O novo banco de dados é exibido no nó do servidor MySQL na janela Serviços.

Criando tabelas de banco de dados

Agora que você se conectou a MyNewDatabase, pode começar a explorar como criar tabelas, preenchê-las com dados e modificar os dados mantidos nas tabelas. Isso permite que você observe mais de perto a funcionalidade oferecida pelo banco de dados Explorer, assim como o suporte do NetBeans IDE para arquivos SQL.

MyNewDatabase está vazio no momento. No IDE, é possível adicionar uma tabela de banco de dados usando a caixa de diálogo Criar tabela ou inserindo uma consulta SQL e executando-a diretamente do Editor SQL. Aqui, você pode explorar ambos os métodos:

  1. Utilização do editor SQL
  2. Utilização da caixa de diálogo Criar tabela

Utilização do editor SQL

  1. No banco de dados Explorer, expanda o nó da conexão de MyNewDatabase (ícone do nó da conexão) e observe que há três subpastas: Tabelas, Visualizações e Procedimentos.
  2. Clique com o botão direito do mouse no nó Tabelas e escolha Executar comando. Uma tela em branco é aberta no Editor SQL na janela principal.
  3. No Editor SQL, digite a seguinte consulta. Esta é uma definição da tabela Consultor que você irá criar.
    CREATE TABLE Counselor (
        id SMALLINT UNSIGNED NOT NULL AUTO_INCREMENT,
        firstName VARCHAR (50),
        nickName VARCHAR (50),
        lastName VARCHAR (50),
        telephone VARCHAR (25),
        email VARCHAR (50),
        memberSince DATE DEFAULT '0000-00-00',
        PRIMARY KEY (id)
                );
    Observação: consultas formadas no Editor SQL são analisadas em SQL. A linguagem SQL utiliza regras de sintaxe estritas com as quais você deve estar familiarizado ao trabalhar no editor do IDE. Ao executar uma consulta, um retorno do mecanismo SQL é gerado na janela de Saída indicando se a execução foi ou não bem-sucedida.
  4. Para executar a consulta, clique no botão Executar SQL (botão Executar SQL) na barra de tarefas na parte superior (Ctrl-Shift-E), ou clique com o botão direito do mouse no Editor SQL e escolha Executar instrução. O IDE gera a tabela Consultor no banco de dados, e você recebe uma mensagem similar à seguinte na janela de Saída.

    Janela de Saída indica execução bem-sucedida
  5. Para verificar as alterações, clique com o botão direito do mouse no nó Tabelas no banco de dados Explorer e escolha Atualizar. A opção Atualizar atualiza o componente UI do banco de dados Explorer para o status atual do banco de dados especificado. Observe que o nó da nova tabela Consultor (ícone do nó da tabela) agora é exibido em Tabelas no explorador do banco de dados. Se você expandir o nó da tabela, poderá ver as colunas (campos) criadas, começando com a chave primária (ícone do nó da chave primária).

    Tabela Consultor exibida no banco de dados Explorer

Utilização da caixa de diálogo Criar tabela

  1. No banco de dados Explorer, clique com o botão direito do mouse no nó Tabelas e escolha Criar tabela. A caixa de diálogo Criar tabela é aberta.
  2. No campo de texto Nome da tabela, digite Assunto.
  3. Clique em Adicionar coluna.
  4. No Nome da coluna, insira id. Selecione SMALLINT no tipo de dados na lista suspensa Tipo. Clique em OK.
    captura de tela da caixa de diálogo Adicionar coluna
  5. Selecione a caixa de seleção Chave primária na caixa de diálogo Adicionar coluna. Você está especificando a chave primária da tabela. Todas as tabelas de bancos de dados relacionais devem conter uma chave primária. Observe que quando a caixa de verificação Chave é marcada, as caixas de verificação Índice e Exclusivo são automaticamente marcadas e a caixa de verificação Nulo é desmarcada. Isso ocorre porque as chaves primárias são usadas para identificar uma linha exclusiva no banco de dados e por padrão formam o índice da tabela. Como todas as linhas precisam ser identificadas, as chaves primárias não podem conter um valor Nulo.
  6. Repita esse procedimento adicionando as colunas remanescentes, como exibido na tabela a seguir.

    Chave Índice Nulo Exclusiva Nome da coluna Tipo de dados Tamanho
    [marcada] [marcada] [marcada] id SMALLINT 0
    [marcada] nome VARCHAR 50
    [marcada] descrição VARCHAR 500
    [marcada] FK_consultorID SMALLINT 0

    Está sendo criada uma tabela chamada Assunto que possuirá dados para cada um dos seguintes registros.

    • Nome: nome do assunto
    • Descrição: descrição do assunto
    • ID do consultor: ID do consultor que corresponde a uma ID da tabela Consultor
    Caixa de diálogo Criar tabela com campos selecionados para tabela Assunto

    Certifique-se de que os campos na caixa de diálogo Criar tabela correspondam aos exibidos acima e clique em OK. O IDE gera a tabela Assunto no banco de dados e você pode ver um nó da nova tabela Assunto (ícone do nó da tabela) exibido imediatamente em Tabelas no banco de dados Explorer.

Trabalho com os dados da tabela

Para trabalhar com dados da tabela, você pode usar o Editor SQL no NetBeans IDE. Ao executar consultas SQL em um banco de dados, é possível adicionar, modificar e excluir dados mantidos em estruturas de bancos de dados. Para adicionar um novo registro (linha) à tabela Consultor, faça o seguinte:

  1. Escolha Executar comando da pasta Tabelas no banco de dados Explorer. Uma tela em branco é aberta no Editor SQL na janela principal.
  2. No Editor SQL, digite a seguinte consulta.
    INSERT INTO Counselor
    VALUES (1, 'Ricky', '"The Dragon"', 'Steamboat','334 612-5678', 'r_steamboat@ifpwafcad.com', '1996-01-01')
  3. Para executar a consulta, clique com o botão direito do mouse no Editor SQL e escolha Executar instrução. Na janela de Saída, você pode ver uma mensagem indicando que a consulta foi executada com êxito.
  4. Para verificar se o novo registro foi adicionado à tabela Consultor, no banco de dados Explorer, clique com o botão direito do mouse no nó da tabela Consultor e escolha Visualizar dados. Um novo painel Editor SQL é aberto na janela principal. Ao escolher Visualizar dados, é gerada automaticamente na região superior do Editor SQL uma consulta para selecionar todos os dados da tabela. Os resultados da instrução são exibidos em um modo de exibição de tabela na região inferior. Neste exemplo, a tabela Consultor é exibida. Observe que uma nova linha foi adicionada com os dados que você acabou de fornecer da consulta SQL.

    novo registro adicionado à tabela Consultor

Execução de um script SQL

Outra forma de gerenciar dados de tabela no NetBeans IDE é executando um script SQL externo diretamente no IDE. Se foi criado um script SQL em qualquer outro lugar, será possível simplesmente abrí-lo no NetBeans IDE e executá-lo no Editor SQL.

Com a finalidade de demonstração, baixe o ifpwafcad.sql e salve-o no computador. Este script cria duas tabelas similares às que você acabou de criar acima (Consultor e Assunto) e preenche-as imediatamente com dados.

Como o script sobrescreve essas tabelas se elas já existirem, exclua as tabelas Consultor e Assunto agora para que fique óbvio que novas tabelas são criadas quando o script é executado. Para excluir tabelas:

  1. Clique com o botão direito do mouse nos nós de tabela Counselor e Subject no Explorador de banco de dados e selecione Excluir.
  2. Clique em Sim na caixa de diálogo Confirmar exclusão de objeto. Observe que essa caixa de diálogo lista as tabelas que serão excluídas.

Ao clicar em Sim na caixa de diálogo Confirmar exclusão de objeto, os nós de tabela são automaticamente removidos do Explorador de banco de dados.

Para executar o script SQL em MyNewDatabase:

  1. Escolha Arquivo > Abrir arquivo no menu principal do IDE. No navegador de arquivos, vá para o local onde você salvou ifpwafcad.sql anteriormente e clique em Abrir. O script se abre automaticamente no Editor SQL.
  2. Certifique-se que a conexão com MyNewDatabase esteja selecionada na caixa suspensa Conexão na barra de ferramentas na parte superior do editor.

    Caixa suspensa Conexão na barra de ferramentas do Editor SQL
  3. Clique no botão Executar SQL (botão Executar SQL) na barra de tarefas do Editor SQL. O script é executado no banco de dados selecionado e qualquer comentário é gerado na janela de Saída.
  4. Para verificar as alterações, clique com o botão direito do mouse no nó da conexão de Meu novo banco de dados na janela Tempo de execução e escolha Atualizar. A opção Atualizar atualiza o componente UI do banco de dados Explorer para o status atual do banco de dados especificado. Observe que as duas novas tabelas do script SQL agora são exibidas como nós de tabela em MyNewDatabase no banco de dados Explorer.
  5. Escolha Visualizar dados do menu contextual de um nó de tabela selecionada para ver os dados contidos nas novas tabelas. Dessa maneira, você pode comparar os dados tabulares com os dados contidos no script SQL para ver se eles coincidem.

Consulte também

Isto conclui o tutorial Conexão um banco de dados MySQL. Este documento demonstrou como configurar o MySQL no computador e definir uma conexão com o servidor de banco de dados do NetBeans IDE. Ele também descreveu como trabalhar com o MySQL no banco de dados Explorer do IDE criando novas instâncias de bancos de dados e tabelas, preenchendo tabelas com dados e executando consultas SQL.

Para tutoriais relacionados e mais avançados, consulte os seguintes recursos: