sp_kill_filestream_non_transacted_handles (Transact-SQL)

  • Article

Ferme des descripteurs de fichiers non transactionnels aux données de FileTable.

Syntaxe

sp_kill_filestream_non_transacted_handles [[ @table_name = ] ‘table_name’, [[ @handle_id = ] @handle_id]]

Arguments

  • table_name
    Nom de la table dans laquelle fermer des descripteurs non transactionnels.

    Vous pouvez passer table_name sans handle_id pour fermer tous les descripteurs non transactionnels ouverts pour le FileTable.

    Vous pouvez passer NULL pour la valeur de table_name afin de fermer tous les descripteurs non transactionnels ouverts pour tous les FileTables de la base de données actuelle. La valeur par défaut est NULL.

  • handle_id
    ID facultatif du descripteur individuel à fermer. Vous pouvez obtenir l'handle_id de la vue de gestion dynamique sys.dm_filestream_non_transacted_handles (Transact-SQL). Chaque ID est unique dans une instance SQL Server. Si vous spécifiez handle_id, vous devez également fournir une valeur pour table_name.

    Vous pouvez passer NULL pour la valeur d'handle_id afin de fermer tous les descripteurs non transactionnels ouverts pour le FileTable spécifié par table_name. La valeur par défaut est NULL.

Valeur des codes de retour

0 (succès) ou 1 (échec)

Jeu de résultats

Aucun.

Remarques d'ordre général

handle_id requis par sp_kill_filestream_non_transacted_handles ne se rapporte pas à session_id ni à l'unité de travail utilisée dans d'autres commandes kill.

Pour plus d'informations, consultez Gérer des FileTables.

Métadonnées

Pour plus d'informations sur les descripteurs de fichiers non transactionnels ouverts, interrogez la vue de gestion dynamique sys.dm_filestream_non_transacted_handles (Transact-SQL).

Sécurité

Autorisations

Vous devez disposer de l'autorisation VIEW DATABASE STATE pour obtenir des descripteurs de fichiers de la vue de gestion dynamique sys.dm_FILESTREAM_non_transacted_handles et pour exécuter sp_kill_filestream_non_transacted_handles.

Exemples

Les exemples suivants indiquent comment appeler sp_kill_filestream_non_transacted_handles pour fermer des descripteurs de fichiers non transactionnels pour les données de FileTable.

-- Close all open handles in the current database.
sp_kill_filestream_non_transacted_handles

-- Close all open handles in myFileTable.
sp_kill_filestream_non_transacted_handles @table_name = ’myFileTable’

-- Close a specific handle in myFileTable.
sp_kill_filestream_non_transacted_handles @table_name = ’myFileTable’, @handle_id = 0xFFFAAADD

L'exemple suivant indique comment utiliser un script pour obtenir un handle_id et le fermer.

DECLARE @handle_id varbinary(16);
DECLARE @table_name sysname;

SELECT TOP 1 @handle_id = handle_id, @table_name = Object_name(table_id)
FROM sys.dm_FILESTREAM_non_transacted_handles;

EXEC sp_kill_filestream_non_transacted_handles @dbname, @table_name, @handle_id;
GO

Voir aussi

Concepts

Gérer des FileTables