Umbenennen der Analyseberichtsdatenbank führt zu Fehler bei Berichten

By | 26. Oktober 2015

Immer mal wieder kommt es zu der Anforderung, dass die von SharePoint genutzten Datenbanken umbenannt werden müssen (Vereinheitlichung, neues Namensschema, etc.). Dabei müssen auch unter Umständen die Datenbanken von der Suchdienstanwendung angepasst werden. Interessant wird das Ganze, wenn die Datenbanken wirklich nur umbenannt werden sollen und nicht gleichzeitig eine Verschiebung auf einen anderen Server stattfindet. Hierfür gibt es auch eine wunderbare Anleitung von Bill Bär. Allerdings gibt es dabei ein kleines Problem bei der Analyseberichtsdatenbank. Nach dem Umbenennen der Analyseberichtsdatenbank können plötzlich keine Berichte mehr geöffnet werden. Der Versuch wird mit folgendem Fehler im ULS Log quittiert:

A database range mapping cannot be found for composite key: 2B-85-37-0C-D0-34-8E-41-91-C6-2A-C2-5A-F4-BE-5B-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00

Diese Fehlermeldung ist im ersten Schritt nicht sehr aussagekräftig und gibt keinen Hinweis auf das ursächliche Problem. Deshalb sollte man zuerst prüfen, ob die Analyseberichte generell überhaupt auf vorhandene Daten zugreifen können. Wie man das tun kann, habe ich bereits in einem Blogbeitrag geschrieben. Funktioniert das Sammeln und Weiterverarbeiten der Daten, sollte man sich einmal näher anzuschauen, was beim Umbenennen der Analyseberichtsdatenbank genau passiert. Das Umbenennen der Analyseberichtsdatenbank wird folgendermaßen durchgeführt:

$SearchService = Get-SPEnterpriseSearchServiceApplication <SearchServiceApplicationName> 
Add-SPServerScaleOutDatabase -ServiceApplication $SearchService -DatabaseServer <Original Server Name> [-DatabaseName <New Database Name>] 
$temp = Get-SPServerScaleOutDatabase -ServiceApplication $SearchService 
Remove-SPServerScaleOutDatabase -Database $temp[0] -ServiceApplication $SearchService

Durch den Befehl Add-SPServerScaleOutDatabase wird eine neue Analyseberichtsdatenbank hinzugefügt und dann die bereits bestehende Datenbank gelöscht. Und vergleicht man die neu erstellte Datenbank mit einem „funktionierenden“ Pendant, gibt es zwei entscheidende Unterschiede. Es fehlen zwei Einträge für die grundsätzliche Konfiguration, die durch den Befehl Add-SPServerScaleOutDatabase anscheinend nicht von der bestehenden Datenbank kopiert bzw. neu erstellt werden. Sieht man sich die fehlenden Einträge an, macht auch plötzlich die Fehlermeldung im ULS Log Sinn.

Sehen wir uns zuerst einmal die Tabelle TenantSettings an:

Umbenennen der Analyseberichtsdatenbank

Bei einer funktionierenden Analyseberichtsdatenbank findet sich hier genau ein Eintrag. Und die PartitionId ist genau der Wert, der laut ULS Log Fehler nicht gefunden wird. Bei der neuen Datenbank ist diese Tabelle leer. Zum Glück sind die Werte nicht dynamisch, sondern sind bei jeder SharePoint Farm identisch. Deshalb kann man den fehlenden Eintrag auch manuell wieder hinzufügen:

USE [Search Service_AnalyticsReportingDB]
GO

INSERT INTO [dbo].[TenantSettings]
           ([PartitionId]
           ,[EventTypeDefinitions]
           ,[Options]
           ,[Filters]
           ,[LastUpdateTime]
           ,[Version])
     VALUES
           (0x2B85370CD0348E4191C62AC25AF4BE5B00000000000000000000000000000000
           ,0x0001000000FFFFFFFF01000000000000000C020000006F4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D3731653962636531313165393432396305010000004F4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E436F6C6C656374696F6E02000000095F74656E616E744964185F6576656E7454797065446566696E6974696F6E4C69737403030B53797374656D2E47756964BD0253797374656D2E436F6C6C656374696F6E732E47656E657269632E44696374696F6E61727960325B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D2C5B4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E2C204D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D373165396263653131316539343239635D5D0200000004FDFFFFFF0B53797374656D2E477569640B000000025F61025F62025F63025F64025F65025F66025F67025F68025F69025F6A025F6B000000000000000000000008070702020202020202020000000000000000000000000000000009040000000404000000BD0253797374656D2E436F6C6C656374696F6E732E47656E657269632E44696374696F6E61727960325B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D2C5B4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E2C204D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D373165396263653131316539343239635D5D040000000756657273696F6E08436F6D7061726572084861736853697A650D4B657956616C756550616972730003000308910153797374656D2E436F6C6C656374696F6E732E47656E657269632E47656E65726963457175616C697479436F6D706172657260315B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D5D08C10253797374656D2E436F6C6C656374696F6E732E47656E657269632E4B657956616C75655061697260325B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D2C5B4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E2C204D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D373165396263653131316539343239635D5D5B5D0B00000009050000001100000009060000000405000000910153797374656D2E436F6C6C656374696F6E732E47656E657269632E47656E65726963457175616C697479436F6D706172657260315B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D5D00000000070600000000010000000B00000003BF0253797374656D2E436F6C6C656374696F6E732E47656E657269632E4B657956616C75655061697260325B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D2C5B4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E2C204D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D373165396263653131316539343239635D5D04F9FFFFFFBF0253797374656D2E436F6C6C656374696F6E732E47656E657269632E4B657956616C75655061697260325B5B53797374656D2E496E7433322C206D73636F726C69622C2056657273696F6E3D342E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D623737613563353631393334653038395D2C5B4D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E2C204D6963726F736F66742E4F66666963652E5365727665722E5365617263682E4170706C69636174696F6E732C2056657273696F6E3D31352E302E302E302C2043756C747572653D6E65757472616C2C205075626C69634B6579546F6B656E3D373165396263653131316539343239635D5D02000000036B65790576616C7565000408454D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E0200000001000000090800000001F7FFFFFFF9FFFFFF02000000090A00000001F5FFFFFFF9FFFFFF03000000090C00000001F3FFFFFFF9FFFFFF04000000090E00000001F1FFFFFFF9FFFFFF00020000091000000001EFFFFFFFF9FFFFFF01020000091200000001EDFFFFFFF9FFFFFF02020000091400000001EBFFFFFFF9FFFFFF03020000091600000001E9FFFFFFF9FFFFFF04020000091800000001E7FFFFFFF9FFFFFF05020000091A00000001E5FFFFFFF9FFFFFF06020000091C0000000508000000454D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E416E616C79746963734576656E7454797065446566696E6974696F6E0C000000095F74656E616E7449640C5F6576656E745479706549640A5F636F756E7454797065085F726F6C6C7570730D5F7461696C5472696D6D696E67085F6F7074696F6E730A5F726563576569676874105F72656C6576616E6365576569676874195F726563656E74506F70756C6172697479496E74657276616C0A5F6576656E744E616D65085F6170704E616D65125F637573746F6D4576656E745479706549640300040400040000000101030B53797374656D2E4775696408374D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E74436F756E745479706502000000354D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E74526F6C6C7570730200000008354D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E744F7074696F6E73020000000808080B53797374656D2E477569640200000001E3FFFFFFFDFFFFFF000000000000000000000000000000000100000005E2FFFFFF374D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E74436F756E7454797065010000000776616C75655F5F0008020000000300000005E1FFFFFF354D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E74526F6C6C757073010000000776616C75655F5F000802000000070000000200000005E0FFFFFF354D6963726F736F66742E4F66666963652E5365727665722E5365617263682E416E616C79746963732E4576656E744F7074696F6E73010000000776616C75655F5F0008020000000200000001000000010000000E0000000A0A01DFFFFFFFFDFFFFFF00000000000000000000000000000000010A0000000800000001DEFFFFFFFDFFFFFF000000000000000000000000000000000200000001DDFFFFFFE2FFFFFF0100000001DCFFFFFFE1FFFFFF070000000200000001DBFFFFFFE0FFFFFF0000000000000000010000000E0000000A0A01DAFFFFFFFDFFFFFF00000000000000000000000000000000010C0000000800000001D9FFFFFFFDFFFFFF000000000000000000000000000000000300000001D8FFFFFFE2FFFFFF0100000001D7FFFFFFE1FFFFFF070000000200000001D6FFFFFFE0FFFFFF0000000000000000010000000E0000000A0A01D5FFFFFFFDFFFFFF00000000000000000000000000000000010E0000000800000001D4FFFFFFFDFFFFFF000000000000000000000000000000000400000001D3FFFFFFE2FFFFFF0100000001D2FFFFFFE1FFFFFF070000000200000001D1FFFFFFE0FFFFFF0000000000000000010000000E0000000A0A01D0FFFFFFFDFFFFFF0000000000000000000000000000000001100000000800000001CFFFFFFFFDFFFFFF000000000000000000000000000000000002000001CEFFFFFFE2FFFFFF0100000001CDFFFFFFE1FFFFFF070000000000000001CCFFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01CBFFFFFFFDFFFFFF0000000000000000000000000000000001120000000800000001CAFFFFFFFDFFFFFF000000000000000000000000000000000102000001C9FFFFFFE2FFFFFF0100000001C8FFFFFFE1FFFFFF070000000000000001C7FFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01C6FFFFFFFDFFFFFF0000000000000000000000000000000001140000000800000001C5FFFFFFFDFFFFFF000000000000000000000000000000000202000001C4FFFFFFE2FFFFFF0300000001C3FFFFFFE1FFFFFF070000000000000001C2FFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01C1FFFFFFFDFFFFFF0000000000000000000000000000000001160000000800000001C0FFFFFFFDFFFFFF000000000000000000000000000000000302000001BFFFFFFFE2FFFFFF0100000001BEFFFFFFE1FFFFFF070000000000000001BDFFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01BCFFFFFFFDFFFFFF0000000000000000000000000000000001180000000800000001BBFFFFFFFDFFFFFF000000000000000000000000000000000402000001BAFFFFFFE2FFFFFF0100000001B9FFFFFFE1FFFFFF070000000000000001B8FFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01B7FFFFFFFDFFFFFF00000000000000000000000000000000011A0000000800000001B6FFFFFFFDFFFFFF000000000000000000000000000000000502000001B5FFFFFFE2FFFFFF0100000001B4FFFFFFE1FFFFFF070000000000000001B3FFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01B2FFFFFFFDFFFFFF00000000000000000000000000000000011C0000000800000001B1FFFFFFFDFFFFFF000000000000000000000000000000000602000001B0FFFFFFE2FFFFFF0100000001AFFFFFFFE1FFFFFF070000000200000001AEFFFFFFE0FFFFFF0200000000000000010000000E0000000A0A01ADFFFFFFFDFFFFFF000000000000000000000000000000000B
           ,0
           ,NULL
           ,GetDate()
           ,1)
GO

Lasst euch nicht von dem ziemlich langen Wert für die EventTypeDefinitions nicht verunsichern, dieser ist wirklich so lang.

Nachdem dieser fehlende Eintrag wieder hinzugefügt ist, muss noch die Tabelle DataRange genauer angesehen werden:

Umbenennen der Analyseberichtsdatenbank

Bei der neu hinzugefügten Datenbank fehlt hier ebenfalls der Eintrag. Diesen müssen wir also auch wieder manuell hinzufügen. Allerdings ist der Wert für das Feld ScaleOutDatabaseId nicht statisch, sondern unterscheidet sich bei jeder Datenbank. Allerdings wird auf diese ID nicht an anderer Stelle referenziert. Deshalb ist es nur wichtig, dass hier eine ScaleOutDatabadeId vorhanden ist. Der Wert ist dabei nur zweitrangig. Am Einfachsten fügt man diesen Eintrag über folgendes SQL-Statement hinzu:

USE [Search Service_AnalyticsReportingDB]
GO

INSERT INTO [dbo].[DataRange]
           ([ScaleOutDatabaseId]
           ,[RangeStart]
           ,[RangeEnd]
           ,[LowerSubRangePoint]
           ,[LowerSubRangeMode]
           ,[UpperSubRangePoint]
           ,[UpperSubRangeMode])
     VALUES
           ('7101A605-EEDE-46B4-890C-344AA0375AD5'
           ,0x0000000000000000000000000000000000000000000000000000000000000000
           ,NULL
           ,NULL
           ,NULL
           ,NULL
           ,NULL)
GO

Möchte man die ScaleOutDatabaseId danach doch noch auf einen zufälligen Wert setzen, gibt es eine entsprechende gespeicherte Prozedur, die die ScaleOutDatabaseId neu setzt:

Umbenennen der Analyseberichtsdatenbank

Durch das Ausführen der gespeicherten Prozedur wird eine neue zufällige ScaleOutDatabaseId generiert. Nach diesem Schritt können Berichte wieder geöffnet werden.

Das Umbenennen der Analyseberichtsdatenbank birgt also doch ein paar Tücken, die man unbedingt beachten sollte. Die hier gezeigte Problematik kann man auch ganz einfach umgehen, indem man nur Restore-SPEnterpriseSearchServiceApplication nutzt. Weitere Informationen zur Nutzung gibt es im TechNet.

In diesem Sinne, Happy SharePointing…

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.