Einleitung
Dieser Artikel unterstützt Sie bei der Auslagerung von eingebetteten Dateien Ihrer Microsoft SQL Server-Datenbank in das Dateisystem mittels FILESTREAM. Diese Vorgehensweise erlaubt es Ihnen, die Datenbankgröße gering zu halten, da die Dateien vom SQL Server aus dem Dateisystem gestreamt werden und die Größenbeschränkung der Datenbank (bei der Microsoft SQL Server Express-Edition) somit weniger relevant erscheint. Eine Anwendung dieser Methode könnte sich bereits lohnen, wenn die zu speichernden Objekte im Durchschnitt größer als 1 Megabyte sind und ein schneller Lesezugriff wichtig ist.
Weitere Informationen hierzu finden Sie auch unter FILESTREAM (SQL Server) - SQL Server | Microsoft Learn
Hinweis: FILESTREAM-Daten können nicht verschlüsselt werden.
Durchführung der Umstellung
Die folgenden Schritte werden anhand der combit CRM-Datenbank „combit_Large??“ erklärt und die SQL-Abfragen beziehen sich auf deren Tabellen (ersetzen Sie an allen Stellen ??
durch die tatsächliche Version Ihrer Datenbank). combit CRM sollte während der Durchführung nicht aktiv sein und kein Anwender sollte in der Datenbank arbeiten. Bitte erstellen Sie vor der Durchführung der folgenden Schritte eine komplette Sicherung Ihrer Datenbanken und der Solution.
Aktivierung von FILESTREAM in der verwendeten SQL Server-Instanz
Damit FILESTREAM verwendet und konfiguriert werden kann, muss es vorher in den Eigenschaften der verwendeten SQL Server-Instanz aktiviert werden. Folgende Schritte sind dafür notwendig:
-
Öffnen Sie zunächst den
SQL Server-Konfigurations-Manager
über das Windows-Startmenü. -
Führen Sie in der linken Leiste einen Rechtsklick auf
SQL-Server Dienste
aus und wählen Sie anschließendÖffnen
. -
Markieren Sie nun auf der rechten Seite die entsprechende SQL Server-Instanz, auf welcher FILESTREAM aktiviert werden soll und wählen
Eigenschaften
aus dem Rechtsklick-Kontextmenü. -
Wechseln Sie im Eigenschaften-Dialog nun auf die Registerkarte
FILESTREAM
und aktivieren Sie die OptionFILESTREAM für Transact-SQL-Zugriff aktivieren
. -
Optional: Wenn ein Lesen und Schreiben der FILESTREAM-Daten über Windows erforderlich sein sollte, dann aktivieren Sie zusätzlich die Option
FILESTREAM für E/A-Dateizugriff aktivieren
. Geben Sie anschließend den Windows-Freigabenamen ein. -
Optional: Falls Remoteclients auf FILESTREAM-Daten dieser Freigabe zugreifen müssen, aktivieren Sie zusätzlich die Option
Zugriff von Remoteclients auf FILESTREAM-Daten zulassen
. -
Bestätigten Sie die vorgenommen Änderungen nun mit
OK
. -
Nach Aktivierung von FILESTREAM im
SQL Server-Konfigurations-Manager
ist es zwingend erforderlich, den FILESTREAM-Zugriffslevel anzupassen. Öffnen Sie dazu imSQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:-- Change FILESTREAM Access Level to 2 - Default: 0 EXEC sp_configure filestream_access_level, 2 RECONFIGURE
Führen Sie die Abfrage anschließend über
Ausführen
für die Datenbankmaster
aus. -
Wechseln Sie nun zurück in den
SQL Server-Konfigurations-Manager
und starten Sie den SQL Server-Dienst neu. Beenden Sie nun denSQL Server-Konfigurations-Manager
.
Sicherstellen der benötigten RowGuid-Feldeigenschaft
Standardmäßig ist dies in der combit_Large??
-Datenbank bereits korrekt eingestellt. Um dies ggf. zu überprüfen, öffnen Sie im SQL Server Management Studio
in der Datenbank combit_Large??
die Tabelle Activities
über Entwerfen
im Kontextmenü. Markieren Sie dort die Spalte ID
und stellen Sie sicher, dass die Eigenschaft RowGuid
auf Ja
steht.
Erzeugen einer neuen Dateigruppe
Für FILESTREAM benötigt die SQL Server-Datenbank eine sogenannte Dateigruppe, welcher eine Datei zugeordnet wird. Öffnen Sie dazu im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
-- Add a file group
ALTER DATABASE combit_Large??
ADD FILEGROUP DocumentsGroup CONTAINS FILESTREAM
GO
-- Add a file for storing database documents to DocumentsGroup
ALTER DATABASE combit_Large??
ADD FILE
(
NAME = 'DocumentsFile',
FILENAME = 'C:\DOCS\FILESTREAM\DocFile'
)
TO FILEGROUP DocumentsGroup
GO
Führen Sie die Abfrage anschließend über Ausführen
aus.
Wichtig: Der Pfad
C:\DOCS\FILESTREAM\
muss vorhanden sein bzw. vorher angelegt werden, wobei hingegen der OrdnerDocFile
nicht existieren darf! Diese Ordner können an einem beliebigen Ort auf Ihrem System liegen.
Nach der Ausführung der SQL-Abfrage sollten in dem Ordner C:\DOCS\FILESTREAM\
der Ordner DocFile
und darin die Datei filestream.hdr
vorhanden sein. Die Datei filestream.hdr
ist eine wichtige Systemdatei, die FILESTREAM-Headerinformationen enthält. Diese Datei darf nicht entfernt oder geändert werden.
Erstellen eines neuen FILESTREAM-Felds
Nun muss in der Datenbank combit_Large??
in der Tabelle Activities
die neue Spalte Document_Filestream
mit dem Datentyp varbinary(MAX)
und der FILESTREAM-Eigenschaft erstellt werden. Öffnen Sie dazu im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
-- Add Field 'Document_Filestream' with field type and arguments
ALTER TABLE Activities
ADD Document_Filestream VARBINARY(MAX) FILESTREAM NULL
Führen Sie die Abfrage anschließend über Ausführen
für die Datenbank combit_Large??
aus.
Abgleichen des BLOB-Felds mit dem FILESTREAM-Feld
Hinweis: Dieser Schritt ist nicht notwendig, wenn in der Datenbank keine eingebetteten Dokumente enthalten sind oder diese ggf. nicht mehr benötigt werden und damit auch nicht übertragen werden müssen.
Damit nun die Inhalte aus dem bisherigen BLOB-Feld Document_Embedded
in das neue FILESTREAM-Feld Document_Filestream
übertragen und die eingebetteten Dokumente ausgelagert werden können, müssen die Felder miteinander abgeglichen werden. Öffnen Sie dazu im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
UPDATE Activities
SET Document_Filestream = Document_Embedded
Führen Sie die Abfrage anschließend über Ausführen
für die Datenbank combit_Large??
aus.
Achtung: Wenn die Tabelle bereits in einer Replikation verwendet wird, dann muss diese vorher aus der Replikation entfernt und nach Abschluss wieder hinzugefügt werden. Ein erneutes Initialisieren des Snapshots ist notwendig!
Anpassen des combit CRM-Projekts
Öffnen Sie nun in combit CRM die Ansichteneigenschaften für die Ansicht Aktivitäten
und setzen in der Lasche Felder
den internen Feldtyp des soeben neu angelegten Felds Document_Filestream
auf den Wert Eingebettete Datei
. Anschließend wechseln Sie auf die Lasche Dokumenteninfos
und vergeben die Feldzuordnungen analog zum bestehenden Feld Document_Embedded
. Wechseln Sie nun noch einmal zurück auf die Lasche Felder
und setzen den Feldtyp des bisher verwendeten Felds Document_Embedded
auf Unbekannt
(dieses Feld wird in einem nachfolgenden Schritt abschließend entfernt werden). Bestätigen Sie nun den Dialog mit OK
und speichern Sie das Projekt.
Öffnen Sie nun die Ansicht Aktivitäten
und wechseln in den Eingabemaskendesigner. Ersetzen Sie dort das Feld Document_Embedded
mit dem Feld Document_Filestream
und speichern die Eingabemaske ab.
Löschen des nicht mehr benötigten BLOB-Felds
Wenn Sie nun sichergestellt haben, dass die bisherigen Inhalte (sofern vorhanden) des BLOB-Felds Document_Embedded
korrekt in das neue FILESTREAM-Feld Document_Filestream
übernommen werden konnten, kann das nun nicht mehr benötigte BLOB-Feld Document_Embedded
gelöscht werden. Öffnen Sie dazu im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
ALTER TABLE Activities
DROP COLUMN Document_Embedded
Führen Sie die Abfrage anschließend über Ausführen
für die Datenbank combit_Large??
aus.
Schließen Sie nun eine ggf. geöffnete Instanz von combit CRM und starten Sie diesen erneut. Um das nun nicht mehr vorhandene BLOB-Feld Document_Embedded
auch aus dem Projekt zu entfernen, öffnen Sie nochmals die Ansichteneigenschaften für die Ansicht Aktivitäten
, bestätigen Sie den Dialog mit OK
und speichern Sie das Projekt abschließend.
Freigabe des belegten Speicherplatzes
Um den durch die ehemals eingebetteten Dokumente belegten Speicherplatz in der SQL-Datenbank wieder freizugeben, öffnen Sie im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
DBCC CLEANTABLE (combit_Large??, 'Activities', 0)
GO
Führen Sie die Abfrage anschließend über Ausführen
aus.
Im Anschluss muss auch die entsprechende Datendatei der Datenbank selbst reduziert werden. Öffnen Sie dazu im SQL Server Management Studio
eine neue Abfrage und geben die folgenden Zeilen ein:
DBCC SHRINKFILE (combit_Large??);
GO
Führen Sie die Abfrage anschließend über Ausführen
aus.
Hinweis: Bitte beachten Sie, dass dieser Vorgang, je nach Größe des belegten Speicherplatzes, entsprechend Zeit in Anspruch nehmen kann.