Condividi tramite


Proprietà personalizzate delle origini

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

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.

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

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

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

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

Nome proprietà

Tipo di dati

Descrizione

RowsetID

String

Valore che identifica il set di righe associato all'output.

Le colonne di output dell'origine XML non includono proprietà personalizzate.

Per ulteriori informazioni, vedere Origine XML.