SQLite - Perl
Neste capítulo, você aprenderá como usar SQLite em programas Perl.
Instalação
O SQLite3 pode ser integrado ao Perl usando o módulo Perl DBI, que é um módulo de acesso ao banco de dados para a linguagem de programação Perl. Ele define um conjunto de métodos, variáveis e convenções que fornecem uma interface de banco de dados padrão.
A seguir estão as etapas simples para instalar o módulo DBI em sua máquina Linux / UNIX -
$ wget http://search.cpan.org/CPAN/authors/id/T/TI/TIMB/DBI-1.625.tar.gz
$ tar xvfz DBI-1.625.tar.gz
$ cd DBI-1.625
$ perl Makefile.PL
$ make
$ make install
Se você precisar instalar o driver SQLite para DBI, ele pode ser instalado da seguinte maneira -
$ wget http://search.cpan.org/CPAN/authors/id/M/MS/MSERGEANT/DBD-SQLite-1.11.tar.gz
$ tar xvfz DBD-SQLite-1.11.tar.gz
$ cd DBD-SQLite-1.11
$ perl Makefile.PL
$ make
$ make install
APIs de interface DBI
A seguir estão importantes rotinas DBI, que podem ser suficientes para trabalhar com o banco de dados SQLite de seu programa Perl. Se você está procurando um aplicativo mais sofisticado, pode consultar a documentação oficial do Perl DBI.
Sr. Não. | API e descrição |
---|---|
1 | DBI->connect($data_source, "", "", \%attr) Estabelece uma conexão de banco de dados, ou sessão, para o $ data_source solicitado. Retorna um objeto de identificador de banco de dados se a conexão for bem-sucedida. A fonte de dados tem o formato - DBI:SQLite:dbname = 'test.db'onde SQLite é o nome do driver SQLite e test.db é o nome do arquivo de banco de dados SQLite. Se o nome do arquivo for fornecido como':memory:', ele criará um banco de dados na memória na RAM que dura apenas durante a sessão. Se o nome do arquivo for o nome do arquivo do dispositivo real, ele tentará abrir o arquivo do banco de dados usando seu valor. Se não existir nenhum arquivo com esse nome, um novo arquivo de banco de dados com esse nome será criado. Você mantém o segundo e o terceiro parâmetros como strings em branco e o último parâmetro é passar vários atributos, conforme mostrado no exemplo a seguir. |
2 | $dbh->do($sql) Essa rotina prepara e executa uma única instrução SQL. Retorna o número de linhas afetadas ou undef em caso de erro. Um valor de retorno de -1 significa que o número de linhas não é conhecido, não aplicável ou não disponível. Aqui, $ dbh é um identificador retornado pela chamada DBI-> connect (). |
3 | $dbh->prepare($sql) Esta rotina prepara uma instrução para execução posterior pelo mecanismo de banco de dados e retorna uma referência a um objeto de manipulação de instrução. |
4 | $sth->execute() Essa rotina executa todo o processamento necessário para executar a instrução preparada. Um undef é retornado se ocorrer um erro. Uma execução bem-sucedida sempre retorna verdadeiro, independentemente do número de linhas afetadas. Aqui, $ sth é um identificador de instrução retornado pela chamada $ dbh-> prepare ($ sql). |
5 | $sth->fetchrow_array() Esta rotina busca a próxima linha de dados e a retorna como uma lista contendo os valores dos campos. Os campos nulos são retornados como valores undef na lista. |
6 | $DBI::err Isso é equivalente a $ h-> err, onde $ h é qualquer um dos tipos de identificador como $ dbh, $ sth ou $ drh. Isso retorna o código de erro do mecanismo de banco de dados nativo do último método de driver chamado. |
7 | $DBI::errstr Isso é equivalente a $ h-> errstr, onde $ h é qualquer um dos tipos de identificador como $ dbh, $ sth ou $ drh. Isso retorna a mensagem de erro do mecanismo de banco de dados nativo do último método DBI chamado. |
8 | $dbh->disconnect() Esta rotina fecha uma conexão de banco de dados aberta anteriormente por uma chamada para DBI-> connect (). |
Conectar ao banco de dados
O código Perl a seguir mostra como se conectar a um banco de dados existente. Se o banco de dados não existir, ele será criado e, finalmente, um objeto de banco de dados será retornado.
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
Agora, vamos executar o programa acima para criar nosso banco de dados test.db no diretório atual. Você pode alterar seu caminho de acordo com sua necessidade. Mantenha o código acima no arquivo sqlite.pl e execute-o conforme mostrado abaixo. Se o banco de dados for criado com sucesso, ele exibirá a seguinte mensagem -
$ chmod +x sqlite.pl
$ ./sqlite.pl
Open database successfully
Crie uma mesa
O seguinte programa Perl é usado para criar uma tabela no banco de dados criado anteriormente.
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
my $stmt = qq(CREATE TABLE COMPANY
(ID INT PRIMARY KEY NOT NULL,
NAME TEXT NOT NULL,
AGE INT NOT NULL,
ADDRESS CHAR(50),
SALARY REAL););
my $rv = $dbh->do($stmt);
if($rv < 0) {
print $DBI::errstr;
} else {
print "Table created successfully\n";
}
$dbh->disconnect();
Quando o programa acima for executado, ele criará a tabela COMPANY em seu test.db e exibirá as seguintes mensagens -
Opened database successfully
Table created successfully
NOTE - Caso você veja o seguinte erro em qualquer uma das operações -
DBD::SQLite::st execute failed: not an error(21) at dbdimp.c line 398
Nesse caso, abra dbdimp.c file disponível na instalação DBD-SQLite e descubra sqlite3_prepare() função e altere seu terceiro argumento para -1 em vez de 0. Finalmente, instale DBD :: SQLite usando make e fazer make install para resolver o problema.
Operação INSERT
O programa Perl a seguir mostra como criar registros na tabela COMPANY criada no exemplo acima.
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
my $stmt = qq(INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (1, 'Paul', 32, 'California', 20000.00 ));
my $rv = $dbh->do($stmt) or die $DBI::errstr;
$stmt = qq(INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (2, 'Allen', 25, 'Texas', 15000.00 ));
$rv = $dbh->do($stmt) or die $DBI::errstr;
$stmt = qq(INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (3, 'Teddy', 23, 'Norway', 20000.00 ));
$rv = $dbh->do($stmt) or die $DBI::errstr;
$stmt = qq(INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (4, 'Mark', 25, 'Rich-Mond ', 65000.00 ););
$rv = $dbh->do($stmt) or die $DBI::errstr;
print "Records created successfully\n";
$dbh->disconnect();
Quando o programa acima for executado, ele criará os registros fornecidos na tabela COMPANY e exibirá as duas linhas a seguir -
Opened database successfully
Records created successfully
SELECT Operação
O programa Perl a seguir mostra como buscar e exibir registros da tabela COMPANY criada no exemplo acima.
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
my $stmt = qq(SELECT id, name, address, salary from COMPANY;);
my $sth = $dbh->prepare( $stmt );
my $rv = $sth->execute() or die $DBI::errstr;
if($rv < 0) {
print $DBI::errstr;
}
while(my @row = $sth->fetchrow_array()) {
print "ID = ". $row[0] . "\n";
print "NAME = ". $row[1] ."\n";
print "ADDRESS = ". $row[2] ."\n";
print "SALARY = ". $row[3] ."\n\n";
}
print "Operation done successfully\n";
$dbh->disconnect();
Quando o programa acima for executado, ele produzirá o seguinte resultado.
Opened database successfully
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 20000
ID = 2
NAME = Allen
ADDRESS = Texas
SALARY = 15000
ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000
ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000
Operation done successfully
Operação ATUALIZAR
O código Perl a seguir mostra como a instrução UPDATE para atualizar qualquer registro e, em seguida, buscar e exibir os registros atualizados da tabela COMPANY.
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
my $stmt = qq(UPDATE COMPANY set SALARY = 25000.00 where ID=1;);
my $rv = $dbh->do($stmt) or die $DBI::errstr;
if( $rv < 0 ) {
print $DBI::errstr;
} else {
print "Total number of rows updated : $rv\n";
}
$stmt = qq(SELECT id, name, address, salary from COMPANY;);
my $sth = $dbh->prepare( $stmt );
$rv = $sth->execute() or die $DBI::errstr;
if($rv < 0) {
print $DBI::errstr;
}
while(my @row = $sth->fetchrow_array()) {
print "ID = ". $row[0] . "\n";
print "NAME = ". $row[1] ."\n";
print "ADDRESS = ". $row[2] ."\n";
print "SALARY = ". $row[3] ."\n\n";
}
print "Operation done successfully\n";
$dbh->disconnect();
Quando o programa acima for executado, ele produzirá o seguinte resultado.
Opened database successfully
Total number of rows updated : 1
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 25000
ID = 2
NAME = Allen
ADDRESS = Texas
SALARY = 15000
ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000
ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000
Operation done successfully
Operação DELETE
O seguinte código Perl mostra como usar a instrução DELETE para excluir qualquer registro e, em seguida, buscar e exibir os registros restantes da tabela COMPANY -
#!/usr/bin/perl
use DBI;
use strict;
my $driver = "SQLite";
my $database = "test.db";
my $dsn = "DBI:$driver:dbname=$database";
my $userid = "";
my $password = "";
my $dbh = DBI->connect($dsn, $userid, $password, { RaiseError => 1 })
or die $DBI::errstr;
print "Opened database successfully\n";
my $stmt = qq(DELETE from COMPANY where ID = 2;);
my $rv = $dbh->do($stmt) or die $DBI::errstr;
if( $rv < 0 ) {
print $DBI::errstr;
} else {
print "Total number of rows deleted : $rv\n";
}
$stmt = qq(SELECT id, name, address, salary from COMPANY;);
my $sth = $dbh->prepare( $stmt );
$rv = $sth->execute() or die $DBI::errstr;
if($rv < 0) {
print $DBI::errstr;
}
while(my @row = $sth->fetchrow_array()) {
print "ID = ". $row[0] . "\n";
print "NAME = ". $row[1] ."\n";
print "ADDRESS = ". $row[2] ."\n";
print "SALARY = ". $row[3] ."\n\n";
}
print "Operation done successfully\n";
$dbh->disconnect();
Quando o programa acima for executado, ele produzirá o seguinte resultado.
Opened database successfully
Total number of rows deleted : 1
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 25000
ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000
ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000
Operation done successfully