O documento discute como dividir aplicações complexas em módulos menores utilizando extensões do PostgreSQL. Isso permite melhor modularidade, reutilização de código e gerenciamento de versões. O exemplo mostra como criar validadores de CPF e e-mail como uma extensão, permitindo validações no banco de dados de forma centralizada.

1. Estripando o Elefante
Como estender o
PostgreSQL...
… estripando sua aplicação e dividindo
um problemão em
problemas menores utilizando extensões?
por Dickson S. Guedes
(@guediz)
PGBR 2011, 4 de Novembro

2. Estripando o Elefante
Como estender o
PostgreSQL...
… estripando sua aplicação e dividindo
um problemão em
problemas menores utilizando extensões?
por Dickson S. Guedes
(@guediz)
PGBR 2011, 4 de Novembro

3. ADVERTÊNCIA!

4. ESTA PALESTRA
POSSUI CONTEÚDO
QUE PODE QUEBRAR
CERTOS
PARADÍGMAS SEUS

5. “Quando você faz as
coisas sempre do
mesmo jeito, obterá
sempre os mesmos
resultados” – Alguém

6. No começo haviam vários bancos
espalhados com várias funções...

7. PostgreSQL 9.0
+
PL/Perl
+
Funções definidas pelo usuário

8. … e então perdeu-se o controle.

9. … e então perdeu-se o controle.
Gerenciamento manual
Não havia controle de versão
Falta de abstração, e modularidade
Sem reutilização de código

10. Como melhorar?

11. Primeiramente entendendo o
problema...

12. Primeiramente entendendo o
problema...
Pensando fora da caixa!

13. pessoas usuarios
email_valido() cpf_valido()
PL/perl PL/pgsql SQL
PostgreSQL 9.1

14. As aplicações precisavam ser
modularizadas...

15. As aplicações precisavam ser
modularizadas...
… e o banco precisava ser
atualizado

16. As aplicações precisavam ser
modularizadas...
… e o banco precisava ser
atualizado

17. Até então não tinhamos....
● Versionamento de funções no banco
● Gerenciamento de contribs
● saber facilmente quais contribs estão instaladas, por exemplo
● Modularidade
● Reaproveitamento de código
● Contribuições para comunidade
● ...

18. Até então não tinhamos....
● Versionamento de funções no banco
● Gerenciamento de contribs
● saber facilmente quais contribs estão instaladas, por exemplo
● Modularidade
● Reaproveitamento de código
● Contribuições para comunidade
● ...
SIM! Eu consigo dividir para conquistar!

19. Tá! E como o PostgreSQL pode
ajudar?

20. EXTENSÕES

21. EXTENSÕES
POR QUE?

22. Porque o PostgreSQL é
divertidamente estendível !

23. Por que o PostgreSQL é
divertidamente estendível ?

24. Por que o PostgreSQL é
divertidamente estendível ?
É guiado por catálogo!

25. Catálogo do sistema
Metadados
Dicionário de dados

26. Catálogo do sistema
Metadados
Dicionário de dados
Diferença para outros SGDBS?

27. Tabelas
Colunas
Tipos de dados
Funções
Domínios
Métodos de acesso
...

28. Tabelas
Colunas
Tipos de dados
Funções
Domínios
Métodos de acesso
...

29. PostgreSQL não é
apenas um
Sistema Gerenciador
de Banco de Dados ...

30. … ele é uma Plataforma
de Desenvolvimento de
Aplicações

31. Você desenvolve bibliotecas de
extensões reutilizáveis …

32. … e as combina para criar aplicações!

33. Vamos começar!

34. Banco PostgreSQL 9.0
Varias tabelas
Várias funções em varias linguagens
Código sem testes
Pouco versionamento das funcoes
O dump possui o codigo das funcoes
Gerenciamento atraves de esquemas

35. Cadastro de pessoas
CREATE TABLE pessoas
(
nro_cpf cpf PRIMARY KEY,
nome text NOT NULL,
data_nascimento date
);

36. Cadastro de pessoas
CREATE TABLE pessoas
(
nro_cpf cpf PRIMARY KEY,
nome text NOT NULL,
data_nascimento date
);

37. Cadastro de pessoas
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES
(88274557875, 'Adaloso Cachimbinho Lustrado', '1981-04-22'),
(96672786465, 'Enelildo Protolino Calado' , '1983-02-13'),
(88856899302, 'Feicebuque Ailaique' , '1976-07-06'),
(12563330858, 'Torrecilda Tapelia' , '1987-11-16'),
(27837882334, 'Almofafio Vasildo Tomado' , '1965-01-08'),
(25616561282, 'Uessebelson Blutuf' , '1983-05-11');

38. Cadastro de pessoas
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES
(88274557875, 'Adaloso Cachimbinho Lustrado', '1981-04-22'),
(96672786465, 'Enelildo Protolino Calado' , '1983-02-13'),
(88856899302, 'Feicebuque Ailaique' , '1976-07-06'),
(12563330858, 'Torrecilda Tapelia' , '1987-11-16'),
(27837882334, 'Almofafio Vasildo Tomado' , '1965-01-08'),
(25616561282, 'Uessebelson Blutuf' , '1983-05-11');

39. Cadastro de pessoas
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES
(88274557875, 'Adaloso Cachimbinho Lustrado', '1981-04-22'),
(96672786465, 'Enelildo Protolino Calado' , '1983-02-13'),
(88856899302, 'Feicebuque Ailaique' , '1976-07-06'),
(12563330858, 'Torrecilda Tapelia' , '1987-11-16'),
(27837882334, 'Almofafio Vasildo Tomado' , '1965-01-08'),
(25616561282, 'Uessebelson Blutuf' , '1983-05-11');
Mas...
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES
(12312312300, 'Ester Lionata Rio', '1981-04-22')

40. Cadastro de pessoas
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES
(88274557875, 'Adaloso Cachimbinho Lustrado', '1981-04-22'),
(96672786465, 'Enelildo Protolino Calado' , '1983-02-13'),
(88856899302, 'Feicebuque Ailaique' , '1976-07-06'),
(12563330858, 'Torrecilda Tapelia' , '1987-11-16'),
(27837882334, 'Almofafio Vasildo Tomado' , '1965-01-08'),
(25616561282, 'Uessebelson Blutuf' , '1983-05-11');
Mas...
INSERT INTO pessoas(nro_cpf, nome, data_nascimento)
VALUES VIOLATION!
(12312312300, 'Ester Lionata Rio', '1981-04-22')

41. Cadastro de usuarios
CREATE TABLE usuarios (
login email PRIMARY KEY,
nro_cpf cpf REFERENCES
pessoas(nro_cpf)
);

42. Cadastro de usuarios
CREATE TABLE usuarios (
login email PRIMARY KEY,
nro_cpf cpf REFERENCES
pessoas(nro_cpf)
);

43. Um operador especial
CREATE OPERATOR #? (
LEFTARG = numeric,
PROCEDURE = cpf_valido
);

44. Um operador especial
CREATE OPERATOR #? (
LEFTARG = numeric,
PROCEDURE = cpf_valido
);

45. Um operador especial
CREATE OPERATOR @? (
LEFTARG = citext,
PROCEDURE = email_valido
);

46. Um operador especial
CREATE OPERATOR @? (
LEFTARG = citext,
PROCEDURE = email_valido
);

47. Cadastro de usuarios
INSERT INTO usuarios (login, nro_cpf)
VALUES
('adaloso@cahimbinho.net', 88856899302),
('enelildo@calado.com', 96672786465),
('feicebuque.ailaique@facebook.com', 88856899302),
('tata.torre87@hotmail.com', 12563330858),
('tomado35@gmail.com', 27837882334),
('usb.83@aasdasdasd.com', 25616561282);

48. Cadastro de usuarios
INSERT INTO usuarios (login, nro_cpf)
VALUES
('adaloso@cahimbinho.net', 88856899302),
('enelildo@calado.com', 96672786465),
('feicebuque.ailaique@facebook.com', 88856899302),
('tata.torre87@hotmail.com', 12563330858),
('tomado35@gmail.com', 27837882334),
('usb.83@aasdasdasd.com', 25616561282);

49. Comportamento esperado
● SELECT cpf_valido(59328253241); -- true
● SELECT 59328253241 #?; -- true
● SELECT 91416000433 #?; -- false
● SELECT NOT 37821042003 #?; -- true
● SELECT email_valido('xpto@net'); -- false
● SELECT email_valido('xpto@hotmail.com'); -- true
● SELECT 'rotime@net' @? ; -- false
● SELECT 'feice@book.net' @? ; -- true

50. pessoas usuarios
Validadores
email_valido() cpf_valido()
PL/perl PL/pgsql SQL
PostgreSQL 9.1

51. Cara! Show me the code!

52. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

53. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

54. Makefile
EXTENSION = validadores
EXTVERSION = $(shell grep default_version $
(EXTENSION).control | sed -e
"s/default_version[[:space:]]*=[[:space:]]*'
([^']*)'/1/")
DATA = $(filter-out $(wildcard sql/*--*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.md)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = --inputdir=test --load-language=plpgsql
#Descomente esta linha caso tenha funções em C
#MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) --version | grep -qE
" 8.| 9.0" && echo no || echo yes)

55. Makefile
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)--$(EXTVERSION).sql
sql/$(EXTENSION)--$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*--*.sql) sql/$(EXTENSION)--$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)--$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)

56. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

57. Controlfile: validadores.control
# validadores extension
comment = 'Extensao que contem validadores de CNPJ, CPF'
default_version = '0.0.1'
relocatable = true

58. Controlfile: validadores.control
# validadores extension
comment = 'Extensao que contem validadores de CNPJ, CPF'
default_version = '0.0.1'
relocatable = true
Learn more ...
http://www.postgresql.org/docs/current/static/extend-extensions.html#AEN51780

59. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

60. Testes?

61. Em banco?

62. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

63. Os passos
● Prepare o código fonte, os testes e a
documentação
● Crie o arquivo Makefile
● Crie o arquivo de controle
● Escreva testes
● Escreva o código
● Documente

64. Gostei! Quero compartilhar!

65. Como faço?

66. PGXN!

67. PGXN
Um índice central de extensões do
PostgreSQL
+
Documentação
+
Pesquisa
+
Fácil instalação

68. Obrigado
David E. Wheeler!
(@theory)

69. DEMO

70. PGXN Client
sudo apt­get install python­pip
pip install pgxnclient
pgxn –help
Ex. pgxn install resetsequence

71. Obrigado
Daniele Varrazzo!
(@dvarrazzo)

72. DEMO

73. PGXN Utils
gem install pgxn_utils
pgxn_utils help
Ex. pgxn_utils skeleton teste

74. DEMO

75. Então...

76. Use extensões ao invés
de scripts que criam
objetos órfãos

77. O PostgreSQL vai saber
que os objetos fazem
parte de um pacote e...

78. … poderá removê-los
com um simples:
DROP EXTENSION … ;

79. pg_dump não vai fazer o
dump de todos os
objetos da extensão

80. O PostgreSQL não vai
deixar você remover
objetos individuais

81. Scripts de modificação
para upgrade de versão
extensao--1.0.0--1.0.1.sql
ALTER EXTENSION extensao
UPDATE TO '1.0.1';

82. ?

83. Referências
● WEB
● http://pgxn.org
● http://blog.pgxn.org
● http://www.postgresql.org.br
● http://www.postgresql.org
● IRC
● irc.freenode.net
– Guedes @ #postgresql, #postgresql-br
● Gtalk
● guedes@guedesoft.net
● Twitter
● @pgxn
● @guediz
● @pgcasts