PathName (Transact-SQL)

Artikel
05/23/2023

Gibt den Pfad eines FILESTREAM BLOB (Binary Large Object) zurück. Die OpenSqlFilestream-API verwendet diesen Pfad, um ein Handle zurückzugeben, das eine Anwendung zum Arbeiten mit den BLOB-Daten mithilfe von Win32-APIs verwenden kann. PathName ist schreibgeschützt.

Transact-SQL-Syntaxkonventionen

Syntax

  
column_name.PathName ( @option [ , use_replica_computer_name ] )

Argumente

column_name
Der Spaltenname einer varbinary(max) FILESTREAM-Spalte. column_name muss ein Spaltenname sein. Es kann sich hierbei weder um einen Ausdruck noch um das Ergebnis einer CAST- oder CONVERT-Anweisung handeln.

Das Anfordern von PathName für eine Spalte eines anderen Datentyps oder für eine varbinary(max) -Spalte, die nicht über das FILESTREAM-Speicherattribut verfügt, führt zu einem Fehler bei der Kompilierzeit der Abfrage.

@option
Ein ganzzahliger Ausdruck , der definiert, wie die Serverkomponente des Pfads formatiert werden soll. Für@option sind die folgenden Werte möglich. Die Standardeinstellung ist 0.

Wert	BESCHREIBUNG
0	Gibt den Servernamen in ein BIOS-Format konvertiert zurück, z. B.: `\\SERVERNAME\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F19F7-38EA-4AB0-BB89-E6C545DBD3F9`
1	Gibt den Servernamen ohne Konvertierung zurück, z. B.: `\\ServerName\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F1`
2	Gibt den vollständigen Serverpfad zurück, z. B.: `\\ServerName.MyDomain.com\MSSQLSERVER\v1\Archive\dbo\Records\Chart\A73F19F7-38EA-4AB0-BB89-E6C545DBD3F9`

use_replica_computer_name
Ein Bitwert, der definiert, wie der Servername in einer Always On Verfügbarkeitsgruppe zurückgegeben werden soll.

Wenn die Datenbank nicht zu einer Always On Verfügbarkeitsgruppe gehört, wird der Wert dieses Arguments ignoriert. Der Computername wird immer im Pfad verwendet.

Wenn die Datenbank zu einer Always On Verfügbarkeitsgruppe gehört, hat der Wert von use_replica_computer_name die folgenden Auswirkungen auf die Ausgabe der PathName-Funktion:

Wert	BESCHREIBUNG
Nicht angegeben.	Die Funktion gibt den virtuellen Netzwerknamen in (VNN) im Pfad zurück.
0	Die Funktion gibt den virtuellen Netzwerknamen in (VNN) im Pfad zurück.
1	Die Funktion gibt den Computernamen im Pfad zurück.

Rückgabetyp

nvarchar(max)

Rückgabewert

Der zurückgegebene Wert ist der vollqualifizierte logische oder NETBIOS-Pfad des BLOB. Pfadname gibt keine IP-Adresse zurück. NULL wird zurückgegeben, wenn das FILESTREAM BLOB nicht erstellt wurde.

Bemerkungen

Die Spalte ROWGUID muss in jeder Abfrage sichtbar sein, die PathName aufruft.

Ein FILESTREAM-BLOB kann nur mithilfe von Transact-SQL erstellt werden.

Beispiele

A. Lesen des Pfads für einen FILESTREAM-BLOB

Im folgenden Beispiel wird PathName der Variablen nvarchar(max) zugewiesen.

DECLARE @PathName nvarchar(max);  
SET @PathName = (  
    SELECT TOP 1 photo.PathName()  
    FROM dbo.Customer  
    WHERE LastName = 'CustomerName'  
    );

B. Anzeigen der Pfade für FILESTREAM-BLOBs in einer Tabelle

Im folgenden Beispiel werden die Pfade für drei FILESTREAM BLOBs erstellt und angezeigt.

-- Create a FILESTREAM-enabled database.  
-- The c:\data directory must exist.  
CREATE DATABASE PathNameDB  
ON  
PRIMARY ( NAME = ArchX1,  
    FILENAME = 'c:\data\archdatP1.mdf'),  
FILEGROUP FileStreamGroup1 CONTAINS FILESTREAM( NAME = ArchX3,  
    FILENAME = 'c:\data\filestreamP1')  
LOG ON  ( NAME = ArchlogX1,  
    FILENAME = 'c:\data\archlogP1.ldf');  
GO  
  
USE PathNameDB;  
GO  
  
-- Create a table, add some records, and  
-- create the associated FILESTREAM  
-- BLOB files.  
  
CREATE TABLE TABLE1  
    (  
        ID int,  
        RowGuidColumn UNIQUEIDENTIFIER  
                      NOT NULL UNIQUE ROWGUIDCOL,  
        FILESTREAMColumn varbinary(MAX) FILESTREAM  
    );  
GO  
  
INSERT INTO TABLE1 VALUES  
 (1, NEWID(), 0x00)  
,(2, NEWID(), 0x00)  
,(3, NEWID(), 0x00);  
GO  
  
SELECT FILESTREAMColumn.PathName() AS 'PathName' FROM TABLE1;  
  
--Results  
--PathName  
------------------------------------------------------------------------------------------------------------  
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\DD67C792-916E-4A76-8C8A-4A85DC5DB908  
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\2907122B-2560-4CB9-86DC-FBE7ABA1843B  
--\\SERVER\MSSQLSERVER\v1\PathNameExampleDB\dbo\TABLE1\FILESTREAMColumn\922BE0E0-CAB9-4403-90BF-945BD258E4BC  
--  
--(3 row(s) affected)  
GO  
  
--Drop the database to clean up.  
USE master;  
GO  
DROP DATABASE PathNameDB;

Weitere Informationen

Binary Large Object (BLOB)-Daten (SQL Server)
GET_FILESTREAM_TRANSACTION_CONTEXT (Transact-SQL)
ZUgreifen auf FILESTREAM-Daten mit OpenSqlFilestream

Teilen über