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 öğreticide, Git komutlarına ve araç setlerine temel düzeyde aşinalık olduğu varsayılır.
• .NET 8

Depoyu ayrı bir kopyasını oluşturup klonlama

GitHub deposunda kendi çatallanızı azure/data-api-builder oluşturarak başlayın. Bu çatal, kendi değişikliklerinizi kalıcı hale almanızı sağlar. Eğer isterseniz, her zaman bir pull request açabilir ve upstream depoya 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. src/Azure.DataApiBuilder.sln çözümünü oluşturun.

   dotnet build src/Azure.DataApiBuilder.sln
   

Motoru çalıştır

Çözüm Azure.DataApiBuilder birden çok proje içerir. Kaynak koddan aracı çalıştırmak için, Azure.DataApiBuilder.Service projesini bir yapılandırma dosyası geçirerek çalıştırın.

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 bulunan bir SQL Server olduğunu 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

   Veri API oluşturucu altyapısı, varsa aynı klasördeki dosyadan dab-config.json yapılandırmayı yüklemeye çalışır. Eğer dab-config.json dosyası yoksa, motor yine de başlatılabilir, ancak hiçbir şey sunamaz.

İlgili içerik

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