Skip to content

Commit ad5481a

Browse files
committed
Update permissions on function article (UUF 317887)
1 parent 1bda8bb commit ad5481a

1 file changed

Lines changed: 7 additions & 5 deletions

File tree

docs/relational-databases/system-functions/sys-fn-xe-file-target-read-file-transact-sql.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "sys.fn_xe_file_target_read_file (Transact-SQL)"
33
description: "The sys.fn_xe_file_target_read_file system function reads files created by the Extended Events asynchronous file target."
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 02/22/2024
6+
ms.date: 10/10/2024
77
ms.service: sql
88
ms.subservice: system-objects
99
ms.topic: "reference"
@@ -46,7 +46,7 @@ The path to the files to read. *path* can contain wildcards and include the name
4646

4747
The path to the metadata file that corresponds to the file or files specified by the *path* argument. *mdpath* is **nvarchar(260)** with no default.
4848

49-
In [!INCLUDE [sssql11-md](../../includes/sssql11-md.md)] and later versions, you don't need this parameter. It was retained for backward compatibility, for log files generated in previous versions of SQL Server. Starting with [!INCLUDE [sssql16-md](../../includes/sssql16-md.md)], this parameter can be given as `NULL`, as `.xem` files are no longer used.
49+
In [!INCLUDE [sssql11-md](../../includes/sssql11-md.md)] and later versions, you don't need this parameter. It was retained for backward compatibility, for log files generated in previous versions of SQL Server. In [!INCLUDE [sssql16-md](../../includes/sssql16-md.md)] and later versions, this parameter can be given as `NULL`, as `.xem` files are no longer used.
5050

5151
#### *initial_file_name*
5252

@@ -73,13 +73,13 @@ Used to specify last offset read previously and skips all events up to the offse
7373

7474
## Remarks
7575

76-
Reading large result sets by executing `sys.fn_xe_file_target_read_file` in [!INCLUDE [ssManStudio](../../includes/ssmanstudio-md.md)] might result in an error. Use the **Results to File** mode (in [!INCLUDE [ssmanstudiofull-md](../../includes/ssmanstudiofull-md.md)], **Ctrl+Shift+F**) to export large result sets to a human-readable file, to read the file with another tool instead.
76+
Reading large result sets by executing `sys.fn_xe_file_target_read_file` in [!INCLUDE [ssManStudio](../../includes/ssmanstudio-md.md)] might result in an error. Use the **Results to File** mode (in [!INCLUDE [ssmanstudiofull-md](../../includes/ssmanstudiofull-md.md)], **Ctrl+Shift+F**) to export large result sets to a human-readable file, to read the file with another tool instead.
7777

7878
[!INCLUDE [sql2008-md](../../includes/sql2008-md.md)] and [!INCLUDE [sql2008r2](../../includes/sql2008r2-md.md)] accept trace results generated in XEL and XEM format. [!INCLUDE [ssSQL11](../../includes/sssql11-md.md)] Extended Events only support trace results in XEL format. We recommend that you use [!INCLUDE [ssManStudio](../../includes/ssmanstudio-md.md)] to read trace results in XEL format.
7979

8080
### Azure SQL
8181

82-
In [!INCLUDE [ssazuremi-md](../../includes/ssazuremi-md.md)] or [!INCLUDE [ssazure-sqldb](../../includes/ssazure-sqldb.md)], store `.xel` files in Azure Blob Storage. You can use `sys.fn_xe_file_target_read_file` to read from extended event sessions you create yourself and store in Azure Blob Storage. For example walkthrough, review [Event File target code for extended events in Azure SQL Database and Azure SQL Managed Instance](/azure/azure-sql/database/xevent-code-event-file).
82+
In [!INCLUDE [ssazuremi-md](../../includes/ssazuremi-md.md)] or [!INCLUDE [ssazure-sqldb](../../includes/ssazure-sqldb.md)], store `.xel` files in Azure Blob Storage. You can use `sys.fn_xe_file_target_read_file` to read from extended event sessions you create yourself and store in Azure Blob Storage. For example walkthrough, review [Create an event session with an event_file target in Azure Storage](/azure/azure-sql/database/xevent-code-event-file).
8383

8484
If you specify wildcard and/or a path for a local file system, you receive an error message similar to:
8585

@@ -90,7 +90,9 @@ A valid URL beginning with 'https://' is required as value for any filepath spec
9090

9191
## Permissions
9292

93-
Requires `VIEW SERVER STATE` permission on the server.
93+
In [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and previous versions, requires `VIEW SERVER STATE` permission on the server.
94+
95+
In [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] and later versions, requires `VIEW SERVER PERFORMANCE STATE` permission on the server.
9496

9597
## Examples
9698

0 commit comments

Comments
 (0)