Attività di lettura dati WMI

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività Lettore di dati WMI esegue query che utilizzano il linguaggio di query di WMI (Windows Management Instrumentation, Strumentazione gestione Windows) per ottenere da WMI informazioni su un sistema informatico. È possibile utilizzare l'attività Lettore di dati WMI per gli scopi seguenti:

Eseguire query sul registro eventi di Windows di un computer locale o remoto e scrivere le informazioni ottenute in un file o in una variabile.
Ottenere informazioni sulla presenza, lo stato o le proprietà dei componenti hardware e quindi utilizzare tali informazioni per determinare se altre attività nel flusso di controllo devono essere eseguite o meno.
Ottenere un elenco di applicazioni e determinare le versioni installate.

Per configurare l'attività Lettore di dati WMI, procedere nel modo seguente:

Specificare la gestione connessione WMI da utilizzare.
Specificare l'origine della query WQL. La query può essere archiviata in una proprietà dell'attività o all'esterno dell'attività, in una variabile o in un file.
Definire il formato dei risultati della query WQL. L'attività supporta le tabelle, le coppie nome/valore delle proprietà e i valori di proprietà.
Specificare la destinazione della query. La destinazione può essere una variabile o un file.
Indicare se la destinazione della query deve essere sovrascritta, mantenuta oppure accodata.

Se l'origine o la destinazione è un file, l'attività Lettore di dati WMI usa una gestione connessione file per connettersi al file. Per ulteriori informazioni, vedere Flat File Gestione connessioni.

L'attività Lettura dati WMI utilizza un gestore connessioni WMI per connettersi al server da cui legge le informazioni WMI. Per altre informazioni, vedere Gestione connessione WMI.

query WQL

WQL è un sottolinguaggio di SQL che include estensioni per supportare la notifica degli eventi WMI e altre caratteristiche specifiche di WMI. Per ulteriori informazioni su WQL, consultare la documentazione di Windows Management Instrumentation nella MSDN Library.

Nota

Le classi WMI variano a seconda della versione di Windows.

La query WQL seguente restituisce le voci contenute nel registro eventi applicazioni.

SELECT * FROM Win32_NTLogEvent WHERE LogFile = 'Application' AND (SourceName='SQLISService' OR SourceName='SQLISPackage') AND TimeGenerated > '20050117'

La query WQL seguente restituisce informazioni sui dischi logici.

SELECT FreeSpace, DeviceId, Size, SystemName, Description FROM Win32_LogicalDisk

La query WQL seguente restituisce un elenco degli aggiornamenti QFE (Quick Fix Engineering) applicati al sistema operativo.

Select * FROM Win32_QuickFixEngineering

Messaggi di registrazione personalizzati disponibili nell'attività Lettore di dati WMI

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Lettore di dati WMI. Per altre informazioni, vedere Registrazione di Integration Services (SSIS).

Voce di log	Descrizione
WMIDataReaderGettingWMIData	Indica che l'attività ha iniziato la lettura dei dati WMI.
WMIDataReaderOperation	Specifica la query WQL eseguita dall'attività.

Configurazione dell'attività Lettore di dati WMI

È possibile impostare le proprietà a livello di programmazione o tramite Progettazione SSIS.

Per informazioni sulle proprietà che è possibile impostare in Progettazione SSIS, fare clic sull'argomento seguente:

Pagina delle espressioni

Per informazioni sull'impostazione di queste proprietà a livello di codice, fare clic sull'argomento seguente:

WmiDataReaderTask

Per altre informazioni sull'impostazione di queste proprietà in Progettazione SSIS, fare clic sull'argomento seguente:

Impostare le proprietà di un'attività o di un contenitore

Editor attività Lettore di dati WMI (pagina Generale)

Utilizzare la pagina Generale della finestra di dialogo Editor dell'attività Lettore dati WMI per assegnare un nome e una descrizione all'attività Lettore dati WMI.

Per ulteriori informazioni su WMI Query Language (WQL), vedere l'argomento di Windows Management Instrumentation, Esecuzione di query con WQL, nella raccolta MSDN.

Opzioni

Nome
Specificare un nome univoco per l'attività Lettore dati WMI. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Digitare una descrizione dell'attività WMI Data Reader.

Editor attività Lettore di dati WMI (pagina Opzioni WMI)

Usare la pagina Opzioni WMI della finestra di dialogo Editor attività Lettore di dati WMI per specificare l'origine della query WQL (Windows Management Instrumentation Query Language) e la destinazione del risultato della query.

Per ulteriori informazioni su WMI Query Language (WQL), vedere l'argomento di Windows Management Instrumentation, Esecuzione di query con WQL, nella raccolta MSDN.

Opzioni statiche

WMIConnectionName
Selezionare una gestione connessione WMI nell'elenco o creare una nuova gestione connessione facendo clic su <Nuova connessione WMI>.

Argomenti correlatiGestione connessione WMI, Editor gestione connessione WMI

WQLQuerySourceType
Consente di selezionare il tipo di origine della query WQL eseguita dall'attività. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.

Valore	Descrizione
Input diretto	Imposta l'origine su una query WQL. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.
Connessione al file	Selezionare un file che contiene la query WQL. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.
Variabile	Consente di impostare l'origine su una variabile che definisce la query WQL. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.

OutputType
Specificare se l'output deve essere una tabella di dati, un valore di proprietà o il nome e il valore della proprietà.

OverwriteDestination
Consente di specificare se mantenere, sovrascrivere o accodare ai dati originali nel file o nella variabile di destinazione.

DestinationType
Consente di selezionare il tipo di destinazione della query WQL eseguita dall'attività. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.

Valore	Descrizione
Connessione al file	Selezionare un file in cui salvare i risultati della query WQL. Selezionando questo valore viene visualizzata l'opzione dinamica DestinationType.
Variabile	Impostare la variabile in cui archiviare i risultati della query WQL. Selezionando questo valore viene visualizzata l'opzione dinamica DestinationType.

Opzioni dinamiche di WQLQuerySourceType

WQLQuerySourceType = Immissione diretta

WQLQuerySource
Specificare una query oppure fare clic sui puntini di sospensione (...) e immettere una query utilizzando la finestra di dialogo WQL Query.

WQLQuerySourceType = Connessione a file

WQLQuerySource
Selezionare una gestione connessione file nell'elenco oppure crearne una nuova facendo clic su <Nuova connessione>.

Argomenti correlati:File Gestione connessioni, File Gestione connessioni Editor

WQLQuerySourceType = Variabile

WQLQuerySource
Selezionare una variabile nell'elenco oppure crearne una nuova facendo clic su <Nuova variabile...>.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungere una variabile

Opzioni dinamiche di DestinationType

DestinationType = Connessione al file

Destinazione
Selezionare una gestione connessione file nell'elenco oppure crearne una nuova facendo clic su <Nuova connessione>.