Condividi tramite


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à.

  • OpenRowset (0): specificare il nome di una tabella o di una vista.

  • OpenRowset from Variable (1): specificare il nome di una variabile contenente il nome di una tabella o di una vista.

  • OpenRowset Using Fastload (3): specificare il nome di una tabella o di una vista.

  • OpenRowset Using Fastload from Variable (4): specificare il nome di una variabile contenente il nome di una tabella o di una vista.

  • SQL Command (2): specificare un'istruzione SQL.

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.

NotaNota
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.

NotaNota
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à.

  • OpenRowset (0): specificare il nome di una tabella o di una vista.

  • OpenRowset from Variable (1): specificare il nome di una variabile contenente il nome di una tabella o di una vista.

  • OpenRowset Using Fastload (3): specificare il nome di una tabella o di una vista.

  • OpenRowset Using Fastload from Variable (4): specificare il nome di una variabile contenente il nome di una tabella o di una vista.

  • SQL Command (2): specificare un'istruzione SQL.

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.

NotaNota
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.

NotaNota
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.