1 -- Copyright 2009-2012, Equinox Software, Inc.
3 -- This program is free software; you can redistribute it and/or
4 -- modify it under the terms of the GNU General Public License
5 -- as published by the Free Software Foundation; either version 2
6 -- of the License, or (at your option) any later version.
8 -- This program is distributed in the hope that it will be useful,
9 -- but WITHOUT ANY WARRANTY; without even the implied warranty of
10 -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 -- GNU General Public License for more details.
13 -- You should have received a copy of the GNU General Public License
14 -- along with this program; if not, write to the Free Software
15 -- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17 --------------------------------------------------------------------------
18 -- An example of how to use:
20 -- DROP SCHEMA foo CASCADE; CREATE SCHEMA foo;
22 -- SELECT migration_tools.init('foo');
23 -- SELECT migration_tools.build('foo');
24 -- SELECT * FROM foo.fields_requiring_mapping;
26 -- create some incoming ILS specific staging tables, like CREATE foo.legacy_items ( l_barcode TEXT, .. ) INHERITS (foo.asset_copy);
27 -- Do some mapping, like UPDATE foo.legacy_items SET barcode = TRIM(BOTH ' ' FROM l_barcode);
28 -- Then, to move into production, do things like:
29 -- insert into asset.copy select * from asset_copy where id not in (select id from asset_copy_legacy where not x_migrate);
31 DROP SCHEMA IF EXISTS migration_tools CASCADE;
32 CREATE SCHEMA migration_tools;
34 CREATE OR REPLACE FUNCTION migration_tools.production_tables (TEXT) RETURNS TEXT[] AS $$
36 migration_schema ALIAS FOR $1;
40 EXECUTE 'SELECT string_to_array(value,'','') AS tables FROM ' || migration_schema || '.config WHERE key = ''production_tables'';'
45 $$ LANGUAGE PLPGSQL STRICT STABLE;
47 CREATE OR REPLACE FUNCTION migration_tools.init (TEXT) RETURNS VOID AS $$
49 migration_schema ALIAS FOR $1;
52 EXECUTE 'DROP TABLE IF EXISTS ' || migration_schema || '.config;';
53 EXECUTE 'CREATE TABLE ' || migration_schema || '.config ( key TEXT UNIQUE, value TEXT);';
54 EXECUTE 'INSERT INTO ' || migration_schema || '.config (key,value) VALUES ( ''production_tables'', ''asset.call_number,asset.call_number_prefix,asset.call_number_suffix,asset.copy_location,asset.copy,asset.copy_alert,asset.stat_cat,asset.stat_cat_entry,asset.stat_cat_entry_copy_map,asset.copy_note,actor.usr,actor.card,actor.usr_address,actor.stat_cat,actor.stat_cat_entry,actor.stat_cat_entry_usr_map,actor.usr_note,actor.usr_standing_penalty,actor.usr_setting,action.circulation,action.hold_request,action.hold_notification,action.hold_request_note,action.hold_transit_copy,action.transit_copy,money.grocery,money.billing,money.cash_payment,money.forgive_payment,acq.provider,acq.provider_address,acq.provider_note,acq.provider_contact,acq.provider_contact_address,acq.fund,acq.fund_allocation,acq.fund_tag,acq.fund_tag_map,acq.funding_source,acq.funding_source_credit,acq.lineitem,acq.purchase_order,acq.po_item,acq.invoice,acq.invoice_item,acq.invoice_entry,acq.lineitem_detail,acq.fund_debit,acq.fund_transfer,acq.po_note,config.circ_matrix_matchpoint,config.circ_matrix_limit_set_map,config.hold_matrix_matchpoint,asset.copy_tag,asset.copy_tag_copy_map,config.copy_tag_type,serial.item,serial.item_note,serial.record_entry,biblio.record_entry'' );';
56 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
58 CREATE OR REPLACE FUNCTION migration_tools.build (TEXT) RETURNS VOID AS $$
60 migration_schema ALIAS FOR $1;
61 production_tables TEXT[];
63 SELECT migration_tools.production_tables(migration_schema) INTO STRICT production_tables;
64 PERFORM migration_tools.build_base_staging_tables(migration_schema,production_tables);
65 EXECUTE 'CREATE UNIQUE INDEX ' || migration_schema || '_patron_barcode_key ON ' || migration_schema || '.actor_card ( barcode );';
66 EXECUTE 'CREATE UNIQUE INDEX ' || migration_schema || '_patron_usrname_key ON ' || migration_schema || '.actor_usr ( usrname );';
67 EXECUTE 'CREATE UNIQUE INDEX ' || migration_schema || '_copy_barcode_key ON ' || migration_schema || '.asset_copy ( barcode );';
68 EXECUTE 'CREATE UNIQUE INDEX ' || migration_schema || '_copy_id_key ON ' || migration_schema || '.asset_copy ( id );';
69 EXECUTE 'CREATE INDEX ' || migration_schema || '_callnum_record_idx ON ' || migration_schema || '.asset_call_number ( record );';
70 EXECUTE 'CREATE INDEX ' || migration_schema || '_callnum_upper_label_id_lib_idx ON ' || migration_schema || '.asset_call_number ( UPPER(label),id,owning_lib );';
71 EXECUTE 'CREATE UNIQUE INDEX ' || migration_schema || '_callnum_label_once_per_lib ON ' || migration_schema || '.asset_call_number ( record,owning_lib,label,prefix,suffix );';
73 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
75 CREATE OR REPLACE FUNCTION migration_tools.build_base_staging_tables (TEXT,TEXT[]) RETURNS VOID AS $$
77 migration_schema ALIAS FOR $1;
78 production_tables ALIAS FOR $2;
80 FOR i IN array_lower(production_tables,1) .. array_upper(production_tables,1) LOOP
81 PERFORM migration_tools.build_specific_base_staging_table(migration_schema,production_tables[i]);
84 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
86 CREATE OR REPLACE FUNCTION migration_tools.build_specific_base_staging_table (TEXT,TEXT) RETURNS VOID AS $$
88 migration_schema ALIAS FOR $1;
89 production_table ALIAS FOR $2;
90 base_staging_table TEXT;
93 base_staging_table = REPLACE( production_table, '.', '_' );
94 EXECUTE 'CREATE TABLE ' || migration_schema || '.' || base_staging_table || ' ( LIKE ' || production_table || ' INCLUDING DEFAULTS EXCLUDING CONSTRAINTS );';
96 SELECT table_schema, table_name, column_name, data_type
97 FROM information_schema.columns
98 WHERE table_schema = migration_schema AND table_name = base_staging_table AND is_nullable = 'NO' AND column_default IS NULL
100 EXECUTE 'ALTER TABLE ' || columns.table_schema || '.' || columns.table_name || ' ALTER COLUMN ' || columns.column_name || ' DROP NOT NULL;';
103 $$ LANGUAGE PLPGSQL STRICT VOLATILE;
105 CREATE OR REPLACE FUNCTION migration_tools.create_linked_legacy_table_from (TEXT,TEXT,TEXT) RETURNS VOID AS $$
107 migration_schema ALIAS FOR $1;
108 parent_table ALIAS FOR $2;
109 source_table ALIAS FOR $3;
113 column_list TEXT := '';
114 column_count INTEGER := 0;
116 create_sql := 'CREATE TABLE ' || migration_schema || '.' || parent_table || '_legacy ( ';
118 SELECT table_schema, table_name, column_name, data_type
119 FROM information_schema.columns
120 WHERE table_schema = migration_schema AND table_name = source_table
122 column_count := column_count + 1;
123 if column_count > 1 then
124 create_sql := create_sql || ', ';
125 column_list := column_list || ', ';
127 create_sql := create_sql || columns.column_name || ' ';
128 if columns.data_type = 'ARRAY' then
129 create_sql := create_sql || 'TEXT[]';
131 create_sql := create_sql || columns.data_type;
133 column_list := column_list || columns.column_name;
135 create_sql := create_sql || ' ) INHERITS ( ' || migration_schema || '.' || parent_table || ' );';
136 --RAISE INFO 'create_sql = %', create_sql;
138 insert_sql := 'INSERT INTO ' || migration_schema || '.' || parent_table || '_legacy (' || column_list || ') SELECT ' || column_list || ' FROM ' || migration_schema || '.' || source_table || ';';
139 --RAISE INFO 'insert_sql = %', insert_sql;
142 $$ LANGUAGE PLPGSQL STRICT VOLATILE;