Origine ODataOData Source

Usare il componente di origine OData in un pacchetto SSIS per utilizzare i dati da un servizio Protocollo OData (Open Data).Use the OData Source component in an SSIS package to consume data from an Open Data Protocol (OData) service. Il componente supporta i protocolli OData v3 e v4.The component supports the OData v3 and v4 protocols.

  • Per il protocollo OData V3, il componente supporta i formati di dati ATOM e JSON.For OData V3 protocol, the component supports the ATOM and JSON data formats.

  • Per il protocollo OData V4, il componente supporta il formato dati JSON.For OData V4 protocol, the component supports the JSON data format.

L'origine OData include il supporto per le origini dati seguenti:The OData source includes support for the following data sources:

  • Microsoft Dynamics AX Online e Microsoft Dynamics CRM OnlineMicrosoft Dynamics AX Online and Microsoft Dynamics CRM Online
  • Elenchi di SharePoint.SharePoint lists. Per visualizzare tutti gli elenchi in un server SharePoint, utilizzare il seguente URL: http://<server > / _vti_bin/ListData.svc.To see all the lists on a SharePoint server, use the following URL: http://<server>/_vti_bin/ListData.svc. Per ulteriori informazioni sulle convenzioni per l'URL di SharePoint, vedere la pagina relativa all' interfaccia REST di SharePoint Foundation.For more information about SharePoint URL conventions, see SharePoint Foundation REST Interface.

Formato OData e prestazioniOData Format and Performance

La maggior parte dei servizi OData possono restituire risultati in più formati.Most OData services can return results in multiple formats. È possibile specificare il formato del set di risultati tramite l'utilizzo di $format opzione di query.You can specify the format of the result set by using the $format query option. I formati quali JSON e JSON Light sono più efficienti di ATOM o XML e possono garantire prestazioni migliori quando si trasferiscono grandi quantità di dati.Formats such as JSON and JSON Light are more efficient than ATOM or XML, and may give you better performance when transferring large amounts of data. Nella tabella seguente vengono forniti i risultati dei test di esempio.The following table provides results from sample tests. Come si può notare, si verifica un miglioramento delle prestazioni del 30-53% quando si passa dal formato ATOM a JSON e un miglioramento del 67% quando si passa da ATOM al nuovo formato JSON Light, disponibile in WCF Data Services 5.1.As you can see, there was a 30-53% performance gain when switching from ATOM to JSON and a 67% performance gain when switching from ATOM to the new JSON light format (available in WCF Data Services 5.1).

RigheRows ATOMATOM JSONJSON JSON (Light)JSON (Light)
1000010000 113 secondi113 seconds 74 secondi74 seconds 68 secondi68 seconds
10000001000000 1110 secondi1110 seconds 853 secondi853 seconds 665 secondi665 seconds

Editor origine OData (pagina Connessione)OData Source Editor (Connection Page)

Usare la pagina Connessione della finestra di dialogo Editor origine OData per selezionare la gestione connessione OData per l'origine OData.Use the Connection page of the OData Source Editor dialog box to select the OData connection manager for the OData source. In questa pagina è inoltre possibile specificare una raccolta o un percorso della risorsa, nonché tutte le opzioni query per scegliere i dati che devono essere recuperati dall'origine OData.This page also lets you specify a collection or a resource path and any query options to indicate what data needs to be retrieved from the OData source.

Opzioni staticheStatic Options

Gestione connessione ODataOData connection manager
Selezionare una gestione connessione esistente nell'elenco o crearne una nuova facendo clic su Nuova.Select an existing connection manager from the list, or create a new connection by clicking New.

Dopo aver selezionato o creato una gestione connessione, la finestra di dialogo mostra la versione del protocollo OData che la gestione connessione sta usando.After you select or create a connection manager, the dialog box displays the OData protocol version that the connection manager is using.

NuovaNew
Creare una nuova gestione connessione usando la finestra di dialogo Editor gestione connessione OData .Create a new connection manager by using the OData Connection Manager Editor dialog box.

Usa percorso risorsa o raccoltaUse collection or resource path
Consente di specificare il metodo per la selezione dei dati dall'origine.Specify the method for selecting data from the source.

OpzioneOption DescriptionDescription
CollectionCollection Recuperare i dati dall'origine OData utilizzando il nome di una raccolta.Retrieve data from the OData source by using a collection name.
Percorso risorsaResource Path Recuperare i dati dall'origine OData utilizzando un percorso della risorsa.Retrieve data from the OData source by using a resource path.

Opzioni queryQuery options
Specificare le opzioni per la query.Specify options for the query. Esempio: $top=5For example: $top=5

URL feedFeed url
Consente di visualizzare le proprietà di sola lettura in base alle opzioni selezionate nella finestra di dialogo URL del feed.Displays the read-only feed URL based on options you selected on this dialog box.

AnteprimaPreview
Vengono visualizzati in anteprima i risultati tramite la finestra di dialogo Anteprima .Preview results by using the Preview dialog box. L'anteprima supporta la visualizzazione di un massimo di 20 righe.Preview can display up to 20 rows.

Opzioni dinamicheDynamic Options

Usa percorso risorsa o raccolta = RaccoltaUse collection or resource path = Collection

CollectionCollection
Selezionare una raccolta dall'elenco a discesa.Select a collection from the drop-down list.

Usa percorso risorsa o raccolta = Percorso risorsaUse collection or resource path = Resource Path

Resource pathResource path
Digitare un percorso della risorsa.Type a resource path. Ad esempio: DipendentiFor example: Employees

Editor origine OData (pagina Colonne)OData Source Editor (Columns Page)

Usare la pagina Colonne della finestra di dialogo Editor origine OData per selezionare le colonne esterne (di origine) da includere nell'output ed eseguirne il mapping alle colonne di output.Use the Columns page of the OData Source Editor dialog box to select external (source) columns to be included in the output and map them to output columns.

OpzioniOptions

Colonne esterne disponibiliAvailable External Columns
Viene visualizzato l'elenco delle colonne di origine disponibili nell'origine dati.View the list of available source columns in the data source. Utilizzare le caselle di controllo nell'elenco per aggiungere colonne alla tabella, o rimuoverne, nella parte inferiore della pagina.Use check boxes in the list to add to or remove columns to the table at the bottom of the page. Le colonne selezionate vengono aggiunte all'output.The selected columns are added to the output.

Colonna esternaExternal Column
Vengono visualizzate le colonne di origine selezionate per essere incluse nell'output.View source columns that you chose to be included in the output.

Colonna di outputOutput Column
Consente di specificare un nome univoco per ogni colonna di output.Provide a unique name for each output column. Per impostazione predefinita viene suggerito il nome della colonna esterna (di origine) selezionata. È comunque possibile scegliere qualsiasi nome descrittivo univoco.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name.

Editor origine OData (pagina Output degli errori)OData Source Editor (Error Output Page)

Usare la pagina Output degli errori della finestra di dialogo Editor origine OData per selezionare le opzioni di gestione degli errori e impostare le proprietà delle colonne di output degli errori.Use the Error Output page of the OData Source Editor dialog box to select error handling options and to set properties on error output columns.

OpzioniOptions

Input/OutputInput/Output
Consente di visualizzare il nome dell'origine dei dati.View the name of the data source.

ColonnaColumn
Vengono visualizzate le colonne esterne (di origine) selezionate nella pagina Gestione connessione della finestra di dialogo Editor origine OData .View the external (source) columns that you selected on the Connection Manager page of the OData Source Editor dialog box.

ErroreError
Consente di specificare l'azione da eseguire in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

Argomenti correlati: Gestione degli errori nei datiRelated Topics: Error Handling in Data

TroncamentoTruncation
Consente di specificare l'azione da eseguire in caso di troncamenti, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
Consente di visualizzare la descrizione dell'errore.View the description of the error.

Imposta questo valore nelle celle selezionateSet this value to selected cells
Consente di specificare l'azione che dovrà interessare tutte le celle selezionate in caso di errore o troncamento: ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

ApplicaApply
Consente di applicare l'opzione di gestione degli errori alle celle selezionate.Apply the error handling option to the selected cells.

Vedere ancheSee Also

Gestione connessione ODataOData Connection Manager