Proprietà personalizzate delle destinazioni
Gli oggetti del flusso di dati nei modelli a oggetti di Microsoft SQL Server Integration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output e colonne di input e colonne di output. Le proprietà personalizzate sono disponibili solo in fase di esecuzione e 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 destinazioni del flusso di dati.
Destinazione ADO NET
Destinazione Training modello di data mining
Destinazione DataReader
Destinazione elaborazione dimensione
Destinazione Excel
Destinazione file flat
Destinazione OLE DB
Destinazione elaborazione partizione
Destinazione file non elaborato
Destinazione recordset
Destinazione SQL Server Compact Edition
Destinazione SQL Server
Per informazioni sulle proprietà comuni alla maggior parte degli oggetti del flusso di dati, vedere Proprietà comuni.
Alcune proprietà delle destinazioni 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.
Destinazione ADO NET
La destinazione ADO.NET include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione ADO.NET. Tutte le proprietà sono di lettura/scrittura. Tali proprietà non sono disponibili in Editor di destinazione ADO.NET, ma possono essere impostate tramite Editor avanzato.
Proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
BatchSize |
Integer |
Numero di righe in un batch inviato al server. Il valore 0 indica che le dimensioni del batch corrispondono alle dimensioni del buffer interno. Il valore predefinito di questa proprietà è 0. |
CommandTimeOut |
Integer |
Numero massimo di secondi durante i quali è possibile eseguire il comando SQL prima del timeout. Il valore 0 indica un periodo di tempo infinito. Il valore predefinito di questa proprietà è 0. |
TableOrViewName |
Stringa |
Nome della tabella o vista di destinazione. |
UseBulkInsertWhenAvailable |
Booleano |
Valore che specifica se utilizzare l'interfaccia System.Data.SqlClient..::..SqlBulkCopy per migliorare le prestazioni di operazioni di inserimento bulk. Solo determinati provider ADO.NET supportano tale interfaccia. Il valore predefinito è True. |
Per ulteriori informazioni, vedere Destinazione ADO.NET.
Proprietà personalizzate della destinazione Training modello di data mining
La destinazione Training modello di data mining include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione Training modello di data mining. Tutte le proprietà sono di lettura/scrittura.
Proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
ASConnectionId |
String |
Identificatore univoco della gestione connessione. |
ASConnectionString |
String |
Stringa di connessione a un'istanza di Analysis Services o a un progetto Analysis Services. |
ObjectRef |
String |
Tag XML che identifica la struttura di data mining utilizzata dalla trasformazione. |
L'input e le colonne di input della destinazione Training modelli di data mining non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione Training modello di data mining.
Proprietà personalizzate della destinazione DataReader
La destinazione DataReader include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione DataReader. Tutte le proprietà, ad eccezione di DataReader, sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
DataReader |
String |
Nome di classe della destinazione DataReader. |
FailOnTimeout |
Boolean |
Indica se generare un errore quando si verifica un ReadTimeout. Il valore predefinito di questa proprietà è False. |
ReadTimeout |
Integer |
Numero di millisecondi prima di un timeout. Il valore predefinito di questa proprietà è 30000 (30 secondi). |
L'input e le colonne di input della destinazione DataReader non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione DataReader.
Proprietà personalizzate della destinazione elaborazione dimensione
La destinazione elaborazione dimensione include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione elaborazione dimensione. Tutte le proprietà sono di lettura/scrittura.
Proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
ASConnectionString |
String |
Stringa di connessione a un'istanza di Analysis Services o a un progetto Analysis Services. |
KeyDuplicate |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave duplicata. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
KeyErrorAction |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave. I valori possibili sono ConvertToUnknown (0) e DiscardRecord (1). Il valore predefinito di questa proprietà è ConvertToUnknown (0). |
KeyErrorLimit |
Integer |
Quando UseDefaultConfiguration è False, limite superiore degli errori di chiave consentiti. |
KeyErrorLimitAction |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica l'azione da eseguire quando viene raggiunto il valore KeyErrorLimit. I valori possibili sono StopLogging (1) e StopProcessing (0). Il valore predefinito di questa proprietà è StopProcessing (0). |
KeyErrorLogFile |
String |
Quando UseDefaultConfiguration è False, percorso e nome del file di registro errori. |
KeyNotFound |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave mancante. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
NullKeyConvertedToUnknown |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire le chiavi Null convertite nel valore Sconosciuto. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
NullKeyNotAllowed |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire i valori Null non consentiti. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
ProcessType |
Integer (enumerazione) |
Tipo di elaborazione della dimensione utilizzata dalla trasformazione. I valori possibili sono ProcessAdd (1) (incrementale), ProcessFull (0) e ProcessUpdate (2). |
UseDefaultConfiguration |
Boolean |
Valore che specifica se la trasformazione utilizza la configurazione degli errori predefinita. Se questa proprietà è False, la trasformazione include informazioni sull'elaborazione degli errori. |
L'input e le colonne di input della destinazione elaborazione dimensione non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione elaborazione dimensione.
Proprietà personalizzate della destinazione Excel
La destinazione 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 della destinazione Excel. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
AccessMode |
Integer (enumerazione) |
Valore che specifica la modalità di accesso della destinazione al relativo database di destinazione. Di seguito vengono indicati i possibili valori della proprietà.
|
CommandTimeout |
Integer |
Numero massimo di secondi durante i quali è possibile eseguire il comando SQL prima del timeout. Il valore 0 indica un periodo di tempo infinito. Il valore predefinito di questa proprietà è 0. .gif "Nota") Nota
Questa proprietà non è disponibile in Editor destinazione Excel, ma può essere impostata tramite Editor avanzato.
|
FastLoadKeepIdentity |
Boolean |
Valore che specifica se copiare i valori Identity durante il caricamento dei dati. Questa proprietà è disponibile solo quando si utilizza una delle opzioni di caricamento rapido. Il valore predefinito di questa proprietà è False. |
FastLoadKeepNulls |
Boolean |
Valore che specifica se copiare i valori Null durante il caricamento dei dati. Questa proprietà è disponibile solo con una delle opzioni di caricamento rapido. Il valore predefinito di questa proprietà è False. |
FastLoadMaxInsertCommitSize |
Integer |
Valore che specifica le dimensioni del batch di cui la destinazione Excel tenta di eseguire il commit durante le operazioni di caricamento rapido. Il valore predefinito 0 indica una singola operazione di commit in seguito all'elaborazione di tutte le righe. |
FastLoadOptions |
String |
Raccolta di opzioni di caricamento rapido. Tra le opzioni di caricamento rapido sono inclusi il blocco delle tabelle e la verifica dei vincoli. È possibile specificare una, nessuna o entrambe le opzioni. Nota
Alcune opzioni valide per questa proprietà non sono disponibili in Editor destinazione Excel, ma possono essere impostate tramite Editor avanzato.
|
OpenRowset |
String |
Quando AccessMode è OpenRowset, nome della tabella o della vista a cui accede la destinazione Excel. |
OpenRowsetVariable |
String |
Quando AccessMode è OpenRowset da variabile, nome della variabile che contiene il nome della tabella o della vista a cui accede la destinazione Excel. |
SqlCommand |
String |
Quando AccessMode è Comando SQL, istruzione Transact-SQL utilizzata dalla destinazione Excel per specificare le colonne di destinazione per i dati. |
L'input e le colonne di input della destinazione Excel non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione Excel.
Proprietà personalizzate della destinazione file flat
La destinazione 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 della destinazione file flat. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
Header |
String |
Blocco di testo inserito nel file prima di iniziare a scrivere i dati. È possibile specificare il valore di questa proprietà utilizzando un'espressione di proprietà. |
Overwrite |
Boolean |
Valore che specifica se sovrascrivere o aggiungere dati a un file di destinazione esistente con lo stesso nome. Il valore predefinito di questa proprietà è True. |
L'input e le colonne di input della destinazione file flat non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione file flat.
Proprietà personalizzate della destinazione OLE DB
La destinazione 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 della destinazione OLE DB. Tutte le proprietà sono di lettura/scrittura.
Nota
Le opzioni FastLoad elencate nella tabella (FastLoadKeepIdentity, FastLoadKeepNulls e FastLoadOptions) corrispondono alle proprietà con nome simile esposte dall'interfaccia IRowsetFastLoad implementata dal provider Microsoft OLE DB per SQL Server (SQLOLEDB). Per ulteriori informazioni, eseguire una ricerca di IRowsetFastLoad nel sito Web MSDN Library.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
AccessMode |
Integer (enumerazione) |
Valore che specifica la modalità di accesso della destinazione al relativo database di destinazione. Di seguito vengono indicati i possibili valori della proprietà.
|
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 massimo di secondi durante i quali è possibile eseguire il comando SQL prima del timeout. Il valore 0 indica un periodo di tempo infinito. Il valore predefinito di questa proprietà è 0. Nota
Questa proprietà non è disponibile in Editor destinazione OLE DB, ma può essere impostata tramite Editor avanzato.
|
DefaultCodePage |
Integer |
Tabella codici predefinita associata alla destinazione OLE DB. |
FastLoadKeepIdentity |
Boolean |
Valore che specifica se copiare i valori Identity durante il caricamento dei dati. Questa proprietà è disponibile solo con una delle opzioni di caricamento rapido. Il valore predefinito di questa proprietà è False. Questa proprietà corrisponde alla proprietà IRowsetFastLoad (OLE DB) OLE DB SSPROP_FASTLOADKEEPIDENTITY. |
FastLoadKeepNulls |
Boolean |
Valore che specifica se copiare i valori Null durante il caricamento dei dati. Questa proprietà è disponibile solo con una delle opzioni di caricamento rapido. Il valore predefinito di questa proprietà è False. Questa proprietà corrisponde alla proprietà IRowsetFastLoad (OLE DB) OLE DB SSPROP_FASTLOADKEEPNULLS. |
FastLoadMaxInsertCommitSize |
Integer |
Valore che specifica le dimensioni del batch di cui la destinazione OLE DB tenta di eseguire il commit durante le operazioni di caricamento rapido. Il valore predefinito 2147483647 indica una singola operazione di commit in seguito all'elaborazione di tutte le righe. |
FastLoadOptions |
String |
Raccolta di opzioni di caricamento rapido. Tra le opzioni di caricamento rapido sono inclusi il blocco delle tabelle e la verifica dei vincoli. È possibile specificare una, nessuna o entrambe le opzioni. Questa proprietà corrisponde alla proprietà IRowsetFastLoad OLE DB SSPROP_FASTLOADOPTIONS e accetta opzioni stringa, ad esempio CHECK_CONSTRAINTS e TABLOCK. Nota
Alcune opzioni valide per questa proprietà non sono disponibili in Editor destinazione OLE DB, ma possono essere impostate tramite Editor avanzato.
|
OpenRowset |
String |
Quando AccessMode è OpenRowset, nome della tabella o della vista a cui accede la destinazione OLE DB. |
OpenRowsetVariable |
String |
Quando AccessMode è OpenRowset da variabile, nome della variabile che contiene il nome della tabella o della vista a cui accede la destinazione OLE DB. |
SqlCommand |
String |
Quando AccessMode è Comando SQL, istruzione Transact-SQL utilizzata dalla destinazione OLE DB per specificare le colonne di destinazione per i dati. |
L'input e le colonne di input della destinazione OLE DB non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione OLE DB.
Proprietà personalizzate della destinazione elaborazione partizione
La destinazione elaborazione partizione include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione elaborazione partizione. Tutte le proprietà sono di lettura/scrittura.
Proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
ASConnectionString |
String |
Stringa di connessione a un progetto Analysis Services o a un'istanza di Analysis Services. |
KeyDuplicate |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave duplicata. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
KeyErrorAction |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave. I valori possibili sono ConvertToUnknown (0) e DiscardRecord (1). Il valore predefinito di questa proprietà è ConvertToUnknown (0). |
KeyErrorLimit |
Integer |
Quando UseDefaultConfiguration è False, limite superiore degli errori di chiave consentiti. |
KeyErrorLimitAction |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica l'azione da eseguire quando viene raggiunto il valore KeyErrorLimit. I valori possibili sono StopLogging (1) e StopProcessing (0). Il valore predefinito di questa proprietà è StopProcessing (0). |
KeyErrorLogFile |
String |
Quando UseDefaultConfiguration è False, percorso e nome del file di registro errori. |
KeyNotFound |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire gli errori di chiave mancante. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è ReportAndContinue (1). |
NullKeyConvertedToUnknown |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire le chiavi Null convertite nel valore Sconosciuto. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è IgnoreError (0). |
NullKeyNotAllowed |
Integer (enumerazione) |
Quando UseDefaultConfiguration è False, valore che indica come gestire i valori Null non consentiti. I valori possibili sono IgnoreError (0), ReportAndContinue (1) e ReportAndStop (2). Il valore predefinito di questa proprietà è ReportAndContinue (1). |
ProcessType |
Integer (enumerazione) |
Tipo di elaborazione della partizione utilizzata dalla trasformazione. I valori possibili sono ProcessAdd (1) (incrementale), ProcessFull (0) e ProcessUpdate (2). |
UseDefaultConfiguration |
Boolean |
Valore che specifica se la trasformazione utilizza la configurazione degli errori predefinita. Se questa proprietà è False, la trasformazione utilizza i valori delle proprietà personalizzate di gestione degli errori elencate in questa tabella, incluse KeyDuplicate, KeyErrorAction e così via. |
L'input e le colonne di input della destinazione elaborazione partizione non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione elaborazione partizione.
Proprietà personalizzate della destinazione file non elaborato
La destinazione 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 della destinazione file non elaborato. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
AccessMode |
Integer (enumerazione) |
Valore che specifica se la proprietà FileName include un nome file o il nome di una variabile che contiene un nome file. Le opzioni valide sono File name (0) e File name from variable (1). |
FileName |
String |
Nome del file in cui la destinazione file non elaborato scrive. |
WriteOption |
Integer (enumerazione) |
Valore che specifica se la destinazione file non elaborato elimina un file esistente con lo stesso nome. Le opzioni valide sono Create Always (0), Create Once (1), Truncate and Append (3) e Append (2). Il valore predefinito di questa proprietà è Create Always (0). |
Nota
È possibile eseguire un'operazione di aggiunta solo se i metadati dei dati aggiunti corrispondono a quelli dei dati già presenti nel file.
L'input e le colonne di input della destinazione file non elaborato non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione file non elaborato.
Proprietà personalizzate della destinazione recordset
La destinazione recordset include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione recordset. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
VariableName |
String |
Nome della variabile che contiene il recordset ADO. |
L'input e le colonne di input della destinazione recordset non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione recordset.
Proprietà personalizzate della destinazione SQL Server Compact Edition
La destinazione SQL Server Compact include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione SQL Server Compact. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
TableName |
String |
Nome della tabella di destinazione in un database di SQL Server Compact. È possibile specificare il valore di questa proprietà utilizzando un'espressione di proprietà. |
L'input e le colonne di input della destinazione SQL Server Compact non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione SQL Server Compact Edition.
Proprietà personalizzate della destinazione SQL Server
La destinazione SQL Server include sia proprietà personalizzate che le proprietà comuni a tutti i componenti del flusso di dati.
Nella tabella seguente vengono descritte le proprietà personalizzate della destinazione SQL Server. Tutte le proprietà sono di lettura/scrittura.
Nome proprietà |
Tipo di dati |
Descrizione |
|---|---|---|
AlwaysUseDefaultCodePage |
Boolean |
Forza l'utilizzo del valore della proprietà DefaultCodePage. Il valore predefinito di questa proprietà è False. |
BulkInsertCheckConstraints |
Boolean |
Valore che specifica se l'inserimento bulk verifica i vincoli. Il valore predefinito di questa proprietà è True. |
BulkInsertFireTriggers |
Boolean |
Valore che specifica se l'inserimento bulk attiva trigger nelle tabelle. Il valore predefinito di questa proprietà è False. |
BulkInsertFirstRow |
Integer |
Valore che specifica la prima riga da inserire. Il valore predefinito di questa proprietà è -1, che indica che non è stato assegnato alcun valore. |
BulkInsertKeepIdentity |
Boolean |
Valore che specifica se i valori possono essere inseriti in colonne Identity. Il valore predefinito di questa proprietà è False. |
BulkInsertKeepNulls |
Boolean |
Valore che specifica se l'inserimento bulk mantiene i valori Null. Il valore predefinito di questa proprietà è False. |
BulkInsertLastRow |
Integer |
Valore che specifica l'ultima riga da inserire. Il valore predefinito di questa proprietà è -1, che indica che non è stato assegnato alcun valore. |
BulkInsertMaxErrors |
Integer |
Valore che specifica il numero massimo di errori che possono verificarsi prima dell'arresto dell'inserimento bulk. Il valore predefinito di questa proprietà è -1, che indica che non è stato assegnato alcun valore. |
BulkInsertOrder |
String |
Nomi delle colonne di ordinamento. È possibile ordinare ogni colonna in ordine crescente o decrescente. Se si utilizzano più colonne di ordinamento, i nomi delle colonne saranno separati da virgole. |
BulkInsertTableName |
String |
Tabella o vista SQL Server nel database in cui vengono copiati i dati. |
BulkInsertTablock |
Boolean |
Valore che specifica se la tabella è bloccata durante l'inserimento bulk. Il valore predefinito di questa proprietà è True. |
DefaultCodePage |
Integer |
Tabella codici da utilizzare quando le informazioni sulla tabella codici non sono disponibili dall'origine dati. |
MaxInsertCommitSize |
Integer |
Valore che specifica il numero massimo di righe da inserire in un batch. Quando il valore è zero, tutte le righe vengono inserite in un singolo batch. |
Timeout |
Integer |
Valore che specifica il numero di secondi di attesa della destinazione SQL Server prima della chiusura se non vi sono dati disponibili per l'inserimento. Il valore 0 indica l'assenza di timeout per la destinazione SQL Server. Il valore predefinito di questa proprietà è 30. |
L'input e le colonne di input della destinazione SQL Server non includono proprietà personalizzate.
Per ulteriori informazioni, vedere Destinazione SQL Server.