Articolo
09/28/2010

Proprietà personalizzate delle origini

Gli oggetti del flusso di dati nei modelli di oggetti di MicrosoftSQL ServerIntegration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output e colonne di input e colonne di output. È possibile accedere alle proprietà personalizzate solo in fase di esecuzione. Tali proprietà non vengono trattate nella documentazione di riferimento relativa alla programmazione gestita in Integration Services.

In questo argomento vengono elencate e descritte le proprietà personalizzate delle origini del flusso di dati.

Origine ADO NET
Origine Excel
Origine file flat
Origine OLE DB
Origine file non elaborato
Origine XML

Per informazioni sulle proprietà comuni alla maggior parte degli oggetti del flusso di dati, vedere Proprietà comuni.

Alcune proprietà delle origini possono essere impostate utilizzando espressioni di proprietà, come indicato in questo argomento. Per ulteriori informazioni, vedere Proprietà del flusso di dati che è possibile impostare tramite espressioni.

Proprietà personalizzate dell'origine ADO.NET

L'origine OLE DB include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine ADO.NET. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
CommandTimeout	String	Valore che specifica il numero di secondi di attesa prima che si verifichi il timeout del comando SQL. Il valore 0 indica che non è impostato alcun timeout del comando.
SqlCommand	String	Istruzione SQL utilizzata dall'origine ADO.NET per l'estrazione dei dati. Durante il caricamento del pacchetto, è possibile aggiornare dinamicamente la proprietà con l'istruzione SQL che verrà utilizzata dall'origine ADO.NET. Per ulteriori informazioni, vedere Guida di riferimento alle espressioni in Integration Services e Utilizzo delle espressioni di proprietà nei pacchetti.
AllowImplicitStringConversion	Boolean	Valore che indica se si verificano le condizioni seguenti: Nessuna generazione di un errore di convalida in caso di mancata corrispondenza tra i tipi di metadati esterni e i tipi stringa delle colonne di output (DT_WSTR o DT_NTEXT). Conversione implicita dei tipi di metadati esterni nel tipo di dati stringa utilizzato dalla colonna di output. Il valore predefinito è TRUE. Per ulteriori informazioni, vedere Origine ADO NET.

CommandTimeout

String

Valore che specifica il numero di secondi di attesa prima che si verifichi il timeout del comando SQL. Il valore 0 indica che non è impostato alcun timeout del comando.

SqlCommand

String

Istruzione SQL utilizzata dall'origine ADO.NET per l'estrazione dei dati.

Durante il caricamento del pacchetto, è possibile aggiornare dinamicamente la proprietà con l'istruzione SQL che verrà utilizzata dall'origine ADO.NET. Per ulteriori informazioni, vedere Guida di riferimento alle espressioni in Integration Services e Utilizzo delle espressioni di proprietà nei pacchetti.

AllowImplicitStringConversion

Boolean

Valore che indica se si verificano le condizioni seguenti:

Nessuna generazione di un errore di convalida in caso di mancata corrispondenza tra i tipi di metadati esterni e i tipi stringa delle colonne di output (DT_WSTR o DT_NTEXT).
Conversione implicita dei tipi di metadati esterni nel tipo di dati stringa utilizzato dalla colonna di output.

Il valore predefinito è TRUE.

Per ulteriori informazioni, vedere Origine ADO NET.

L'output e le colonne di output dell'origine ADO.NET non includono proprietà personalizzate.

Per ulteriori informazioni, vedere Origine ADO NET.

Proprietà personalizzate dell'origine Excel

L'origine Excel include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine Excel. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
AccessMode	Integer	Modalità utilizzata per accedere al database. I valori possibili sono OpenRowset, OpenRowset da variabile, Comando SQL e Comando SQL da variabile. Il valore predefinito è OpenRowset.
CommandTimeout	Integer	Numero di secondi prima del timeout del comando. Il valore 0 indica un timeout infinito. Nota Questa proprietà non è disponibile in Editor origine Excel, ma può essere impostata tramite Editor avanzato.
OpenRowset	String	Nome dell'oggetto di database utilizzato per aprire un set di righe.
OpenRowsetVariable	String	Variabile che contiene il nome dell'oggetto di database utilizzato per aprire un set di righe.
ParameterMapping	String	Mapping tra i parametri nel comando SQL e le variabili.
SqlCommand	String	Comando SQL da eseguire.
SqlCommandVariable	String	Variabile che contiene il comando SQL da eseguire.

L'output e le colonne di output dell'origine Excel non includono proprietà personalizzate.

Per ulteriori informazioni, vedere Origine Excel.

Proprietà personalizzate dell'origine file flat

L'origine file flat include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine file flat. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
FileNameColumnName	String	Nome di una colonna di output contenente il nome file. Se non si specifica alcun nome, non verrà generata alcuna colonna contenente il nome file. Nota Questa proprietà non è disponibile in Editor origine file flat, ma può essere impostata tramite Editor avanzato.
RetainNulls	Boolean	Valore che specifica se i valori Null dal file di origine devono essere mantenuti come tali durante l'elaborazione dei dati tramite il motore della pipeline di trasformazione dati. Il valore predefinito di questa proprietà è False.

L'output dell'origine file flat non include proprietà personalizzate.

Nella tabella seguente vengono descritte le proprietà personalizzate delle colonne di output dell'origine file flat. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
FastParse	Boolean	Valore che indica se la colonna utilizza le routine di analisi più veloci ma indipendenti dalle impostazioni locali disponibili in DTS oppure le routine di analisi standard dipendenti dalle impostazioni locali. Per ulteriori informazioni, vedere Analisi veloce e Analisi standard. Il valore predefinito di questa proprietà è False. Nota Questa proprietà non è disponibile in Editor origine file flat, ma può essere impostata tramite Editor avanzato.

Per ulteriori informazioni, vedere Origine file flat.

Proprietà personalizzate dell'origine OLE DB

L'origine OLE DB include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine OLE DB. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
AccessMode	Integer	Modalità utilizzata per accedere al database. I valori possibili sono OpenRowset, OpenRowset da variabile, Comando SQL e Comando SQL da variabile. Il valore predefinito è OpenRowset.
AlwaysUseDefaultCodePage	Boolean	Valore che indica se utilizzare il valore della proprietà DefaultCodePage per ogni colonna o se tentare di dedurre la tabella codici dalle impostazioni locali di ogni colonna. Il valore predefinito di questa proprietà è False.
CommandTimeout	Integer	Numero di secondi prima del timeout del comando. Il valore 0 indica un timeout infinito. Nota Questa proprietà non è disponibile in Editor origine OLE DB, ma può essere impostata tramite Editor avanzato.
DefaultCodePage	Integer	Tabella codici da utilizzare quando le informazioni sulla tabella codici non sono disponibili dall'origine dati.
OpenRowset	String	Nome dell'oggetto di database utilizzato per aprire un set di righe.
OpenRowsetVariable	String	Variabile che contiene il nome dell'oggetto di database utilizzato per aprire un set di righe.
ParameterMapping	String	Mapping tra i parametri nel comando SQL e le variabili.
SqlCommand	String	Comando SQL da eseguire.
SqlCommandVariable	String	Variabile che contiene il comando SQL da eseguire.

L'output e le colonne di output dell'origine OLE DB non includono proprietà personalizzate.

Per ulteriori informazioni, vedere Origine OLE DB.

Proprietà personalizzate dell'origine file non elaborato

L'origine file non elaborato include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine file non elaborato. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
AccessMode	Integer (enumerazione)	Modalità utilizzata per accedere ai dati non elaborati. I valori possibili sono File name (0) e File name from variable (1). Il valore predefinito è File name (0).
FileName	String	Percorso e nome del file di origine.

L'output e le colonne di output dell'origine file non elaborato non includono proprietà personalizzate.

Per ulteriori informazioni, vedere Origine file non elaborato.

Proprietà personalizzate dell'origine XML

L'origine XML include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.

Nella tabella seguente vengono descritte le proprietà personalizzate dell'origine XML. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà	Tipo di dati	Descrizione
AccessMode	Integer	Modalità utilizzata per accedere ai dati XML.
UseInlineSchema	Boolean	Valore che indica se utilizzare una definizione dello schema inline all'interno dell'origine XML. Il valore predefinito di questa proprietà è False.
XMLData	String	File o variabili da cui recuperare i dati XML. È possibile specificare il valore di questa proprietà utilizzando un'espressione di proprietà.
XMLSchemaDefinition	String	Percorso e nome del file di definizione dello schema (estensione xsd). È possibile specificare il valore di questa proprietà utilizzando un'espressione di proprietà.