scrivere un'estensione per postgresql 9.1
DESCRIPTION
A partire dalla versione 9.1 PostgreSQL fornisce la possibilità di raggruppare un insieme di oggetti (tipi di dato, tabelle, funzioni, operatori, ecc..) all'interno di un'estensione.L'idea che molteplici oggetti del database possano essere considerati come un'unica entità, porta notevoli vantaggi in termini di gestione e design del database, in quanto con un solo comando si possono aggiungere, modificare o cancellare tutti gli oggetti contenuti in un'estensione. In questo intervento si mostrerà come creare una semplice estensione e il suo utilizzo pratico.TRANSCRIPT
![Page 1: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/1.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Scrivere un'estensioneper PostgreSQL 9.1
Marco NenciariniItalian PostgreSQL Users Group
www.itpug.orgwww.postgresql.org
![Page 2: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/2.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Marco Nenciarini• DBA, sviluppatore e sysadmin presso 2ndQuadrant
– Database OLTP business critical– Data warehousing
• Membro della comunità di PostgreSQL– Co-Fondatore di ITPUG
• Debian Developer
![Page 3: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/3.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Sommario• Perché le estensioni• Anatomia di un'estensione• Installazione• Manutenzione e aggiornamento• PGXN• Conclusioni
![Page 4: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/4.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Ecosistema PostgreSQL• Estensibilità• Ricca documentazione• Grande quantità di moduli aggiuntivi
– 46 Contrib, molteplici estensioni, estensioni private– PostGIS, hstore, adminpack, dblink, ltree, pgq, ip4r, intagg,
cube, pgfincore, pgcrypto, citext, pg_trgm, wildspeed, temporal, prexpg_stattuple, pg_freespacemap, pg_stat_statements, …
![Page 5: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/5.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Prima di PostgreSQL 9.1• Installazione tramite script
• Lo script sql può contenere molti oggetti• Tutti gli oggetti vengono creati nello schema di default• Difficoltà di gestione in database multi-schema
apt-get install postgresql-contrib-9.0psql -f /usr/share/postgresql/9.0/contrib/cube.sql
![Page 6: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/6.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Perché le estensioni• Supporto migliore per dump e restore• Separazione logica fra l'estensione e gli altri oggetti
presenti nel database– Non fa parte dei dati– È una dipendenza dei dati
• Installazione in uno schema specifico• Operazioni di manutenzione semplificate
CREATE EXTENSION IF NOT EXISTS cube WITH SCHEMA public;
![Page 7: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/7.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Anatomia di un'estensione• File di controllo
– Metadati– Impostazioni– Dipendenze
• Script SQL di installazione– Nessuna nuova sintassi da imparare– Ambiente di esecuzione controllato
• Script SQL di aggiornamento (opzionali)• Moduli binari (opzionali)
![Page 8: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/8.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Il file di controllo• In ${SHAREDIR}/extension
• Si deve chiamare <nome_estensione>.control
• Sintassi chiave/valore (come postgresql.conf)
$ cat /usr/share/postgresql/9.1/extension/pair.control# pair extensioncomment = 'A key/value pair data type'default_version = '1.0'relocatable = true
![Page 9: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/9.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Lo script di installazione• <estensione>--<versione>.sql• È un normale script SQL• Viene eseguito all'interno di una transazione
– No BEGIN/COMMIT/ROLLBACK
• Ambiente controllato– Tutto quello che viene creato fa parte dell'estensione
• Due sostituzioni possibili– MODULE_PATHNAME– @extschema@
•
![Page 10: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/10.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Esempio: pair--1.0.sqlCREATE TYPE pair AS ( k text, v text );
CREATE OR REPLACE FUNCTION pair(text, text)RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair;';
CREATE OPERATOR ~> (LEFTARG = text,RIGHTARG = text,
PROCEDURE = pair);
ALTER EXTENSION pair DROP TYPE _pair; -- bug 9.1
![Page 11: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/11.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Esempio: estensione non rilocabile• Se l'estensione necessita conoscere schema di
destinazione durante l'installazione essere marcata come non rilocabile– Usare @extschema@ come segnaposto per lo schema– relocatable = false
• Se l'estensione necessita di essere installata in uno schema specifico– relocatable = false– schema = schema_di_destinazione
![Page 12: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/12.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Installazione• CREATE EXTENSION
– IF NOT EXISTS– SCHEMA <schema_esistente>– VERSION <versione>– FROM <versione_modulo>
CREATE EXTENSION hstore;
CREATE EXTENSION cube FROM unpackaged;
![Page 13: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/13.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Ispezione da psqlpostgres=# \dx List of installed extensions Name | Version | Schema | Description ------+---------+--------+---------------------------- pair | 1.0 | pair | A key/value pair data type(1 row)
postgres=# \dx+ Objects in extension "pair" Object Description ------------------------------- function pair.pair(text,text) operator pair.~>(text,text) type pair.pair(3 rows)
![Page 14: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/14.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Supporto per il dump/restore• L'estensione è una dipendenza
– Una sola riga nel dump (commenti esclusi)
• L'estensione può contenere tabelle– Le tabelle non compaiono nel dump– Ma le tabelle possono essere modificate!
$ pg_dump | grep pair-- Name: pair; Type: EXTENSION; Schema: -; Owner: CREATE EXTENSION IF NOT EXISTS pair WITH SCHEMA public;-- Name: EXTENSION pair; Type: COMMENT; Schema: -; Owner: COMMENT ON EXTENSION pair IS 'A key/value pair data type';
![Page 15: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/15.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Tabelle
Supporto per tabelle di configurazione– Dump del solo contenuto– Possibilità di discriminare fra dati di default e dati aggiuntivi
CREATE TABLE extconfig ( key text, value text, standard_entry boolean);
SELECT pg_catalog.pg_extension_config_dump( 'extconfig', 'WHERE NOT standard_entry');
![Page 16: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/16.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Manutenzione• Aggiornamento atomico
• Rilocazione in uno schema diverso
ALTER EXTENSION pair UPDATE;
ALTER EXTENSION pair SET SCHEMA pair;
![Page 17: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/17.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Gli script di aggiornamento• <estensione>--<da_versione>--<a_versione>.sql• Stessa sintassi dello script di installazione• Strada più corta per la versione richiesta• Nessuna assunzione su ordinamento
– Downgrade– Nomi simbolici
• Funzione pg_extension_update_paths('estensione')• Versione “unpackaged”
![Page 18: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/18.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Esempio: pair--unpackaged--1.0.sql
ALTER EXTENSION pair ADD TYPE pair;ALTER EXTENSION pair ADD FUNCTION pair(text, text);ALTER EXTENSION pair ADD OPERATOR ~> (text,text);
• Si basa su un'estensione vuota• Aggiunge manualmente il contenuto del vecchio modulo
![Page 19: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/19.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Esempio: pair--1.0--1.1.sql
CREATE OR REPLACE FUNCTION pair(anyelement, anyelement)RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';CREATE OR REPLACE FUNCTION pair(text, anyelement)RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';CREATE OR REPLACE FUNCTION pair(anyelement, anyelement)RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair';CREATE OPERATOR ~> (LEFTARG = text, RIGHTARG = anyelement, PROCEDURE = pair);CREATE OPERATOR ~> (LEFTARG = anyelement, RIGHTARG = text, PROCEDURE = pair);CREATE OPERATOR ~> (LEFTARG = anyelement, RIGHTARG = anyelement, PROCEDURE = pair);
![Page 20: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/20.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Esempio: pg_extension_update_paths
postgres=# SELECT * FROM pg_extension_update_paths('pair'); source | target | path ------------+------------+---------------------- 1.0 | 1.1 | 1.0--1.1 1.0 | unpackaged | 1.1 | 1.0 | 1.1 | unpackaged | unpackaged | 1.0 | unpackaged--1.0 unpackaged | 1.1 | unpackaged--1.0--1.1(6 rows)
![Page 21: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/21.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
PostgreSQL eXtension Network - PGXN• http://pgxn.org/• Obiettivo: raccogliere tutte le estensioni open source• PGXN Client
– simile a apt-get o yum• pgxn install estensione
• pgxn search parola
• PGXN Utils– Ausilio per lo sviluppatore di estensioni
![Page 22: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/22.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
META.json
{ "name": "pair", "abstract": "A key/value pair data type", "version": "0.1.0", "maintainer": "Marco Nenciarini <[email protected]>", "license": "postgresql", "metaspec": { "version": "1.0.0", "url": "http://pgxn.org/meta/spec.txt" },}
• Specifiche http://pgxn.org/spec/
![Page 23: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/23.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Conclusioni• Usare moduli aggiuntivi non è mai stato così facile• Vantaggi anche per chi sviluppa estensioni
– Robustezza– Manutenibilità
• Applicazioni come estensioni– Aggiornamento atomico– Packaging– Dump selettivo
• Lenta migrazione dei moduli esistenti
![Page 24: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/24.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Domande?• E-Mail: [email protected]• URL: www.2ndquadrant.it• Blog: blog.2ndquadrant.it
![Page 25: Scrivere un'estensione per PostgreSQL 9.1](https://reader033.vdocuments.net/reader033/viewer/2022042614/559970151a28ab6c368b47bb/html5/thumbnails/25.jpg)
Marco Nenciarini – [email protected] - ITPUG.org
PGDay.IT 2011Monash University Prato Centre
Venerdì 25 Novembre 2011
Licenza Creative CommonsAttribuzioneNon commercialeCondividi allo stesso modo2.5 Italia
http://creativecommons.org/licenses/by-nc-sa/2.5/it/© 2011 2ndQuadrant Italia - http://www.2ndquadrant.it