sp_kill_filestream_non_transacted_handles (Transact-SQL)
Cierra los identificadores de archivos no transaccionales para datos de FileTable.
Sintaxis
sp_kill_filestream_non_transacted_handles [[ @table_name = ] ‘table_name’, [[ @handle_id = ] @handle_id]]
Argumentos
table_name
El nombre de la tabla en la que se van a cerrar los identificadores no transaccionales.Puede pasar table_name sin handle_id para cerrar todos los identificadores no transaccionales abiertos para el objeto FileTable.
Puede pasar NULL como valor de table_name para cerrar todos los identificadores no transaccionales abiertos para todos los objetos FileTable en la base de datos actual. El valor predeterminado es NULL.
handle_id
El Id. opcional del identificador individual que se cerrará. Puede obtener el objeto handle_id de la vista de administración dinámica sys.dm_filestream_non_transacted_handles (Transact-SQL). Cada Id. es único en una instancia de SQL Server. Si especifica handle_id, también tiene que proporcionar un valor para table_name.Puede pasar NULL como valor de handle_id para cerrar todos los identificadores no transaccionales abiertos para el objeto FileTable especificado por table_name. El valor predeterminado es NULL.
Valor del código de retorno
0 (correcto) o 1 (error)
Conjunto de resultados
Ninguno.
Comentarios generales
El objeto handle_id requerido por sp_kill_filestream_non_transacted_handles no está relacionado con el objeto session_id o la unidad de trabajo utilizada en otros comandos kill.
Para obtener más información, vea Administrar FileTables.
Metadatos
Para obtener información sobre identificadores de archivos no transaccionales abiertos, consulte la vista de administración dinámica sys.dm_filestream_non_transacted_handles (Transact-SQL).
Seguridad
Permisos
Debe tener el permiso VIEW DATABASE STATE para obtener identificadores de archivos desde la vista de administración dinámica sys.dm_FILESTREAM_non_transacted_handles y ejecutar sp_kill_filestream_non_transacted_handles.
Ejemplos
En los ejemplos siguientes se muestra cómo llamar a sp_kill_filestream_non_transacted_handles para cerrar identificadores de archivos no transaccionales para datos 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
En el ejemplo siguiente se muestra cómo usar un script para obtener un objeto handle_id y cerrarlo.
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