Bagikan melalui

Membangun dan menjalankan penyusun Api Data dari kode sumber

  • Artikel

Penyusun API Data (DAB) adalah proyek sumber terbuka yang dihosting di GitHub. Kapan saja, Anda dapat mengunduh kode sumber, memodifikasi kode, dan menjalankan proyek langsung dari sumber. Panduan ini mencakup semua langkah yang diperlukan untuk membangun proyek langsung dari kode sumbernya.

Prasyarat

Fork dan kloning repositori

Mulailah dengan membuat fork azure/data-api-builder repositori GitHub Anda sendiri. Fork ini memungkinkan Anda untuk mempertahankan perubahan Anda sendiri. Jika Anda memilih, Anda selalu dapat membuka permintaan pull dan menyarankan perubahan pada repositori upstram.

  1. Navigasikan ke https://github.com/azure/data-api-builder/fork.

  2. Create fork repositori di akun atau organisasi Anda sendiri. Tunggu hingga operasi forking selesai sebelum melanjutkan.

  3. Buka terminal baru.

  4. Kloning fork.

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

    Tip

    Atau, Anda dapat membuka fork atau repositori asli sebagai GitHub Codespace.

  5. Bangun solusinya src/Azure.DataApiBuilder.sln .

    dotnet build src/Azure.DataApiBuilder.sln

Jalankan mesin

Solusinya Azure.DataApiBuilder mencakup beberapa proyek. Untuk menjalankan alat dari sumber, jalankan proyek yang Azure.DataApiBuilder.Service melewati file konfigurasi.

  1. Di direktori akar, buat file baru bernama dab-config.json.

    Tip

    File .gitignore secara otomatis mengabaikan file konfigurasi DAB apa pun.

  2. Tambahkan konten berikut ke file konfigurasi.

    {
  "$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"
        }
      ]
    }
  }
}

    Penting

    Ini adalah konfigurasi sampel yang mengasumsikan Anda memiliki SQL Server yang tersedia di komputer lokal Anda. Jika tidak, Anda dapat menjalankan kontainer Docker untuk SQL Server dengan data sampel Anda. Untuk informasi selengkapnya, lihat membuat data sampel.

  3. Jalankan src/Service/Azure.DataApiBuilder.Service.csproj proyek. --ConfigFileName Gunakan argumen untuk menentukan file konfigurasi yang dibuat pada langkah sebelumnya.

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

    Tip

    Mesin penyusun Api Data akan mencoba memuat konfigurasi dari dab-config.json file di folder yang sama, jika ada. Jika tidak dab-config.json ada file, mesin akan tetap dimulai tetapi tidak akan dapat melayani apa pun.

Konten terkait