Percorsi in Integration ServicesIntegration Services Paths

Un percorso collega due componenti in un flusso di dati connettendo l'output di un componente all'input dell'altro.A path connects two components in a data flow by connecting the output of one data flow component to the input of another component. Un percorso ha un'origine e una destinazione.A path has a source and a destination. Se un percorso connette, ad esempio, un'origine OLE DB e una trasformazione Ordinamento, l'origine OLE DB costituirà l'origine del percorso e la trasformazione Ordinamento ne costituirà la destinazione.For example, if a path connects an OLE DB source and a Sort transformation, the OLE DB source is the source of the path, and the Sort transformation is the destination of the path. L'origine è il componente da cui inizia il percorso, mentre la destinazione è il componente in cui termina.The source is the component where the path starts, and the destination is the component where the path ends.

Se si esegue un pacchetto in Progettazione SSISSSIS , è possibile visualizzare i dati in un flusso di dati collegando visualizzatori dati a un percorso.If you run a package in SSISSSIS Designer, you can view the data in a data flow by attaching data viewers to a path. Un visualizzatore dati può essere configurato in modo da visualizzare i dati in una griglia.A data viewer can be configured to display data in a grid. Si tratta di un utile strumento di debug.A data viewer is a useful debugging tool. Per altre informazioni, vedere Debug di un flusso di dati.For more information, see Debugging Data Flow.

Configurare il percorsoConfigure the path

In Progettazione SSISSSIS è disponibile la finestra di dialogo Editor percorso flusso di dati che consente di impostare le proprietà di un percorso, visualizzare i metadati delle colonne di dati che passano attraverso il percorso e configurare i visualizzatori dati.The SSISSSIS Designer provides the Data Flow Path Editor dialog box for setting path properties, viewing the metadata of the data columns that pass through the path, and configuring data viewers.

Le proprietà configurabili di un percorso includono nome, descrizione e annotazione.The configurable path properties include the name, description, and annotation of the path. È possibile configurare i percorsi anche a livello di codice.You can also configure paths programmatically. Per altre informazioni, vedere Connessione dei componenti del flusso di dati a livello di programmazione.For more information, see Connecting Data Flow Components Programmatically.

L'annotazione di un percorso visualizza il nome dell'origine del percorso o il nome del percorso sull'area di progettazione della scheda Flusso di dati in Progettazione SSISSSIS .A path annotation displays the name of the path source or the path name on the design surface of the Data Flow tab in SSISSSIS Designer. Le annotazioni dei percorsi sono simili a quelle che è possibile aggiungere a flussi di dati, flussi di controllo e gestori di eventi.Path annotations are similar to the annotations you can add to data flows, control flows, and event handlers. L'unica differenza è costituita dal fatto che sono collegate a un percorso, mentre le altre annotazioni vengono visualizzate nelle schede Flusso di dati, Flusso di controlloe Gestore eventodi Progettazione SSISSSIS .The only difference is that a path annotation is attached to a path, whereas other annotations appear on the Data Flow, Control Flow, and Event Handler tabs of SSISSSIS Designer.

I metadati indicano il nome, il tipo di dati, la precisione, la scala, la lunghezza, la tabella codici e il componente di origine di ogni colonna nell'output del componente precedente.The metadata shows the name, data type, precision, scale, length, code page, and source component of each column in the output of the previous component. Il componente di origine è il componente del flusso di dati che ha creato la colonnaThe source component is the data flow component that created the column. e può anche non essere il primo componente nel flusso di dati.This may or may not be the first component in the data flow. Le trasformazioni Unione input multipli e Ordinamento, ad esempio, creano proprie colonne e costituiscono pertanto l'origine delle relative colonne di output.For example, the Union All and Sort transformations create their own columns, and they are the sources of their output columns. La trasformazione Copia colonna, invece, può passare colonne senza modificarle oppure creare nuove colonne copiando le colonne di input.In contrast, a Copy Column transformation can pass through columns without changing them or can create new columns by copying input columns. La trasformazione Copia colonna costituisce il componente di origine solo per le nuove colonne.The Copy Column transformation is the source component only of the new columns.

Impostare le proprietà di un percorso con i dati Editor percorso flusso diSet the properties of a path with the Data Flow Path Editor

I percorsi connettono due componenti flusso di dati.Paths connect two data flow components. Affinché sia possibile impostare le proprietà di un percorso, il flusso di dati deve contenere almeno due componenti connessi.Before you can set path properties, the data flow must contain at least two connected data flow components.

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT)aprire il progetto di Integration ServicesIntegration Services che contiene il pacchetto desiderato.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want.

  2. In Esplora soluzioni fare doppio clic sul pacchetto per aprirlo.In Solution Explorer, double-click the package to open it.

  3. Fare clic sulla scheda Flusso di dati , quindi fare doppio clic su un percorso.Click the Data Flow tab, and then double-click a path.

  4. Nella finestra di dialogo Editor percorso flusso di datifare clic su Generale.In Data Flow Path Editor, click General. È possibile modificare il nome predefinito del percorso e specificarne una descrizione.You can then edit the default name of the path and provide a description of the path. È anche possibile modificare la proprietà PathAnnotation.You can also modify the PathAnnotation property.

  5. Scegliere OK.Click OK.

  6. Per salvare il pacchetto aggiornato, scegliere Salva elementi selezionati dal menu File .To save the updated package, click Save Selected Items on the File menu.

Pagina generale - Editor percorso flusso di datiGeneral Page - Data Flow Path Editor

Utilizzare la finestra di dialogo Editor percorso flusso di dati per impostare le proprietà del percorso, visualizzare i metadati delle colonne e gestire i visualizzatori di dati collegati al percorso.Use the Data Flow Path Editor dialog box to set path properties, view column metadata, and manage the data viewers attached to the path.

Utilizzare il nodo Generale della finestra di dialogo Editor percorso flusso di dati per assegnare un nome e una descrizione al percorso e per specificare le opzioni relative all'annotazione del percorso.Use the General node of the Data Flow Path Editor dialog box to name and describe the path, and to specify the options for path annotation.

OpzioniOptions

NomeName
Consente di digitare un nome univoco per il percorso.Provide a unique name for the path.

IDID
L'identificatore di derivazione del percorso.The lineage identifier of the path. Questa proprietà è di sola lettura.This property is read-only.

IdentificationStringIdentificationString
Stringa che identifica il percorso.The string that identifies the path. Viene generata automaticamente in base al nome immesso sopra.Automatically generated from the name entered above.

DescriptionDescription
Consente di digitare una descrizione del percorso.Describe the path.

PathAnnotationPathAnnotation
Specificare il tipo di annotazione da utilizzare.Specify the type of annotation to use. Selezionare Never per disabilitare le annotazioni, AsNeeded per abilitare le annotazioni su richiesta, SourceName per aggiungere automaticamente le annotazioni utilizzando il valore dell'opzione SourceName e PathName per aggiungere automaticamente le annotazioni utilizzano il valore della proprietà Nome .Choose Never to disable annotations, AsNeeded to enable annotation on demand, SourceName to automatically annotate using the value of the SourceName option, and PathName to automatically annotate using the value of the Name property.

DestinationNameDestinationName
Consente di visualizzare l'input corrispondente alla fine del percorso.Displays the input that is the end of the path.

SourceNameSourceName
Indica l'output che corrisponde all'inizio del percorso.Displays the output that is the start of the path.

Pagina metadati - Editor percorso flusso di datiMetadata Page - Data Flow Path Editor

Utilizzare la pagina Metadati della finestra di dialogo Editor percorso flusso di dati per visualizzare i metadati delle colonne percorso.Use the Metadata page of the Data Flow Path Editor dialog box to view the metadata of the path columns.

OpzioniOptions

Metadati percorsoPath metadata
Elenca i metadati delle colonne.Lists column metadata. Fare clic sulle intestazioni di colonna per ordinarne i dati.Click the column headings to sort column data.

NomeName
Indica il nome delle colonne.Lists the column name.

Tipo di datiData Type
Indica il tipo di dati della colonna.Lists the data type of the column.

PrecisionePrecision
Indica il numero di cifre in un valore numerico.Lists the number of digits in a numeric value.

ScalaScale
Indica il numero di cifre a destra del separatore decimale in un valore numerico.List the number of digits to the right of the decimal point in a numeric value.

LunghezzaLength
Indica la lunghezza corrente della colonna.Lists the current length of the column.

Tabella codiciCode Page
Indica la tabella codici della colonna.Lists the code page of the column. Il valore 0 indica che la colonna non utilizza alcuna tabella codici.The value 0 indicates that the column does not use a code page. Ciò si verifica quando i dati sono di tipo Unicode, numerico, data o ora.This occurs when data is in Unicode, or has a numeric, date, or time data type.

Posizione chiave ordinamentoSort Key Position
Indica la posizione della chiave di ordinamento della colonna.Lists the sort key position of the column. Il valore 0 indica che la colonna non è ordinata.The value 0 indicates the column is not sorted.

Nota

Il prefisso meno (-) indica che l'ordinamento della colonna è decrescente.A minus (-) prefix indicates the column is sorted in descending order.

Flag di confrontoComparison Flags
Elenca i flag di confronto applicati alla colonna.Lists the comparison flags that apply to the column.

Componente di origineSource Component
Indica il componente di flusso di dati che corrisponde all'origine della colonna.Lists the data flow component that is the source of the column.

Copia negli AppuntiCopy to Clipboard
Consente di copiare i metadati della colonna negli Appunti.Copy the column metadata to the clipboard. Per impostazione predefinita, tutte le righe di metadati vengono copiate nell'ordine in cui sono attualmente visualizzate.By default, all metadata rows are copied as sorted in the order currently displayed.

Pagina visualizzatori dati - Editor percorso flusso di datiData Viewers Page - Data Flow Path Editor

Utilizzare la pagina Visualizzatori dati della finestra di dialogo Editor percorso flusso di dati per gestire i visualizzatori di dati associati al percorso.Use the Data Viewers page of the Data Flow Path Editor dialog box to manage the data viewers that are attached to the path.

OpzioniOptions

NomeName
Consente di elencare i visualizzatori di dati.Lists the data viewers.

Tipo visualizzatore datiData Viewer Type
Consente di elencare il tipo di visualizzatore di dati.Lists the type of data viewer.

AggiungiAdd
Fare clic per aggiungere un visualizzatore di dati tramite la finestra di dialogo Configura visualizzatore dati .Click to add a data viewer by using the Configure Data Viewer dialog box.

EliminaDelete
Consente di eliminare il visualizzatore di dati selezionato.Click to delete the selected data viewer.

ConfigurareConfigure
Fare clic per configurare il visualizzatore di dati selezionato tramite la finestra di dialogo Configura visualizzatore dati .Click to configure a selected data viewer by using the Configure Data Viewer dialog box.

Proprietà del percorsoPath properties

Gli oggetti del flusso di dati nel modello a oggetti MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services hanno proprietà comuni e proprietà personalizzate a livello di componente, input e output, colonne di input e colonne di output.The data flow objects in the MicrosoftMicrosoft SQL ServerSQL Server Integration ServicesIntegration Services object model have common properties and custom properties at the level of the component, inputs and outputs, and input columns and output columns. Molte proprietà hanno valori di sola lettura assegnati in fase di esecuzione dal motore del flusso di dati.Many properties have read-only values that are assigned at run time by the data flow engine.

In questo argomento vengono elencate e descritte le proprietà personalizzate dei percorsi che connettono gli oggetti del flusso di dati.This topic lists and describes the custom properties of the paths that connect data flow objects.

Proprietà personalizzate di un tracciatoCustom properties of a path

Nel modello a oggetti Integration ServicesIntegration Services un percorso che connette componenti nel flusso di dati implementa l'interfaccia IDTSPath100.In the Integration ServicesIntegration Services object model, a path that connects components in the data flow implements the IDTSPath100 interface.

Nella tabella seguente vengono descritte le proprietà configurabili dei percorsi in un flusso di dati.The following table describes the configurable properties of the paths in a data flow. Inoltre, il motore del flusso di dati assegna valori a proprietà di sola lettura aggiuntive che non sono elencate qui.The data flow engine also assigns values to additional read-only properties that are not listed here.

Nome proprietàProperty name Tipo di datiData Type DescriptionDescription
PathAnnotationPathAnnotation Integer (enumerazione)Integer (enumeration) Un valore che indica se un'annotazione deve essere visualizzata con il percorso sulla superficie dell'area di progettazione.A value that indicates whether an annotation should be displayed with the path on the designer surface. I valori possibili sono AsNeeded, SourceName, PathNamee Never.The possible values are AsNeeded, SourceName, PathName, and Never. Il valore predefinito è AsNeeded.The default value is AsNeeded.
DestinationNameDestinationName IDTSInput100 L'input associato al percorso.The input associated with the path.
SourceNameSourceName IDTSOutput100 L'output associato al percorso.The output associated with the path.