Zugreifen auf FILESTREAM-Daten mit Transact-SQL

  • Artikel

Gilt für:SQL Server

In diesem Artikel wird beschrieben, wie Sie die Transact-SQL INSERT-, UPDATE- und DELETE-Anweisungen zum Verwalten von FILESTREAM-Daten verwenden.

Hinweis

In den Beispielen in diesem Artikel sind die FILESTREAM-fähige Datenbank und die Tabelle erforderlich, die in "Create a FILESTREAM-Enabled Database" erstellt und eine Tabelle zum Speichern von FILESTREAM-Daten erstellt werden.

Einfügen einer Zeile mit FILESTREAM-Daten

Verwenden Sie die Transact-SQL INSERT-Anweisung, um einer Tabelle eine Zeile hinzuzufügen, die FILESTREAM-Daten unterstützt. Wenn Sie Daten in eine FILESTREAM-Spalte einfügen, können Sie NULL oder einen varbinary(max) -Wert einfügen.

NULL einfügen

Im folgenden Beispiel wird gezeigt, wie NULLeingefügt wird. Wenn der FILESTREAM-Wert lautet NULL, erstellt das Datenbankmodul keine Datei im Dateisystem.

INSERT INTO Archive.dbo.Records
    VALUES (NEWID(), 1, NULL);
GO

Einfügen eines Datensatzes der Länge Null

Das folgende Beispiel veranschaulicht, wie mit INSERT ein Datensatz mit der Länge 0 (null) erstellt wird. Dies ist hilfreich, wenn Sie ein Dateihandle abrufen müssen, die Datei jedoch durch die Verwendung von Win32-APIs geändert wird.

INSERT INTO Archive.dbo.Records
    VALUES (NEWID(), 2, 
      CAST ('' AS VARBINARY(MAX)));
GO

Erstellen einer Datendatei

Das folgende Beispiel veranschaulicht, wie mit INSERT eine Datei mit Daten erstellt wird. Das Datenbankmodul konvertiert die Zeichenfolge Seismic Data in einen varbinary(max) Wert. FILESTREAM erstellt die Windows-Datei, wenn sie noch nicht vorhanden ist. Die Daten werden dann der Datendatei hinzugefügt.

INSERT INTO Archive.dbo.Records
    VALUES (NEWID(), 3, 
      CAST ('Seismic Data' AS VARBINARY(MAX)));
GO

Wenn Sie alle Daten in der Tabelle Archive.dbo.Records auswählen, sollten ähnliche Ergebnisse wie in der folgenden Tabelle angezeigt werden. Die Id -Spalte enthält jedoch andere GUIDs.

ID SerialNumber Diagramm
C871B90F-D25E-47B3-A560-7CC0CA405DAC 1 NULL
F8F5C314-0559-4927-8FA9-1535EE0BDF50 2 0x
7F680840-B7A4-45D4-8CD5-527C44D35B3F 3 0x536569736D69632044617461

AKTUALISIEREN von FILESTREAM-Daten

Sie können Transact-SQL verwenden, um die Daten in der Dateisystemdatei zu aktualisieren, aber Sie möchten möglicherweise nicht, wenn Sie große Datenmengen in eine Datei streamen.

Im folgenden Beispiel wird der gesamte Text im Dateidatensatz durch den Text Xray 1ersetzt.

UPDATE Archive.dbo.Records
SET [Chart] = CAST('Xray 1' AS VARBINARY(MAX))
WHERE [SerialNumber] = 2;

FILESTREAM-Daten löschen

Wenn Sie eine Zeile mit einem FILESTREAM-Feld löschen, löschen Sie auch die zugrunde liegenden Dateisystemdateien. Die einzige Möglichkeit zum Löschen einer Zeile und daher der Datei besteht darin, die Transact-SQL DELETE-Anweisung zu verwenden.

Im folgenden Beispiel wird das Löschen einer Zeile und der entsprechenden Dateisystemdateien veranschaulicht.

DELETE Archive.dbo.Records
WHERE SerialNumber = 1;
GO

Wenn Sie alle Daten aus der Archive.dbo.Records Tabelle auswählen, ist die Zeile nicht mehr vorhanden, und Sie können die zugeordnete Datei nicht mehr verwenden.

Hinweis

Die zugrunde liegenden Dateien werden vom FILESTREAM Garbage Collector entfernt.

Überprüfen, ob eine Tabelle oder Datenbank FILESTREAM-Daten enthält

Um herauszufinden, ob eine Datenbank oder Tabelle FILESTREAM-Daten enthält, müssen Sie die Systemansichten abfragen.

Das folgende erweiterte Beispiel zeigt die Schritte zum Erstellen einer neuen Datenbank, Erstellen von Tabellen mit FILESTREAM-Daten und Abfragesystemansichten, um festzustellen, ob die Tabellen und die Datenbank selbst FILESTREAM-Daten enthalten.

USE [master];
GO

-- Create database with FILESTREAM
CREATE DATABASE [FileStreamTest] CONTAINMENT = NONE ON PRIMARY (
    NAME = N'FileStreamTest'
    , FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA\FileStreamTest.mdf'
    , SIZE = 204800 KB
    , MAXSIZE = UNLIMITED
    , FILEGROWTH = 65536 KB
    )
    , FILEGROUP [FileStreamFG] CONTAINS FILESTREAM DEFAULT(NAME = N'FileStreamTestFStream', FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA\FileStreamTestFStream', MAXSIZE = UNLIMITED) LOG ON (
    NAME = N'FileStreamTest_log'
    , FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA\FileStreamTest_log.ldf'
    , SIZE = 270336 KB
    , MAXSIZE = 2048 GB
    , FILEGROWTH = 65536 KB
    )
    WITH CATALOG_COLLATION = DATABASE_DEFAULT;
GO

USE [FileStreamTest];
GO

CREATE TABLE FSTiffs (
    Guid UNIQUEIDENTIFIER ROWGUIDCOL NOT NULL UNIQUE DEFAULT NEWSEQUENTIALID()
    , DocumentID INT NOT NULL
    , DocumentType VARCHAR(10) NOT NULL
    , FileContent VARBINARY(MAX) FILESTREAM NOT NULL
    , DateInserted DATETIME
);

-- Which database and files use FILESTREAM 
SELECT db_name(database_id) dbname
    , name AS file_name
    , physical_name
    , type_desc
    , *
FROM sys.master_files
WHERE type_desc = 'FILESTREAM';

-- Which tables in the database have FILESTREAM enabled
USE [FileStreamTest]
GO

SELECT *
FROM sys.tables
WHERE filestream_data_space_id IS NOT NULL;

--insert a TIFF file
INSERT INTO FSTiffs (
    DocumentID
    , DocumentType
    , FileContent
    , DateInserted
    )
SELECT 101
    , '.tiff'
    , *
    , GETDATE()
FROM OPENROWSET(BULK N'C:\Temp\Sample1.tiff', SINGLE_BLOB) rs;

-- Select data from FILESTREAM table
SELECT *
FROM FSTiffs;

-- Update a document
UPDATE FSTiffs
SET FileContent = (
        SELECT *
        FROM OPENROWSET(BULK N'C:\Temp\Sample2.tiff', SINGLE_BLOB) AS rs
        )
WHERE DocumentID = 101;

-- Delete a document
DELETE FSTiffs
WHERE DocumentID = 101;

--clean up any delete files
EXEC sp_filestream_force_garbage_collection @dbname = N'FileStreamTest'
    , @filename = N'FileStreamTestFStream';

Siehe auch