sp_kill_filestream_non_transacted_handles (T-SQL)
Berlaku untuk: SQL Server
Menutup handel file nontransaksi ke data FileTable.
Sintaks
sp_kill_filestream_non_transacted_handles [
[ @table_name = ] 'table_name'
, [ [ @handle_id = ] handle_id ]
]
Argumen
[ @table_name = ] 'table_name'
Nama tabel untuk menutup handel nontransaksi.
Anda dapat meneruskan table_name tanpa handle_id untuk menutup semua handel nontransaksi terbuka untuk FileTable.
Anda dapat meneruskan NULL untuk nilai table_name untuk menutup semua handel nontransaksi terbuka untuk semua FileTable dalam database saat ini. NULL adalah nilai default.
[ @handle_id = ] handle_id
ID opsional dari handel individual yang akan ditutup. Anda bisa mendapatkan handle_id dari tampilan manajemen dinamis sys.dm_filestream_non_transacted_handles (Transact-SQL ). Setiap ID unik dalam instans SQL Server. Jika Anda menentukan handle_id, maka Anda juga harus memberikan nilai untuk table_name.
Anda dapat meneruskan NULL untuk nilai handle_id untuk menutup semua handel nontransaksi terbuka untuk FileTable yang ditentukan oleh table_name. NULL adalah nilai default.
Mengembalikan nilai kode
0
(berhasil) atau 1
(kegagalan).
Tataan hasil
Tidak ada.
Keterangan
handle_id yang diperlukan oleh tidak terkait dengan session_id
sp_kill_filestream_non_transacted_handles
unit kerja atau yang digunakan dalam perintah lainkill
.
Untuk informasi selengkapnya, lihat Mengelola FileTables.
Metadata
Untuk informasi tentang handel file nontransaksi terbuka, kueri tampilan manajemen dinamis sys.dm_filestream_non_transacted_handles (Transact-SQL).
Izin
Anda harus memiliki izin TAMPILKAN STATUS DATABASE untuk mendapatkan handel file dari sys.dm_filestream_non_transacted_handles
tampilan manajemen dinamis dan untuk menjalankan sp_kill_filestream_non_transacted_handles
.
Contoh
Contoh berikut menunjukkan cara memanggil sp_kill_filestream_non_transacted_handles
untuk menutup handel file nontransaksi untuk data 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;
Contoh berikut menunjukkan cara menggunakan skrip untuk mendapatkan handle_id dan menutupnya.
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