/PLSQLcodeHash

Primary LanguagePLSQL

PLSQLcodeHash (get_CodeHash4Cmp)

Motivation

Changes to PL/SQL programs can be recognized using the source code timestamp in the repository.

However, it is not clear whether effective PL/SQL code or only comments, white spaces or lower/upper case tokens were changed.

The function get_CodeHash4Cmp determines the hash code of the effective PL/SQL database stored code without white spaces, comments or changed lower/upper case tokens, so that proof of real code changes is possible by means of hash code comparison.

The program was deliberately programmed simply and transparently with GOTO’s in order to enable possible extensions without side effects.

Quick Start

After saving the get_CodeHash4Cmp function, the following application steps are possible:

select get_CodeHash4Cmp('<stored-code-name>') from dual;

You will get the SHA384 code hash so you can save it for later comparison:

select get_CodeHash4Cmp('<stored-code-name>', '<PLSQL-code-hash-to-compare>') from dual;

Example:

  • Step 1: Save the example procedure prc_example into the database:

create or replace procedure prc_example(p_x VARCHAR2) is
  /*
    This is a PL/SQL code demo for code hashing.
    F.Matz : 2020-10-19
    --
  */
  l_y NUMBER;
begin
  -- get PI --
  l_y := acos(-1);
  dbms_output.put_line(l_y);
end prc_example;

  • Step 2: Get the PL/SQL code hash from this prc_example and store it:

select get_codehash4cmp('PRC_EXAMPLE') from dual;

E030996282B21D2083F518741C49531ED528F3D6FA04E56726BA7ACCC27E2718BDAEA4946DB936E524B78F7FEC78673A

  • Step 3: Copy & paste the example prc_example changes into the database:

create or replace PROCEDURE Prc_Example(p_x VARCHAR2) IS

  /*
    This is a PL/SQL code demo for code hashing.
    F.Matz : 2020-10-19
    -- comment changed ! 
  */
  
  l_y NUMBER;
  
BEGIN
  
  -- get PI --
  -- new comment ... --
  l_y := Acos(-1);
  dbms_output.put_line(l_y);
  
END Prc_Example;

  • Step 4: Compare the actual PL/SQL code hash with the stored from the prc_example above:

select get_codehash4cmp('PRC_EXAMPLE_CHANGED', 'E030996282B21D2083F518741C49531ED528F3D6FA04E56726BA7ACCC27E2718BDAEA4946DB936E524B78F7FEC78673A') from dual;

=> PRC_EXAMPLE : OK'

Result: No PL/SQL code changes were detected, right!

That's all.