Accéder aux FileTables avec des API d’entrée-sortie de fichier

S’applique à : SQL Server

Décrit le fonctionnement des E/S du système de fichiers sur un FileTable.

Commencer à utiliser les API d'E/S de fichier avec des FileTables

Les FileTables sont principalement utilisés via le système de fichiers Windows et les API d'E/S de fichier. Les FileTables prennent en charge l'accès non transactionnel via le vaste ensemble d'API d'E/S de fichier disponibles.

1. L'accès aux API d'E/S de fichier commence en général par l'acquisition d'un chemin d'accès UNC logique pour le fichier ou le répertoire. Les applications peuvent utiliser une instruction Transact-SQL avec la fonction GetFileNamespacePath (Transact-SQL) pour obtenir le chemin d’accès logique du fichier ou du répertoire. Pour plus d'informations, consultez Work with Directories and Paths in FileTables.

2. L'application utilise ensuite ce chemin d'accès logique pour obtenir un handle de fichier ou de répertoire et effectuer une action à l'aide de l'objet. Le chemin d'accès peut être passé à toute fonction API du système de fichiers prise en charge, par exemple CreateFile() ou CreateDirectory(), pour créer ou ouvrir un fichier et obtenir un handle. Le handle peut ensuite être utilisé pour créer un flux de données, énumérer ou organiser les répertoires, obtenir ou définir des attributs de fichier, supprimer des fichiers ou des répertoires, etc.

Création de fichiers et de répertoires dans un FileTable

Il est possible de créer un fichier ou un répertoire dans un FileTable en appelant les API d'E/S de fichier, telles que CreateFile ou CreateDirectory.

• Tous les indicateurs de création de disposition, les modes de partage et les modes d'accès sont pris en charge. Cela inclut la création, la suppression et la modification sur place de fichiers. Les mises à jour d'espaces de noms de fichier, autrement dit les opérations créer, supprimer, renommer ou déplacer des répertoires, sont également prises en charge.

• La création d'un fichier ou répertoire correspond à la création d'une ligne dans le FileTable sous-jacent.

• Pour les fichiers, les données de flux sont stockées dans la colonne file_stream , alors que pour les répertoires, cette colonne est Null.

• Pour les fichiers, la colonne is_directory contient la valeur false. Pour les répertoires, cette colonne contient la valeur true.

• Le partage et la concurrence d’accès sont appliqués lorsque plusieurs opérations d’E/S de fichier ou opérations Transact-SQL simultanées affectent le même fichier ou répertoire dans la hiérarchie.

Lecture de fichiers et de répertoires dans un FileTable

Une sémantique d’isolation de lecture validée (READ COMMITTED) est appliquée dans SQL Server pour toutes les opérations d’accès d’E/S de fichier sur les données de flux et les données d’attribut.

Écriture et mise à jour de fichiers et de répertoires dans un FileTable

• Toutes les opérations d'écriture ou de mise à jour d'E/S de fichier sur un FileTable sont non transactionnelles. En d’autres termes, aucune transaction SQL Server n’est liée à ces opérations et aucune garantie ACID n’est fournie.

• L'ensemble des mises à jour sur place/accès en continu d'E/S de fichier est pris en charge pour le FileTable.

• Les mises à jour d’attributs ou de données FILESTREAM via des API d’E/S de fichier se traduisent par des mises à jour des colonnes d’attributs file_stream et de fichiers correspondantes dans le FileTable.

Suppression de fichiers et de répertoires dans un FileTable

Toute la sémantique des API d'E/S de fichier Windows est appliquée lorsque vous supprimez un fichier ou un répertoire.

• La suppression d’un répertoire échoue si le répertoire contient des fichiers ou des sous-répertoires.

• La suppression d'un fichier ou d'un répertoire entraîne la suppression de la ligne correspondante dans le FileTable. Cela équivaut à supprimer la ligne via une opération Transact-SQL.

Opérations du système de fichiers prises en charge

Les FileTables prennent en charge les API de système de fichiers associées aux opérations de système de fichiers suivantes :

• Gestion d’annuaires

• Gestion des fichiers

Les FileTables ne prennent pas en charge les opérations suivantes :

• Gestion des disques

• Gestion des volumes

• NTFS transactionnel

Éléments supplémentaires à prendre en considération pour l'accès d'E/S de fichier aux FileTables

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

Lorsque la base de données qui contient des données FILESTREAM ou FileTable appartient à un groupe de disponibilité Always On, tous les accès aux données FILESTREAM ou 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é Always On (SQL Server).

Mises à jour partielles

Un descripteur accessible en écriture obtenu pour des données FILESTREAM dans un FileTable à l’aide de la fonction GetFileNamespacePath (Transact-SQL) peut être utilisé pour effectuer des mises à jour sur place et partielles du contenu FILESTREAM. Ce comportement contraste avec l’accès FILESTREAM transactionnel effectué via un descripteur obtenu en appelant OpenSQLFILESTREAM() et en passant un contexte de transaction explicite.

Sémantique transactionnelle

Lorsque vous accédez aux fichiers d'un FileTable à l'aide des API d'E/S de fichier, ces opérations ne sont pas associées à des transactions utilisateur. Elles présentent les caractéristiques supplémentaires suivantes :

• Dans la mesure où l'accès non transactionnel aux données FILESTREAM dans un FileTable n'est pas associé à une transaction, il n'a pas de sémantique d'isolation spécifique. Toutefois, SQL Server peut utiliser des transactions internes pour appliquer une sémantique de verrouillage ou de concurrence aux données de FileTable. Toutes les transactions internes de ce type sont effectuées avec une isolation de lecture validée (READ COMMITTED).

• Il n'existe aucune garantie ACID pour ces opérations non transactionnelles sur des données FILESTREAM. Les garanties de cohérence sont semblables à celles des mises à jour de fichiers effectuées par les applications dans le système de fichiers.

• Ces modifications ne peuvent pas être restaurées.

Toutefois, il est également possible d’accéder à la colonne FILESTREAM d’un FileTable à l’aide de l’accès transactionnel FILESTREAM en appelant OpenSqlFileStream(). Ce type d'accès peut être entièrement transactionnel et respecte tous les niveaux de cohérences transactionnelles actuellement pris en charge.

Contrôle d’accès concurrentiel

SQL Server applique le contrôle d’accès concurrentiel pour l’accès de FileTable parmi les applications de système de fichiers, ainsi qu’entre applications de système de fichiers et applications Transact-SQL. Ce contrôle d'accès concurrentiel s'effectue en prenant des verrous appropriés sur les lignes FileTable.

Déclencheurs

La création, la modification ou la suppression de fichiers, de répertoires ou de leurs attributs via le système de fichiers se traduit par les opérations d'insertion, de mise à jour ou de suppression correspondantes dans le FileTable. Tous les déclencheurs DML Transact-SQL associés sont déclenchés dans le cadre de ces opérations.

Fonctionnalités de système de fichiers prises en charge dans les FileTables

Voir aussi

Charger des fichiers dans des FileTables
Travailler avec des répertoires et des chemins d’accès dans des FileTables
Accéder aux FileTables avec Transact-SQL
DDL, fonctions, procédures stockées et vues FileTable