Aracılığıyla paylaş


Veri API'si oluşturucusunda görünümleri kullanma

DAB'de görünümler, tablolara alternatif olarak desteklenir. Bir görünüm, minimum yapılandırmayla REST veya GraphQL uç noktaları aracılığıyla gösterilebilir.

Konfigürasyon

Bir görünümü açmak için:

  • source.type seçeneğini "view" olarak ayarlayın
  • Tam belirtimli görünüm adına ayarlayın source.object
  • key-fields kullanarak bir satırı benzersiz tanımlayın.
  • Eylemini (ve görünüm güncellenebilir ise isteğe bağlı olarak "create", "update", "delete") kullanarak "read" izin verme

CLI örneği

dab add BookDetail \
  --source dbo.vw_books_details \
  --source.type "view" \
  --source.key-fields "id" \
  --permissions "anonymous:read"

Yapılandırma örneği

"BookDetail": {
  "source": {
    "type": "view",
    "object": "dbo.vw_books_details",
    "key-fields": [ "id" ]
  },
  "permissions": [
    {
      "role": "anonymous",
      "actions": [ "read" ]
    }
  ]
}

REST desteği

  • Tüm REST fiillerini destekler: GET, POST, PUT, , PATCHDELETE
  • Varsayılan davranış, tablo destekli varlıkların davranışı ile aynıdır.
  • İşlemlerin başarılı olması için görünümün güncelleştirilebilir olması ve uygun izinlerin ayarlanması gerekir

Örnek istek

GET /api/BookDetail/42

vw_books_details içindeki id = 42 ile satırı döndürüyor.

GraphQL desteği

  • Görünüm, GraphQL türü olarak görünür
  • Sorgular her zaman desteklenir
  • Mutasyonlar yalnızca görünüm güncelleştirilebilir olduğunda desteklenir
  • Standart DAB GraphQL şema yapısını izler

İzinler

  • Salt okunur görünümler için read eylemini kullanın
  • create, update, ve delete yalnızca görünümün güncelleştirilebilir olması durumunda kullanın.

Sınırlamalar

  • key-fields gereklidir
  • Görünümler ilişkileri desteklemez
  • Görünüm bir tablo gibi davranırsa sayfalandırma, filtreleme ve sıralama desteklenir