Aracılığıyla paylaş

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

  • Makale

Veri API'leri oluşturucusu (DAB), GitHub'da barındırılan bir açık kaynak projedir. İ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ı ve araçları hakkında temel bilgiler edinilmesi varsayılır.
  • .NET 8

Deponun çatalını oluşturma ve kopyalama

GitHub deposunda kendi çatalınızı azure/data-api-builder oluşturarak başlayın. Bu çatal, kendi değişikliklerinizi kalıcı hale almanızı sağlar. İsterseniz, her zaman bir çekme isteği açabilir ve değişiklikleri yukarı akış deposunda önerebilirsiniz.

  1. https://github.com/azure/data-api-builder/fork sayfasına gidin.

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

  3. Yeni bir terminal açın.

  4. Çatalı klonlama.

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

    İpucu

    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ırma

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

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

    İpucu

    .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 bir SQL Server olduğunu varsayar. 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 Projeyi çalıştırın. --ConfigFileName Önceki adımda oluşturulan yapılandırma dosyasını belirtmek için bağımsız değişkenini kullanın.

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

    İpucu

    Veri API'sinin oluşturucu altyapısı, varsa aynı klasördeki dosyadan dab-config.json yapılandırmayı yüklemeyi dener. Dosya yoksa dab-config.json , altyapı yine de başlatılır, ancak hiçbir şeye hizmet edemeyecektir.

İlgili içerik