OData v4 Veri Sağlayıcısı, gereksinimler ve en iyi uygulamalar

Makale
03/15/2023

Bu konuda OData v4 Veri Sağlayıcısını yapılandırmanın yanı sıra, OData v4 Veri Sağlayıcısını bir OData web hizmetine bağlanmak üzere kullanmaya ilişkin gereksinimler ve önerilen en iyi uygulamalar açıklanmaktadır.

OData v4 veri sağlayıcısı en iyi uygulamaları

Microsoft Dataverse tüm tabloların bir Kimlik özniteliği olmasını gerektirir; bu kimlik benzersiz tanıtıcı olarak bilinir ve değeri guid olmalıdır. Kimlik sütunlarını yalnızca Edm.Guid veri türüne sahip dış sütunlarla eşleyebilirsiniz. Edm.Int32 veri türünü Dataverse'te bir Benzersiz Tanımlayıcı veri türü sütunuyla eşleyemezsiniz.
Null değeri alabilen özelliklere sahip OData tabloları sanal tablodaki eşlenen sütunla eşleşecek şekilde ayarlanmalıdır. Örneğin, Nullable=False değerine sahip OData tablo özelliğinin Dataverse Sütun Gereksinimi özniteliği İşletme Gerekli olarak ayarlanmış sütunla eşleştirilmesi gerekir.
Izgaraya veri yüklediğinizdeki gibi, birden fazla sorgu almak için, seçme ve filtreleme sorgu parametrelerini kullanarak dış veri kaynağından döndürülen veri kümesinin boyutunu denetleyin.
Henüz etkin değilse, sistem yöneticileri eklenti izlemeyi etkinleştirmelidir. Etkinleştirildikten sonra, OData uç noktasından gelen tüm hatalar eklenti izleme günlüğüne kaydedilir. Daha fazla bilgi: Yönetici Kılavuzu: Sistem Ayarları iletişim kutusu - Özelleştirme sekmesi
Başka bir ortama bağlanmak için OData v4 Veri Sağlayıcıyı kullanamazsınız.

Veri türü eşleme

Aşağıdaki tabloda Dataverse veri türleriyle olan OData Tablosu Veri Modeli (EDM) veri türü eşlemeleri listelenmektedir.

OData Veri Türü	Dataverse Veri Türü
`Edm.Boolean`	İki Seçenek
`Edm.DateTime`	Tarih ve Saat
`Edm.DateTimeOffset`	Tarih ve Saat
`Edm.Decimal`	Ondalık Sayı veya Para Birimi
`Edm.Double`	Kayan Noktalı Sayı
`Edm.Guid`	Benzersiz Tanıtıcı
`Edm.Int32`	Tam Sayı
`Edm.Int64`	Tam Sayı
`Edm.String`	Tek Satır Metin ya da Birden Çok Metin Satırı

Sanal tablolarla eşlenmek için desteklenmeyen OData EDM veri türleri

Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte

OData v4 Veri Sağlayıcısını kullanarak veri kaynağı ekleme

Bu yordam, hazır OData Veri Sağlayıcısının bir sanal tablo veri kaynağı olarak nasıl kullanılacağını gösterir.

Ayarlar > Yönetim > Sanal Varlık Veri Kaynakları'na gidin.
Eylemler araç çubuğunda, Yeni öğesine tıklayın.
Veri Sağlayıcısı Seç iletişim kutusu üzerinde, aşağıdaki veri kaynaklarından seçim yapın ve sonra Tamam'ı tıklayın.
- OData v4 Veri Sağlayıcısı. Dataverse, OData v4 açık standardı destekleyen veri kaynaklarına bağlanmak kullanılabilecek bir Odata v4 veri sağlayıcısı içerir.
- Özel veri sağlayıcısı. Bir veri sağlayıcısı eklentisini içe aktardıysanız, veri sağlayıcı burada görünür. Daha fazla bilgi: Geliştirici Belgeleri: Sanal tablolarla çalışmaya başlama
Yeni Veri Kaynağı özellikleri sayfasında, aşağıdaki sütunları tamamlayın ve satırı kaydedin.
- Ad. Veri kaynağını açıklayan bir isim yazın.
- Uri. OData Veri Sağlayıcısını kullanıyorsanız, OData web hizmeti için uri'yi girin. Örneğin, OData sağlayıcısını Azure'de barındırılan bir web hizmetine bağlanmak için kullanıyorsanız URL şuna benzer görünebilir: https://contosodataservice.azurewebsites.net/odata/.
- Saniye olarak zaman aşımı. Bir veri isteği zaman aşımına uğramadan önce web hizmetinden yanıt için beklenecek saniye sayısını girin. Örneğin, zaman aşımı gerçekleşmeden önce en fazla 30 saniye beklemek için 30 girin.
- Sayfalandırma modu. Sorgu sonuçlarının nasıl sayfalandığını denetlemek için istemci tarafı mı yoksa sunucu tarafı mı sayfalama kullanılacağını seçin. İstemci tarafı sayfalama varsayılan değerdir. Sunucu tarafı sayfalama ile, sunucu sorgu dizesine eklenen $skiptoken parametresini kullanarak sonuçların nasıl sayfalandığını denetler. Daha fazla bilgi: Belirteç Sistem Sorgusu Seçeneğini Atla ($skiptoken)
  - Satır içi dönüş sayısı. Sonuç kümesinde toplam satır sayısını döndürür. Bu ayar, verileri bir ızgaraya döndürdüğünüzde sonraki sayfa işlevini etkinleştirmek için kullanılır. OData uç noktanız OData $inlinecount parametresini desteklemiyorsa, yanlış değer kullanın. Varsayılan değer olarak yanlış kullanılır.
- İstek Parametreleri. İsteğe bağlı olarak, OData web hizmetine bağlannmakta kullanılan özel başlık veya sorgu dize parametrelerini ekleyebilirsiniz; dış hizmete kimlik doğrulama parametreleri gibi. Sorgu Dizesi'ni tıklaarak başlık ve sorgu dizesi parametresi ve değeri arasında geçiş yapın. En fazla 10 adet başlık veya sorgu dizesi eklenebilir.

Ayrıca bkz.

Dış veri kaynağından veri içeren sanal tablo oluşturma ve düzenleme

Not

Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)

Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).

Aracılığıyla paylaş