Travailler avec des répertoires et des chemins d'accès dans FileTables

Décrit la structure de répertoires dans laquelle les fichiers sont stockés dans FileTables.

Dans cette rubrique

Je souhaite…

• Travailler avec des répertoires et des chemins d'accès dans des FileTable

• Utiliser des chemins d'accès relatifs pour du code portable

En savoir plus

• Restrictions importantes

  • Niveau d'imbrication

  • Longueur du nom du chemin d'accès complet

• Chemin complet à un élément stocké dans un FileTable

• Sémantique des répertoires racine aux niveaux de l'instance, de la base de données et de FileTable

• Colonne is_directory dans le schéma de FileTable

• Utilisation de noms de réseau virtuel (VNN) avec des groupes de disponibilité AlwaysOn

Procédure : travailler avec des répertoires et des chemins d'accès dans FileTables

Vous pouvez utiliser les trois fonctions suivantes pour travailler avec des répertoires FileTable dans Transact-SQL :

[Haut de la page]

Procédure : utiliser des chemins d'accès relatifs pour du code portable

Pour garder le code et les applications indépendantes de l'ordinateur actuel et de la base de données, évitez d'écrire du code qui contient des chemins d'accès de fichier absolus. Au lieu de cela, obtenez le chemin d'accès complet à un fichier au moment de l'exécution à l'aide des fonctions FileTableRootPath (Transact-SQL) et GetFileNamespacePath (Transact-SQL), comme indiqué dans l'exemple suivant. Par défaut, la fonction GetFileNamespacePath retourne le chemin d'accès relatif du fichier sous le chemin d'accès racine de la base de données.

USE database_name;
DECLARE @root nvarchar(100);
DECLARE @fullpath nvarchar(1000);

SELECT @root = FileTableRootPath();
SELECT @fullpath = @root + file_stream.GetFileNamespacePath()
    FROM filetable_name
    WHERE name = N'document_name';

PRINT @fullpath;
GO

[Haut de la page]

Restrictions importantes

Niveau d'imbrication

Longueur du nom du chemin d'accès complet

Chemin complet à un élément stocké dans un FileTable

Le chemin d'accès complet à un fichier ou un répertoire stocké dans un FileTable commence par les éléments suivants :

1. Le partage activé pour l'accès d'E/S de fichier FILESTREAM au niveau de l'instance de SQL Server.

2. Le DIRECTORY_NAME spécifié au niveau de la base de données.

3. Le FILETABLE_DIRECTORY spécifié au niveau du FileTable.

La hiérarchie résultante ressemble à celle-ci :

\\<machine>\<instance-level FILESTREAM share>\<database-level directory>\<FileTable directory>\

Cette hiérarchie de répertoires forme la racine de l'espace de noms de fichiers du FileTable. Sous cette hiérarchie de répertoires, les données FILESTREAM pour le FileTable sont stockées en tant que fichiers, et comme sous-répertoires qui peuvent également contenir des fichiers et des sous-répertoires.

Il est important de se souvenir que la hiérarchie de répertoires créée sous le partage FILESTREAM au niveau de l'instance est une hiérarchie de répertoires virtuels. Cette hiérarchie est stockée dans la base de données SQL Server et n'est pas représentée physiquement dans le système de fichiers NTFS. Toutes les opérations qui accèdent à des fichiers et des répertoires sous le partage FILESTREAM et dans le FileTables qu'il contient sont interceptées et gérées par un composant de SQL Server incorporé dans le système de fichiers.

[Haut de la page]

Sémantique des répertoires racines aux niveaux de l'instance, de la base de données et de FileTable

Cette hiérarchie de répertoires observe la sémantique suivante :

• Le partage FILESTREAM au niveau de l'instance est configuré par un administrateur et stocké comme propriété du serveur. Vous pouvez renommer ce partage à l'aide du gestionnaire de configuration de SQL Server. Une opération de changement de nom n'entre en vigueur qu'une fois que le serveur a redémarré.

• Le DIRECTORY_NAME au niveau de la base de données est null par défaut lorsque vous créez une base de données. Un administrateur peut définir ou modifier ce nom à l'aide de l'instruction ALTER DATABASE. Le nom doit être unique (dans une comparaison ne respectant pas la casse) dans cette instance.

• On fournit en général le nom FILETABLE_DIRECTORY dans le cadre de l'instruction CREATE TABLE lorsque l'on crée un FileTable. Vous pouvez modifier ce nom à l'aide de la commande ALTER TABLE.

• Vous ne pouvez pas renommer ces répertoires racines par le biais d'opérations d'E/S de fichier.

• Vous ne pouvez pas ouvrir ces répertoires racines avec des descripteurs de fichiers exclusifs.

[Haut de la page]

Colonne is_directory dans le schéma de FileTable

Le tableau suivant décrit l'interaction entre la colonne is_directory et la colonne file_stream qui contient les données FILESTREAM dans un FileTable.

[Haut de la page]

Utilisation de noms de réseau virtuel (VNN) avec des groupes de disponibilité AlwaysOn

Lorsque la base de données qui contient des données FILESTREAM ou FileTable appartient à un groupe de disponibilité AlwaysOn :

• Les fonctions FILESTREAM et FileTable acceptent ou retournent des noms de réseau virtuel (VNN) à la place de noms d'ordinateur. Pour plus d'informations sur ces fonctions, consultez Fonctions Filestream et FileTable (Transact-SQL).

• Tous les accès à FILESTREAM ou aux données FileTable via les API du système de fichiers doivent utiliser des VNN à la place des noms d'ordinateur. Pour plus d'informations, consultez FILESTREAM et FileTable avec groupes de disponibilité AlwaysOn (SQL Server).

[Haut de la page]

Voir aussi

Concepts

Activer les conditions préalables pour les FileTables

Créer, modifier et supprimer des FileTables

Accéder aux FileTables avec Transact-SQL

Accéder aux FileTables avec les API d'E/S de fichier