Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL Server SSIS Integration Runtime in Azure Data Factory
Per impostare le proprietà dei componenti flusso di dati, tra cui origini, destinazioni e trasformazioni, utilizzare una delle funzionalità seguenti:
Gli editor di componenti forniti da Integration Services. Gli editor includono solo le proprietà personalizzate di ogni componente flusso di dati.
Nella finestra Proprietà sono elencate sia le proprietà personalizzate a livello di componente per ogni elemento, sia le proprietà comuni a tutti gli elementi del flusso di dati.
La finestra di dialogo Editor avanzato consente l'accesso alle proprietà personalizzate di ciascun componente. La finestra di dialogo Editor avanzato consente inoltre di accedere alle proprietà comuni a tutti i componenti del flusso di dati: le proprietà di input, output, output di errore, colonne e colonne esterne.
Impostare le proprietà di un componente flusso di dati usando un editor del componente
In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il flusso di dati con il componente di cui si desidera visualizzare e modificare le proprietà.
Fare doppio clic sul componente del flusso di dati.
Nell'editor del componente visualizzare o modificare i valori delle proprietà e quindi chiudere l'editor.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.
Impostare le proprietà di un componente flusso di dati nella finestra Proprietà
In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il componente di cui si desidera visualizzare e modificare le proprietà.
Fare clic con il pulsante destro del mouse sul componente flusso di dati, quindi scegliere Proprietà.
Visualizzare o modificare i valori delle proprietà, quindi chiudere la finestra Proprietà .
Nota
Molte proprietà sono in sola lettura e non possono essere modificate.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.
Impostare le proprietà di un componente flusso di dati usando l'Editor avanzato
In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
Fare clic sulla scheda Flusso di controllo , quindi fare doppio clic sull'attività Flusso di dati che contiene il componente che si desidera visualizzare o modificare.
Nella finestra di progettazione del flusso di dati fare clic con il pulsante destro del mouse sul componente flusso di dati, quindi scegliere Visualizza editor avanzato.
Nota
In SQL Server i componenti flusso di dati che supportano più input non possono usare la finestra di dialogo Editor avanzato.
Nella finestra di dialogo Editor avanzato eseguire una delle operazioni seguenti:
Fare clic sulla scheda Gestioni connessioni per visualizzare e specificare la connessione usata dal componente.
Nota
La scheda Gestioni connessioni è disponibile solo per i componenti flusso di dati che utilizzano gestioni connessioni per connettersi a origini dati quali file e database.
Fare clic sulla scheda Proprietà componente per visualizzare e modificare le proprietà a livello di componente.
Per visualizzare e modificare le mappature tra le colonne esterne e l'output disponibile, fare clic sulla scheda Mappature delle colonne.
Nota
La scheda Mappature delle colonne è disponibile solo quando si visualizzano o si modificano origini o destinazioni.
Per visualizzare un elenco delle colonne di input disponibili e aggiornare i nomi delle colonne di output, fare clic sulla scheda Colonne di input .
Nota
La scheda Colonne di input è disponibile solo quando si utilizzano trasformazioni o destinazioni. Per altre informazioni, vedere Trasformazioni di Integration Services.
Fare clic sulla scheda Proprietà input e output per visualizzare e modificare le proprietà degli input, degli output e degli output di errore, nonché le proprietà delle colonne in esse contenute.
Nota
Le sorgenti non hanno input. Le destinazioni non hanno output, ad eccezione di un output di errore facoltativo.
Visualizzare o modificare i valori delle proprietà.
Fare clic su OK.
Per salvare il pacchetto aggiornato, dal menu File scegliere Salva elementi selezionati.
Proprietà comuni dei componenti flusso di dati
Gli oggetti del flusso di dati nel modello a oggetti di Microsoft SQL Server Integration Services hanno proprietà comuni e proprietà personalizzate ai livelli di componente, di input e output e di colonna di input e di output. Molte proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
In questo argomento vengono elencate e descritte le proprietà comuni degli oggetti del flusso di dati.
Proprietà del componente
Nel modello a oggetti di Integration Services un componente nel flusso di dati implementa l'interfaccia IDTSComponentMetaData100.
Nella tabella seguente vengono descritte le proprietà dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| ComponentClassID | Stringa | Valore CLSID del componente. |
| Informazioni di contatto | Stringa | Informazioni di contatto dello sviluppatore di un componente. |
| Descrizione | Stringa | Descrizione del componente flusso di dati. Il valore predefinito di questa proprietà è il nome del componente flusso di dati. |
| ID | Intero | Valore che identifica in modo univoco questa istanza del componente. |
| Stringa di identificazione | Stringa | Identifica il componente. |
| IsDefaultLocale | Booleano | Indica se il componente utilizza le impostazioni locali dell'attività Flusso di dati alla quale appartiene. |
| LocaleID | Intero | Le impostazioni locali utilizzate dal componente del flusso di dati quando il pacchetto viene eseguito. Tutte le impostazioni locali di Windows sono disponibili per l'utilizzo nei componenti flusso di dati. |
| Nome | Stringa | Nome del componente del flusso di dati. |
| PipelineVersion | Intero | La versione dell'attività di flusso di dati nella quale un componente è progettato per essere eseguito. |
| Usa disposizioni | Booleano | Indica se un componente dispone di un output di errore. |
| Convalida metadati esterni | Booleano | Indica se i metadati delle colonne esterne sono convalidati. Il valore predefinito di questa proprietà è True. |
| Versione | Intero | Versione di un componente. |
Proprietà di input
Nel modello a oggetti di Integration Services le trasformazioni e le destinazioni includono input. L'input di un componente nel flusso di dati implementa l'interfaccia IDTSInput100.
Nella tabella seguente vengono descritte le proprietà degli input dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| Descrizione | Stringa | Descrizione dell'input. |
| Operazione di errore o troncamento | Stringa | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| Gestione righe di errore | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
| HasSideEffects | Booleano | Indica se un componente può essere rimosso dal piano di esecuzione del flusso di dati se non è collegato a un componente a valle e se la proprietà RunInOptimizedMode è impostata su true. |
| ID | Intero | Valore che identifica l'input in modo univoco. |
| Stringa di identificazione | Stringa | Stringa che identifica l'input. |
| IsSorted | Booleano | Indica se i dati nell'input sono ordinati. |
| Nome | Stringa | Nome dell'input. |
| SourceLocale | Intero | Identificatore delle impostazioni locali (LCID) dei dati di input. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. . I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
Le destinazioni e alcune trasformazioni non supportano gli output di errore e le proprietà ErrorRowDisposition e TruncationRowDisposition di questi componenti sono di sola lettura.
Proprietà delle colonne di input
Nel modello a oggetti di Integration Services un input contiene una raccolta di colonne di input. Una colonna di input di un componente nel flusso di dati implementa l'interfaccia IDTSInputColumn100.
Nella tabella seguente vengono descritte le proprietà delle colonne di input dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| ComparisonFlags | Intero | Set di flag che specificano il confronto di colonne che hanno un tipo di dati character. Per altre informazioni, vedere Comparing String Data. |
| Descrizione | Stringa | Descrive la colonna di input. |
| Operazione di errore o troncamento | Stringa | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| Gestione righe di errore | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | L'ID della colonna di metadati esterna assegnata a una colonna di input. |
| ID | Intero | Valore che identifica la colonna di input in modo univoco. |
| Stringa di identificazione | Stringa | Stringa che identifica la colonna di input. |
| LineageID | Intero | L'ID della colonna a monte. |
| LineageIdentificationString | Stringa | Stringa di identificazione che include il nome della colonna a monte. |
| Nome | Stringa | Nome della colonna di input. |
| Posizione della chiave di ordinamento | Intero | Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne. Il valore 0 indica che la colonna non è ordinata. Per ulteriori informazioni, vedere Ordinare i dati per le trasformazioni Merge e Merge Join. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
| UpstreamComponentName | Stringa | Nome del componente a monte. |
| Tipo di utilizzo | DTSUsageType | Valore che determina come una colonna di input viene utilizzata dal componente. |
Le colonne di input includono anche le proprietà del tipo di dati descritte in "Proprietà del tipo di dati".
Proprietà di output
Nel modello a oggetti di Integration Services le origini e le trasformazioni includono output. Un output di un componente nel flusso di dati implementa l'interfaccia IDTSOutput100.
Nella tabella seguente vengono descritte le proprietà degli output dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| Elimina l'output quando il percorso viene scollegato | Booleano | Valore che determina se il motore del flusso di dati elimina l'output quando viene scollegato da un percorso. |
| Descrizione | Stringa | Descrive l'output. |
| Operazione di errore o troncamento | Stringa | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| Gestione righe di errore | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
| Gruppo di esclusione | Intero | Valore che identifica un gruppo di output che si escludono a vicenda. |
| HasSideEffects | Booleano | Valore che indica se un componente può essere rimosso dal piano di esecuzione del flusso di dati se non è collegato a un componente a monte e se la proprietà RunInOptimizedMode è impostata su true. |
| ID | Intero | Valore che identifica l'output in modo univoco. |
| Stringa di identificazione | Stringa | Stringa che identifica l'output. |
| IsErrorOut | Booleano | Indica se l'output è un output di errore. |
| IsSorted | Booleano | Indica se l'output è ordinato. Il valore predefinito è Falso. ** Importante** L'impostazione del valore della proprietà IsSorted su True non determina l'ordinamento dei dati. Questa proprietà fornisce solo un'indicazione ai componenti a valle che i dati sono stati precedentemente ordinati. Per ulteriori informazioni, vedere Ordinare i dati per le trasformazioni Merge e Merge Join. |
| Nome | Stringa | Nome dell'output. |
| SynchronousInputID | Intero | L'ID di un input sincrono con l'output. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I valori sono Errore del componente, Ignora errore e Reindirizza riga. |
Proprietà delle colonne di output
Nel modello a oggetti di Integration Services un output contiene una raccolta di colonne di output. Una colonna di output di un componente nel flusso di dati implementa l'interfaccia IDTSOutputColumn100.
Nella tabella seguente vengono descritte le proprietà delle colonne di output dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| ComparisonFlags | Intero | Set di flag che specificano il confronto di colonne che hanno un tipo di dati character. Per altre informazioni, vedere Comparing String Data. |
| Descrizione | Stringa | Descrive la colonna di output. |
| Operazione di errore o troncamento | Stringa | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| Gestione righe di errore | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Errore del componente, Ignora errore e Reindirizza riga. Il valore predefinito è Errore del componente. |
| ExternalMetadataColumnID | Intero | L'ID della colonna di metadati esterna assegnata a una colonna di input. |
| ID | Intero | Valore che identifica la colonna di output in modo univoco. |
| Stringa di identificazione | Stringa | Stringa che identifica la colonna di output. |
| LineageID | Intero | L'ID della colonna di uscita. I componenti a valle fanno riferimento alla colonna utilizzando questo valore. |
| LineageIdentificationString | Stringa | Stringa di identificazione che include il nome della colonna. |
| Nome | Stringa | Nome della colonna di output. |
| Posizione della chiave di ordinamento | Intero | Valore che indica se una colonna è ordinata, l'ordinamento e la sequenza di ordinamento di più colonne. Il valore 0 indica che la colonna non è ordinata. Per ulteriori informazioni, vedere Ordinare i dati per le trasformazioni Merge e Merge Join. |
| SpecialFlags | Intero | Un valore che contiene i flag speciali della colonna di output. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I valori sono Errore del componente, Ignora errore e Reindirizza riga. Il valore predefinito è Errore del componente. |
Le colonne di output includono anche un set di proprietà del tipo di dati.
Proprietà delle colonne di metadati esterne
Nel modello a oggetti di Integration Services input e output possono contenere una raccolta di colonne di metadati esterne. Una colonna di metadati esterna di un componente nel flusso di dati implementa l'interfaccia IDTSExternalMetadataColumn100.
Nella tabella seguente vengono descritte le proprietà delle colonne di metadati esterne dei componenti in un flusso di dati. Alcune proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| Descrizione | Stringa | Descrive la colonna esterna. |
| ID | Intero | Valore che identifica la colonna in modo univoco. |
| Stringa di identificazione | Stringa | Stringa che identifica la colonna. |
| Nome | Stringa | Nome della colonna esterna. |
Le colonne di metadati esterne includono anche un set di proprietà del tipo di dati.
Proprietà dei tipi di dati
Le colonne di metadati esterne e le colonne di output includono anche un set di proprietà del tipo di dati. A seconda del tipo di dati della colonna, le proprietà possono essere di lettura/scrittura o di sola lettura.
Nella tabella seguente vengono descritte le proprietà del tipo di dati delle colonne di metadati esterne e delle colonne di output.
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| CodePage | Intero | Specifica la tabella codici per i dati stringa non Unicode. |
| DataType | Integer (enumerazione) | Tipo di dati della colonna in Integration Services. Per altre informazioni, vedere Tipi di dati di Integration Services. |
| Durata | Intero | Lunghezza della colonna in caratteri. |
| Precisione | Intero | Precisione di una colonna numerica. |
| Scala | Intero | Scala di una colonna numerica. |
Proprietà personalizzate dei componenti flusso di dati
Per informazioni sulle proprietà personalizzate, vedere gli argomenti seguenti
Proprietà personalizzate della destinazione dell'addestramento del modello di data mining
Proprietà personalizzate di destinazione per l'elaborazione delle dimensioni
Proprietà personalizzate OLE DB Proprietà personalizzate OLE DB
Proprietà personalizzate della destinazione di elaborazione della partizione
Proprietà personalizzate della destinazione SQL Server Compact Edition
Usare un'espressione in un componente flusso di dati
Questa procedura descrive come aggiungere un'espressione alla trasformazione Suddivisione condizionale o alla trasformazione Colonna derivata. La trasformazione Suddivisione condizionale utilizza espressioni per definire le condizioni che dirigono le righe di dati all'output della trasformazione, mentre la trasformazione Colonna derivata utilizza espressioni per definire i valori assegnati alle colonne.
Per implementare un'espressione in una trasformazione, è necessario che il pacchetto includa almeno un'attività Flusso di dati e un'origine.
In SQL Server Data Tools (SSDT) aprire il progetto di Integration Services che contiene il pacchetto desiderato.
In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.
In Progettazione SSIS fare clic sulla scheda Flusso di controllo e quindi sull'attività Flusso di dati contenente il flusso di dati in cui si vuole implementare un'espressione.
Fare clic sulla scheda Flusso di dati e trascinare nell'area di progettazione una delle trasformazioni, Suddivisione condizionale o Colonna derivata, dalla Casella degli strumenti.
Trascinare il connettore verde dall'origine o da una trasformazione alla trasformazione Suddivisione condizionale o alla trasformazione Colonna derivata.
Fare doppio clic sulla trasformazione. Verrà visualizzata la finestra di dialogo corrispondente.
Nel riquadro di sinistra espandere il nodo Variabili in modo da visualizzare le variabili definite dall'utente e di sistema. Espandere anche il nodo Colonne in modo da visualizzare le colonne di input della trasformazione.
Nel riquadro di destra, espandi i nodi Funzioni matematiche, Funzioni stringa, Funzioni di data/ora, Funzioni NULL, Cast di tipo e Operatori per accedere alle funzioni, ai cast e agli operatori forniti dalla grammatica delle espressioni.
A seconda della trasformazione, compilare un'espressione in uno dei modi seguenti:
Nella finestra di dialogo Editor Trasformazione Suddivisione condizionale, trascinare variabili, colonne, funzioni, operatori e cast nella colonna Condizione. In alternativa, è possibile digitare l'espressione direttamente nella colonna Condizione .
Nella finestra di dialogo Editor della trasformazione Colonna derivata, trascinare variabili, colonne, funzioni, operatori e cast nella colonna Espressione. In alternativa, è possibile digitare l'espressione direttamente nella colonna Espressione .
Nota
Quando si sposta lo stato attivo dalla colonna Condizione o dalla colonna Espressione, il testo dell'espressione potrebbe essere evidenziato per indicare che la sintassi dell'espressione non è corretta.
Fare clic su OK per chiudere la finestra di dialogo.
Nota
Se l'espressione non è valida, viene visualizzato un avviso che evidenzia gli errori di sintassi.
Proprietà del flusso di dati che è possibile impostare con un'espressione
I valori di determinate proprietà di oggetti del flusso di dati possono essere specificati utilizzando espressioni di proprietà disponibili nel contenitore dell'attività Flusso di dati.
Per informazioni sull'utilizzo delle espressioni di proprietà, vedere utilizzo delle espressioni di proprietà nei pacchetti.
È possibile utilizzare espressioni di proprietà per personalizzare la configurazione di ogni istanza di pacchetto distribuita. È anche possibile usare espressioni di proprietà per specificare i vincoli in fase di esecuzione per un pacchetto tramite l'opzione /set con l'utilità del prompt dei comandi dtexec . Ad esempio, è possibile limitare il MaximumThreads utilizzato dalla trasformazione Sort oppure il MaxMemoryUsage delle trasformazioni Fuzzy Grouping e Fuzzy Lookup. Se non vincolate, queste trasformazioni possono memorizzare nella cache grandi quantità di dati.
Per specificare un'espressione di proprietà per una delle proprietà degli oggetti del flusso di dati elencate in questo argomento, visualizzare la finestra Proprietà per l'attività flusso di dati selezionando l'attività flusso di dati nell'area di progettazione Flusso di controllo o selezionando la scheda Flusso di dati della finestra di progettazione senza selezionare componenti o percorsi singoli. Selezionare la proprietà Espressioni e fare clic sul pulsante con i puntini di sospensione (...) per visualizzare la finestra di dialogo Editor delle espressioni della proprietà. Selezionare una proprietà dall'elenco a discesa Proprietà, quindi digitare un'espressione nella casella di testo Espressione oppure fare clic sui puntini di sospensione (...) per visualizzare la finestra di dialogo Generatore di espressioni.
Nell'elenco Proprietà vengono visualizzate le proprietà disponibili solo per gli oggetti del flusso di dati che sono già stati posizionati sulla superficie Flusso di dati della finestra di progettazione. Pertanto, non è possibile usare l'elenco Proprietà per visualizzare tutte le possibili proprietà degli oggetti del flusso di dati che supportano le espressioni di proprietà. Ad esempio, se è stata posizionata un'origine ADO NET nell'area di progettazione, l'elenco Proprietà contiene una voce per la proprietà [ADO NET Source].[SqlCommand] . Nell'elenco vengono anche visualizzate molte proprietà dell'attività Flusso di dati.
È possibile specificare i valori delle proprietà del seguente elenco utilizzando le espressioni di proprietà.
Origini del flusso di dati
| Oggetto del flusso di dati | Proprietà |
|---|---|
| Origine ADO NET | Proprietà TableOrViewName Proprietà SqlCommand |
| Origine XML | Proprietà XMLData Proprietà XMLSchemaDefinition |
Trasformazioni del flusso di dati
Per altre informazioni su queste proprietà personalizzate, vedere proprietà personalizzate della trasformazione.
| Oggetto del flusso di dati | Proprietà |
|---|---|
| Suddivisione condizionale - trasformazione | Proprietà FriendlyExpression |
| Trasformazione di colonna derivata | Proprietà FriendlyExpression |
| Raggruppamento fuzzy - trasformazione | Proprietà MaxMemoryUsage |
| Ricerca fuzzy - trasformazione | Proprietà MaxMemoryUsage |
| Trasformazione Ricerca | Proprietà SqlCommand Proprietà SqlCommandParam |
| Comando OLE DB - trasformazione | Proprietà SqlCommand |
| Trasformazione di campionamento percentuale | Proprietà SamplingValue |
| Trasformazione tramite Pivot | Proprietà PivotKeyValue |
| Campionamento righe - trasformazione | Proprietà SamplingValue |
| Trasformazione di ordinamento | Proprietà MaximumThreads |
| Trasformazione Unpivot | Proprietà PivotKeyValue |
Destinazioni del flusso di dati
| Oggetto del flusso di dati | Proprietà |
|---|---|
| Destinazione ADO NET | Proprietà TableOrViewName Proprietà BatchSize Proprietà CommandTimeout |
| Destinazione file flat | Proprietà dell'intestazione |
| destinazione di SQL Server Compact | Proprietà TableName |
| Destinazione SQL Server | Proprietà BulkInsertTableName Proprietà BulkInsertFirstRow Proprietà BulkInsertLastRow Proprietà BulkInsertOrder Proprietà Tempo di attesa |