Studju dwar l-implimentazzjoni tal-loġika tan-negozju fil-livell tal-funzjonijiet maħżuna PostgreSQL

L-impetu għall-kitba ta’ dan l-iskeċċ kien l-artiklu "Matul il-kwarantina, l-ammont ta 'xogħol żdied 5 darbiet, iżda konna lesti." Kif Lingualeo mar għal PostgreSQL bi 23 miljun utent. Sibt ukoll l-artiklu ppubblikat 4 snin ilu interessanti - L-implimentazzjoni tal-loġika tan-negozju fil-MySQL.

Deher interessanti li l-istess ħsieb - "timplimenta loġika tan-negozju fid-database".

Studju dwar l-implimentazzjoni tal-loġika tan-negozju fil-livell tal-funzjonijiet maħżuna PostgreSQL

Ma kontx jien biss li ġejt f’moħħi.

Ukoll, għall-futur, ridt nippreserva, l-ewwelnett, għalija nnifsi, żviluppi interessanti li qamu waqt l-implimentazzjoni. Speċjalment meta wieħed iqis li relattivament reċentement ittieħdet deċiżjoni strateġika biex tinbidel l-arkitettura u tittrasferixxi l-loġika tan-negozju għal-livell backend. Sabiex dak kollu li ġie żviluppat dalwaqt ma jkun ta’ ebda użu għal ħadd u ma jkun ta’ interess għal ħadd.

Il-metodi deskritti mhumiex xi tip ta 'skoperta jew eċċezzjonali. taf kif, kollox huwa klassiku u ġie implimentat diversi drabi (per eżempju, użajt approċċ simili 20 sena ilu fuq Oracle).Ddeċidejt biss li niġbor kollox f'post wieħed. Fil-każ li tiġi utli għal xi ħadd. Kif wriet il-prattika, ħafna drabi l-istess idea tiġi lil nies differenti b'mod indipendenti. U huwa utli li żżommha għalik innifsek bħala tifkira.

Naturalment, xejn f'din id-dinja mhu perfett, żbalji u typos sfortunatament huma possibbli. Il-kritika u l-kummenti huma milqugħa u mistennija bil-qawwa U dettall żgħir ieħor - dettalji speċifiċi tal-implimentazzjoni jitħallew barra. Xorta waħda, kollox għadu jintuża fi proġett ta 'ħidma reali. Allura, l-artiklu huwa biss skeċċ u deskrizzjoni tal-kunċett ġenerali, xejn aktar. Nispera li jkun hemm biżżejjed dettalji biex tifhem l-istampa ġenerali.

L-idea ġenerali hija "taqsam u tirbaħ, aħbi u stess"

L-idea hija klassika - skema separata għat-tabelli, skema separata għall-funzjonijiet maħżuna.
Il-klijent m'għandux aċċess għad-data direttament. Kull ma jista 'jagħmel il-klijent huwa li jsejjaħ il-funzjoni maħżuna u jipproċessa r-rispons riċevut.

Rwoli

CREATE ROLE store;

CREATE ROLE sys_functions;

CREATE ROLE loc_audit_functions;

CREATE ROLE service_functions;

CREATE ROLE business_functions;

Skemi

Skema tal-ħażna tal-mejda

Tabelli ta' mira li jimplimentaw entitajiet suġġetti.

CREATE SCHEMA store AUTHORIZATION store ;

Dijagramma tal-funzjoni tas-sistema

Funzjonijiet tas-sistema, b'mod partikolari għall-illoggjar tal-bidliet fit-tabella.

CREATE SCHEMA sys_functions AUTHORIZATION sys_functions ;

Skema ta' verifika lokali

Funzjonijiet u tabelli biex jimplimentaw verifika lokali tal-eżekuzzjoni ta 'funzjonijiet maħżuna u bidliet fit-tabelli fil-mira.

CREATE SCHEMA loc_audit_functions AUTHORIZATION loc_audit_functions;

Dijagramma tal-funzjoni tas-servizz

Funzjonijiet għal funzjonijiet ta' servizz u DML.

CREATE SCHEMA service_functions AUTHORIZATION service_functions;

Dijagramma tal-funzjoni tan-negozju

Funzjonijiet għall-funzjonijiet finali tan-negozju msejħa mill-klijent.

CREATE SCHEMA business_functions AUTHORIZATION business_functions;

Drittijiet ta 'aċċess

Rwol - DBA għandu aċċess sħiħ għall-iskemi kollha (separati mir-rwol ta' Sid tad-DB).

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;

Rwol - UTENT għandu l-privileġġ EŻEKUTTA fid-dijagramma funzjonijiet_negozju.

CREATE ROLE user_role;

Privileġġi bejn skemi

GĦOTJA
Peress li l-funzjonijiet kollha huma maħluqa bl-attribut DEFINITUR TA' SIGURTÀ istruzzjonijiet meħtieġa REVOKE EXECUTE FUQ IL-FUNZJONI KOLLHA... MILL-pubbliku;

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 ;

Allura l-iskema tad-database hija lesta. Tista' tibda timla d-dejta.

Tabelli tal-mira

Il-ħolqien ta' tabelli huwa trivjali. Ebda karatteristiċi speċjali, ħlief li ġie deċiż li ma tużax SERJAL u jiġġeneraw sekwenzi b'mod espliċitu. Barra minn hekk, ovvjament, użu massimu ta 'struzzjonijiet

COMMENT ON ...

Kummenti għal Kollha oġġetti, mingħajr eċċezzjoni.

Verifika lokali

Biex tilloggja l-eżekuzzjoni tal-funzjonijiet maħżuna u l-bidliet fit-tabelli fil-mira, tintuża tabella tal-verifika lokali, li tinkludi, fost affarijiet oħra, dettalji tal-konnessjoni tal-klijent, it-tikketta tal-modulu msejjaħ, u l-valuri attwali tal-input u parametri tal-output fil-forma ta 'JSON.

Funzjonijiet tas-sistema

Iddisinjat għall-illoggjar tal-bidliet fit-tabelli fil-mira. Huma funzjonijiet grillu.

Mudell - funzjoni tas-sistema

---------------------------------------------------------
-- 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 ();

Funzjonijiet ta' servizz

Iddisinjat biex jimplimenta operazzjonijiet ta 'servizz u DML fuq tabelli fil-mira.

Mudell - funzjoni tas-servizz

--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;

Funzjonijiet tan-negozju

Iddisinjat għal funzjonijiet kummerċjali finali msejħa mill-klijent. Dejjem jirritornaw - JSON. Biex tinterċetta u tilloggja l-iżbalji ta' eżekuzzjoni, uża l-blokk EĊĊEZZJONI.

Mudell - funzjoni tan-negozju

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;

Total

Biex tiddeskrivi l-istampa ġenerali, naħseb li huwa pjuttost biżżejjed. Jekk xi ħadd hu interessat fid-dettalji u r-riżultati, ikteb kummenti, inkun kuntent li nżid aktar kuntatti mal-istampa.

PS

Logging żball sempliċi - tip ta 'parametru ta' input

-[ 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""
                | }

Sors: www.habr.com

Żid kumment