Autoentities

Konfigurationseinstellungen für die automatische Entitätsgenerierung basierend auf Musterabgleichsregeln. Autoentities ist ein Peer zum entities Abschnitt – wenn autoentities vorhanden, entities ist nicht mehr erforderlich. Das Schema lässt entweder autoentities oder entities (oder beides) zu. Wenn beide vorhanden sind, haben explizit definierte Entitäten Vorrang vor autoentities Übereinstimmungen mit demselben Namen.

Muster

Vorlage

Erlaubnisse

Formatübersicht

{
  "autoentities": {
    "<definition-name>": {
      "patterns": {
        "include": [ "<string>" ],    // default: ["%.%"]
        "exclude": [ "<string>" ],    // default: null
        "name": "<string>"            // default: "{object}"
      },
      "template": {
        "rest": { "enabled": <boolean> },      // default: true
        "graphql": { "enabled": <boolean> },   // default: true
        "mcp": { "dml-tools": <boolean> },     // default: true
        "health": { "enabled": <boolean> },    // default: true
        "cache": {
          "enabled": <boolean>,                // default: false
          "ttl-seconds": <integer>,            // default: null
          "level": "<string>"                  // default: "L1L2"
        }
      },
      "permissions": [
        {
          "role": "<string>",
          "actions": [ { "action": "<string>" } ]
        }
      ]
    }
  }
}

Definitionsname (autoentities)

Jeder Schlüssel im autoentities Objekt ist eine benannte Definition. Bei dem Namen wird die Groß-/Kleinschreibung beachtet und dient als logischer Bezeichner. Sie können mehrere Definitionen mit unterschiedlichen Mustern und Berechtigungen definieren.

Format

{
  "autoentities": {
    "<definition-name>": { ... }
  }
}

Beispiel

{
  "autoentities": {
    "public-tables": {
      "patterns": { "include": [ "dbo.%" ] },
      "permissions": [ { "role": "anonymous", "actions": [ { "action": "read" } ] } ]
    },
    "admin-tables": {
      "patterns": { "include": [ "admin.%" ] },
      "permissions": [ { "role": "authenticated", "actions": [ { "action": "*" } ] } ]
    }
  }
}

Muster (Definitionsname autoentities)

Definiert Regeln zum Einschließen, Ausschließen und Benennen, die bestimmen, welche Datenbankobjekte als Entitäten verfügbar gemacht werden.

Verschachtelte Eigenschaften

• include– Mindestens ein MSSQL-Muster LIKE , das angibt, welche Datenbankobjekte einbezogen werden sollen. Wird als Wildcard verwendet % . Das Musterformat lautet schema.object (z dbo.% . B. entspricht allen Objekten im dbo Schema). Wenn null oder ausgelassen, wird standardmäßig auf ["%.%"] (alle Objekte in allen Schemas) festgelegt.

• exclude– Mindestens ein MSSQL-Muster LIKE , das angibt, welche Datenbankobjekte ausgeschlossen werden sollen. Ausschlussmuster werden nach einschließen von Mustern ausgewertet. Wenn null oder ausgelassen, werden keine Objekte ausgeschlossen.

• name— Interpolationsmuster, das steuert, wie übereinstimmene Datenbankobjekte als Entitäten benannt werden. Unterstützt {schema} und {object} Platzhalter. Jeder aufgelöste Name muss für alle Entitäten in der Konfiguration eindeutig sein.

Format

{
  "autoentities": {
    "<definition-name>": {
      "patterns": {
        "include": [ "<string>" ],
        "exclude": [ "<string>" ],
        "name": "<string>"
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "patterns": {
        "include": [ "dbo.%" ],
        "exclude": [ "dbo.internal%" ],
        "name": "{schema}_{object}"
      }
    }
  }
}

Bei dieser Konfiguration wird jede Tabelle im dbo Schema (mit Ausnahme dieser Übereinstimmungen dbo.internal%) als Entität verfügbar gemacht. Eine Benannte dbo.Products Tabelle wird zu einer Entität namens dbo_Products.

Name (Musterdefinitionsname autoentities)

Steuert, wie übereinstimmene Datenbankobjekte als Entitäten benannt werden. Unterstützt zwei Platzhalter:

Wenn sie weggelassen wird, bedeutet die Standardeinstellung "{object}" , dass der Entitätsname dem Datenbankobjektnamen direkt entspricht.

Format

{
  "autoentities": {
    "<definition-name>": {
      "patterns": {
        "name": "<string>"
      }
    }
  }
}

Beispiele

REST (Vorlagendefinitionsname autoentities)

Verschachtelte Eigenschaften

Format

{
  "autoentities": {
    "<definition-name>": {
      "template": {
        "rest": { "enabled": <boolean> }
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "template": {
        "rest": { "enabled": false }
      }
    }
  }
}

GraphQL (Vorlagendefinitionsname autoentities)

Verschachtelte Eigenschaften

Format

{
  "autoentities": {
    "<definition-name>": {
      "template": {
        "graphql": { "enabled": <boolean> }
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "template": {
        "graphql": { "enabled": true }
      }
    }
  }
}

MCP (Vorlagendefinitionsname autoentities)

Verschachtelte Eigenschaften

Aktiviert oder deaktiviert MCP-Datenmanipulationssprache (DML)-Tools für alle übereinstimmende Entitäten.

Format

{
  "autoentities": {
    "<definition-name>": {
      "template": {
        "mcp": { "dml-tools": <boolean> }
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "template": {
        "mcp": { "dml-tools": true }
      }
    }
  }
}

Integrität (Vorlagendefinitionsname autoentities)

Verschachtelte Eigenschaften

Format

{
  "autoentities": {
    "<definition-name>": {
      "template": {
        "health": { "enabled": <boolean> }
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "template": {
        "health": { "enabled": true }
      }
    }
  }
}

Cache (Vorlagendefinitionsname autoentities)

Aktiviert und konfiguriert das Zwischenspeichern von Antworten für alle übereinstimmenen Entitäten.

Verschachtelte Eigenschaften

Die level Eigenschaft steuert, welche Cacheebenen verwendet werden:

Format

{
  "autoentities": {
    "<definition-name>": {
      "template": {
        "cache": {
          "enabled": <boolean>,
          "ttl-seconds": <integer>,
          "level": "<L1 | L1L2>"
        }
      }
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "template": {
        "cache": {
          "enabled": true,
          "ttl-seconds": 30,
          "level": "L1L2"
        }
      }
    }
  }
}

Berechtigungen (Definitionsname autoentities)

Berechtigungen, die auf jede Entität angewendet werden, die mit dieser autoentities Definition übereinstimmt. Jedes Element ist ein Objekt mit einem role und einem actions Array.

Verschachtelte Eigenschaften

Unterstützte Aktionswerte: create, read, , update, deleteoder * (Wildcard erweitert sich auf alle vier CRUD-Aktionen).

Format

{
  "autoentities": {
    "<definition-name>": {
      "permissions": [
        {
          "role": "<string>",
          "actions": [ { "action": "<string>" } ]
        }
      ]
    }
  }
}

Beispiel

{
  "autoentities": {
    "my-def": {
      "patterns": {
        "include": [ "dbo.%" ]
      },
      "permissions": [
        { "role": "anonymous", "actions": [ { "action": "read" } ] },
        { "role": "authenticated", "actions": [ { "action": "*" } ] }
      ]
    }
  }
}

Vollständiges Beispiel

{
  "autoentities": {
    "my-def": {
      "patterns": {
        "include": [ "dbo.%" ],
        "exclude": [ "dbo.internal%" ],
        "name": "{schema}_{object}"
      },
      "template": {
        "rest": { "enabled": true },
        "graphql": { "enabled": true },
        "mcp": { "dml-tools": true },
        "health": { "enabled": true },
        "cache": { "enabled": true, "ttl-seconds": 30, "level": "L1L2" }
      },
      "permissions": [
        { "role": "anonymous", "actions": [ { "action": "read" } ] }
      ]
    }
  }
}

Bei dieser Konfiguration wird jede Tabelle im dbo Schema (mit Ausnahme dieser Übereinstimmungen dbo.internal%) automatisch als DAB-Entität verfügbar gemacht. Jede Entität wird mit dem {schema}_{object} Muster benannt (z dbo_Products. B. ), verfügt über REST-, GraphQL-, MCP- und Integritätsprüfungen aktiviert, verwendet zwischenspeichern mit einer 30-Sekunden-Zeit-zu-Live-Funktion und gewährt read Zugriff auf die anonymous Rolle.

Verwandte Inhalte

• dab auto-config Befehlsreferenz
• dab auto-config-simulate Befehlsreferenz
• Neuerungen in Version 2.0
• Entitätenkonfiguration