FILESTREAM für Microsoft SQL Server aktivieren

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:

  1. Öffnen Sie zunächst den SQL Server-Konfigurations-Manager über das Windows-Startmenü.

  2. Führen Sie in der linken Leiste einen Rechtsklick auf SQL-Server Dienste aus und wählen Sie anschließend Öffnen.

  3. 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ü.

  4. Wechseln Sie im Eigenschaften-Dialog nun auf die Registerkarte FILESTREAM und aktivieren Sie die Option FILESTREAM für Transact-SQL-Zugriff aktivieren.

  5. 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.

  6. Optional: Falls Remoteclients auf FILESTREAM-Daten dieser Freigabe zugreifen müssen, aktivieren Sie zusätzlich die Option Zugriff von Remoteclients auf FILESTREAM-Daten zulassen.

  7. Bestätigten Sie die vorgenommen Änderungen nun mit OK.

  8. Nach Aktivierung von FILESTREAM im SQL Server-Konfigurations-Manager ist es zwingend erforderlich, den FILESTREAM-Zugriffslevel anzupassen. Öffnen Sie dazu im SQL 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 Datenbank master aus.

  9. Wechseln Sie nun zurück in den SQL Server-Konfigurations-Manager und starten Sie den SQL Server-Dienst neu. Beenden Sie nun den SQL 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 Ordner DocFile 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.

IDKBAD001258 KBAD001258