vérifier le statut d’une opération de compression

Résumé

Il est recommandé d’effectuer régulièrement une compression pour garantir l’intégrité de la géodatabase versionnée. Cette opération supprime les états qui ne sont plus référencés par une version et déplace des enregistrements des tables de deltas vers leurs tables métier correspondantes. La fréquence de modification des données a une incidence sur la durée de l’opération de compression. Lors de la sortie des utilitaires 10.3 et 10.2.1 et du correctif 1 Telco, un journal supplémentaire sur la compression a été prévu pour présenter le déroulement complet de la procédure.

Procédure

1. Créez la table COMPRESS_LOG, si elle n’existe pas déjà. Cette table est générée automatiquement au moment de la première exécution de l’opération de compression.
2. Créez une table d’audit de compression pour y insérer des enregistrements dès modification de la colonne COMPRESS_STATUS dans la table COMPRESS_LOG.
3. Créez un déclencheur pour la table COMPRESS_LOG afin de capturer les modifications apportées aux colonnes COMPRESS_STATUS et les reporter dans la table d’audit de compression.

   • Pour une géodatabase Oracle :

     CREATE TABLE SDE.COMPRESS_LOG
        (    "SDE_ID" NUMBER(*,0) NOT NULL ENABLE,
             "SERVER_ID" NUMBER(*,0) NOT NULL ENABLE,
             "DIRECT_CONNECT" VARCHAR2(1) NOT NULL ENABLE,
             "COMPRESS_START" DATE NOT NULL ENABLE,
             "START_STATE_COUNT" NUMBER(*,0) NOT NULL ENABLE,
             "COMPRESS_END" DATE,
             "END_STATE_COUNT" NUMBER(*,0),
             "COMPRESS_STATUS" VARCHAR2(20)
        )
       PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255 NOCOMPRESS LOGGING
       STORAGE(INITIAL 131072 NEXT 131072 MINEXTENTS 1 MAXEXTENTS 2147483645
       PCTINCREASE 0 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT FLASH_CACHE 
       DEFAULT CELL_FLASH_CACHE DEFAULT)
       TABLESPACE SDE;
     
     CREATE TABLE SDE.COMPRESS_LOG_TRACKER_TAB
     (SDE_ID NUMBER(*,0),
      SERVER_ID NUMBER(*,0),  
      LOG_DATE DATE,
      COMPRESS_END DATE,
      COMPRESS_STATUS VARCHAR2(20),
      START_STATE_COUNT NUMBER(*,0),
      END_STATE_COUNT NUMBER(*,0))
       PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255 NOCOMPRESS LOGGING
       STORAGE(INITIAL 131072 NEXT 131072 MINEXTENTS 1 MAXEXTENTS 2147483645
       PCTINCREASE 0 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT FLASH_CACHE 
       DEFAULT CELL_FLASH_CACHE DEFAULT)
       TABLESPACE SDE;
     
     
     CREATE OR REPLACE TRIGGER SDE.COMPRESS_LOG_TRACKER_TRIG
     AFTER INSERT OR UPDATE 
        OF COMPRESS_STATUS
        ON SDE.COMPRESS_LOG
        REFERENCING NEW AS new
        FOR EACH ROW
     DECLARE
       BEGIN
        INSERT INTO SDE.COMPRESS_LOG_TRACKER_TAB (SDE_ID, SERVER_ID, LOG_DATE, COMPRESS_END, COMPRESS_STATUS, START_STATE_COUNT, END_STATE_COUNT)
        VALUES (:new.SDE_ID, :new.SERVER_ID, sysdate, :new.COMPRESS_END, :new.COMPRESS_STATUS, :new.START_STATE_COUNT, :new.END_STATE_COUNT);
       EXCEPTION
         WHEN OTHERS THEN
             RAISE;
     END;
     /
     
      Interrogez la table de suivi de la compression :
     
     SQL> select * from sde.compress_log_tracker_tab;
     
         SDE_ID  SERVER_ID LOG_DATE                 COMPRESS_END             COMPRESS_STATUS      START_STATE_COUNT END_STATE_COUNT
     ---------- ---------- ------------------------ ------------------------ -------------------- ----------------- ---------------
             51       5896 Tue 07-Jul-2015 10:55:16                          IN PROGRESS                         15
             51       5896 Tue 07-Jul-2015 10:55:16                          DELETE LEAF STATES                  15              15
             51       5896 Tue 07-Jul-2015 10:55:17                          TRIMMING                            15              13
             51       5896 Tue 07-Jul-2015 10:55:17                          MOVE TO BASE                        15              13
             51       5896 Tue 07-Jul-2015 10:55:17 Tue 07-Jul-2015 10:55:17 SUCCESS                             15               1
     
     5 rows selected.

   • Pour une géodatabase SQL Server :

     CREATE TABLE [sde].[SDE_compress_log](
     	[compress_id] [int] IDENTITY(1,1) NOT NULL,
     	[sde_id] [int] NOT NULL,
     	[server_id] [int] NOT NULL,
     	[direct_connect] [varchar](1) NOT NULL,
     	[compress_start] [datetime] NOT NULL,
     	[start_state_count] [int] NOT NULL,
     	[compress_end] [datetime] NULL,
     	[end_state_count] [int] NULL,
     	[compress_status] [varchar](20) NULL,
      CONSTRAINT [compress_log_pk] PRIMARY KEY CLUSTERED 
     (
     	[compress_id] ASC
     )WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
     ) ON [PRIMARY]
     
     GO
     
     
     CREATE TABLE [sde].[SDE_COMPRESS_LOG_TRACKER_TAB]
     (
        [SDE_ID] int  NULL,
        [SERVER_ID] int  NULL,
        [LOG_DATE] datetime  NULL,
        [COMPRESS_END] [datetime],
        [COMPRESS_STATUS] varchar(20),
        [START_STATE_COUNT] [int],
        [END_STATE_COUNT] [int]
     )
     GO
     
     
     CREATE TRIGGER sde.SDE_COMPRESS_LOG_TRACKER_TRIG
        ON sde.SDE_COMPRESS_LOG
         AFTER INSERT, UPDATE
           AS 
              BEGIN
                 SET  NOCOUNT  ON
                 /* column variables declaration*/
                 DECLARE
                    @new$SDE_ID int, 
                    @new$SERVER_ID int, 
                    @new$LOG_DATE datetime,
                    @new$COMPRESS_END datetime,
                    @new$COMPRESS_STATUS varchar(20),
                    @new$START_STATE_COUNT int,
                    @new$END_STATE_COUNT int
                 DECLARE
                     ForEachInsertedRowTriggerCursor CURSOR LOCAL FORWARD_ONLY READ_ONLY FOR 
                       SELECT SDE_ID, SERVER_ID, sysdatetime(), COMPRESS_END, COMPRESS_STATUS, START_STATE_COUNT, END_STATE_COUNT
                       FROM inserted
                 OPEN ForEachInsertedRowTriggerCursor
                 FETCH ForEachInsertedRowTriggerCursor
                     INTO @new$SDE_ID, @new$SERVER_ID, @new$LOG_DATE, @new$COMPRESS_END, @new$COMPRESS_STATUS, @new$START_STATE_COUNT, @new$END_STATE_COUNT
                 WHILE @@fetch_status = 0           
                    BEGIN
                       /* trigger implementation: begin*/
                       BEGIN
                          IF (UPDATE(COMPRESS_STATUS))
                             BEGIN
     
                                 INSERT sde.SDE_COMPRESS_LOG_TRACKER_TAB(SDE_ID, SERVER_ID, LOG_DATE, COMPRESS_END, COMPRESS_STATUS, START_STATE_COUNT, END_STATE_COUNT)
                                 VALUES (@new$SDE_ID, @new$SERVER_ID, sysdatetime(), @new$COMPRESS_END, @new$COMPRESS_STATUS, @new$START_STATE_COUNT, @new$END_STATE_COUNT)
                             END
                       END
                       /* trigger implementation: end*/
                       FETCH ForEachInsertedRowTriggerCursor
                           INTO @new$SDE_ID, @new$SERVER_ID, @new$LOG_DATE, @new$COMPRESS_END, @new$COMPRESS_STATUS, @new$START_STATE_COUNT, @new$END_STATE_COUNT
                    END
                 CLOSE ForEachInsertedRowTriggerCursor
                 DEALLOCATE ForEachInsertedRowTriggerCursor
              END
     GO
     
     
      Interrogez la table de suivi de la compression :
     
     select * from sde.SDE_COMPRESS_LOG_TRACKER_TAB
     go
     
     SDE_ID      SERVER_ID   LOG_DATE                COMPRESS_END            COMPRESS_STATUS      START_STATE_COUNT END_STATE_COUNT
     
     ----------- ----------- ----------------------- ----------------------- -------------------- ----------------- ---------------
            3035        9016 2015-07-02 12:36:07.690                    NULL IN PROGRESS                       8154            NULL
            3035        9016 2015-07-02 12:36:07.720                    NULL DELETE LEAF STATES                8154            8154
            3035        9016 2015-07-02 12:52:03.113                    NULL TRIMMING                          8154            6308
            3035        9016 2015-07-02 12:53:44.770                   NULL MOVE TO BASE                      8154            6306
            3035        9016 2015-07-02 12:56:12.637 2015-07-02 12:56:12.623 SUCCESS                           8154            6094
     
     (5 rows affected)

     Remarque :
     Si la géodatabase d’entreprise SQL Server est gérée par un utilisateur DBO (et non SDE), changez le propriétaire des tables et passez de SDE à DBO pour déclencher l’opération.

   • Description de chacune des opérations COMPRESS_STATUS :

     • IN PROGRESS : indique que l’opération de compression a commencé
     • DELETE LEAF STATES : supprime tous les états qui ne participent pas à la généalogie d’une version
     • TRIMMING : réduit les généalogies candidates d’états en un état
     • MOVE TO BASE : déplace des lignes de tables de deltas dans les tables de base (métier) - sauf si cette opération est bloquée par une autre version
     • SUCCESS : indique que l’opération de compression a réussi