Impostazione delle proprietà di un componente del flusso di dati
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:
Editor dei 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 anche di accedere alle proprietà comuni a tutti i componenti flusso di dati, ossia le proprietà degli input, degli output, degli output degli errori, delle colonne e delle 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.
Fare clic sulla scheda Mapping colonne per visualizzare e modificare i mapping tra le colonne esterne e l'output disponibile.
Nota
La scheda Mapping colonne è disponibile solo durante la visualizzazione o la modifica di 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 degli errori, nonché le proprietà delle colonne che contengono.
Nota
Le origini non includono input, mentre le destinazioni non includono output, ad eccezione di un output degli errori 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 flusso di dati nel modello a oggetti di Microsoft SQL Server Integration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output, colonne di input e colonne 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 | String | Valore CLSID del componente. |
| ContactInfo | String | 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 | Nr. intero | Valore che identifica in modo univoco questa istanza del componente. |
| IdentificationString | String | Identifica il componente. |
| IsDefaultLocale | Booleano | Indica se il componente utilizza le impostazioni locali dell'attività Flusso di dati alla quale appartiene. |
| LocaleID | Intero | Impostazioni locali che il componente flusso di dati utilizza durante l'esecuzione del pacchetto. Tutte le impostazioni locali di Windows sono disponibili per l'utilizzo nei componenti flusso di dati. |
| Nome | string | Nome del componente del flusso di dati. |
| PipelineVersion | Intero | Versione dell'attività Flusso di dati nella quale il componente è progettato per l'esecuzione. |
| UsesDispositions | Booleano | Indica se un componente ha un output degli errori. |
| ValidateExternalMetadata | 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. |
| ErrorOrTruncationOperation | String | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| ErrorRowDisposition | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Interrompi componente, Ignora erroree 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 | Nr. intero | Valore che identifica l'input in modo univoco. |
| IdentificationString | String | Stringa che identifica l'input. |
| IsSorted | Booleano | Indica se i dati nell'input sono ordinati. |
| Nome | string | Nome dell'input. |
| SourceLocale | Intero | ID 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 Interrompi componente, Ignora erroree Reindirizza riga. |
Le destinazioni e alcune trasformazioni non supportano gli output degli errori 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. |
| ErrorOrTruncationOperation | String | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| ErrorRowDisposition | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Interrompi componente, Ignora erroree Reindirizza riga. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | ID della colonna di metadati esterna assegnato a una colonna di input. |
| ID | Nr. intero | Valore che identifica la colonna di input in modo univoco. |
| IdentificationString | String | Stringa che identifica la colonna di input. |
| LineageID | Intero | ID della colonna a monte. |
| LineageIdentificationString | String | Stringa di identificazione che include il nome della colonna a monte. |
| Nome | string | Nome della colonna di input. |
| SortKeyPosition | 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 altre informazioni, vedere Ordinamento dei dati per le trasformazioni Unione e Merge Join. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I valori sono Interrompi componente, Ignora erroree Reindirizza riga. |
| UpstreamComponentName | String | Nome del componente a monte. |
| UsageType | 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. L'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 |
|---|---|---|
| DeleteOutputOnPathDetached | 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. |
| ErrorOrTruncationOperation | String | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| ErrorRowDisposition | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Interrompi componente, Ignora erroree Reindirizza riga. |
| ExclusionGroup | 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 | Nr. intero | Valore che identifica l'output in modo univoco. |
| IdentificationString | String | Stringa che identifica l'output. |
| IsErrorOut | Booleano | Indica se l'output è un output degli errori. |
| 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 hint ai componenti a valle in relazione all'ordinamento precedente dei dati. Per altre informazioni, vedere Ordinamento dei dati per le trasformazioni Unione e Merge Join. |
| Nome | string | Nome dell'output. |
| SynchronousInputID | Intero | ID di un input sincrono all'output. |
| TruncationRowDisposition | DTSRowDisposition | Valore che determina la gestione dei troncamenti da parte del componente durante l'elaborazione delle righe. I valori sono Interrompi componente, Ignora erroree 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. |
| ErrorOrTruncationOperation | String | Stringa facoltativa che specifica i tipi di errori o troncamenti che possono verificarsi durante l'elaborazione di una riga. |
| ErrorRowDisposition | DTSRowDisposition | Valore che specifica la gestione degli errori. I valori sono Interrompi componente, Ignora erroree Reindirizza riga. Il valore predefinito è Interrompi componente. |
| ExternalMetadataColumnID | Intero | ID della colonna di metadati esterna assegnato a una colonna di input. |
| ID | Nr. intero | Valore che identifica la colonna di output in modo univoco. |
| IdentificationString | String | Stringa che identifica la colonna di output. |
| LineageID | Intero | ID della colonna di output. I componenti a valle fanno riferimento alla colonna utilizzando questo valore. |
| LineageIdentificationString | String | Stringa di identificazione che include il nome della colonna. |
| Nome | string | Nome della colonna di output. |
| SortKeyPosition | 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 altre informazioni, vedere Ordinamento dei dati per le trasformazioni Unione e Merge Join. |
| SpecialFlags | Intero | 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 Interrompi componente, Ignora erroree Reindirizza riga. Il valore predefinito è Interrompi 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 | Nr. intero | Valore che identifica la colonna in modo univoco. |
| IdentificationString | String | Stringa che identifica la colonna. |
| Nome | string | 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. |
| Tipo di dati | Integer (enumerazione) | Tipo di dati Integration Services della colonna. Per altre informazioni, vedere Tipi di dati di Integration Services. |
| Durata | Intero | Lunghezza della colonna in caratteri. |
| Precisione | Intero | Precisione di una colonna numerica. |
| Ridimensiona | 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 Training modello di data mining
Proprietà personalizzate della destinazione elaborazione dimensione
Proprietà personalizzate OLE DB Proprietà personalizzate OLE DB
Proprietà personalizzate della destinazione elaborazione partizione
Proprietà personalizzate della destinazione SQL Server Compact Edition
Usare un'espressione in un componente flusso di dati
In questo argomento viene descritta la procedura per l'aggiunta di un'espressione nella trasformazione Suddivisione condizionale o 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 una trasformazione Suddivisione condizionale o Colonna derivata dalla casella degli strumenti all'area di progettazione.
Trascinare il connettore verde dall'origine o trasformazione alla trasformazione Suddivisione condizionale o 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 espandere i nodi Funzioni matematiche, Funzioni per i valori stringa, Funzioni di data/ora, Funzioni NULL, Cast di tipoe Operatori per accedere alle funzioni, ai cast e agli operatori del linguaggio 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 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 lo stato attivo viene rimosso dalla colonna Condizione o 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 vincolare il MaximumThreads usato dalla trasformazione dell'ordinamento o il MaxMemoryUsage delle trasformazioni del raggruppamento fuzzy e della ricerca fuzzy. 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 sui puntini di sospensione per visualizzare la finestra di dialogo Editor espressioni di proprietà . Visualizzare l'elenco a discesa Proprietà per selezionare una proprietà, quindi digitare un'espressione nella casella di testo Espressione o fare clic sui puntini di sospensione per visualizzare la finestra di dialogo Generatore di espressioni .
Nell'elenco Proprietà vengono visualizzate le proprietà disponibili per gli oggetti del flusso di dati già posizionati nell'area di progettazione Flusso di dati . 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 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 |
| Campionamento percentuale - trasformazione | Proprietà SamplingValue |
| Trasformazione tramite Pivot | Proprietà PivotKeyValue |
| Campionamento righe - trasformazione | Proprietà SamplingValue |
| Ordinamento - trasformazione | 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 |
| file flat - destinazione | Proprietà dell'intestazione |
| destinazione di SQL Server Compact | Proprietà TableName |
| SQL Server - destinazione | Proprietà BulkInsertTableName Proprietà BulkInsertFirstRow Proprietà BulkInsertLastRow Proprietà BulkInsertOrder Proprietà Timeout |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per