Пример использования Qbim для тестового объекта

Установка расширения

create extension qbim cascade;

Создание тестового объекта

create table test (
	id bigserial not null,
	sd timestamp not null default current_timestamp,
	ed timestamp not null default 'infinity'::timestamp,
	name text not null,
	state bigint not null,
	val bigint not null,
	dsc text not null,
	constraint cls_id_sd_ed_excl exclude using gist (id with =, tsrange(sd, ed) with &&) where ((sd <> ed))
);
create index test_id_sd_ed_excl on test using gist (id, tsrange(sd, ed)) where (sd <> ed);

comment on table test is 'Тестовый объект'; 
comment on column test.id is 'Идентификатор';
comment on column test.sd is 'Время начала действия версии';
comment on column test.ed is 'Время окончания действия версии';
comment on column test.name is 'Имя тестового экземпляра объекта';
comment on column test.state is 'Состояние экземпляра (CLS#3)';
comment on column test.val is 'Некоторое значение';
comment on column test.dsc is 'Описание';

Описание в таблицах описания объектов

select qbim_describe_object(i_table_name => 'test'::text, i_obj_id => null::bigint);

Примечание
Если в качестве параметра i_obj_id передаётся конкретное значение, нужно обновить значение последовательности obj_id_seq для предотвращения конфликтов на уникальность идентификатора.

Например,

select qbim_describe_object(i_table_name => 'test'::text, i_obj_id => 73::bigint);

select setval('obj_id_seq',73);

где 73 в данном примере - максимальный id таблице obj.

Создание реализации объекта

Примечание
Здесь и далее при вызове интерфейсных методов указывается случайный идентификатор пользователя '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid, который используется при регистрации действия.

select qbim_create(1::bigint,null::text,null::bigint,
  '-infinity'::timestamp,null::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'name','Test record'::text,
  'state',1::bigint,
  'val',5::bigint
);

Изменение объекта — создание версий

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:30.0'::timestamp,null::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'state',2::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:36:30.0'::timestamp,null::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'state',3::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:30.0'::timestamp,'2021-03-30 13:36:00.0'::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'val',6::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:20.0'::timestamp,'2021-03-30 13:36:15.0'::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'val',7::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:36:00.0'::timestamp,null::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'val',9::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:20.0'::timestamp,'2021-03-30 13:36:15.0'::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'val',10::bigint,
  'state', 6::bigint
);

select qbim_change(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:20.0'::timestamp,'2021-03-30 13:36:30.0'::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid,
  'val',11::bigint,
  'state', 7::bigint
);

Выборка, просмотр версий

Можно запускать на разных этапах изменения объекта.

Запрос версии «на момент времени»

select * from test
where '2021-03-30 13:35:45.0'::timestamp <@ tsrange(sd,ed)
order by id, sd, ed;

Запрос всех версий, кроме «схлопнувшихся»

select * from test where sd<>ed
order by id, sd, ed;

Запрос всех версий

select * from test
order by id, sd, ed;

Закрытие версии

select qbim_close(1::bigint,null::text,1::bigint,
  '2021-03-30 13:35:15.0'::timestamp,
  '463404e8-ee5d-4597-b9a9-e3b69e29d18a'::uuid
);

Регистрация действий

select
    r_object, lnk_dt, fct_dt, action, pid, userid
from action;
r_objectlnk_dtfct_dtactionpiduserid
1:1-infinity2021-05-05 11:47:43.95759512522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:1-infinity2021-05-05 11:48:08.11745932522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:08.11764922522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:09.59536332522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:302021-05-05 11:48:09.59645722522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:1-infinity2021-05-05 11:48:10.98879932522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:10.98905332522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:10.98926422522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:1-infinity2021-05-05 11:48:12.51561132522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:12.51667932522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:002021-05-05 11:48:12.51769232522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:202021-05-05 11:48:12.51882922522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:12.51975522522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:15.09410332522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:152021-05-05 11:48:15.09430232522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:302021-05-05 11:48:15.09448932522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:002021-05-05 11:48:15.09466322522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:302021-05-05 11:48:15.09482922522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:1-infinity2021-05-05 11:48:17.11089132522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:202021-05-05 11:48:17.11109432522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:302021-05-05 11:48:17.11128632522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:002021-05-05 11:48:17.11147632522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:202021-05-05 11:48:17.11169222522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:1-infinity2021-05-05 11:48:19.3658432522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:202021-05-05 11:48:19.36607732522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:36:152021-05-05 11:48:19.36626532522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:202021-05-05 11:48:19.36644322522463404e8-ee5d-4597-b9a9-e3b69e29d18a
1:12021-03-30 13:35:152021-05-05 11:51:57.07987842522463404e8-ee5d-4597-b9a9-e3b69e29d18a

Значения полей описаны в разделе Описание версионируемых таблиц.

Примечание
Поля fct_dt и pid могут отличаться; в данной таблице они приведены как пример.

Copyright © KVANTOM LLC, 2019-2024