P1-O que é Mckoi?

Um banco de dados relacional, "pure" Java, distribuído sob a GPL (GNU General Public License).

P2-Onde fazer download do Mckoi?

O website do Mckoi é http://www.mckoi.com/database/index.html. Acesse-o e baixe sua última versão estável (na data deste tutorial era a 1.0.3).

P3-Como instalar o Mckoi?

A instalação do Mckoi é bastante simples: basta descompactar o arquivo "mckoi1.0.3.zip" para o diretório desejado, abaixo do qual será criado um diretório "mckoi1.0.3".

(Neste tutorial, assumo que a instalação do Mckoi será feita pelos usuários MS Windows XP no diretório "C:\Arquivos de programas", e pelos usuários Linux no diretório "/opt".)
P4-Como criar um banco de dados Mckoi?

A sintaxe do comando para criar um banco de dados Mckoi é a seguinte…

  -create [usuario_administrador] [senha_administrador]

Esse comando cria um banco de dados vazio e a ele adiciona um usuário administrador.

Seja, por exemplo, criar um banco de dados "db_filmes".

a)Crie um diretório "db_filmes" abaixo do diretório raiz (\) do disco C, caso seja usuário MS Windows XP, ou abaixo do seu diretório de usuário (/home/<<user>>/), caso seja usuário Linux. Esse diretório armazenará os arquivos de dados e de log do banco do dados.

b)Abra o arquivo de configuração "db.conf", localizado no diretório de instalação do Mckoi (C:\Arquivos de programas\mckoi1.0.3 ou \opt\mckoi1.0.3).

b.1)Remova o comentário (#) da variável "root_path"
b.2)Insira o comentário (#) em frente a variável "root_path=jvm"

Com as alterações (b.1) e (b.2), aquelas linhas do arquivo de configuração "db.conf" devem ficar assim…

root_path=configuration
#root_path=jvm

b.3)Informe como valor da variável "database_path" o caminho para armazenar os arquivos de dados do banco de dados. Tal caminho é relativo àquele do arquivo de configuração "db.conf". Seus diretórios devem ser separados pelo caractere "/".

Para o nosso "db_filmes", informe…

database_path=../../db_filmes/dados (usuários MS Windows XP)

ou

database_path=../home/<<user>>/db_filmes/dados (usuários Linux)

Configurado dessa forma, os arquivos de dados serão armazenados em "C:\db_filmes\dados" ou "/home/<<user>>/db_filmes/dados", respectivamente no MS Windows XP e Linux.

b.4)Informe como valor da variável "log_path" o caminho para armazenar os arquivos de logs do banco de dados. Tal caminho também é relativo àquele do arquivo de configuração "db.conf" e seus diretórios devem ser separados pelo caractere "/".

Para o no caso banco "db_filmes", informe…

log_path=../../db_filmes/log (usuários MS Windows XP)

ou

database_path=../home/<<user>>/db_filmes/log (usuários Linux)

Configurado dessa forma, os arquivos de log serão armazenados em "C:\db_filmes\log" ou "/home/<<user>>/db_filmes/log", respectivamente no MS Windows XP e Linux.

b.5)Se desejar ou for necessário, substitua o valor default (9157) da variável "jdbc_server_port". Essa variável indica a porta do servidor (host) onde o banco de dados será montado.

Para o nosso banco de "db_filmes", informe…

jdbc_server_port=59999

c)Abra um terminal (Linux) ou prompt de comando (MS Windows XP)

d)Acesse o diretório de instalação do Mckoi (C:\Arquivos de programas\mckoi1.0.3 ou /opt/mckoi1.0.3) e execute o comando…

java -jar mckoidb.jar -create "admin" "123456"

Esse comando produzirá a mensagem abaixo e fará com que seja criado um banco de dados vazio, tendo como administrador o usuário "admin", senha "123456".

Mckoi SQL Database ( 1.0.3 )
Copyright (C) 2000 – 2004 Diehl and Associates, Inc.  All rights reserved.
Use: -h for help.

  Mckoi SQL Database comes with ABSOLUTELY NO WARRANTY.
  This is free software, and you are welcome to redistribute it
  under certain conditions.  See LICENSE.txt for details of the
  GPL License.

Acesse os diretórios de dados ("C:\db_filmes\dados" ou "/home/<<user>>/db_filmes/dados") e log ("C:\db_filmes\log" ou "/home/<<user>>/db_filmes/log") do banco de dados "db_filmes"  para conferir a criação de diversos arquivos de dados e log.

P5 – Como "levantar" o servidor de banco de dados?

A partir de um terminal ou prompt de comando, acesse o diretório de instalação do Mckoi1.0.3 e execute o comando…

java -jar mckoidb.jar

A execução desse comando deve gerar a mensagem abaixo…

Mckoi SQL Database ( 1.0.3 )
Copyright (C) 2000 – 2004 Diehl and Associates, Inc.  All rights reserved.
Use: -h for help.

  Mckoi SQL Database comes with ABSOLUTELY NO WARRANTY.
  This is free software, and you are welcome to redistribute it
  under certain conditions.  See LICENSE.txt for details of the
  GPL License.

TCP JDBC Server (multi_threaded) on port: 59999.
Boot time: 421ms.

P6 – Como dar um "shutdown" no banco de dados?

A sintaxe do comando para dar um "shutdown" no banco de dados Mckoi é a seguinte…

  -shutdown [host] [porta] [usuario_administrador] [senha_administrador]

Para dar um shutdown no nosso banco de dados "db_filmes", abrar um outro terminal ou prompt de comando, acesse o diretório de instalação do Mckoi1.0.3" e execute o comando…

java -jar mckoidb.jar -shutdown localhost 59999 admin 123456

Como resultado, deve ser gerada a mensagem abaixo…

Mckoi SQL Database ( 1.0.3 )
Copyright (C) 2000 – 2004 Diehl and Associates, Inc.  All rights reserved.
Use: -h for help.

  Mckoi SQL Database comes with ABSOLUTELY NO WARRANTY.
  This is free software, and you are welcome to redistribute it
  under certain conditions.  See LICENSE.txt for details of the
  GPL License.

e no terminal ou prompt de comando onde o servidor de banco de dados foi levantado, você poderá conferir que ele foi finalizado.

P7 – Como testar o banco de dados?

Após levantar o servidor de banco de dados, abra um novo terminal ou prompt de comando e digite…

java -cp mckoidb.jar com.mckoi.tools.JDBCQueryTool -url "jdbc:mckoi://localhost:59999/" -u "admin" -p "123456"

Esse comando fará com que seja inicializado o utilitário "Mckoi JDBC Query Tool". Trata-se de um aplicativo simples, distribuído com o Mckoi 1.0.3, útil para submetermos comandos SQL ao banco de dados.

Na área de comandos SQL do "JDBC Query Tool", digite o comando abaixo e execute-o clicando em "Run Query".

    CREATE TABLE filmes
    (id NUMERIC DEFAULT UNIQUEKEY('filmes'),
     titulo varchar(50),
     cinema varchar(30),
     sala integer,
     data date,
     hora time)

Esse comando SQL fará com que seja criada a tabela "filmes" no banco de dados "db_filmes". Atenção para o modo de criar um campo ("id") do tipo auto-incremento: id NUMERIC DEFAULT UNIQUEKEY('filmes').

Siga o exemplo de instrução INSERT abaixo para inserir registros na tabela "filmes"…

    INSERT INTO
filmes (titulo, cinema, sala, data, hora)
    VALUES ('Batismo de Sangue', 'Academia de Tênis', 7,'2007-02-07', '19:10:00')

Para listar os registros inseridos, submeta o comando…

    SELECT * FROM filmes

Finalize a conexão com o banco de dados com o comando…

    SHUTDOWN

Encerre o aplicativo "Mckoi JDBC Quey Tool" (File -> Exit). Abra-o novamente e repita o comando SELECT acima.

Voilà! Eis novamente os registros gravados no banco de dados "db_filmes"!

P8 – Como acessar um banco de dados Mckoi a partir de um aplicativo Java?

Primeiramente, inclua no CLASSPATH o arquivo "mkjdbc.jar" (se a conexão for com um servidor de banco de dados) ou o arquivo "mckoidb.jar" (se a conexão for com um banco de dados standalone). Ambos os arquivos estão localizados no diretório de instalação do Mckoi1.0.3.

Abaixo, um aplicativo simples demonstrando o uso do banco de dados "db_filmes".

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

public class TesteMckoi {

    public static void main(String[] args) {

        try {
            Class.forName("com.mckoi.JDBCDriver").newInstance();
            System.out.println("1-Carregado o driver do banco de dados…");
        } catch (Exception e) {
            System.out.println("Driver do Mckoi não localizado");
            System.exit(1);
        }

          // Para conexão com um banco de dados standalone…
          // use este formato de url (MS Windows XP)
        // String url = "jdbc:mckoi:local://Arquivos de programas/mckoi1.0.3./db.conf";

        // ou este formato (Linux)
        // String url = "jdbc:mckoi:local://home/<<user>>/mckoi1.0.3./db.conf";

          // Para conexão com um servidor de banco de dados, use este formato de url
        String url = "jdbc:mckoi://localhost:59999/";
        String username = "admin";
        String password = "123456";
        Connection connection;
        try {
            connection = DriverManager.getConnection(url, username, password);
            System.out.println("2-Estabelecida conexão com o banco de dados…");
        } catch (SQLException e) {
            System.out.println("Erro ao conectar com banco de dados");
            System.out.println("Motivo: " + e.getMessage());
            System.exit(1);
            return;
        }
        try {
            String sql = "SELECT * FROM filmes";
            PreparedStatement stmt = connection.prepareStatement(sql);
            ResultSet rs = stmt.executeQuery();
            System.out.println("3-Listando filmes cadastrados no banco de dados…");
            while (rs.next()){
                System.out.println("Código -> " + rs.getInt(1) + " Título -> " + rs.getString(2));
            }
        } catch (SQLException e){
            
        }
        try {
            connection.close();
            System.out.println("4-Finalizada a conexão com o banco de dados…");
        } catch (SQLException e) {
            System.out
                    .println("Erro ao finalizar a conexão com do banco de dados");
            System.out.println("Motivo: " + e.getMessage());
            return;
        }
        
        System.out.println("5-Fim do aplicativo");
    }
}

Categoria(s): Banco de dados ,Tutoriais

Outros posts