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 akkor hasznos, ha:

• 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

Structure

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.

Top-level file

{
  "data-source-files": [
    "dab-config-sql.json",
    "dab-config-cosmos.json"
  ],
  "runtime": {
    "rest": {
      "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')",
    "database-name": "library"
  },
  "entities": {
    "LoanRecord": {
      "source": {
        "object": "LoanRecords"
      },
      "permissions": [
        { "role": "anonymous", "actions": [ "read" ] }
      ]
    }
  }
}

Behavior

• A rendszer csak a legfelső szintű fájl runtime beállításait tartja tiszteletben
• Minden gyermekfájlnak tartalmaznia kell egy és entities egy szakaszt data-source 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

Benefits

• 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

Limitations

• Nincsenek kapcsolatok a konfigurációs fájlok között
• 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