Em primeiro lugar efetue o download em:
# wget http://linorg.usp.br/apache/cassandra/0.5.1/apache-cassandra-0.5.1-bin.tar.gz
Descompacte o pacote com o tradicional comando "tar -zxvf" e configure a variável ambiental CASSANDRA_HOME:
# cd /opt
# tar -zxvf apache-cassandra-0.5.1-bin.tar.gz
# export CASSANDRA_HOME=/opt/apache-cassandra-0.5.1
Modifique o arquivo
storage-conf.xml conforme as suas necessidades e crie as pastas:
# cd /opt/apache-cassandra-0.5.1/conf/
# vi storage-conf.xml
Crie os diretórios especificados no arquivo storage-conf.xml mencionado anteriormente.
# mkdir -p /var/lib/cassandra/commitlog
# mkdir /var/lib/cassandra/data
# mkdir /var/lib/cassandra/callouts
# mkdir /var/lib/cassandra/staging
# mkdir -p /var/log/cassandra
# mkdir -p /var/lib/cassandra
ATENÇÃO:
Se você optou baixar o código fonte, basta utilizar o comando abaixo para compilar o pacote:
# ant ivy-retrieve
Pronto, inicie o serviço Cassandra executando o script "cassandra" na pasta bin seguido do parâmetro -f:
# bin/cassandra -f
Para executar o cliente, entre na pasta /opt/apache-cassandra-0.5.1/bin/ e execute o comando "cassandra-cli" seguido no IP do servidor e a porta. No nosso caso, utilizaremos o valores default (localhost e porta 9160).
# cd /opt/apache-cassandra-0.5.1/bin/
# ./cassandra-cli --host localhost --port 9160
Connected to localhost/9160
Welcome to cassandra CLI.
Type 'help' or '?' for help. Type 'quit' or 'exit' to quit.
Cassandra>
Agora no console cliente do Cassandra, utilize os comandos do exemplo abaixo para inserir uma chave:
cassandra>
set Keyspace1.Standard1['cabelo']['first'] = 'Alessandro'
Value inserted.
cassandra>
set Keyspace1.Standard1['cabelo']['last'] = 'Faria'
Value inserted.
cassandra>
set Keyspace1.Standard1['cabelo']['age'] = '38'
Value inserted.
Consultando a chave inclusa anteriormente:
cassandra>
get Keyspace1.Standard1['cabelo']
=> (column=6c617374, value=Faria, timestamp=1267416876445)
=> (column=6669727374, value=Alessandro, timestamp=1267416865908)
=> (column=616765, value=38, timestamp=1267416894415)
Returned 3 results.
Excluindo a chave adicionada anteriormente:
cassandra>
del Keyspace1.Standard1['cabelo']
row removed.
E o desenvolvimento? Para os desenvolvedores, sugiro o projeto
Cassandra Java Client. A seguir uma receita de bolo (da página oficial) de como efetuar o download e testá-lo:
svn checkout https://cassandra-java-client.googlecode.com/svn/trunk/ cassandra-java-client
$ cd cassandra-java-client
$ mvn install
Abaixo um código exemplo extraível da própria página do projeto:
CassandraClient cl = pool.getClient() ;
KeySpace ks = cl.getKeySpace("Keyspace1") ;
// insert value
ColumnPath cp = new ColumnPath("Standard1" , null, "testInsertAndGetAndRemove".getBytes("utf-8"));
for(int i = 0 ; i < 100 ; i++){
ks.insert("testInsertAndGetAndRemove_"+i, cp , ("testInsertAndGetAndRemove_value_"+i).getBytes("utf-8"));
}
//get value
for(int i = 0 ; i < 100 ; i++){
Column col = ks.getColumn("testInsertAndGetAndRemove_"+i, cp);
String value = new String(col.getValue(),"utf-8") ;
assertTrue( value.equals("testInsertAndGetAndRemove_value_"+i) ) ;
}
//remove value
for(int i = 0 ; i < 100 ; i++){
ks.remove("testInsertAndGetAndRemove_"+i, cp);
}
try{
ks.remove("testInsertAndGetAndRemove_not_exist", cp);
}catch(Exception e){
fail("remove not exist row should not throw exceptions");
}
//get already removed value
for(int i = 0 ; i < 100 ; i++){
try{
Column col = ks.getColumn("testInsertAndGetAndRemove_"+i, cp);
fail("the value should already being deleted");
}catch(NotFoundException e){
}catch(Exception e){
fail("throw out other exception, should be NotFoundException." + e.toString() );
}
}
pool.releaseClient(cl) ;
pool.close() ;
Acredito que este documento permita alavancar o interesse para outros projetos com a tecnologia NoSQL. Como sempre menciono: Colaborar atrai amigos, competir atrai inimigos...
Sobre o autor:
http://www.netitec.com.br/alessandro