Hêza nivîsandina vê xêzkirinê gotar bû . Min gotara ku 4 sal berê hatî weşandin jî balkêş dît - .
Balkêş xuya bû ku heman raman - "di databasê de mantiqa karsaziyê bicîh bikin".
Yê ku hat bîra min ne tenê ez bûm.
Di heman demê de, ji bo pêşerojê, min xwest ku, berî her tiştî, ji bo xwe, pêşveçûnên balkêş ên ku di dema pêkanînê de derketine biparêzin. Nemaze ji ber ku di demên dawî de biryarek stratejîk hate girtin ku mîmarî biguhezîne û mantiqa karsaziyê veguhezîne asta paşîn. Ji ber ku her tiştê ku hatiye pêşxistin di demek nêz de ji kesî re ne kêrî xwe tê û ji kesî re ne eleqedar dibe.
Rêbazên ku têne diyar kirin celebek vedîtin an awarte ne. dizanin ka çawa, her tişt klasîk e û çend caran hatiye bicihanîn (mînak, min 20 sal berê li ser Oracle nêzîkatiyek wusa bikar anî). Min tenê biryar da ku her tiştî li cîhek berhev bikim. Di rewşê de ku ew ji bo kesek bikêr tê. Wekî ku pratîkê destnîşan kiriye, pir caran heman raman bi serê xwe ji mirovên cûda re tê. Û kêrhatî ye ku hûn wê ji bo xwe wekî bîranînek bihêlin.
Helbet di vê dinyayê da tu tişt ne tekûz e, şaşî û xeletiyên tîpan mixabin mimkûn in. Rexne û şîrove bi tundî tê pêşwazîkirin û çaverêkirin.. Û detayeke din a biçûk - hûrguliyên pêkanîna taybetî ji holê hatine rakirin. Beriya her tiştî, her tişt hîn jî di projeyek xebata rastîn de tê bikar anîn. Ji ber vê yekê, gotar tenê nexşeyek û ravekek têgeha giştî ye, ne tiştek din. Ez hêvî dikim ku hûrguliyên bes hene ku wêneya giştî fam bikin.
Fikra giştî “parçe bike û bi ser bikeve, veşêre û xwedî derkeve” ye.
Fikir klasîk e - ji bo tabloyan şemayek veqetandî, ji bo fonksiyonên hilandî şemayek cihê.
Xerîdar rasterast bi daneyan re nagihîje. Tiştê ku xerîdar dikare bike ev e ku gazî fonksiyona hilanîn bike û bersiva wergirtî pêvajoyê bike.
Role
CREATE ROLE store;
CREATE ROLE sys_functions;
CREATE ROLE loc_audit_functions;
CREATE ROLE service_functions;
CREATE ROLE business_functions;
Schemes
Plana hilanîna maseyê
Tabloyên armancê yên ku pêkhateyên mijarê pêk tînin.
CREATE SCHEMA store AUTHORIZATION store ;
Diagrama fonksiyona pergalê
Fonksiyonên pergalê, bi taybetî ji bo tomarkirina guhertinên tabloyê.
CREATE SCHEMA sys_functions AUTHORIZATION sys_functions ;
Plana kontrolkirina herêmî
Fonksiyon û tabloyên ji bo bicihanîna lênihêrîna herêmî ya pêkanîna fonksiyonên hilanîn û guheztinên tabloyên armanc.
CREATE SCHEMA loc_audit_functions AUTHORIZATION loc_audit_functions;
Diagrama fonksiyona karûbarê
Fonksiyonên ji bo karûbarên karûbar û DML.
CREATE SCHEMA service_functions AUTHORIZATION service_functions;
Diagrama fonksiyona karsaziyê
Fonksiyonên ji bo fonksiyonên karsaziya paşîn ên ku ji hêla xerîdar ve têne gazî kirin.
CREATE SCHEMA business_functions AUTHORIZATION business_functions;
Mafên gihiştinê
Rol - DBA xwedan gihîştina tevahî ya hemî şemayan e (ji rola Xwedî DB veqetandî).
CREATE ROLE dba_role;
GRANT store TO dba_role;
GRANT sys_functions TO dba_role;
GRANT loc_audit_functions TO dba_role;
GRANT service_functions TO dba_role;
GRANT business_functions TO dba_role;
Rol - BIKARANÎVAN îmtiyazê heye DARDEKIRIN di diagramê de business_functions.
CREATE ROLE user_role;
Îmtiyazên di navbera schemes
PIŞGIRÎ
Ji ber ku hemî fonksiyon bi taybetmendiyê têne afirandin SECURITY DEFINIER talîmatên pêwîst LI SER HEMÛ FUNKSYONÊ BİXWÎNE BİXWÎNE… JI gel;
REVOKE EXECUTE ON ALL FUNCTION IN SCHEMA sys_functions FROM public ;
REVOKE EXECUTE ON ALL FUNCTION IN SCHEMA loc_audit_functions FROM public ;
REVOKE EXECUTE ON ALL FUNCTION IN SCHEMA service_functions FROM public ;
REVOKE EXECUTE ON ALL FUNCTION IN SCHEMA business_functions FROM public ;
GRANT USAGE ON SCHEMA sys_functions TO dba_role ;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA sys_functions TO dba_role ;
GRANT USAGE ON SCHEMA loc_audit_functions TO dba_role ;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA loc_audit_functions TO dba_role ;
GRANT USAGE ON SCHEMA service_functions TO dba_role ;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA service_functions TO dba_role ;
GRANT USAGE ON SCHEMA business_functions TO dba_role ;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA business_functions TO dba_role ;
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA business_functions TO user_role ;
GRANT ALL PRIVILEGES ON SCHEMA store TO GROUP business_functions ;
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA store TO business_functions ;
GRANT USAGE ON ALL SEQUENCES IN SCHEMA store TO business_functions ;
Ji ber vê yekê şemaya databasê amade ye. Hûn dikarin dest bi dagirtina daneyan bikin.
Tabloyên armanc
Çêkirina tabloyan ne tiştek e. Taybetmendiyên taybetî tune, ji bilî ku biryar hate girtin ku neyê bikar anîn SERIALL û rêzikên eşkere biafirînin. Zêdetir, bê guman, karanîna herî zêde ya rêwerzan
COMMENT ON ...Comments for всех tiştên, bê îstîsna.
Kontrola herêmî
Ji bo qeydkirina pêkanîna fonksiyonên hilanîn û guheztinên li tabloyên armancê, tabloyek kontrolê ya herêmî tê bikar anîn, ku di nav de, hûrguliyên pêwendiya xerîdar, etîketa modula ku jê re tê gotin, û nirxên rastîn ên têketinê û Parametreyên derketinê di forma JSON de.
Fonksiyonên pergalê
Ji bo qeydkirina guhertinên di tabloyên armancê de hatî çêkirin. Ew fonksiyonên tîrêjê ne.
Şablon - fonksiyona pergalê
---------------------------------------------------------
-- INSERT
CREATE OR REPLACE FUNCTION sys_functions.table_insert_log ()
RETURNS TRIGGER AS $$
BEGIN
PERFORM loc_audit_functions.make_log( ' '||'table' , 'insert' , json_build_object('id', NEW.id) );
RETURN NULL ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;
CREATE TRIGGER table_after_insert AFTER INSERT ON storage.table FOR EACH ROW EXECUTE PROCEDURE sys_functions.table_insert_log();
---------------------------------------------------------
-- UPDATE
CREATE OR REPLACE FUNCTION sys_functions.table_update_log ()
RETURNS TRIGGER AS $$
BEGIN
IF OLD.column != NEW.column
THEN
PERFORM loc_audit_functions.make_log( ' '||'table' , 'update' , json_build_object('OLD.column', OLD.column , 'NEW.column' , NEW.column ) );
END IF ;
RETURN NULL ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;
CREATE TRIGGER table_after_update AFTER UPDATE ON storage.table FOR EACH ROW EXECUTE PROCEDURE sys_functions.table_update_log ();
---------------------------------------------------------
-- DELETE
CREATE OR REPLACE FUNCTION sys_functions.table_delete_log ()
RETURNS TRIGGER AS $$
BEGIN
PERFORM loc_audit_functions.make_log( ' '||'table' , 'delete' , json_build_object('id', OLD.id ) );
RETURN NULL ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;
CREATE TRIGGER table_after_delete AFTER DELETE ON storage.table FOR EACH ROW EXECUTE PROCEDURE sys_functions.table_delete_log ();fonksiyonên xizmetê
Ji bo pêkanîna karûbarên karûbar û DML-ê li ser maseyên armanc hatî çêkirin.
Şablon - fonksiyona karûbarê
--INSERT
--RETURN id OF NEW ROW
CREATE OR REPLACE FUNCTION service_functions.table_insert ( new_column store.table.column%TYPE )
RETURNS integer AS $$
DECLARE
new_id integer ;
BEGIN
-- Generate new id
new_id = nextval('store.table.seq');
-- Insert into table
INSERT INTO store.table
(
id ,
column
)
VALUES
(
new_id ,
new_column
);
RETURN new_id ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;
--DELETE
--RETURN ROW NUMBERS DELETED
CREATE OR REPLACE FUNCTION service_functions.table_delete ( current_id integer )
RETURNS integer AS $$
DECLARE
rows_count integer ;
BEGIN
DELETE FROM store.table WHERE id = current_id;
GET DIAGNOSTICS rows_count = ROW_COUNT;
RETURN rows_count ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;
-- UPDATE DETAILS
-- RETURN ROW NUMBERS UPDATED
CREATE OR REPLACE FUNCTION service_functions.table_update_column
(
current_id integer
,new_column store.table.column%TYPE
)
RETURNS integer AS $$
DECLARE
rows_count integer ;
BEGIN
UPDATE store.table
SET
column = new_column
WHERE id = current_id;
GET DIAGNOSTICS rows_count = ROW_COUNT;
RETURN rows_count ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;Fonksiyonên karsaziyê
Ji bo fonksiyonên karsaziya paşîn ên ku ji hêla xerîdar ve têne gazî kirin hatî çêkirin. Ew her gav vedigerin - JSON. Ji bo têkbirin û qeydkirina xeletiyên darvekirinê, blokê bikar bînin ÎSTÎSNA.
Şablon - fonksiyona karsaziyê
CREATE OR REPLACE FUNCTION business_functions.business_function_template(
--Input parameters
)
RETURNS JSON AS $$
DECLARE
------------------------
--for exception catching
error_message text ;
error_json json ;
result json ;
------------------------
BEGIN
--LOGGING
PERFORM loc_audit_functions.make_log
(
'business_function_template',
'STARTED',
json_build_object
(
--IN Parameters
)
);
PERFORM business_functions.notice('business_function_template');
--START BUSINESS PART
--END BUSINESS PART
-- SUCCESFULLY RESULT
PERFORM business_functions.notice('result');
PERFORM business_functions.notice(result);
PERFORM loc_audit_functions.make_log
(
'business_function_template',
'FINISHED',
json_build_object( 'result',result )
);
RETURN result ;
----------------------------------------------------------------------------------------------------------
-- EXCEPTION CATCHING
EXCEPTION
WHEN OTHERS THEN
PERFORM loc_audit_functions.make_log
(
'business_function_template',
'STARTED',
json_build_object
(
--IN Parameters
) , TRUE );
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR',
json_build_object('SQLSTATE',SQLSTATE ), TRUE
);
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR',
json_build_object('SQLERRM',SQLERRM ), TRUE
);
GET STACKED DIAGNOSTICS error_message = RETURNED_SQLSTATE ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-RETURNED_SQLSTATE',json_build_object('RETURNED_SQLSTATE',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = COLUMN_NAME ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-COLUMN_NAME',
json_build_object('COLUMN_NAME',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = CONSTRAINT_NAME ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-CONSTRAINT_NAME',
json_build_object('CONSTRAINT_NAME',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = PG_DATATYPE_NAME ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-PG_DATATYPE_NAME',
json_build_object('PG_DATATYPE_NAME',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = MESSAGE_TEXT ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-MESSAGE_TEXT',json_build_object('MESSAGE_TEXT',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = SCHEMA_NAME ;
PERFORM loc_audit_functions.make_log
(s
'business_function_template',
' ERROR-SCHEMA_NAME',json_build_object('SCHEMA_NAME',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = PG_EXCEPTION_DETAIL ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-PG_EXCEPTION_DETAIL',
json_build_object('PG_EXCEPTION_DETAIL',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = PG_EXCEPTION_HINT ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-PG_EXCEPTION_HINT',json_build_object('PG_EXCEPTION_HINT',error_message ), TRUE );
GET STACKED DIAGNOSTICS error_message = PG_EXCEPTION_CONTEXT ;
PERFORM loc_audit_functions.make_log
(
'business_function_template',
' ERROR-PG_EXCEPTION_CONTEXT',json_build_object('PG_EXCEPTION_CONTEXT',error_message ), TRUE );
RAISE WARNING 'ALARM: %' , SQLERRM ;
SELECT json_build_object
(
'isError' , TRUE ,
'errorMsg' , SQLERRM
) INTO error_json ;
RETURN error_json ;
END
$$ LANGUAGE plpgsql SECURITY DEFINER;Encam
Ji bo danasîna wêneya giştî, ez difikirim ku ew têr e. Ger kesek bi hûrgulî û encaman re eleqedar be, şîroveyan binivîsîne, ez ê kêfxweş bibim ku pêvekên din li wêneyê zêde bikim.
PS
Têketina xeletiyek hêsan - celebê parametreya têketinê
-[ RECORD 1 ]-
date_trunc | 2020-08-19 13:15:46
id | 1072
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | STARTED
jsonb_pretty | {
| "dko": {
| "id": 4,
| "type": "Type1",
| "title": "CREATED BY addKD",
| "Weight": 10,
| "Tr": "300",
| "reduction": 10,
| "isTrud": "TRUE",
| "description": "decription",
| "lowerTr": "100",
| "measurement": "measurement1",
| "methodology": "m1",
| "passportUrl": "files",
| "upperTr": "200",
| "weightingFactor": 100.123,
| "actualTrValue": null,
| "upperTrCalcNumber": "120"
| },
| "CardId": 3
| }
-[ RECORD 2 ]-
date_trunc | 2020-08-19 13:15:46
id | 1073
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR
jsonb_pretty | {
| "SQLSTATE": "22P02"
| }
-[ RECORD 3 ]-
date_trunc | 2020-08-19 13:15:46
id | 1074
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR
jsonb_pretty | {
| "SQLERRM": "invalid input syntax for type numeric: "null""
| }
-[ RECORD 4 ]-
date_trunc | 2020-08-19 13:15:46
id | 1075
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-RETURNED_SQLSTATE
jsonb_pretty | {
| "RETURNED_SQLSTATE": "22P02"
| }
-[ RECORD 5 ]-
date_trunc | 2020-08-19 13:15:46
id | 1076
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-COLUMN_NAME
jsonb_pretty | {
| "COLUMN_NAME": ""
| }
-[ RECORD 6 ]-
date_trunc | 2020-08-19 13:15:46
id | 1077
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-CONSTRAINT_NAME
jsonb_pretty | {
| "CONSTRAINT_NAME": ""
| }
-[ RECORD 7 ]-
date_trunc | 2020-08-19 13:15:46
id | 1078
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-PG_DATATYPE_NAME
jsonb_pretty | {
| "PG_DATATYPE_NAME": ""
| }
-[ RECORD 8 ]-
date_trunc | 2020-08-19 13:15:46
id | 1079
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-MESSAGE_TEXT
jsonb_pretty | {
| "MESSAGE_TEXT": "invalid input syntax for type numeric: "null""
| }
-[ RECORD 9 ]-
date_trunc | 2020-08-19 13:15:46
id | 1080
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-SCHEMA_NAME
jsonb_pretty | {
| "SCHEMA_NAME": ""
| }
-[ RECORD 10 ]-
date_trunc | 2020-08-19 13:15:46
id | 1081
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-PG_EXCEPTION_DETAIL
jsonb_pretty | {
| "PG_EXCEPTION_DETAIL": ""
| }
-[ RECORD 11 ]-
date_trunc | 2020-08-19 13:15:46
id | 1082
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-PG_EXCEPTION_HINT
jsonb_pretty | {
| "PG_EXCEPTION_HINT": ""
| }
-[ RECORD 12 ]-
date_trunc | 2020-08-19 13:15:46
id | 1083
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-PG_EXCEPTION_CONTEXT
jsonb_pretty | {
usename | emp1
log_module | addKD
log_module_hash | 0b4c1529a89af3ddf6af3821dc790e8a
status | ERROR-MESSAGE_TEXT
jsonb_pretty | {
| "MESSAGE_TEXT": "invalid input syntax for type numeric: "null""
| }
Source: www.habr.com