Compartilhar via


sys.fn_MSxe_read_event_stream (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

sys.fn_MSxe_read_event_stream retorna dados binários para uso interno pela classe .NET QueryableXEventData . A interface do usuário de eventos estendidos no SSMS (SQL Server Management Studio) usa essa classe para ler dados da sessão de eventos.

Para exibir dados de eventos legíveis por humanos, use um dos seguintes, em vez de chamar sys.fn_MSxe_read_event_stream diretamente:

Convenções de sintaxe de Transact-SQL

Sintaxe

sys.fn_MSxe_read_event_stream ( source , source_option )

Argumentos

origem

A fonte específica dos dados de evento retornados pela função. A origem é nvarchar(260) sem padrão.

A origem é interpretada de forma diferente dependendo do valor de source_option:

source_option Interpretação da origem
0 A origem é o nome de uma sessão de evento iniciada.
1 A origem é o caminho para os arquivos de log de sessão de eventos a serem lidos.

Quando usado com arquivos no sistema de arquivos local, a origem deve incluir o nome de um arquivo de log de sessão de eventos e pode conter * como um curinga.

Quando usado com blobs em um contêiner do Armazenamento do Azure, a origem é uma URL HTTP construída pela concatenação de duas partes:

1. O caminho para um contêiner de armazenamento do Armazenamento do Azure, seguido por uma barra (/).
2. Um prefixo comum para os nomes de blobs no contêiner que devem ser lidos.

Por exemplo, usar https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session como origem recupera dados de todos os blobs com nomes começando com xe_session, e independentemente do restante do nome do blob, incluindo a extensão. Curingas não podem ser especificados. Uma credencial que permite o acesso ao contêiner do Armazenamento do Azure deve existir.

source_option

A opção que determina o tipo da fonte de dados do evento. Os valores possíveis são:

Value Descrição
0 Retorna dados de evento do destino event_stream de uma sessão de evento iniciada. A função é executada indefinidamente, retornando novos dados de evento à medida que a sessão os produz.
1 Retorna dados de evento dos arquivos de log de eventos estendidos especificados pela origem.

Tabela retornada

Nome da coluna Tipo de dados Descrição
tipo int O tipo de evento. Não é anulável.
dados image Dados de eventos binários. Permite valor nulo.