Programando em C com SQLite3

Autor: Herberson da Silva Miranda

1 – Introdução

O SQLite3 fornece recursos para que os desenvolvedores possam armazenar os dados de suas aplicações em tabelas e manipular esses dados através de comandos SQL ou seja criando bancos de dados para seus softwares. A grande vantagem em utilizar SQLite para armazenar essas informações que seu uso dispensa a necessidade de um SGDB de grande porte, como MySQL ou PostgreSQL, em suas aplicações, podendo armazenar tudo em um simples arquivo.

2 – Conhecendo o SQLite3

O SQLite é constituído por dois componentes a SQLite library (biblioteca SQLite) e o SQLite3, a biblioteca foi escrita em C entretanto diversas linguagens suportam o seu uso; como TCL, C/C++, PHP, Java entre outras; o SQLite3 e um front-end (a parte do software onde o usuário efetua a interação com o software) em modo texto para que possamos efetuar a criação de bases, tabelas, execução de comandos SQL e gerenciamento da base de dados. Podem fazer o download da biblioteca neste link, sua instalação e sem mistérios, em sistemas Linux baseados no sistema Debian podem estuar a instalação utilizando a ferramenta apt-get, em sistemas baseados no Red Hat utilizem o yum.

3 – Pré-requisitos e ferramentas utilizadas

Para compreensão total deste artigo é altamente recomendado o conhecimento básico na linguagem SQL e na linguagem C, todos os exemplos de códigos contidos neste artigo seguem o C ANSI, o compilador utilizado foi o GCC (GNU C Compiler) versão 4.4.5, o sistema usado foi o Ubuntu 10.10 (AMD64), os códigos foram escritos utilizando o editor VIM versão 7.2.330. A versão do sqlite3 utilizada no artigo foi a 3.7.2

4 – Começando

A primeira tarefa e cria um banco de dados, criamos com o comando:

$ sqlite3 nome_do_banco.db

Após o comando ser executado será aberto um shell (interface de linha de comando) neste shell será onde os comandos deverão ser inseridos, para sair do shell do sqlite3 use o comando ‘.q’.Dentro do shell do sqlite3 iremos criar a nossa tabela com o comando:

CREATE TABLE cadastro ('id' INTEGER PRIMARY KEY, nome VARCHAR(50), idade INTEGER);

Criação da tabela no sqlite3

A tabela e bastante simples e composta por 3 colunas, id, nome e idade. Agora que temos nossa primeira tabela criada podemos dar inicio a programação. Vamos efetuar o acesso a está tabela. O código abaixo demonstra claramente como efetuamos o acesso.

#include <stdio.h>
#include <sqlite3.h> //Biblioteca requerida pelo sqlite3

int main()
{

int abrir;    //Variavel que sera usada para validar a conexao com o banco de dados.

sqlite3 *db;    //Variavel que sera usada nas funcoes posteriores.

abrir = sqlite3_open("banco1.db",&db);    //Cria a conexao

//Valida a conexao
if(abrir)
{
printf("Erro na conexao!\n");
}
else
{
printf("Conectado ao banco com sucesso.\n");
}

sqlite3_close(db); //Encerra a conexao

return 0;
}

4.1 – Explicado o código00.c

O código é bastante simples, ele efetua a conexão com o banco1.db, caso consiga efetua a conexão, ele informa que está conectado ao banco, caso negativo informa que não foi possível se conectar ao banco. A conexão e efetuada com a função sqlite3_open(), ela requer dois parâmetros:

• Nome do banco de dados;
• Um ponteiro utilizado pelas funções do sqlite3 para localizar o banco.

No bloco do if-else e feita a verificação para a conexão, a função sqlite3_open() e do tipo int e retorna um valor 0 caso a conexão tenha sido efetuada e o valor 1 em caso de erro. Dentro dos blocos if-else e informado o resultado da conexão utilizando as funções printf(). A função sqlite3_close() fecha a conexão, toda conexão criada precisa ser fechada. Para compilar utilizando o GCC deve-se incluir a opção -l sqlite3 no final, da seguinte forma:

$ gcc sqlite00.c -o sqlite00 -l sqlite3

4.2 – Inserindo dados

Para inserirmos dados utilizamos a função sqlite3_exec(), seu protótipo é o seguinte:

Função sqlite3_exec()

Vamos fazer algumas alterações no codigo00, inserindo a função sqlite3_exec() ficando da seguinte forma:

#include <stdio.h>
#include <sqlite3.h>

int main()
{
sqlite3 *db;
char comando[] = "insert into cadastro (nome,idade) values ('Pedro','25')";

if(sqlite3_open("banco1.db",&db))  //Abre e testa a conexao
{
printf("Nao foi possivel conectar!\n");
}

else
{
printf("Conectado!\n");
sqlite3_exec(db,comando,0,0,0); //Executa a instrucao.
}

sqlite3_close(db); //Fecha a conexao

return 0;
}

A função sqlite3_exec() requer 5 parâmetros, o primeiro é o banco que será acessado, segundo a instrução SQL a ser executada, o terceiro campo e utilizado para criamos statement (stmt), o quarto campo é onde os parâmetros que serão passados para a função que irá criar o stmt serão colocados., o ultimo campo será a onde a mensagem de erro será escrita, caso tenha algum erro.

5 – Conclusão

Neste curto artigo foi possível ter uma introdução ao uso da biblioteca Sqlite3 em aplicações C, sua g rande vantagem esta na facilidade em embuti-lo nos programas, sua API é bastante rica e não faz feio perto de outros SGDB como MySQL ou postgreSQL.

6 – Referências

• Command Line Shell For SQLite disponível em http://www.sqlite.org/sqlite.html, acessado em: 25 de fevereiro de 2011.
• [Tutorial]Usando Sqlite com linguagens C e C++ http://forum.imasters.com.br/topic/383367-tutorial-usando-sqlite-com-linguagem-c-e-c/, acessado em: 28 de fevereiro de 2011.
• SQlite 03 disponível em http://www.bibliotecaunix.org/index.php/SQLite3, acessado em: 25 de fevereiro de 2011.
• SQlite tutorial disponível em http://freshmeat.net/articles/sqlite-tutorial, acessado em 27 de fevereiro de 2011.
• SQlite disponível em http://en.wikipedia.org/wiki/SQLite3, acessado em 27 de fevereiro de 2011.
• [Programação]SQlite e seu acesso em C, disponível em http://onbytes.blogspot.com/2009/04/programacao-sqlite-e-seu-acesso-em-c.html, acessado em: 05 de março de 2011.

[]‘s

Textos Relacionados:

• [Programação] Utilizando argumentos em C ou que diabos é esse argc e argv ?
• [Programação] Números aleatórios em C + gerador de senhas em C
• [Programação] Funções hiperbólicas em C
• [Programação] Concatenando String em C
• [Programação] Criando seus próprios tipos de variáveis em C

Segue abaixo uma lista de comandos de sql

ABORT -- abort the current transaction
ALTER DATABASE -- change a database
ALTER GROUP -- add users to a group or remove users from a group
ALTER TABLE -- change the definition of a table
ALTER TRIGGER -- change the definition of a trigger
ALTER USER -- change a database user account
ANALYZE -- collect statistics about a database
BEGIN -- start a transaction block
CHECKPOINT -- force a transaction log checkpoint
CLOSE -- close a cursor
CLUSTER -- cluster a table according to an index
COMMENT -- define or change the comment of an object
COMMIT -- commit the current transaction
COPY -- copy data between files and tables
CREATE AGGREGATE -- define a new aggregate function
CREATE CAST -- define a user-defined cast
CREATE CONSTRAINT TRIGGER -- define a new constraint trigger
CREATE CONVERSION -- define a user-defined conversion
CREATE DATABASE -- create a new database
CREATE DOMAIN -- define a new domain
CREATE FUNCTION -- define a new function
CREATE GROUP -- define a new user group
CREATE INDEX -- define a new index
CREATE LANGUAGE -- define a new procedural language
CREATE OPERATOR -- define a new operator
CREATE OPERATOR CLASS -- define a new operator class for indexes
CREATE RULE -- define a new rewrite rule
CREATE SCHEMA -- define a new schema
CREATE SEQUENCE -- define a new sequence generator
CREATE TABLE -- define a new table
CREATE TABLE AS -- create a new table from the results of a query
CREATE TRIGGER -- define a new trigger
CREATE TYPE -- define a new data type
CREATE USER -- define a new database user account
CREATE VIEW -- define a new view
DEALLOCATE -- remove a prepared query
DECLARE -- define a cursor
DELETE -- delete rows of a table
DROP AGGREGATE -- remove a user-defined aggregate function
DROP CAST -- remove a user-defined cast
DROP CONVERSION -- remove a user-defined conversion
DROP DATABASE -- remove a database
DROP DOMAIN -- remove a user-defined domain
DROP FUNCTION -- remove a user-defined function
DROP GROUP -- remove a user group
DROP INDEX -- remove an index
DROP LANGUAGE -- remove a user-defined procedural language
DROP OPERATOR -- remove a user-defined operator
DROP OPERATOR CLASS -- remove a user-defined operator class
DROP RULE -- remove a rewrite rule
DROP SCHEMA -- remove a schema
DROP SEQUENCE -- remove a sequence
DROP TABLE -- remove a table
DROP TRIGGER -- remove a trigger
DROP TYPE -- remove a user-defined data type
DROP USER -- remove a database user account
DROP VIEW -- remove a view
END -- commit the current transaction
EXECUTE -- execute a prepared query
EXPLAIN -- show the execution plan of a statement
FETCH -- retrieve rows from a table using a cursor
GRANT -- define access privileges
INSERT -- create new rows in a table
LISTEN -- listen for a notification
LOAD -- load or reload a shared library file
LOCK -- explicitly lock a table
MOVE -- position a cursor on a specified row of a table
NOTIFY -- generate a notification
PREPARE -- create a prepared query
REINDEX -- rebuild corrupted indexes
RESET -- restore the value of a run-time parameter to a default value
REVOKE -- remove access privileges
ROLLBACK -- abort the current transaction
SELECT -- retrieve rows from a table or view
SELECT INTO -- create a new table from the results of a query
SET -- change a run-time parameter
SET CONSTRAINTS -- set the constraint mode of the current transaction
SET SESSION AUTHORIZATION -- set the session user identifier and the current user identifier of the current session
SET TRANSACTION -- set the characteristics of the current transaction
SHOW -- show the value of a run-time parameter
START TRANSACTION -- start a transaction block
TRUNCATE -- empty a table
UNLISTEN -- stop listening for a notification
UPDATE -- update rows of a table
VACUUM -- garbage-collect and optionally analyze a database

Textos Relacionados:

• 10 Dicas para começar a usar o PostgreSQL
• [Artigo] Programando em C com SQLite3
• [Dica] Conhecendo FSlint
• Visualizando código ASCII
• Gerando senhas aleatórias

Resolvi escrever este artigo, pois já encontrei muitos e muitos servidores neste estado, o que não chega ser um problema do postgresql, mas sim uma falta de atenção do seu administrador.

Descrição do Problema:

Qualquer usuário normal (que tenha shell) no servidor consegue acesso owner em todas as bases do pgsql sem digitar nenhuma senha. Isso acontece por que existem muitos administradores de DB PgSQL que acabam deixando as suas permissões padrões.

Veja o exemplo:
Primeiro descubra qual o usuário Owner das bases (normalmente pgsql ou postgres).

depois digite:


(/home/gamk)> psql -u -l
Username: pgsql
Password:

datname |datdba|encoding|datpath
---------+------+--------+------
template1 | 70 | 0 |template1
gamk | 0 | 0 |gamk
linuxsec | 0 | 0 |linuxsec
teste | 0 | 0 |teste
(4 rows)

Quando pedir o nome do usuário digite o Owner do DB (normalmente pgsql ou postgres). Logo após será pedida a senha, pressione apenas ENTER (sem digitar nada) e pronto, você tem a lista de todas as Bases que o Banco possui. Para entrar em uma delas como owner basta repetir o processo, (ex: base linuxsec) digite “psql -u linuxsec” e repita o processo de senha. Pronto você já está como Owner na base e pode fazer o que quiser, inclusive ALTERAR, INCLUIR, EXCLUIR dados, até mesmo destruir as tabelas…

Ps: Isso também funciona com os comandos (createdb, destroydb, createuser…) Pois é, realmente muito grave!!!

Vamos à causa e à solução: Editando o arquivo pg_hba.conf (normalmente em /usr/local/pgsql/data), você tem as seguintes linhas (descomentadas):


local all trust
host all 127.0.0.1 255.255.255.255 trust


Esta linha libera todas as bases com permissão trust (em localhost), a permissão trust dá acesso as bases sem requisição de senha (mesmo que o user tenha uma senha). A solução é simples basta alterar a linha por:


local all password
host all 127.0.0.1 255.255.255.255 password


E, de preferência, definir senhas para os usuários, (você pode usar o ALTER USER, e o CREATE USER). Existem outros tipos de “permissões” como (ident, reject, crypt, krb4, krb5), leia o arquivo pg_hba.conf que ele tem uma boa “documentação” sobre o assunto. Uma coisa tão simples, que nos pode poupar algumas noites sem dormir. Espero ter sido útil.

Boa Sorte :-D

Autor: Diego Linke – GAMK <gamk@gamk.com.br>

Textos Relacionados:

• [Linux] Fixando um processo em um núcleo do processador
• [Reflexão] O problema do Amarok, Firefox, Smartphones e Tablets
• [SED] Introdução ao SED – parte 2
• [SED] Introdução ao sed
• Revista Espírito Livre Número 31

Textos Relacionados:

• Comandos de SQL
• [Linux] Fixando um processo em um núcleo do processador
• [Shellscript] Converter strings maiúsculas para minusculas e vice-versa
• Instalando Emesene no Ubuntu
• Mplayer vs Mplayer2