Whitepaper. Produkt: combit Relationship Manager. Datensatzhistorie mit dem SQL Server 2000 und combit GmbH Untere Laube Konstanz

Transkript

1 combit GmbH Untere Laube Konstanz Whitepaper Produkt: combit Relationship Manager Datensatzhistorie mit dem SQL Server 2000 und 2005

2 Datensatzhistorie mit dem SQL Server 2000 und Inhalt Erstellen einer automatischen Datensatz-Änderungshistorie 3 Einleitung 3 Einschränkungen 3 Realisierung der Ablagetabelle 3 Struktur der Tabelle UpdateTriggerResult 3 SQL Script der Tabelle UpdateTriggerResult 3 Der Trigger 4 Anlegen eines Triggers 4 Definition des Triggers 4 Notwendige Anpassungen 6

3 Datensatzhistorie mit dem SQL Server 2000 und Erstellen einer automatischen Datensatz-Änderungshistorie Einleitung Mit dem Microsoft SQL Server 2000 und 2005 haben Sie die Möglichkeit, Datensatzänderungen automatisch protokollieren zu lassen. Hierzu werden sogenannte Trigger verwendet. Ein Trigger ist eine besondere Art von gespeicherter Prozedur, die nicht direkt von einem Benutzer aufgerufen wird. Beim Erstellen des Triggers wird festgelegt, dass der Trigger auszuführen ist, wenn eine bestimmte Art von Datenänderung an einer bestimmten Tabelle oder Spalte vorgenommen wird. Einschränkungen Da der hier gezeigte Trigger auch die jeweiligen Inhalte (Alt/Neu) der betroffenen Felder protokolliert, gelten folgende Einschränkungen: Tabellen mit Feldern vom Typ text, ntext, image können nicht mit diesem Trigger überwacht werden. Er muss hierfür ein wenig angepasst werden. Lesen Sie hierzu bitte den Abschnitt Notwendige Anpassungen. Der Trigger benötigt crm oder höher! Realisierung der Ablagetabelle Zur Speicherung der Historie wird eine Tabelle in der gleichen Datenbank erstellt, in die die jeweiligen Änderungsinformationen automatisch von dem Trigger eingetragen werden. Struktur der Tabelle UpdateTriggerResult Feldname SQL Datentyp Inhalt Benutzer varchar(20) crm Benutzername Datum datetime Serverdatum + Zeit Feld varchar(64) Betroffener Feldname ID uniqueidentifier ID dieses Datensatzes RefRecordID uniqueidentifier ID des geänderten Datensatzes InhaltAlt varchar(1000) Inhalt vor der Änderung InhaltNeu varchar(1000) Inhalt nach der Änderung SQL Script der Tabelle UpdateTriggerResult CREATE TABLE [dbo].[updatetriggerresult] ( [Benutzer] [varchar] (20) COLLATE Latin1_General_CI_AS NOT NULL, [Datum] [datetime] NOT NULL, [Feld] [varchar] (64) COLLATE Latin1_General_CI_AS NOT NULL, [ID] uniqueidentifier ROWGUIDCOL NOT NULL, [RefRecordID] [uniqueidentifier] NOT NULL, [InhaltAlt] [varchar] (1000) COLLATE Latin1_General_CI_AS NULL, [InhaltNeu] [varchar] (1000) COLLATE Latin1_General_CI_AS NULL ) ON [PRIMARY] GO

4 Datensatzhistorie mit dem SQL Server 2000 und Der Trigger Anlegen eines Triggers Im Enterprise Manager des SQL Servers haben Sie die Möglichkeit, für eine bestimmte Tabelle einen Trigger zu erstellen. Wechseln Sie hierzu über Tabelle bearbeiten in den Eigenschaftsdialog der Tabelle. Hier haben Sie über das Kontextmenü Aufgabe > Trigger verwalten Zugriff auf einen weiteren Konfigurationsdialog: Definition des Triggers Der hier gezeigte Trigger fügt für jede Feldänderung einen neuen Datensatz in der Tabelle UpdateTriggerResult an. /* This trigger records the history of field changes */ CREATE TRIGGER [UpdateHistory] ON [dbo].[crm] FOR UPDATE AS nvarchar(200),

5 Datensatzhistorie mit dem SQL Server 2000 und uniqueidentifier -- make sure this variable has the right type -- set the current tablename here = 'CRM' = = max(ordinal_position) from INFORMATION_SCHEMA.COLUMNS where TABLE_NAME = getdate() -- get current primary key -> make sure the variable has the right type = [RECORDID] from deleted -- create temporary tables select * into #del FROM deleted select * into #ins FROM inserted -- get the current crm Login name (needs V or above!) = case PATINDEX('%@combit%', "program_name") when 0 then 'UNKNOWN' else LEFT("program_name", PATINDEX('%@combit%', "program_name")-1) end FROM master..sysprocesses AS p WHERE p.spid IS NULL = '' -- iterate all changed fields begin = min(ordinal_position) from INFORMATION_SCHEMA.COLUMNS where TABLE_NAME and ORDINAL_POSITION = (@field - 1 )% = power(2,@bit - 1) = ((@field - 1) / 8) + 1 if substring(columns_updated(),@char, 1) > 0 begin = COLUMN_NAME from INFORMATION_SCHEMA.COLUMNS where TABLE_NAME and ORDINAL_POSITION -- get the new content of that field = = ' + N' FROM #ins' EXEC N'@ContentsNew varchar(1000) OUTPUT -- get the old content of that field = = ' + N' FROM #del' EXEC N'@ContentsOld varchar(1000) OUTPUT -- save the change information INSERT INTO UpdateTriggerResult

6 Datensatzhistorie mit dem SQL Server 2000 und (Benutzer, Datum, Feld, RefRecordID, InhaltAlt, InhaltNeu) @ContentsNew) end end Notwendige Anpassungen Damit der Trigger auch mit Ihren Tabellen funktioniert, sind einige Anpassungen notwendig: 1. Sollte der Datentyp Ihres Primärschlüssels anders sein, so passen Sie dies bitte in folgender Zeile uniqueidentifier 2. Anpassung des Feldnamens für den Primärschlüssel = [RECORDID] from deleted 3. Anpassung des Tabellennamens = 'CRM' 4. Wenn Sie die Inhalte der Felder nicht protokollieren möchten, oder den Trigger in einer Tabelle mit text, ntext und image Feldern verwenden wollen, löschen Sie bitte folgende Zeilen: select * into #del FROM deleted select * into #ins FROM inserted und = = ' + N' FROM #ins' EXEC N'@ContentsNew varchar(1000) OUTPUT = = ' + N' FROM #del' EXEC N'@ContentsOld varchar(1000) OUTPUT Hinweis: combit macht keine Angaben zu einer bestimmten Eignung obiger Informationen. Irrtümer und Fehler bleiben ausdrücklich vorbehalten, die Angaben erfolgen ohne Gewähr und enthalten keine Zusicherung. Die Informationen können z.t. auch ein Versuch sein, Ihnen bei einer Aufgabenstellung zu helfen, selbst wenn das Produkt eigentlich nicht für diesen speziellen Zweck vorgesehen wurde.