VENDITE: 1-800-867-1389

Confrontare tipi di query fisse e flessibili

Aggiornamento: febbraio 2014

 

 

In Marketplace i dati vengono esposti tramite feed OData. Il protocollo OData (Open Data) è un protocollo Web per l'esecuzione di query e l'aggiornamento dei dati che consente di sbloccare i dati e liberarli dai silo attualmente presenti nelle applicazioni. Per fornire l'accesso alle informazioni provenienti da diversi servizi, applicazioni e archivi, OData si basa su tecnologie Web quali HTTP, il protocollo Atom Publishing (AtomPub) e JSON.

I criteri di funzionamento di OData sono coerenti con quelli del Web. OData utilizza URI per l'identificazione delle risorse e un'interfaccia uniforme basata su HTTP per l'interazione con tali risorse. Mediante OData, un servizio può consentire ai client di generare dinamicamente query sui feed, aggiungendo filtri, criteri di ordinamento e simili, oppure può fornire metodi di query fissi, simili ad altri endpoint di servizi Web, in cui il client deve fornire un set o un subset di parametri e ottiene un set di risultati specifico, in base a quanto determinato dal proprietario dei contenuti. In Marketplace vengono pubblicati servizi che utilizzano entrambi i tipi di query. Il tipo di query disponibile per un set di dati è specificato nella pagina Dettagli corrispondente, come illustrato nell'immagine riportata di seguito.

Un set di dati per query flessibili consente di aggiungere filtri facoltativi basati su coppie nome parametro/valore per l'esecuzione di query (columnName=dataValue), oltre a una serie di opzioni di query OData supportate da Marketplace. Per ulteriori informazioni sulle opzioni di query supportate in Marketplace, vedere Opzioni di query OData supportate.

Quando si sviluppa un'applicazione che utilizza un set di dati per query flessibili, utilizzare la funzionalità Aggiungi riferimento al servizio di Visual Studio per generare classi .NET fortemente tipizzate, che sarà possibile utilizzare per chiamare il servizio OData dall'interno dell'applicazione. Per ulteriori informazioni, vedere Step 2: Add the Service Reference for your Data Service.

Un set di dati per query fisse consente di chiamare metodi di query predefiniti resi disponibili dall'editore dei contenuti. Un metodo di query può avere un set di parametri obbligatori e/o opzionali che consentono di aggiungere un filtro vincolato alla query. È possibile trovare un elenco di parametri obbligatori e/o opzionali per qualsiasi set di dati per query fisse nella pagina Dettagli corrispondente.

La funzionalità Aggiungi riferimento al servizio di Visual Studio non supporta attualmente la generazione di codice per i servizi dati che supportano query fisse. Qualsiasi set di dati con supporto per query fisse fornisce una classe proxy predefinita. Il file della classe proxy è disponibile nella pagina Dettagli del set di dati dopo l'acquisto della sottoscrizione. Le classi proxy utilizzano la libreria client di WCF Data Services per creare una classe .NET fortemente tipizzata in grado di chiamare il servizio OData. Per ulteriori informazioni, vedere Creare un'applicazione per query fisse.

Per determinare il tipo di queri supportato da un set di dati, vedere la sezione Determinare il tipo di query più avanti in questo argomento.

Prima di procedere, verificare di avere a disposizione quanto segue:

 

Sezione Descrizione

Esempi di URI

Vengono forniti esempi di URI di query flessibili e fisse.

Determinare il tipo di query

Viene descritta la procedura per determinare se un set di dati supporta query flessibili o fisse.

 

URI Descrizione

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport?region=northamerica

Query flessibile per l'accesso ai dati dei report delle vendite della società Contoso, Ltd. per l'America del Nord.

https://api.datamarket.azure.com/data.ashx/contoso.com/salesreport/GetSalesReport

Query flessibile per l'accesso ai dati dei report delle vendite della società Contoso, Ltd.
Poiché non è specificato alcun parametro, il set di risultati non è filtrato e la query restituisce tutti i report delle vendite nel sistema.

https://api.datamarket.azure.com/Data.ashx/adatum.com/CensusInfo/GetCensusData

Query fissa senza parametri obbligatori per l'accesso ai dati di censimento più recenti forniti dal servizio A. Datum, Inc.

La chiamata a GetCensusData è il metodo di accesso ai dati nella classe di servizio C# scaricata che viene fornita da Marketplace.

https://api.datamarket.azure.com/Data.ashx/thephone-company.com/accountbalance/GetAccountBalance?phonenumber=5551234567

Query fissa con un parametro obbligatorio per l'accesso ai dati del saldo di un conto specifico forniti dal servizio Marketplace della società The Phone Company.
Se la coppia obbligatoria nome parametro/valore non è specificata, la query non riesce.

La chiamata a GetAccountBalance è il metodo di accesso ai dati nella classe di servizio C# scaricata che viene fornita da Marketplace.

ImportantImportante
Una query flessibile senza parametri restituisce un set di risultati non filtrato.
Una query fissa con un numero di parametri errato (troppi o troppo pochi) non riesce.

Per ulteriori informazioni sulla creazione di URI per l'esecuzione di query sui servizi OData, vedere la pagina relativa alle convezioni degli URI OData sul sito OData.org.

Alcuni set di dati consentono solo l'esecuzione di query fisse oppure di query senza parametri o con coppie parametro/valore obbligatorie. Altri set di dati consentono invece l'esecuzione di query flessibili, ovvero di query che includono coppie parametro/valore facoltative per filtrare il set di risultati. Per individuare il tipo di query richiesto da un set di dati, attenersi alla procedura riportata di seguito.

  1. Fare clic sulla scheda Dati personali.

  2. Fare clic su Utilizza a destra del nome del set di dati che si desidera utilizzare nell'applicazione.

  3. Scorrere la pagina verso il basso in modo da visualizzare le schede al di sotto della descrizione del set di dati.

  4. Fare clic sulla scheda Dettagli.

  5. Individuare la riga di testo al di sotto dell'URL radice del servizio. In questo esempio è riportata una query flessibile.


    Figura 1 – Tipo di query

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft