sys.fn_MSxe_read_event_stream (T-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream mengembalikan data biner untuk penggunaan internal oleh kelas QueryableXEventData .NET. UI Extended Events di SQL Server Management Studio (SSMS) menggunakan kelas ini untuk membaca data sesi peristiwa.

Untuk melihat data peristiwa yang dapat dibaca manusia, gunakan salah satu hal berikut alih-alih memanggil sys.fn_MSxe_read_event_stream secara langsung:

Konvensi sintaks transact-SQL

Sintaks

sys.fn_MSxe_read_event_stream ( source , source_option )

Argumen

sumber

Sumber data peristiwa tertentu yang dikembalikan oleh fungsi . Sumber adalah nvarchar(260) tanpa default.

Sumber ditafsirkan secara berbeda tergantung pada nilai source_option:

source_option Interpretasi sumber
0 Sumber adalah nama sesi peristiwa yang dimulai.
1 Sumber adalah jalur ke file log sesi peristiwa untuk dibaca.

Ketika digunakan dengan file dalam sistem file lokal, sumber harus menyertakan nama file log sesi peristiwa dan dapat berisi * sebagai kartubebas.

Saat digunakan dengan blob dalam kontainer Azure Storage, sumber adalah URL HTTP yang dibangun oleh perangkaian dua bagian:

1. Jalur ke kontainer penyimpanan Azure Storage, diikuti dengan garis miring (/).
2. Awalan umum untuk nama blob dalam kontainer yang harus dibaca.

Misalnya, menggunakan https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session sebagai sumber mengambil data dari semua blob dengan nama yang dimulai dengan xe_session, dan terlepas dari sisa nama blob termasuk ekstensi. Kartubebas tidak dapat ditentukan. Kredensial yang memungkinkan akses ke kontainer Azure Storage harus ada.

source_option

Opsi yang menentukan jenis sumber data peristiwa. Nilai yang mungkin adalah:

Nilai Deskripsi
0 Mengembalikan data peristiwa dari target event_stream sesi peristiwa yang dimulai. Fungsi ini dijalankan tanpa batas waktu, mengembalikan data peristiwa baru saat sesi menghasilkannya.
1 Mengembalikan data peristiwa dari file log peristiwa yang diperluas yang ditentukan oleh sumber.

Tabel dikembalikan

Nama kolom Jenis data Deskripsi
jenis int Jenis kejadian. Tidak dapat diubah ke null.
data image Data peristiwa biner. Dapat diubah ke null.

Konten terkait

  • Last updated on