Több adatforrás hozzáadása

A Data API Builder adatforrásfájlok használatával támogatja a hibrid végpontokat, így több adatforrást és azok entitásait is definiálhatja külön konfigurációs fájlokban.

Ez a megközelítés olyan helyzetekben hasznos, mint például:

• Több adatbázisból származó entitásokat kell elérhetővé tennie
• A konfigurációkat modulárisan szeretné rendszerezni
• Egymástól függetlenül kell kezelnie a különböző adat-háttérrendszereket

Struktúra

Több adatforrás definiálásához hozzon létre több konfigurációs fájlt, és hivatkozzon rájuk a data-source-files legfelső szintű konfiguráció tömbjében.

Legfelső szintű fájl

{
  "data-source-files": [
    "dab-config-sql.json",
    "dab-config-cosmos.json"
  ],
  "runtime": {
    "rest": {
      "enabled": true
    },
    "graphql": {
      "enabled": true
    },
    "mcp": {
      "enabled": true
    }

  }
}

Gyermekfájl: dab-config-sql.json

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "@env('SQL_CONNECTION_STRING')"
  },
  "entities": {
    "Book": {
      "source": {
        "object": "dbo.Books"
      },
      "permissions": [
        { "role": "anonymous", "actions": [ "read" ] }
      ]
    }
  }
}

Gyermekfájl: dab-config-cosmos.json

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "connection-string": "@env('COSMOS_CONNECTION_STRING')",
    "options": {
      "database": "library"
    }
  },
  "entities": {
    "LoanRecord": {
      "source": {
        "object": "LoanRecords"
      },
      "permissions": [
        { "role": "anonymous", "actions": [ "read" ] }
      ]
    }
  }
}

Magatartás

• A rendszer csak a legfelső szintű fájl runtime beállításait tartja tiszteletben
• Minden gyermekfájlnak tartalmaznia kell egy és data-source egy szakaszt entities is
• Az entitásneveknek globálisan egyedinek kell lenniük az összes fájlban
• A különálló fájlokban definiált entitások nem hivatkoznak egymásra kapcsolatokon keresztül
• A fájlok szükség szerint almappákba ágyazhatók

Előnyök

• A konfiguráció tiszta elkülönítése háttérrendszerenként
• Skálázható többadatbázisos API-k engedélyezése
• Leegyszerűsíti az összetett rendszerek karbantartását

Korlátozások

• Nincsenek kapcsolatok a konfigurációs fájlok között
• A körkörös fájlhivatkozások nem engedélyezettek
• Csak a legfelső szintű fájl szabályozza a futtatókörnyezet viselkedését