Aracılığıyla paylaş

update komut

Veri API oluşturucusu yapılandırma dosyasında var olan bir varlık tanımını güncelleştirin. Varlık zaten eklendikten sonra kaynak meta verileri, izinleri, pozlamayı (REST/GraphQL), ilkeleri, önbelleğe almayı, ilişkileri, eşlemeleri ve açıklayıcı meta verileri ayarlamak için bu komutu kullanın.

İpucu

Yeni varlıklar oluşturmak ve dab add bunları geliştirmek için kullanındab update. Alan adı yeniden eşlemesi (--map), içinde değil yalnızca içinde updateaddkullanılabilir.

Sözdizimi

dab update <entity-name> [options]

Hızlı bakış

Seçenek Özet
<entity-name> Gerekli konumsal bağımsız değişken. Mantıksal varlık adı.
-s, --source Kaynak tablonun, görünümün veya saklı yordamın adı.
--permissions Biçimdeki role:actions rol ve eylemler.
--description Varlık açıklamasını değiştirin.
-c, --config Yapılandırma dosyasının yolu. Atlanırsa varsayılan çözünürlük uygulanır.
--help Yardım ekranını görüntüleyin.
--version Sürüm bilgilerini görüntüleme.

Önbellek

Seçenek Özet
--cache.enabled Varlık önbelleğe almayı etkinleştirin veya devre dışı bırakın.
--cache.ttl Yaşam süresini saniyeler içinde önbelleğe alın.

Fields

Seçenek Özet
--fields.exclude Dışlanan alanların virgülle ayrılmış listesi.
--fields.include Eklenen alanların virgülle ayrılmış listesi (* = tümü).
-m, --map Alan eşleme çiftleri name:alias. Tüm kümeyi değiştirir.

Alanlar meta verileri

Seçenek Özet
--fields.name Açıklanacak veritabanı sütununun adı.
--fields.alias Alanın diğer adı.
--fields.description Alanın açıklaması.
--fields.primary-key Bu alanı birincil anahtar olarak ayarlayın.

GraphQL

Seçenek Özet
--graphql GraphQL pozlaması: false, true, singularveya singular:plural.
--graphql.operation Yalnızca saklı yordamlar: query veya mutation (varsayılan mutasyon).

İzinler ve İlkeler

Seçenek Özet
--permissions role:actions tek bir rol için. Birden çok rol için birden çok kez çalıştırın.
--policy-database VERITABANı sorgusuna eklenen OData stili filtre.
--policy-request Veritabanı öncesi istek filtresi.

Ilişki

Seçenek Özet
--relationship İlişki adı. İlişki seçenekleriyle kullanın.
--cardinality İlişki kardinalitesi: one veya many.
--target.entity Hedef varlık adı.
--linking.object Çoka çok için nesne bağlama.
--linking.source.fields Kaynağa işaret eden nesne alanlarını bağlama.
--linking.target.fields Hedefe işaret eden nesne alanlarını bağlama.
--relationship.fields Doğrudan ilişkiler için alan eşlemeleri.

REST

Seçenek Özet
--rest REST pozlaması: false, trueveya özel yol.
--rest.methods Yalnızca saklı yordamlar. İzin verilen HTTP fiillerini değiştirin.

Kaynak

Seçenek Özet
-s, --source Temel alınan veritabanı nesne adı.
--source.key-fields Görünümler veya PK olmayan tablolar için gereklidir.
--source.params Yalnızca saklı yordamlar. Varsayılan parametreleri değiştirin.
--source.type Kaynak türü: table, viewveya stored-procedure.

Parametreler (saklı yordamlar)

Seçenek Özet
--parameters.name Parametre adlarının virgülle ayrılmış listesi.
--parameters.description Parametre açıklamalarının virgülle ayrılmış listesi.
--parameters.required Gerekli bayrakların virgülle ayrılmış listesi.
--parameters.default Varsayılan değerlerin virgülle ayrılmış listesi.

--cache.enabled

Bu varlık için önbelleğe almayı etkinleştirin veya devre dışı bırakın.

Example

dab update \
  Book \
  --cache.enabled true

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "cache": {
        "enabled": true
      }
    }
  }
}

--cache.ttl

Önbellek yaşam süresini saniyeler içinde ayarlayın. Yalnızca önbelleğe alma etkinse geçerlidir.

Example

dab update \
  Book \
  --cache.ttl 600

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "cache": {
        "ttl-seconds": 600
      }
    }
  }
}

Uyarı

Önbellek devre dışı bırakıldığında TTL sağlamanın, önbelleğe alma etkinleştirilene kadar hiçbir etkisi olmaz.

--description

Varlık açıklamasını değiştirin.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  Book \
  --description "Updated description"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "description": "Updated description"
    }
  }
}

--fields.exclude

Hariç tutulacak alanların virgülle ayrılmış listesi.

Example

dab update \
  Book \
  --permissions "anonymous:read" \
  --fields.exclude "internal_flag,secret_note"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "permissions": [
        {
          "role": "anonymous",
          "actions": [
            {
              "action": "read",
              "fields": {
                "exclude": [ "internal_flag", "secret_note" ]
              }
            }
          ]
        }
      ]
    }
  }
}

--fields.include

Eklenecek alanların virgülle ayrılmış listesi. * tüm alanları içerir. Var olan ekleme listesini değiştirir.

Example

dab update \
  Book \
  --permissions "anonymous:read" \
  --fields.include "id,title,author"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "permissions": [
        {
          "role": "anonymous",
          "actions": [
            {
              "action": "read",
              "fields": {
                "exclude": [],
                "include": [ "id", "title", "author" ]
              }
            }
          ]
        }
      ]
    }
  }
}

--graphql

GraphQL pozlamayı denetleme.

Example

dab update \
  Book \
  --graphql book:books

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "graphql": {
        "enabled": true,
        "type": {
          "singular": "book",
          "plural": "books"
        }
      }
    }
  }
}

--graphql.operation

Yalnızca saklı yordamlar. İşlem türünü ayarlar. Varsayılan mutation değeridir.

Example

dab update \
  RunReport \
  --graphql.operation query

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "RunReport": {
      "graphql": {
        "operation": "query"
      }
    }
  }
}

Uyarı

Tablolar veya görünümler için sağlama --graphql.operation yoksayılır.

-m, --map

Veritabanı alanlarını kullanıma sunulan adlarla eşleyin. Eşleme kümesinin tamamını değiştirir.

Example

dab update \
  Book \
  --map "id:bookId,title:bookTitle"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "fields": [
        {
          "name": "id",
          "alias": "bookId",
          "primary-key": false
        },
        {
          "name": "title",
          "alias": "bookTitle",
          "primary-key": false
        }
      ]
    }
  }
}

Önemli

Mevcut eşlemelerin üzerine yazılır. Saklamak istediğiniz tüm eşlemeleri yeniden ifade edin.

--permissions

Tek bir rol ve eylemleri için izinleri ekler veya güncelleştirir.

Birden çok rol eklemek için birden çok kez (rol başına bir kez) çalıştırabilirsiniz dab update .

Example

dab update \
  Book \
  --permissions "anonymous:read"

dab update \
  Book \
  --permissions "authenticated:create,read,update"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "permissions": [
        {
          "role": "anonymous",
          "actions": [
            {
              "action": "read"
            }
          ]
        },
        {
          "role": "authenticated",
          "actions": [
            { "action": "create" },
            { "action": "read" },
            { "action": "update" }
          ]
        }
      ]
    }
  }
}

Uyarı

Belirtilen rol zaten varsa, eylemleri güncelleştirilir; aksi takdirde rol eklenir.

--policy-database

VERITABANı sorgusuna eklenen OData stili filtre.

Example

dab update \
  Book \
  --permissions "anonymous:read" \
  --policy-database "region eq 'US'"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "permissions": [
        {
          "role": "anonymous",
          "actions": [
            {
              "action": "read",
              "policy": {
                "database": "region eq 'US'"
              }
            }
          ]
        }
      ]
    }
  }
}

--policy-request

veritabanına erişmeden önce istek düzeyi ilkesi değerlendirildi.

Example

dab update \
  Book \
  --permissions "anonymous:read" \
  --policy-request "@claims.role == 'admin'"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "permissions": [
        {
          "role": "anonymous",
          "actions": [
            {
              "action": "read",
              "policy": {
                "request": "@claims.role == 'admin'"
              }
            }
          ]
        }
      ]
    }
  }
}

--relationship

İlişki tanımlama veya güncelleştirme. Diğer ilişki seçenekleriyle kullanın.

Example

dab update \
  User \
  --relationship profile \
  --target.entity Profile \
  --cardinality one \
  --relationship.fields "id:user_id"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "User": {
      "relationships": {
        "profile": {
          "cardinality": "one",
          "target.entity": "Profile",
          "source.fields": [ "id" ],
          "target.fields": [ "user_id" ]
        }
      }
    }
  }
}

--cardinality

İlişki için kardinalite. ile kullanın --relationship.

Example

dab update \
  User \
  --relationship profile \
  --target.entity Profile \
  --cardinality one \
  --relationship.fields "id:user_id"

--target.entity

İlişki için hedef varlık adı. ile kullanın --relationship.

Example

dab update \
  User \
  --relationship profile \
  --target.entity Profile \
  --cardinality one \
  --relationship.fields "id:user_id"

--linking.object

Yalnızca çoka çok. Bağlama nesnesi olarak kullanılan veritabanı nesnesi adı.

Example

dab update \
  Book \
  --relationship books_authors \
  --target.entity Author \
  --cardinality many \
  --relationship.fields "id:id" \
  --linking.object dbo.books_authors \
  --linking.source.fields book_id \
  --linking.target.fields author_id

--linking.source.fields

Yalnızca çoka çok. Kaynak varlığa işaret eden nesne alanlarının virgülle ayrılmış listesi.

Example

dab update \
  Book \
  --relationship books_authors \
  --target.entity Author \
  --cardinality many \
  --relationship.fields "id:id" \
  --linking.object dbo.books_authors \
  --linking.source.fields book_id \
  --linking.target.fields author_id

--linking.target.fields

Yalnızca çoka çok. Hedef varlığa işaret eden nesne alanlarını bağlamanın virgülle ayrılmış listesi.

Example

dab update \
  Book \
  --relationship books_authors \
  --target.entity Author \
  --cardinality many \
  --relationship.fields "id:id" \
  --linking.object dbo.books_authors \
  --linking.source.fields book_id \
  --linking.target.fields author_id

--relationship.fields

Doğrudan ilişkiler için iki nokta üst üste ayrılmış alan eşlemeleri.

--relationship.fields Değer, virgülle ayrılmış çiftler listesidirsourceField:targetField.

Example

dab update \
  User \
  --relationship profile \
  --target.entity Profile \
  --cardinality one \
  --relationship.fields "id:user_id"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "User": {
      "relationships": {
        "profile": {
          "source.fields": [ "id" ],
          "target.fields": [ "user_id" ]
        }
      }
    }
  }
}

--rest

REST pozlamayı kontrol edin.

Example

dab update \
  Book \
  --rest BooksApi

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "rest": {
        "enabled": true,
        "path": "/BooksApi"
      }
    }
  }
}

--rest.methods

Yalnızca saklı yordamlar. İzin verilen HTTP yöntemlerini değiştirin. Varsayılan değer POST'tır.

Example

dab update \
  RunReport \
  --rest true \
  --rest.methods GET,POST

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "RunReport": {
      "rest": {
        "enabled": true,
        "methods": [ "get", "post" ]
      }
    }
  }
}

Uyarı

REST devre dışıyken sağlamanın --rest.methods hiçbir etkisi yoktur.

-s, --source

Temel alınan veritabanı nesnesini güncelleştirin.

Example

dab update \
  Book \
  --source dbo.Books

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "source": {
        "object": "dbo.Books",
        "type": "table"
      }
    }
  }
}

--source.key-fields

Çıkarılma PK'sı olmayan görünümler veya tablolar için. Mevcut anahtarları değiştirir. Saklı yordamlar için geçerli değil.

Example

dab update \
  SalesSummary \
  --source.type view \
  --source.key-fields "year,region"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "SalesSummary": {
      "fields": [
        { "name": "year", "primary-key": true },
        { "name": "region", "primary-key": true }
      ]
    }
  }
}

Uyarı

Saklı yordamlarla kullanılmasına --source.key-fields izin verilmez.

--source.params

Yalnızca saklı yordamlar. Parametre varsayılanlarını değiştirin.

Uyarı

v1.7 ön sürümü CLI'sinde --source.params kullanım dışıdır. kullanın--parameters.name--parameters.default//--parameters.description/--parameters.required.

Example

dab update \
  RunReport \
  --source.type stored-procedure \
  --source.params "year:2024,region:west"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "RunReport": {
      "source": {
        "parameters": [
          { "name": "year", "required": false, "default": "2024" },
          { "name": "region", "required": false, "default": "west" }
        ]
      }
    }
  }
}

Uyarı

Tablo veya görünümlerle kullanılmasına --source.params izin verilmez.

--source.type

Kaynak nesne türünü değiştirin.

Example

dab update \
  Book \
  --source.type view

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Book": {
      "source": {
        "type": "view",
        "object": "Book"
      }
    }
  }
}

--parameters.name

Yalnızca saklı yordamlar. Parametre adlarının virgülle ayrılmış listesi.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  GetOrdersByDateRange \
  --parameters.name "StartDate,EndDate" \
  --parameters.required "true,true" \
  --parameters.description "Beginning of date range,End of date range"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "GetOrdersByDateRange": {
      "source": {
        "parameters": [
          {
            "name": "StartDate",
            "description": "Beginning of date range",
            "required": true
          },
          {
            "name": "EndDate",
            "description": "End of date range",
            "required": true
          }
        ]
      }
    }
  }
}

--parameters.description

Yalnızca saklı yordamlar. ile hizalanmış --parameters.nameparametre açıklamalarının virgülle ayrılmış listesi.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  GetOrdersByDateRange \
  --parameters.name "StartDate,EndDate" \
  --parameters.description "Beginning of date range,End of date range"

--parameters.required

Yalnızca saklı yordamlar. ile hizalanmış --parameters.namedeğerlerinfalsetrue/virgülle ayrılmış listesi.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  GetOrdersByDateRange \
  --parameters.name "StartDate,EndDate" \
  --parameters.required "true,true"

--parameters.default

Yalnızca saklı yordamlar. ile hizalanmış --parameters.namevarsayılan değerlerin virgülle ayrılmış listesi.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  GetOrdersByDateRange \
  --parameters.name "CustomerID" \
  --parameters.default "null"

--fields.name

Açıklanacak veritabanı sütununun adı.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  Products \
  --fields.name Id \
  --fields.primary-key true \
  --fields.description "Product Id"

Sonuçta elde edilen yapılandırma

{
  "entities": {
    "Products": {
      "fields": [
        {
          "name": "Id",
          "description": "Product Id",
          "primary-key": true
        }
      ]
    }
  }
}

--fields.alias

Alanın diğer adı. ile hizalanmış --fields.namevirgülle ayrılmış bir liste kullanın.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  Products \
  --fields.name Id \
  --fields.alias product_id

--fields.description

Alanın açıklaması. ile hizalanmış --fields.namevirgülle ayrılmış bir liste kullanın.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  Products \
  --fields.name Id \
  --fields.description "Product Id"

--fields.primary-key

Alan için birincil anahtar bayrağı. ile hizalanmış --fields.namedeğerlerinfalsetrue/virgülle ayrılmış listesini kullanın.

Uyarı

Bu seçenek yalnızca v1.7 öncesi CLI'de (şu anda RC) kullanılabilir. ile yükleyin dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab update \
  Products \
  --fields.name Id \
  --fields.primary-key true

-c, --config

Yapılandırma dosyasının yolu.

Example

dab update \
  Book \
  --description "Updated description" \
  --config dab-config.json

--help

Yardım ekranını görüntüleyin.

Example

dab update --help

--version

Sürüm bilgilerini görüntüleme.

Example

dab update --version

Önemli

Kaynak türünün değiştirilmesi diğer özellikleri geçersiz kılabilir. Örneğin, görünümler her zaman anahtar alanları gerektirir; saklı yordamlar anahtar alanlarını tanımlayamaz.

  • Last updated on