sys.fn_MSxe_read_event_stream (Transact-SQL)

Область применения:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

sys.fn_MSxe_read_event_stream возвращает двоичные данные для внутреннего использования класса QueryableXEventData .NET. Пользовательский интерфейс расширенных событий в СРЕДЕ SQL Server Management Studio (SSMS) использует этот класс для чтения данных сеанса событий.

Чтобы просмотреть данные событий, доступные для чтения, используйте одно из следующих действий, а не вызов sys.fn_MSxe_read_event_stream напрямую:

Пользовательский интерфейс расширенных событий в SSMS.
sys.fn_xe_file_target_read_file табличное значение функции.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sys.fn_MSxe_read_event_stream ( source , source_option )

Аргументы

источник

Конкретный источник данных события, возвращаемых функцией. Источник — nvarchar(260) без значения по умолчанию.

Источник интерпретируется по-разному в зависимости от значения source_option:

source_option Интерпретация источника

0 Источник — это имя сеанса запущенного события.

1 Источник — это путь к файлам журнала сеанса событий для чтения.

При использовании с файлами в локальной файловой системе источник должен содержать имя файла журнала сеансов событий и может содержать * подстановочный знак.

При использовании с большими двоичными объектами в контейнере службы хранилища Azure источник — это URL-адрес HTTP, созданный объединением двух частей:

1. Путь к контейнеру хранилища Azure, за которым следует косая черта (/).
2. Общий префикс для имен больших двоичных объектов в контейнере, который должен быть прочитан.

Например, использование https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session в качестве источника извлекает данные из всех больших двоичных объектов с именами, начиная xe_sessionс, и независимо от оставшейся части имени большого двоичного объекта, включая расширение. Не удается указать подстановочные знаки. Учетные данные, разрешающие доступ к контейнеру службы хранилища Azure, должны существовать.

source_option	Интерпретация источника
`0`	Источник — это имя сеанса запущенного события.
`1`	Источник — это путь к файлам журнала сеанса событий для чтения. При использовании с файлами в локальной файловой системе источник должен содержать имя файла журнала сеансов событий и может содержать `` подстановочный знак. При использовании с большими двоичными объектами в контейнере службы хранилища Azure источник* — это URL-адрес HTTP, созданный объединением двух частей: 1. Путь к контейнеру хранилища Azure, за которым следует косая черта (`/`). 2. Общий префикс для имен больших двоичных объектов в контейнере, который должен быть прочитан. Например, использование `https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session` в качестве источника извлекает данные из всех больших двоичных объектов с именами, начиная `xe_session`с, и независимо от оставшейся части имени большого двоичного объекта, включая расширение. Не удается указать подстановочные знаки. Учетные данные, разрешающие доступ к контейнеру службы хранилища Azure, должны существовать.

source_option

Параметр, определяющий тип источника данных события. Возможны следующие значения:

Ценность	Описание
`0`	Возвращает данные о событиях из целевого объекта event_stream запущенного сеанса событий. Функция выполняется на неопределенный срок, возвращая новые данные события, как сеанс создает его.
`1`	Возвращает данные о событиях из файлов расширенного журнала событий, указанных источником.

Таблица возвращенной информации

Имя столбца	Тип данных	Описание
type	int	Тип события. Не допускает значения NULL.
.	image	Двоичные данные события. Допускает значение NULL.

Обратная связь

Была ли эта страница полезна?

Last updated on 2025-09-10