OData v4 資料提供者設定、需求和最佳做法
本主題搭配如何設定 OData v4 資料提供者，以及使用 OData v4 資料提供者與 OData v4 Web 服務進行連接的需求和建議最佳作法。
OData v4 資料提供者最佳做法
- Microsoft Dataverse 要求所有資料表都必須有識別碼屬性，這個識別碼稱為唯一識別碼，而且其值必須為 GUID。 您只能將識別碼資料行以
Edm.Guid資料類型對應至外部資料行。 您不可將Edm.Int32資料類型對應至 Dataverse 中的 [唯一識別碼] 資料類型資料行。 - 具有可為 Null 屬性的 OData 資料表必須設定成符合虛擬資料表中的已對應資料行。 例如，具備 Nullable=False 的 OData 資料表屬性 (Property) 必須將 Dataverse 中已對應資料行的欄位需求屬性設定為業務需求。
- 擷取多個查詢時 (例如在網格中載入資料時)，請使用 select 和 filter 查詢參數來控制外部資料來源傳回的資料集大小。
- 如果尚未啟用外掛程式追蹤，則系統管理員必須啟用此功能。 啟用後，OData 端點發生的所有錯誤都會擷取到外掛程式追蹤記錄檔中。 其他資訊：系統管理員指南：系統設定對話方塊 – 自訂索引標籤。
- 您無法使用 OData v4 資料提供程式連線至其他環境。
資料類型對應
下表列出 OData 資料表資料模型 (EDM) 資料類型與 Dataverse 資料類型的對應。
| OData 資料類型 | Dataverse 資料類型 |
|---|---|
Edm.Boolean |
兩個選項 |
Edm.DateTime |
日期及時間 |
Edm.DateTimeOffset |
日期及時間 |
Edm.Decimal |
十進位數或貨幣 |
Edm.Double |
浮點數 |
Edm.Guid |
唯一識別碼 |
Edm.Int32 |
整數 |
Edm.Int64 |
整數 |
Edm.String |
單行文字或多行文字 |
不支援與虛擬資料表對應的 OData EDM 資料類型
Edm.BinaryEdm.TimeEdm.FloatEdm.SingleEdm.Int16Edm.ByteEdm.SByte
使用 OData v4 資料提供者新增資料來源
此程序告訴您如何使用立即可用的 OData 資料提供者作為虛擬資料表資料來源。
移至**設定** > 管理 > 虛擬實體資料來源。
按一下動作工具列上的新增。
在選取資料提供者對話方塊中，從下列資料來源選取，然後按一下確定。
- OData v4 資料提供者。 Dataverse 包含 Odata v4 資料提供者，可用來連接至支援 OData v4 開放標準的資料來源。
- 自訂資料提供者。 如果您已匯入資料提供者外掛程式，這裡就會顯示此資料提供者。 其他資訊：開發人員文件：開始使用虛擬資料表
在新增資料來源內容頁面中，完成下列資料行，然後儲存資料列。
- 名稱. 輸入描述資料來源的名稱。
- URI。 如果您使用 OData 資料提供者，請輸入 OData Web 服務的 URI。 例如，如果使用 OData 提供者連接至裝載於 Azure 的 Web 服務，URI 可能看起來類似
https://contosodataservice.azurewebsites.net/odata/。 - 逾時 (秒)。 輸入資料要求逾時之前等待 Web 服務回應的秒數。例如，輸入 30 表示最多先等待三十秒，然後才發生逾時。
- 分頁模式。 選取要透過用戶端還是伺服器端分頁來控制查詢結果分頁方式。 預設值為用戶端分頁。 使用伺服器端分頁時，伺服器會使用新增至查詢字串的 $skiptoken 參數來控制結果分頁方式。 其他資訊：跳過權杖系統查詢選項 ($skiptoken)
- 傳回內嵌計數。 傳回結果集中的資料列總數。 將資料傳回至網格時，使用此設定來下一頁功能。 如果 OData 端點不支援 OData $inlinecount 參數，請使用 false 的值。 預設值為 false。
- 要求參數。 或者，也可以新增用於連接至 OData Web 服務的自訂標頭或查詢字串參數，例如外部服務的驗證參數。 按一下查詢字串可在標頭與查詢字串參數及值之間切換。 最多可新增 10 個標頭或查詢字串。
