セールス: 1-800-867-1380

固定のクエリと柔軟なクエリの種類を比較する

更新日: 2014年2月

 

DataMarket ロゴ

Marketplace は、OData フィードを使用してデータを公開しています。Open Data Protocol (OData) は、データのロックを解除し、現在アプリケーションに存在するサイロから解放するように、データをクエリし、更新するための Web プロトコルです。OData は、HTTP、Atom Publishing Protocol (AtomPub)、JSON などの Web テクノロジを適用し、これらのテクノロジに基づいて構築することで、この処理を実行し、多様なアプリケーション、サービス、およびストアからの情報に対するアクセスを提供します。

OData は、Web の機能と同じです。OData は、リソースの識別に URI を使用し、HTTP ベースであり、これらのリソースとやり取りするためにインターフェイスを統一します。OData は、フィルターの追加、並べ替えなど、フィードに対するクエリをクライアントが動的に構築したり、(他の Web サービス エンドポイントと同様に) サービスで固定クエリ メソッドを提供したりできる機能をサービスに提供します。固定クエリの場合、クライアントは特定セットのパラメーターまたはパラメーターの一部を指定する必要があります。コンテンツ所有者の決定に従い、特定の結果セットが返されます。Marketplace は、これら両方の種類のクエリを利用するサービスを公開しています。データセットに使用できるクエリの種類は、以下の図のように、データセットの [詳細] ページに指定されています。

柔軟なクエリ データセットを使用すると、データセットをクエリするときに (columnName=dataValue) オプションのパラメーター名/名前フィルターを追加できるだけでなく、Marketplace でサポートされている多数の OData クエリ オプションを追加できます。Marketplace でサポートされるクエリ オプションの詳細については、「サポートされる OData クエリ オプション」を参照してください。

柔軟なクエリ データセットを使用するアプリケーションを開発する場合、Visual Studio の [サービス参照の追加] を使用して、厳密に型指定された .NET クライアントを生成します。その結果、アプリケーション内から OData サービスを使用できるようになります。詳細については、「Step 2: Add the Service Reference for your Data Service」を参照してください。

固定クエリ データセットは、コンテンツ発行元が使用を許可した定義済みのクエリ メソッドを呼び出すことができます。クエリ メソッドには、必須のパラメーターと省略可能なパラメーターのセットがあり、クエリを制約するフィルターを追加できます。データセットの [詳細] ページには、固定クエリのデータセットについて必須のパラメーターまたは省略可能なパラメーターのリストが表示されます。

Visual Studio の [サービス参照の追加] では、現在、固定クエリをサポートするデータ サービスのコード生成をサポートしていません。固定クエリをサポートするすべてのデータセットは、データセット用に事前に作成されたプロキシ クラスを提供します。プロキシ クラス ファイルは、サブスクリプションの購入後にデータセットの [詳細] ページに表示されます。プロキシ クラスは WCF データ サービス クライアント ライブラリを使用して、OData サービスを呼び出すことができる厳密に型指定された .NET クラスを作成します。詳細については、「固定クエリのアプリケーションの作成」を参照してください。

データセットがサポートするクエリの種類を判断するには、以下のセクション「クエリの種類を判断する」を参照してください。

作業を進める前に、以下が用意されていることを確認してください。

  • 有効な Windows Live ID アカウント。Live ID を持っていない場合は、Windows Live ホーム ページにアクセスしてサインアップします。

  • 有効な Marketplace アカウント。Marketplace を持っていない場合は、「Marketplace アカウントの作成」のトピックの手順を実行してください。

  • 米国の Data.gov 2006-2008 Crime データセットへのサブスクリプション。このデータセットにサブスクライブしていない場合は、「データのオファーにサブスクライブする」を参照して手順に従ってください。

 

セクション 説明

URI の例

柔軟なクエリと固定クエリの URI の例。

クエリの種類を判断する

データセットが柔軟なクエリと固定クエリのどちらをサポートするかを決定する手順。

 

URI URI の説明

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

Contoso, Ltd. の北米の営業レポートにアクセスする柔軟なクエリ。

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

Contoso, Ltd. の営業レポート データにアクセスする柔軟なクエリ。
パラメーターは指定されていないので、結果セットはフィルターが解除され、クエリからシステム内のすべての営業レポートが返されます。

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

A. Datum, Inc. サービスからの最新の人口調査にアクセスするための必須のパラメーターがない固定プロキシ。

GetCensusData の呼び出しは、Marketplace で提供されているダウンロード済みの C# サービス クラスのデータ アクセス方法です。

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

The Phone Company の Marketplace サービスの特定のアカウント残高データにアクセスするための必須のパラメーターが 1 つある固定クエリ。
必須のパラメーター名/値のペアが指定されていない場合、クエリは失敗します。

GetAccountBalance の呼び出しは、Marketplace で提供されているダウンロード済みの C# サービス クラスのデータ アクセス方法です。

Important重要
パラメーターがない柔軟なクエリは、フィルターされていない結果セットを返します。
パラメーター数が正しくない (少なすぎる、または多すぎる) 固定クエリは失敗します。

OData サービスをクエリする URI を構築する方法の詳細については、OData.org の「OData URI 表記規則 (英語)」を参照してください。

一部のデータセットは、固定クエリ (パラメーターがないクエリ、または必須のパラメーター/値のペアがあるクエリ) のみを許可しています。また、柔軟なクエリ (結果セットをフィルターするオプションのパラメーター/値のペアを含むクエリ) を許可しているデータセットもあります。データセットに必要なクエリの種類を確認してください。

  1. [マイ データ] タブをクリックします。

  2. アプリケーションで使用するデータセット名の右にある [使用] という単語をクリックします。

  3. データセットの説明の下にあるタブまでページをスクロールします。

  4. [詳細] タブをクリックします。

  5. サービス ルート URL の下のテキスト行にクエリの種類が表示されます。これは柔軟なクエリの例です。

    クエリの種類


    図 1: クエリの種類

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2015 Microsoft