Kaynak koddan Veri API'si oluşturucusu oluşturma ve çalıştırma

Veri API oluşturucusu (DAB), GitHub'da barındırılan bir açık kaynak projesidir. İstediğiniz zaman kaynak kodu indirebilir, kodu değiştirebilir ve projeyi doğrudan kaynaktan çalıştırabilirsiniz. Bu kılavuz, projeyi doğrudan kaynak kodundan oluşturmak için gereken tüm adımları içerir.

Önkoşullar

• GitHub hesabı
• Git
  • Bu öğretici, Git komutları ve araçları konusunda temel bilgilere sahip olduğunuzu varsayar.
• .NET 8

Depoyu fork edip klonlayın

azure/data-api-builder GitHub deposunda kendi fork'unuzu oluşturarak başlayın. Bu çatal, kendi değişikliklerinizi kalıcı hale almanızı sağlar. İsterseniz, her zaman bir pull request açabilir ve ana depodaki değişiklikleri önerebilirsiniz.

1. https://github.com/azure/data-api-builder/fork'a gidin.

2. Kendi hesabınızda veya kuruluşunuzda deponun çatalını oluşturun. Devam etmeden önce çatal oluşturma işleminin tamamlanmasını bekleyin.

3. Yeni bir terminal açın.

4. Çatalı klonla.

   git clone https://github.com/<your-username>/data-api-builder.git
   

   Tavsiye

   Alternatif olarak, çatalı veya özgün depoyu GitHub Codespace olarak açabilirsiniz.

5. Çözümü oluşturun src/Azure.DataApiBuilder.sln .

   dotnet build src/Azure.DataApiBuilder.sln
   

Motoru çalıştır

Çözüm Azure.DataApiBuilder birden çok proje içerir. Aracı kaynak koddan çalıştırmak için projeyi bir yapılandırma dosyası belirterek çalıştırın Azure.DataApiBuilder.Service.

1. Kök dizinde adlı dab-config.jsonyeni bir dosya oluşturun.

   Tavsiye

   .gitignore dosyası tüm DAB yapılandırma dosyalarını otomatik olarak yoksayar.

2. Yapılandırma dosyasına aşağıdaki içeriği ekleyin.

   {
     "$schema": "https://github.com/Azure/data-api-builder/releases/latest/download/dab.draft.schema.json",
     "data-source": {
       "database-type": "mssql",
       "connection-string": "Server=localhost,1433;Initial Catalog=Library;User Id=sa;Password=<your-password>;TrustServerCertificate=true;"
     },
     "entities": {
       "book": {
         "source": "dbo.Books",
         "permissions": [
           {
             "actions": [
               "read"
             ],
             "role": "anonymous"
           }
         ]
       }
     }
   }
   

   Önemli

   Bu, yerel makinenizde mevcut olan bir SQL Server'ı varsayan bir örnek yapılandırmadır. Bunu yapmazsanız, örnek verilerinizle SQL Server için bir Docker kapsayıcısı çalıştırabilirsiniz. Daha fazla bilgi için bkz. Örnek veri oluşturma.

3. src/Service/Azure.DataApiBuilder.Service.csproj projesini çalıştırın. Önceki adımda oluşturulan yapılandırma dosyasını belirtmek için --ConfigFileName bağımsız değişkenini kullanın.

   dotnet run --project src/Service/Azure.DataApiBuilder.Service.csproj --ConfigFileName ../../dab-config.json 
   

   Tavsiye

   Data API builder altyapısı, varsa aynı klasördeki dosyadan dab-config.json yapılandırmayı yüklemeyi dener. dab-config.json dosyası yoksa motor yine de başlatılır, ancak hiçbir şey sunamaz.

İlgili içerik

• GitHub'da azure/data-api-builder
• Docker kapsayıcısında çalıştırma