銷售: 1-800-867-1380

比較固定與彈性查詢類型

更新日期: 2014年2月

 

DataMarket 標誌

Marketplace 會使用 OData 摘要公開資料。開放式資料通訊協定 (OData) 是用來查詢和更新資料的一種 Web 通訊協定,可供解除鎖定您的資料並將它從應用程式中現存的定址接收器釋出。OData 會套用 Web 技術 (例如 HTTP、Atom 發行通訊協定 (AtomPub) 和 JSON) 並以其做為建置基礎,以供從各種應用程式、服務、存放區存取資訊。

OData 與 Web 運作的方式一致 - 它會使用 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 的「加入服務參考」目前不支援程式碼產生。任何支援固定查詢的資料集均可提供資料集的預先建立 Proxy 類別。購買訂用之後,即可在資料集的 [詳細資料] 頁面上取得 Proxy 類別檔案。Proxy 類別會使用 WCF 資料服務用戶端程式庫來建立可呼叫 OData 服務的強型別 .NET 類別。如需詳細資訊,請參閱建立固定查詢應用程式

若要判斷資料集支援哪種查詢類型,請參閱底下的判斷查詢類型一節。

繼續之前,請確定您具備:

  • 有效的 Windows Live ID 帳戶。如果您沒有 Live ID,請移至 Windows Live 首頁並註冊。

  • 有效的 Marketplace 帳戶。如果您沒有 Marketplace,請移至建立您的 Marketplace 帳戶主題,然後依照此處的指示執行。

  • Data.gov 2006-2008 Crime in the United States 資料集的訂用。如果尚未訂用此資料集,請瀏覽至訂用資料供應項目,然後依照指示執行。

 

章節 描述

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 的呼叫是在下載的 C# 類別類別中由 Marketplace 提供的資料存取方法。

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

具有一個必要參數的固定查詢,用以從電話公司的 Marketplace 服務存取特定帳戶餘額資料。
如果未提供必要的參數名稱/值組,則查詢會失敗。

GetAccountBalance 的呼叫是在下載的 C# 類別類別中由 Marketplace 提供的資料存取方法。

Important重要事項
沒有參數的彈性查詢會傳回未經篩選的結果集。
參數個數不適當 (太少或太多) 的固定查詢會失敗。

如需建立 URI 以查詢 OData 服務的詳細資訊,請參閱 OData.org 上的 OData URI 轉換

某些資料集只允許固定查詢,即沒有參數的查詢或具有必要參數/值組的查詢。其他資料集則允許彈性查詢,即包含選擇性參數/值組來篩選結果集的查詢。找出您的資料集所需的查詢類型。

  1. 按一下 [我的資料] 索引標籤。

  2. 按一下 [使用] 這個字右邊您要用於您的應用程式中的資料集名稱。

  3. 將頁面向下捲動到資料集描述下方的索引標籤。

  4. 按一下 [詳細資料] 索引標籤。

  5. 尋找可告知您查詢類型的服務根目錄 URL 底下的文字行。這個範例適用於彈性查詢。

    查詢類型


    圖 1 - 查詢類型

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2015 Microsoft