Read-SqlXEvent
Legge SQL Server XEvent dal file XEL o dalla sessione XEvent di SQL live.
Sintassi
Read-SqlXEvent
[-FileName] <String>
[<CommonParameters>] Read-SqlXEvent
-ConnectionString <String>
-SessionName <String>
[<CommonParameters>] Descrizione
Il Read-SqlXEvent legge SQL Server XEvent da un file o da una sessione XEvent SQL attiva. Le sessioni XEvent vengono create dall'API Transact-SQL CREATE EVENT SESSION. I file XEvent di SQL hanno in genere . Estensioni XEL o sqlaudit e contengono un flusso di eventi XEvent. La struttura degli XEvents è definita nella configurazione della sessione. I flussi live SQL sono disponibili tramite il protocollo SQL TDS e richiedono l'autenticazione sul server che li ha prodotti.
New in v22: if you are using the -ConnectionString parameter, you may get an error like "The certificate chain was issued by an authority that is not trusted." This is because the new SQL driver changed its default to something more secure. Either make sure you configure your server properly, or install/trust the certificate; alternatively (not recommended), you can pass Encrypt=Optional or TrustServerCertificate=true in the connection string to go back to the behavior that existed in v21 of the module.
Esempio
Esempio 1: Leggere e analizzare il file sqlaudit. Ogni oggetto restituito conterrà tutte le informazioni di un singolo record di controllo.
Read-SqlXEvent -FileName C:\audits\Audit-20190529-132659.sqlaudit
# The output would look like this:
#
# Name : audit_event
# UUID : c6479a6f-f1bd-4759-9881-fcb493821aff
# Timestamp : 6/13/2019 7:49:42 AM +00:00
# Fields : {[audit_schema_version, 1], [event_time, 6/13/2019 7:49:42 AM +00:00], [sequence_number, 1], [action_id,
# 1129534785]...}
# Actions : {}
#
# Name : audit_event
# UUID : c6479a6f-f1bd-4759-9881-fcb493821aff
# Timestamp : 6/13/2019 12:42:28 PM +00:00
# Fields : {[audit_schema_version, 1], [event_time, 6/13/2019 12:42:28 PM +00:00], [sequence_number, 1], [action_id,
# 1129534785]...}
# Actions : {}
# ...Esempio 2: Leggere e analizzare il flusso live di XEvents dal SQL Server in esecuzione nello stesso computer connesso con autenticazione di Windows. Ogni oggetto restituito conterrà tutte le informazioni di un singolo record XEvent.
Read-SQLXEvent -ConnectionString "Server=.;Database=master;Trusted_Connection=True" -SessionName telemetry_xevents
# The output would look like this:
#
# Name : auto_stats
# UUID : 9237e17a-a73d-4832-8936-f319e19e219b
# Timestamp : 11/14/2022 5:31:12 AM +00:00
# Fields : {[database_id, 1], [object_id, 74], [index_id, 1], [job_id, 0]…}
# Actions : {}
#
# Name : auto_stats
# UUID : 9237e17a-a73d-4832-8936-f319e19e219b
# Timestamp : 11/14/2022 5:31:12 AM +00:00
# Fields : {[database_id, 1], [object_id, 74], [index_id, 17], [job_id, 0]…}
# Actions : {}
# ...Parametri
-ConnectionString
SQL Server stringa di connessione.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileName
Nome file di un file XEvent da leggere.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SessionName
Il SQL Server nome della sessione XEvent come definito dal transact-SQL CREATE EVENT SESSION.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
System.String
Output
Microsoft.SqlServer.XEvent.XELite.IXEvent