configure-Befehl

Konfigurieren Sie Laufzeit- und Datenquelleneigenschaften, die nicht entitätsspezifisch in einer vorhandenen Konfigurationsdatei des Daten-API-Generators sind. Nicht angegebene Optionen lassen vorhandene Werte unverändert. Wenn eine bereitgestellte Option ungültig ist, schlägt das gesamte Update fehl (alles oder nichts).

Akronyme, die in dieser Referenz verwendet werden: Model Context Protocol (MCP), Datenmanipulationssprache (DML), Zeit für Live (TTL), JSON Web Token (JWT), Release Candidate (RC), Data Collection Rule (DCR) und Datensammlungsendpunkt (DATA Collection Endpoint, DCE).

Hinweis

Dieser Befehl ändert den entities Abschnitt nicht. Wird für Entitätsänderungen verwendet dab update .

Syntax

dab configure [options]

Von Bedeutung

Die Einstellungen "OpenTelemetry" und "Application Insights" sind mit dab add-telemetrydab configurenicht konfiguriert. Siehe "concept/monitor/open-telemetry.md " und "concept/monitor/application-insights.md".

Schnellblick

Option Zusammenfassung
-c, --config Pfad zur Konfigurationsdatei (Standard dab-config.json).

Datenquellenabschnitt

Option Zusammenfassung
--data-source.database-type Legen Sie den Datenbanktyp fest.
--data-source.connection-string Legen Sie die Datenbankverbindungszeichenfolge fest.
--data-source.options.database Datenbankname für Cosmos DB für NoSql.
--data-source.options.container Containername für Cosmos DB für NoSql.
--data-source.options.schema Schemapfad für Cosmos DB für NoSql.
--data-source.options.set-session-context Aktivieren oder Deaktivieren des Sitzungskontexts. Standardwert: false.
--data-source.health.enabled Aktivieren oder deaktivieren Sie die Integritätsprüfung der Datenquelle.
--data-source.health.name Bezeichner für Datenquelle im Integritätsprüfungsbericht.
--data-source.health.threshold-ms Schwellenwert für die Integritätsprüfungsabfrage in Millisekunden.
--data-source.user-delegated-auth.enabled Aktivieren Sie die OBO-benutzerdelegierte Authentifizierung.
--data-source.user-delegated-auth.provider Legen Sie den OBO-Identitätsanbieter fest.
--data-source.user-delegated-auth.database-audience Zielgruppe für das nachgeschaltete SQL-Token.
--data-source-files Verweisen Sie auf zusätzliche Datenquellenkonfigurationsdateien.

GraphQL-Abschnitt

Option Zusammenfassung
--runtime.graphql.depth-limit Maximale Abfragetiefe beschränken.
--runtime.graphql.enabled Aktivieren oder Deaktivieren des GraphQL-Endpunkts.
--runtime.graphql.path Passen Sie den GraphQL-Endpunktpfad an.
--runtime.graphql.allow-introspection Zulassen oder Verweigern der GraphQL-Introspektion.
--runtime.graphql.multiple-mutations.create.enabled Aktivieren Von Mutationen mit mehrfacher Erstellung.

REST-Abschnitt

Option Zusammenfassung
--runtime.rest.enabled Aktivieren oder Deaktivieren des REST-Endpunkts.
--runtime.rest.path Passen Sie den REST-Endpunktpfad an.
--runtime.rest.request-body-strict Erzwingen der strengen ÜBERPRÜFUNG des REST-Anforderungstexts.

Paginierungsbereich

Option Zusammenfassung
--runtime.pagination.max-page-size Maximale Seitengröße für paginierte Ergebnisse.
--runtime.pagination.default-page-size Standardseitengröße für paginierte Ergebnisse.
--runtime.pagination.next-link-relative Verwenden Sie relative URLs in den nächsten Links der REST-Paginierung.

MCP-Abschnitt

Option Zusammenfassung
--runtime.mcp.enabled Aktivieren oder Deaktivieren des MCP-Endpunkts.
--runtime.mcp.path Passen Sie den MCP-Endpunktpfad an.
--runtime.mcp.description Legen Sie die MCP-Serverbeschreibung fest.
--runtime.mcp.dml-tools Aktivieren oder deaktivieren Sie alle MCP-DML-Tools.
--runtime.mcp.dml-tools.describe-entities Aktivieren oder deaktivieren Sie das Tool zur Beschreibung von Entitäten.
--runtime.mcp.dml-tools.create-record Aktivieren oder deaktivieren Sie das Create-Record-Tool.
--runtime.mcp.dml-tools.read-records Aktivieren oder deaktivieren Sie das Tool zum Lesen von Datensätzen.
--runtime.mcp.dml-tools.update-record Aktivieren oder deaktivieren Sie das Update-Datensatztool.
--runtime.mcp.dml-tools.delete-record Aktivieren oder deaktivieren Sie das Tool zum Löschen von Datensätzen.
--runtime.mcp.dml-tools.execute-entity Aktivieren oder Deaktivieren des Execute-Entity-Tools.
--runtime.mcp.dml-tools.aggregate-records Aktivieren oder deaktivieren Sie das Tool für Aggregatdatensätze.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Ausführungszeitlimit in Sekunden für Aggregatdatensätze.

Cacheabschnitt

Option Zusammenfassung
--runtime.cache.enabled Aktivieren oder Deaktivieren des globalen Caches.
--runtime.cache.ttl-seconds Globaler Cache-TTL in Sekunden.
--runtime.compression.level Legen Sie die HTTP-Antwortkomprimierungsebene fest.

Hostabschnitt

Option Zusammenfassung
--runtime.host.mode Hostmodus festlegen: Entwicklung oder Produktion.
--runtime.host.max-response-size-mb Maximale Antwortgröße in Megabyte.
--runtime.host.cors.origins Zulässige CORS-Ursprünge.
--runtime.host.cors.allow-credentials Legen Sie CORS-Zulassungsanmeldeinformationen fest.
--runtime.host.authentication.provider Authentifizierungsanbieter.
--runtime.host.authentication.jwt.audience JWT-Zielgruppenanspruch.
--runtime.host.authentication.jwt.issuer JWT-Ausstelleranspruch.

Abschnitt "Integrität"

Option Zusammenfassung
--runtime.health.enabled Aktivieren oder deaktivieren Sie den globalen Integritätsendpunkt.
--runtime.health.cache-ttl-seconds Cache-TTL für Integritätsprüfungsberichte.
--runtime.health.max-query-parallelism Maximale Anzahl gleichzeitiger Integritätsprüfungsabfragen.
--runtime.health.roles Rollen, die umfassende Integritätsergebnisse anzeigen dürfen.

Effektive Berechtigungen

Option Zusammenfassung
--show-effective-permissions Zeigt aufgelöste Berechtigungen für alle Entitäten an.

Key Vault-Abschnitt

Option Zusammenfassung
--azure-key-vault.endpoint Azure Key Vault-Basisendpunkt.
--azure-key-vault.retry-policy.mode Wiederholen Sie den Richtlinienmodus.
--azure-key-vault.retry-policy.max-count Max. Wiederholungsversuche.
--azure-key-vault.retry-policy.delay-seconds Verzögerung zwischen Wiederholungen.
--azure-key-vault.retry-policy.max-delay-seconds Maximale Verzögerung für exponentielle Wiederholungen.
--azure-key-vault.retry-policy.network-timeout-seconds Timeout für Netzwerkanrufe.

Telemetrieabschnitt

Option Zusammenfassung
--runtime.telemetry.log-level Konfigurieren Sie die Ausführlichkeit der Protokollierung nach Namespace.
--runtime.telemetry.azure-log-analytics.enabled Aktivieren Sie die Azure Log Analytics-Telemetrie.
--runtime.telemetry.azure-log-analytics.dab-identifier Unterscheiden des Protokollursprungs.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Spülungsrhythmen in Sekunden.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Benutzerdefinierter Tabellenname.
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id Datensammlungsregel-ID.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Datensammlungsendpunkt.
--runtime.telemetry.file.enabled Aktivieren Sie die Telemetrie der Dateisenke.
--runtime.telemetry.file.path Pfad zur Protokolldatei.
--runtime.telemetry.file.rolling-interval Rollintervall.
--runtime.telemetry.file.retained-file-count-limit Maximale Anzahl der aufbewahrten Dateien.
--runtime.telemetry.file.file-size-limit-bytes Maximale Größe pro Datei vor dem Rollen.

-c, --config

Pfad zur Konfigurationsdatei. Der Standardwert ist, dab-config.json sofern nicht dab-config.<DAB_ENVIRONMENT>.json vorhanden, wobei DAB_ENVIRONMENT es sich um eine Umgebungsvariable handelt.

Example

dab configure \
  --config ./dab-config.json \
  --runtime.rest.enabled true

--data-source.database-type

Datenbanktyp.

Zulässige Werte:

  • MSSQL
  • DWSQL
  • PostgreSQL
  • CosmosDB_PostgreSQL
  • CosmosDB_NoSQL
  • MySQL

Example

dab configure \
  --data-source.database-type PostgreSQL

Resultierende Konfiguration

{
  "data-source": {
    "database-type": "postgresql"
  }
}

--data-source.connection-string

Verbindungszeichenfolge für die Datenquelle.

Example

dab configure \
  --data-source.connection-string "Server=myserver;Database=mydb;User Id=myuser;Password=mypassword;"

Resultierende Konfiguration

{
  "data-source": {
    "connection-string": "Server=myserver;Database=mydb;User Id=myuser;Password=mypassword;"
  }
}

--data-source-files

Verweisen Sie auf zusätzliche Datenquellenkonfigurationsdateien aus der Stammkonfigurationsdatei.

Example

dab configure \
  --data-source-files ./dab-config.sales.json

Resultierende Konfiguration

{
  "data-source-files": [
    "./dab-config.sales.json"
  ]
}

--data-source.options.database

Datenbankname für Cosmos DB für NoSql.

Example

dab configure \
  --data-source.options.database MyCosmosDatabase

Resultierende Konfiguration

{
  "data-source": {
    "options": {
      "database": "MyCosmosDatabase"
    }
  }
}

--data-source.options.container

Containername für Cosmos DB für NoSql.

Example

dab configure \
  --data-source.options.container MyCosmosContainer

Resultierende Konfiguration

{
  "data-source": {
    "options": {
      "container": "MyCosmosContainer"
    }
  }
}

--data-source.options.schema

Schemapfad für Cosmos DB für NoSql.

Example

dab configure \
  --data-source.options.schema ./schema.gql

Resultierende Konfiguration

{
  "data-source": {
    "options": {
      "schema": "./schema.gql"
    }
  }
}

--data-source.options.set-session-context

Aktivieren sie den Sitzungskontext.

Zulässige Werte:

  • true
  • false (Standardwert)

Example

dab configure \
  --data-source.options.set-session-context false

Resultierende Konfiguration

{
  "data-source": {
    "options": {
      "set-session-context": false
    }
  }
}

--data-source.health.enabled

Aktivieren oder deaktivieren Sie die Integritätsprüfung für die Datenquelle. Der Standardwert ist true.

Example

dab configure \
  --data-source.health.enabled false

Resultierende Konfiguration

{
  "data-source": {
    "health": {
      "enabled": false
    }
  }
}

--data-source.health.name

Bezeichner für Datenquelle im Integritätsprüfungsbericht.

Example

dab configure \
  --data-source.health.name my-sql-health

Resultierende Konfiguration

{
  "data-source": {
    "health": {
      "name": "my-sql-health"
    }
  }
}

--data-source.health.threshold-ms

Maximale Dauer in Millisekunden für die Abfrage der Datenquellenintegritätsprüfung. Der Standardwert ist 1000.

Example

dab configure \
  --data-source.health.threshold-ms 750

Resultierende Konfiguration

{
  "data-source": {
    "health": {
      "threshold-ms": 750
    }
  }
}

--data-source.user-delegated-auth.enabled

Aktivieren oder deaktivieren Sie die benutzerdelegierte Authentifizierung beiBehalf-Of (OBO). Wird nur für mssql Datenquellen unterstützt.

Hinweis

Die in diesem Abschnitt beschriebene Funktionalität des Daten-API-Generators 2.0 befindet sich derzeit in der Vorschau und kann sich vor der allgemeinen Verfügbarkeit ändern. Weitere Informationen finden Sie unter Neuigkeiten in Version 2.0.

Example

dab configure \
  --data-source.user-delegated-auth.enabled true

Resultierende Konfiguration

{
  "data-source": {
    "user-delegated-auth": {
      "enabled": true
    }
  }
}

--data-source.user-delegated-auth.provider

Legen Sie den Identitätsanbieter für die benutzerdelegierteBehalf-Of(OBO)-Authentifizierung fest. Derzeit wird nur EntraId unterstützt.

Hinweis

Die in diesem Abschnitt beschriebene Funktionalität des Daten-API-Generators 2.0 befindet sich derzeit in der Vorschau und kann sich vor der allgemeinen Verfügbarkeit ändern. Weitere Informationen finden Sie unter Neuigkeiten in Version 2.0.

Example

dab configure \
  --data-source.user-delegated-auth.provider EntraId

Resultierende Konfiguration

{
  "data-source": {
    "user-delegated-auth": {
      "provider": "EntraId"
    }
  }
}

--data-source.user-delegated-auth.database-audience

Legen Sie die Zielgruppe für das nachgeschaltete SQL-Token fest, wenn OBO aktiviert ist.

Example

dab configure \
  --data-source.user-delegated-auth.database-audience "https://database.windows.net"

Resultierende Konfiguration

{
  "data-source": {
    "user-delegated-auth": {
      "database-audience": "https://database.windows.net"
    }
  }
}

--runtime.graphql.depth-limit

Maximale zulässige Tiefe der geschachtelten Abfrage.

Zulässige Werte:

  • $(0,2147483647]$ (einschließlich)
  • -1 zum Entfernen des Grenzwerts

Example

dab configure \
  --runtime.graphql.depth-limit 3

Resultierende Konfiguration

{
  "runtime": {
    "graphql": {
      "depth-limit": 3
    }
  }
}

--runtime.graphql.enabled

Aktivieren Sie den GraphQL-Endpunkt von DAB.

Example

dab configure \
  --runtime.graphql.enabled false

Resultierende Konfiguration

{
  "runtime": {
    "graphql": {
      "enabled": false
    }
  }
}

--runtime.graphql.path

Passen Sie den GraphQL-Endpunktpfad von DAB an. Präfixpfad mit /.

Example

dab configure \
  --runtime.graphql.path /graphql

Resultierende Konfiguration

{
  "runtime": {
    "graphql": {
      "path": "/graphql"
    }
  }
}

--runtime.graphql.allow-introspection

Zulassen oder Verweigern von GraphQL-Introspection-Anforderungen.

Example

dab configure \
  --runtime.graphql.allow-introspection false

Resultierende Konfiguration

{
  "runtime": {
    "graphql": {
      "allow-introspection": false
    }
  }
}

--runtime.graphql.multiple-mutations.create.enabled

Aktivieren oder Deaktivieren von Erstellungsvorgängen mit mehreren Mutationen im generierten GraphQL-Schema.

Example

dab configure \
  --runtime.graphql.multiple-mutations.create.enabled true

Resultierende Konfiguration

{
  "runtime": {
    "graphql": {
      "multiple-mutations": {
        "create": {
          "enabled": true
        }
      }
    }
  }
}

--runtime.rest.enabled

Aktivieren Sie den REST-Endpunkt von DAB.

Example

dab configure \
  --runtime.rest.enabled false

Resultierende Konfiguration

{
  "runtime": {
    "rest": {
      "enabled": false
    }
  }
}

--runtime.rest.path

Passen Sie den REST-Endpunktpfad von DAB an. Präfixpfad mit /.

Example

dab configure \
  --runtime.rest.path /myapi

Resultierende Konfiguration

{
  "runtime": {
    "rest": {
      "path": "/myapi"
    }
  }
}

--runtime.rest.request-body-strict

Verbieten Sie zusätzliche REST-Anforderungstextfelder.

Example

dab configure \
  --runtime.rest.request-body-strict true

Resultierende Konfiguration

{
  "runtime": {
    "rest": {
      "request-body-strict": true
    }
  }
}

--runtime.pagination.max-page-size

Maximale Seitengröße für paginierte Ergebnisse. Der Standardwert ist 100000. Das Minimum ist 1.

Example

dab configure \
  --runtime.pagination.max-page-size 50000

Resultierende Konfiguration

{
  "runtime": {
    "pagination": {
      "max-page-size": 50000
    }
  }
}

--runtime.pagination.default-page-size

Standardseitengröße für paginierte Ergebnisse. Der Standardwert ist 100. Das Minimum ist 1.

Example

dab configure \
  --runtime.pagination.default-page-size 50

Resultierende Konfiguration

{
  "runtime": {
    "pagination": {
      "default-page-size": 50
    }
  }
}

--runtime.pagination.next-link-relative

Verwenden Sie relative URLs anstelle absoluter URLs in REST-Paginierungswerten nextLink . Der Standardwert ist false.

Example

dab configure \
  --runtime.pagination.next-link-relative true

Resultierende Konfiguration

{
  "runtime": {
    "pagination": {
      "next-link-relative": true
    }
  }
}

--runtime.mcp.enabled

Aktivieren Sie den MCP-Endpunkt von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.enabled false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "enabled": false
    }
  }
}

--runtime.mcp.path

Passen Sie den MCP-Endpunktpfad von DAB an. Präfixpfad mit /.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.path /mcp2

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "path": "/mcp2"
    }
  }
}

--runtime.mcp.description

Legen Sie die MCP-Serverbeschreibung fest, die in der initialisierten Antwort verfügbar gemacht werden soll.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.description "My MCP Server"

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "description": "My MCP Server"
    }
  }
}

--runtime.mcp.dml-tools

Aktivieren Sie den MCP-DML-Tools-Endpunkt von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Weitere Informationen zu MCP-DML-Tools finden Sie unter SQL MCP Server-Datenmanipulationssprachentools.

Example

dab configure \
  --runtime.mcp.dml-tools false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": false
    }
  }
}

--runtime.mcp.dml-tools.describe-entities

Aktivieren Sie das MCP von DAB zur Beschreibung von Entitäten.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.describe-entities false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "describe-entities": false
      }
    }
  }
}

--runtime.mcp.dml-tools.create-record

Aktivieren Sie das MCP-Erstellungstool von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.create-record false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "create-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.read-records

Aktivieren Sie das MCP-Lesedatensatztool von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.read-records false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "read-records": false
      }
    }
  }
}

--runtime.mcp.dml-tools.update-record

Aktivieren Sie das MCP-Updatedatensatztool von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.update-record false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "update-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.delete-record

Aktivieren Sie das MCP-Löschdatensatztool von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.delete-record false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "delete-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.execute-entity

Aktivieren Sie das MCP-Tool zum Ausführen der Entität von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.execute-entity false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "execute-entity": false
      }
    }
  }
}

--runtime.mcp.dml-tools.aggregate-records

Aktivieren Sie das MCP-Aggregatdatensätze-Tool von DAB.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.aggregate-records false

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "aggregate-records": false
      }
    }
  }
}

--runtime.mcp.dml-tools.aggregate-records.query-timeout

Legen Sie das Ausführungstimeout in Sekunden für das MCP-Tool für Aggregatdatensätze fest.

Standardwert: 30. Bereich: 1 bis 600.

Hinweis

Diese Option ist in der Vorschau-CLI des Daten-API-Generators 2.0 verfügbar. Installieren Sie die neueste Vorabversion mit dotnet tool install microsoft.dataapibuilder --prerelease.

Example

dab configure \
  --runtime.mcp.dml-tools.aggregate-records.query-timeout 60

Resultierende Konfiguration

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "aggregate-records": {
          "enabled": true,
          "query-timeout": 60
        }
      }
    }
  }
}

--runtime.cache.enabled

Aktivieren Sie den CACHE von DAB global. Sie müssen auch die Zwischenspeicherung für jede Entität aktivieren.

Example

dab configure \
  --runtime.cache.enabled true

Resultierende Konfiguration

{
  "runtime": {
    "cache": {
      "enabled": true
    }
  }
}

--runtime.cache.ttl-seconds

Passen Sie die globale Standardzeit des DAB-Caches in Sekunden an.

Example

dab configure \
  --runtime.cache.ttl-seconds 30

Resultierende Konfiguration

{
  "runtime": {
    "cache": {
      "enabled": false,
      "ttl-seconds": 30
    }
  }
}

--runtime.compression.level

Hinweis

Die in diesem Abschnitt beschriebene Funktionalität des Daten-API-Generators 2.0 befindet sich derzeit in der Vorschau und kann sich vor der allgemeinen Verfügbarkeit ändern. Weitere Informationen finden Sie unter Neuigkeiten in Version 2.0.

Legen Sie die HTTP-Antwortkomprimierungsebene fest.

Zulässige Werte:

  • optimal— Ausgleich des Komprimierungsverhältnisses und der Geschwindigkeit (Standard)
  • fastest— Priorisiert die Komprimierungsgeschwindigkeit gegenüber dem Verhältnis
  • none— Deaktiviert die Komprimierung

Example

dab configure \
  --runtime.compression.level optimal

Resultierende Konfiguration

{
  "runtime": {
    "compression": {
      "level": "optimal"
    }
  }
}

--runtime.host.mode

Legen Sie den Hostausführungsmodus von DAB fest.

Zulässige Werte:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "mode": "development"
    }
  }
}

--runtime.host.max-response-size-mb

Maximale Größe in Megabyte für eine Datenbankantwort in einem einzigen Ergebnis. Der Standardwert ist 158.

Example

dab configure \
  --runtime.host.max-response-size-mb 256

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "max-response-size-mb": 256
    }
  }
}

--runtime.host.cors.origins

Überschreiben zulässiger Ursprünge in CORS. Stellen Sie Werte als durch Leerzeichen getrennte Liste bereit.

Example

dab configure \
  --runtime.host.cors.origins \
  https://contoso.com \
  https://fabrikam.com

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "cors": {
        "origins": [
          "https://contoso.com",
          "https://fabrikam.com"
        ]
      }
    }
  }
}

--runtime.host.cors.allow-credentials

Legen Sie den Wert für die Access-Control-Allow-Credentials Kopfzeile fest.

Example

dab configure \
  --runtime.host.cors.allow-credentials true

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "cors": {
        "allow-credentials": true
      }
    }
  }
}

--runtime.host.authentication.provider

Konfigurieren Sie den Namen des Authentifizierungsanbieters.

Example

dab configure \
  --runtime.host.authentication.provider AppService

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "authentication": {
        "provider": "AppService"
      }
    }
  }
}

--runtime.host.authentication.jwt.audience

Konfigurieren Sie einen oder mehrere beabsichtigte Empfänger des JWT-Tokens.

Example

dab configure \
  --runtime.host.authentication.jwt.audience api://my-app

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "authentication": {
        "jwt": {
          "audience": "api://my-app"
        }
      }
    }
  }
}

--runtime.host.authentication.jwt.issuer

Konfigurieren Sie die Entität, die das JWT-Token ausgestellt hat.

Example

dab configure \
  --runtime.host.authentication.jwt.issuer https://login.microsoftonline.com/common/v2.0

Resultierende Konfiguration

{
  "runtime": {
    "host": {
      "authentication": {
        "provider": "AppService",
        "jwt": {
          "audience": "api://my-app",
          "issuer": "https://login.microsoftonline.com/common/v2.0"
        }
      }
    }
  }
}

--runtime.health.enabled

Aktivieren oder deaktivieren Sie den globalen Integritätsendpunkt. Der Standardwert ist true.

Example

dab configure \
  --runtime.health.enabled true

Resultierende Konfiguration

{
  "runtime": {
    "health": {
      "enabled": true
    }
  }
}

--runtime.health.cache-ttl-seconds

Zeit für zwischengespeicherte Integritätsprüfungsberichte in Sekunden zu leben. Der Standardwert ist 5. Das Minimum ist 0.

Example

dab configure \
  --runtime.health.cache-ttl-seconds 10

Resultierende Konfiguration

{
  "runtime": {
    "health": {
      "cache-ttl-seconds": 10
    }
  }
}

--runtime.health.max-query-parallelism

Maximale Anzahl gleichzeitiger Integritätsprüfungsabfragen. Der Standardwert ist 4. Werte werden an den unterstützten Bereich von 1 Durchlauf 8geklemmt.

Example

dab configure \
  --runtime.health.max-query-parallelism 6

Resultierende Konfiguration

{
  "runtime": {
    "health": {
      "max-query-parallelism": 6
    }
  }
}

--runtime.health.roles

Rollen, die umfassende Integritätsergebnisse anzeigen dürfen. Konfigurieren Sie im Produktionsmodus mindestens eine Rolle.

Example

dab configure \
  --runtime.health.roles admin support

Resultierende Konfiguration

{
  "runtime": {
    "health": {
      "roles": [ "admin", "support" ]
    }
  }
}

--azure-key-vault.endpoint

Konfigurieren Sie die Azure Key Vault-Endpunkt-URL.

Example

dab configure \
  --azure-key-vault.endpoint https://my-vault.vault.azure.net

Resultierende Konfiguration

{
  "azure-key-vault": {
    "endpoint": "https://my-vault.vault.azure.net"
  }
}

--azure-key-vault.retry-policy.mode

Konfigurieren Sie den Wiederholungsrichtlinienmodus.

Zulässige Werte:

  • fixed
  • exponential

Example

dab configure \
  --azure-key-vault.retry-policy.mode fixed

Resultierende Konfiguration

{
  "azure-key-vault": {
    "retry-policy": {
      "mode": "fixed"
    }
  }
}

--azure-key-vault.retry-policy.max-count

Konfigurieren Sie die maximale Anzahl von Wiederholungsversuchen.

Example

dab configure \
  --azure-key-vault.retry-policy.max-count 5

Resultierende Konfiguration

{
  "azure-key-vault": {
    "retry-policy": {
      "max-count": 5
    }
  }
}

--azure-key-vault.retry-policy.delay-seconds

Konfigurieren Sie die anfängliche Verzögerung zwischen Wiederholungen in Sekunden.

Example

dab configure \
  --azure-key-vault.retry-policy.delay-seconds 2

Resultierende Konfiguration

{
  "azure-key-vault": {
    "retry-policy": {
      "delay-seconds": 2
    }
  }
}

--azure-key-vault.retry-policy.max-delay-seconds

Konfigurieren Sie die maximale Verzögerung zwischen Wiederholungen in Sekunden (für den exponentiellen Modus).

Example

dab configure \
  --azure-key-vault.retry-policy.max-delay-seconds 30

Resultierende Konfiguration

{
  "azure-key-vault": {
    "retry-policy": {
      "max-delay-seconds": 30
    }
  }
}

--azure-key-vault.retry-policy.network-timeout-seconds

Konfigurieren Sie das Netzwerktimeout für Anforderungen in Sekunden.

Example

dab configure \
  --azure-key-vault.retry-policy.network-timeout-seconds 20

Resultierende Konfiguration

{
  "azure-key-vault": {
    "retry-policy": {
      "mode": "fixed",
      "max-count": 5,
      "delay-seconds": 2,
      "max-delay-seconds": 30,
      "network-timeout-seconds": 20
    }
  }
}

--runtime.telemetry.log-level

Konfigurieren Sie die Ausführlichkeit der Protokollierung nach Namespace. Wird default für die globale Fallbackebene verwendet, oder geben Sie einen Namespace- oder Klassennamen nach --runtime.telemetry.log-level..

Zulässige Werte: Trace, , Debug, Information, WarningError, , . CriticalNone

Example

dab configure \
  --runtime.telemetry.log-level.default Warning \
  --runtime.telemetry.log-level.Azure.DataApiBuilder.Core Information

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "warning",
        "Azure.DataApiBuilder.Core": "information"
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.enabled

Aktivieren oder deaktivieren Sie Azure Log Analytics.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.enabled true

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "enabled": true
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.dab-identifier

Konfigurieren Sie eine IN Azure Log Analytics verwendete DAB-Bezeichnerzeichenfolge.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.dab-identifier MyDab

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "dab-identifier": "MyDab"
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.flush-interval-seconds

Konfigurieren Sie das Leerintervall in Sekunden für Azure Log Analytics.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.flush-interval-seconds 10

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "flush-interval-seconds": 10
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.custom-table-name

Konfigurieren des benutzerdefinierten Tabellennamens für Azure Log Analytics.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.custom-table-name MyDabLogs

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "auth": {
          "custom-table-name": "MyDabLogs"
        }
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id

Konfigurieren Sie DCR unveränderliche ID für Azure Log Analytics.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id dcr-123

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "auth": {
          "dcr-immutable-id": "dcr-123"
        }
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.dce-endpoint

Konfigurieren sie den DCE-Endpunkt für Azure Log Analytics.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.dce-endpoint https://example.eastus-1.ingest.monitor.azure.com

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "enabled": true,
        "auth": {
          "custom-table-name": "MyDabLogs",
          "dcr-immutable-id": "dcr-123",
          "dce-endpoint": "https://example.eastus-1.ingest.monitor.azure.com"
        },
        "dab-identifier": "MyDab",
        "flush-interval-seconds": 10
      }
    }
  }
}

--runtime.telemetry.file.enabled

Aktivieren oder deaktivieren Sie die Dateisenkenprotokollierung.

Example

dab configure \
  --runtime.telemetry.file.enabled true

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "file": {
        "enabled": true
      }
    }
  }
}

--runtime.telemetry.file.path

Konfigurieren Sie den Pfad für die Dateisenkenprotokollierung.

Example

dab configure \
  --runtime.telemetry.file.path C:\\logs\\dab-log.txt

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "file": {
        "path": "C:\\logs\\dab-log.txt"
      }
    }
  }
}

--runtime.telemetry.file.rolling-interval

Konfigurieren Sie das Rollintervall für die Dateisenkenprotokollierung.

Zulässige Werte:

  • Minute
  • Hour
  • Day
  • Month
  • Year
  • Infinite

Example

dab configure \
  --runtime.telemetry.file.rolling-interval Month

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "file": {
        "rolling-interval": "Month"
      }
    }
  }
}

--runtime.telemetry.file.retained-file-count-limit

Maximale Anzahl aufbewahrter Dateien konfigurieren.

Example

dab configure \
  --runtime.telemetry.file.retained-file-count-limit 5

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "file": {
        "retained-file-count-limit": 5
      }
    }
  }
}

--runtime.telemetry.file.file-size-limit-bytes

Maximale Dateigrößenbeschränkung in Bytes konfigurieren.

Example

dab configure \
  --runtime.telemetry.file.file-size-limit-bytes 2097152

Resultierende Konfiguration

{
  "runtime": {
    "telemetry": {
      "file": {
        "enabled": true,
        "path": "C:\\logs\\dab-log.txt",
        "rolling-interval": "Month",
        "retained-file-count-limit": 5,
        "file-size-limit-bytes": 2097152
      }
    }
  }
}

--show-effective-permissions

Zeigt die aufgelösten Berechtigungen für jede Entität an, nachdem die Rollenvererbung angewendet wurde. Verwenden Sie diese Option, um zu sehen, was jede Rolle tatsächlich tun kann, ohne die Konfiguration manuell zu überarbeiten.

Hinweis

Die in diesem Abschnitt beschriebene Funktionalität des Daten-API-Generators 2.0 befindet sich derzeit in der Vorschau und kann sich vor der allgemeinen Verfügbarkeit ändern. Weitere Informationen finden Sie unter Neuigkeiten in Version 2.0.

Example

dab configure \
  --show-effective-permissions

dab configure \
  --show-effective-permissions --config my-config.json

dab configure ^
  --show-effective-permissions --config my-config.json

Beispielausgabe

Entity: Book
	Role: anonymous        | Actions: Read
	Role: authenticated    | Actions: Read (inherited from: anonymous)
	Unconfigured roles inherit from: anonymous

Entity: Order
	Role: admin            | Actions: Create, Read, Update, Delete
	Role: anonymous        | Actions: Read
	Role: authenticated    | Actions: Read (inherited from: anonymous)
	Unconfigured roles inherit from: authenticated
  • Last updated on