Bagikan melalui

sp_kill_filestream_non_transacted_handles (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Menutup handel file nontransaksi ke data FileTable.

Konvensi sintaks transact-SQL

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_idsp_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

Konten terkait