Udostępnij za pomocą

sys.fn_MSxe_read_event_stream (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

sys.fn_MSxe_read_event_stream Zwraca dane binarne do użytku wewnętrznego przez klasę QueryableXEventData .NET. Interfejs użytkownika zdarzeń rozszerzonych w programie SQL Server Management Studio (SSMS) używa tej klasy do odczytywania danych sesji zdarzeń.

Aby wyświetlić dane zdarzeń czytelne dla człowieka, użyj jednego z następujących elementów zamiast wywoływać sys.fn_MSxe_read_event_stream bezpośrednio:

Transact-SQL konwencje składni

Składnia

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

źródło

Określone źródło danych zdarzeń zwracanych przez funkcję. Źródło to nvarchar(260) bez wartości domyślnej.

Źródło jest interpretowane inaczej w zależności od wartości source_option:

source_option Interpretacja źródła
0 Źródło jest nazwą uruchomionej sesji zdarzeń.
1 Źródło to ścieżka do plików dziennika sesji zdarzeń do odczytu.

W przypadku użycia z plikami w lokalnym systemie plików źródło musi zawierać nazwę pliku dziennika sesji zdarzeń i może zawierać * jako symbol wieloznaczny.

W przypadku użycia z obiektami blob w kontenerze usługi Azure Storage źródło jest adresem URL HTTP skonstruowanym przez łączenie dwóch części:

1. Ścieżka do kontenera magazynu usługi Azure Storage, po której następuje ukośnik (/).
2. Wspólny prefiks nazw obiektów blob w kontenerze, który należy odczytać.

Na przykład użycie jako https://<storage-account-name>.blob.core.windows.net/container-name>/xe_sessionźródła pobiera dane ze wszystkich obiektów blob z nazwami rozpoczynającymi się od xe_session, a niezależnie od pozostałej części nazwy obiektu blob, w tym rozszerzenia. Nie można określić symboli wieloznacznych. Musi istnieć poświadczenie zezwalające na dostęp do kontenera usługi Azure Storage.

source_option

Opcja określająca typ źródła danych zdarzenia. Dopuszczalne wartości:

Wartość Description
0 Zwraca dane zdarzeń z event_stream celu uruchomionej sesji zdarzeń. Funkcja jest wykonywana na czas nieokreślony, zwracając nowe dane zdarzeń, gdy sesja je generuje.
1 Zwraca dane zdarzeń z rozszerzonych plików dziennika zdarzeń określonych przez źródło.

Zwrócona tabela

Nazwa kolumny Typ danych Description
typ int Typ zdarzenia. Nie można pustą wartość null.
dane image Dane zdarzeń binarnych. Jest dopuszczana wartość null.

Treści powiązane

  • Last updated on