configure parancs

Konfiguráljon olyan futtatókörnyezeti és adatforrás-tulajdonságokat, amelyek nem entitásspecifikusak egy meglévő Data API Builder-konfigurációs fájlban. A meg nem határozott beállítások változatlanul hagyják a meglévő értékeket. Ha bármelyik megadott beállítás érvénytelen, a teljes frissítés meghiúsul (minden vagy semmi).

A jelen hivatkozásban használt mozaikszavak: Model Context Protocol (MCP), adatmanipulációs nyelv (DML), élettartam (TTL), JSON Web Token (JWT), kiadásjelölt (RC), adatgyűjtési szabály (DCR) és adatgyűjtési végpont (DCE).

Megjegyzés:

Ez a parancs nem módosítja a szakaszt entities . Entitásmódosításokhoz használható dab update .

Szemantika

dab configure [options]

Fontos

Az OpenTelemetry és az Application Insights beállításai a következővel dab add-telemetryvannak konfigurálva: nem dab configure. Lásd : concept/monitor/open-telemetry.md és concept/monitor/application-insights.md.

Gyors áttekintés

Lehetőség Összefoglalás
-c, --config A konfigurációs fájl elérési útja (alapértelmezett dab-config.json).

Adatforrás szakasz

Lehetőség Összefoglalás
--data-source.database-type Adja meg az adatbázis típusát.
--data-source.connection-string Állítsa be az adatbázis kapcsolati sztringét.
--data-source.options.database A Cosmos DB for NoSql adatbázisának neve.
--data-source.options.container A Cosmos DB for NoSql tárolóneve.
--data-source.options.schema A Cosmos DB for NoSql sémaútvonala.
--data-source.options.set-session-context Munkamenet-környezet engedélyezése vagy letiltása. Alapértelmezett: false.
--data-source.health.enabled Engedélyezze vagy tiltsa le az adatforrás állapotellenőrzését.
--data-source.health.name Az állapot-ellenőrzési jelentésben szereplő adatforrás azonosítója.
--data-source.health.threshold-ms Állapot-ellenőrzési lekérdezési küszöbérték ezredmásodpercben.
--data-source.user-delegated-auth.enabled Engedélyezze az OBO felhasználó által delegált hitelesítést.
--data-source.user-delegated-auth.provider Állítsa be az OBO identitásszolgáltatót.
--data-source.user-delegated-auth.database-audience Célközönség az alsóbb rétegbeli SQL-jogkivonathoz.
--data-source-files További adatforráskonfigurációs fájlok hivatkozása.

GraphQL-szakasz

Lehetőség Összefoglalás
--runtime.graphql.depth-limit A lekérdezés maximális mélységének korlátozása.
--runtime.graphql.enabled A GraphQL-végpont engedélyezése vagy letiltása.
--runtime.graphql.path Testre szabhatja a GraphQL-végpont elérési útját.
--runtime.graphql.allow-introspection A GraphQL bevezető szakaszának engedélyezése vagy elutasítása.
--runtime.graphql.multiple-mutations.create.enabled Többszörös létrehozású mutációk engedélyezése.

REST szakasz

Lehetőség Összefoglalás
--runtime.rest.enabled REST-végpont engedélyezése vagy letiltása.
--runtime.rest.path Testre szabhatja a REST-végpont elérési útját.
--runtime.rest.request-body-strict Szigorú REST-kérelemtörzs-ellenőrzés kényszerítése.

Lapozás szakasz

Lehetőség Összefoglalás
--runtime.pagination.max-page-size Lapszámozott találatok maximális oldalmérete.
--runtime.pagination.default-page-size Lapszámozott találatok alapértelmezett oldalmérete.
--runtime.pagination.next-link-relative Használjon relatív URL-címeket a REST-lapozás következő hivatkozásaiban.

MCP-szakasz

Lehetőség Összefoglalás
--runtime.mcp.enabled Az MCP-végpont engedélyezése vagy letiltása.
--runtime.mcp.path Szabja testre az MCP-végpont elérési útját.
--runtime.mcp.description Adja meg az MCP-kiszolgáló leírását.
--runtime.mcp.dml-tools Engedélyezze vagy tiltsa le az összes MCP DML-eszközt.
--runtime.mcp.dml-tools.describe-entities Engedélyezze vagy tiltsa le a leíró entitások eszközt.
--runtime.mcp.dml-tools.create-record Engedélyezze vagy tiltsa le a rekord létrehozása eszközt.
--runtime.mcp.dml-tools.read-records Engedélyezze vagy tiltsa le az olvasási rekordok eszközt.
--runtime.mcp.dml-tools.update-record Engedélyezze vagy tiltsa le a frissítés-rekord eszközt.
--runtime.mcp.dml-tools.delete-record Engedélyezze vagy tiltsa le a törlési rekord eszközt.
--runtime.mcp.dml-tools.execute-entity Engedélyezze vagy tiltsa le az execute-entity eszközt.
--runtime.mcp.dml-tools.aggregate-records Engedélyezze vagy tiltsa le az összesítő rekordok eszközt.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Végrehajtási időtúllépés másodpercekben az összesítő rekordok esetében.

Gyorsítótár szakasz

Lehetőség Összefoglalás
--runtime.cache.enabled Globális gyorsítótár engedélyezése vagy letiltása.
--runtime.cache.ttl-seconds A globális gyorsítótár TTL-je másodpercek alatt.
--runtime.compression.level HTTP-választömörítési szint beállítása.

Gazdagép szakasz

Lehetőség Összefoglalás
--runtime.host.mode Gazdagép mód beállítása: Fejlesztés vagy éles környezet.
--runtime.host.max-response-size-mb Maximális válaszméret megabájtban.
--runtime.host.cors.origins Engedélyezett CORS-források.
--runtime.host.cors.allow-credentials Adja meg a CORS engedélyezési hitelesítő adatait.
--runtime.host.authentication.provider Hitelesítésszolgáltató.
--runtime.host.authentication.jwt.audience JWT-célközönség állítása.
--runtime.host.authentication.jwt.issuer JWT-kiállítói jogcím.

Állapot szakasz

Lehetőség Összefoglalás
--runtime.health.enabled Engedélyezze vagy tiltsa le a globális állapotvégpontot.
--runtime.health.cache-ttl-seconds TTL gyorsítótárazva állapot-ellenőrzési jelentésekhez.
--runtime.health.max-query-parallelism Egyidejű állapot-ellenőrzési lekérdezések maximális száma.
--runtime.health.roles Az átfogó állapoteredmények megtekintésére jogosult szerepkörök.

Hatályos engedélyek

Lehetőség Összefoglalás
--show-effective-permissions Az összes entitás feloldott engedélyeinek megjelenítése.

Key Vault szakasz

Lehetőség Összefoglalás
--azure-key-vault.endpoint Az Azure Key Vault alapvégpontja.
--azure-key-vault.retry-policy.mode Próbálkozzon újra a házirend móddal.
--azure-key-vault.retry-policy.max-count Újrapróbálkozási kísérletek maximális kihasználása.
--azure-key-vault.retry-policy.delay-seconds Késleltetés az újrapróbálkozások között.
--azure-key-vault.retry-policy.max-delay-seconds Exponenciális újrapróbálkozások maximális késleltetése.
--azure-key-vault.retry-policy.network-timeout-seconds Időtúllépés hálózati hívások esetén.

Telemetriai szakasz

Lehetőség Összefoglalás
--runtime.telemetry.log-level A naplózás részletességének konfigurálása névtér szerint.
--runtime.telemetry.azure-log-analytics.enabled Engedélyezze az Azure Log Analytics telemetriáját.
--runtime.telemetry.azure-log-analytics.dab-identifier A napló eredetének megkülönböztetése.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Öblítse ki másodpercek alatt az ütemet.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Egyéni táblanév.
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id Adatgyűjtési szabály azonosítója.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Adatgyűjtési végpont.
--runtime.telemetry.file.enabled Engedélyezze a fájl fogadó telemetriáját.
--runtime.telemetry.file.path A naplófájl elérési útja.
--runtime.telemetry.file.rolling-interval Gördülő intervallum.
--runtime.telemetry.file.retained-file-count-limit Megtartott fájlok maximális száma.
--runtime.telemetry.file.file-size-limit-bytes Fájlonkénti maximális méret a működés előtt.

-c, --config

A konfigurációs fájl elérési útja. Alapértelmezett érték, dab-config.json ha dab-config.<DAB_ENVIRONMENT>.json nem létezik, ahol DAB_ENVIRONMENT környezeti változó van.

Example

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

--data-source.database-type

Adatbázis típusa.

Engedélyezett értékek:

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

Example

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

Eredményként kapott konfiguráció

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

--data-source.connection-string

Az adatforrás kapcsolati sztringje.

Example

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

Eredményként kapott konfiguráció

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

--data-source-files

További adatforráskonfigurációs fájlok hivatkozása a gyökérkonfigurációs fájlból.

Example

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

Eredményként kapott konfiguráció

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

--data-source.options.database

A Cosmos DB for NoSql adatbázisának neve.

Example

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

Eredményként kapott konfiguráció

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

--data-source.options.container

A Cosmos DB for NoSql tárolóneve.

Example

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

Eredményként kapott konfiguráció

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

--data-source.options.schema

A Cosmos DB for NoSql sémaútvonala.

Example

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

Eredményként kapott konfiguráció

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

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

Munkamenet-környezet engedélyezése.

Engedélyezett értékek:

  • true
  • false (alapértelmezett)

Example

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

Eredményként kapott konfiguráció

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

--data-source.health.enabled

Engedélyezze vagy tiltsa le az adatforrás állapot-ellenőrzését. Az alapértelmezett érték true.

Example

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

Eredményként kapott konfiguráció

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

--data-source.health.name

Az állapot-ellenőrzési jelentésben szereplő adatforrás azonosítója.

Example

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

Eredményként kapott konfiguráció

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

--data-source.health.threshold-ms

Az adatforrás állapot-ellenőrző lekérdezésének maximális időtartama ezredmásodpercben. Az alapértelmezett érték 1000.

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze vagy tiltsa le a felhasználó által delegált on-Behalf-Of (OBO) hitelesítést. Csak adatforrások esetén mssql támogatott.

Megjegyzés:

Az ebben a szakaszban ismertetett Data API builder funkció a 2.0-s és újabb verziókban érhető el. További információ: A 2.0-s verzió újdonságai.

Example

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

Eredményként kapott konfiguráció

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

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

Állítsa be a felhasználó által delegált on-Behalf-Of (OBO) hitelesítés identitásszolgáltatóját. Jelenleg csak EntraId támogatott.

Megjegyzés:

Az ebben a szakaszban ismertetett Data API builder funkció a 2.0-s és újabb verziókban érhető el. További információ: A 2.0-s verzió újdonságai.

Example

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

Eredményként kapott konfiguráció

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

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

Állítsa be az alsóbb rétegbeli SQL-jogkivonat célközönségét, ha az OBO engedélyezve van.

Example

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

Eredményként kapott konfiguráció

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

--runtime.graphql.depth-limit

A beágyazott lekérdezés megengedett legnagyobb mélysége.

Engedélyezett értékek:

  • $(0,2147483647]$ (beleértve)
  • -1 a korlát eltávolításához

Example

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

Eredményként kapott konfiguráció

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

--runtime.graphql.enabled

Engedélyezze a DAB GraphQL-végpontját.

Example

dab configure \
  --runtime.graphql.enabled false

Eredményként kapott konfiguráció

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

--runtime.graphql.path

Testre szabhatja a DAB GraphQL-végpont elérési útját. Előtag elérési útja a ./

Example

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

Eredményként kapott konfiguráció

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

--runtime.graphql.allow-introspection

GraphQL-bevezető kérések engedélyezése vagy elutasítása.

Example

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

Eredményként kapott konfiguráció

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

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

Többmutációs létrehozási műveletek engedélyezése vagy letiltása a létrehozott GraphQL-sémában.

Example

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

Eredményként kapott konfiguráció

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

--runtime.rest.enabled

Engedélyezze a DAB REST-végpontját.

Example

dab configure \
  --runtime.rest.enabled false

Eredményként kapott konfiguráció

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

--runtime.rest.path

Szabja testre a DAB REST-végpontjának elérési útját. Előtag elérési útja a ./

Example

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

Eredményként kapott konfiguráció

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

--runtime.rest.request-body-strict

Tiltsa le a felesleges REST-kérés törzsmezőit.

Example

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

Eredményként kapott konfiguráció

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

--runtime.pagination.max-page-size

Lapszámozott találatok maximális oldalmérete. Az alapértelmezett érték 100000. A minimális értéke .1

Example

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

Eredményként kapott konfiguráció

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

--runtime.pagination.default-page-size

Lapszámozott találatok alapértelmezett oldalmérete. Az alapértelmezett érték 100. A minimális értéke .1

Example

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

Eredményként kapott konfiguráció

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

--runtime.pagination.next-link-relative

Használjon relatív URL-címeket abszolút URL-címek helyett a REST lapozási nextLink értékekben. Az alapértelmezett érték false.

Example

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

Eredményként kapott konfiguráció

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

--runtime.mcp.enabled

Engedélyezze a DAB MCP-végpontját.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

dab configure \
  --runtime.mcp.enabled false

Eredményként kapott konfiguráció

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

--runtime.mcp.path

Szabja testre a DAB MCP-végpontjának elérési útját. Előtag elérési útja a ./

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

--runtime.mcp.description

Állítsa be az MCP-kiszolgáló leírását úgy, hogy az az inicializált válaszban legyen közzétéve.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

--runtime.mcp.dml-tools

Engedélyezze a DAB MCP DML-eszközök végpontját.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Az MCP DML-eszközökkel kapcsolatos további információkért lásd az SQL MCP Server adatmanipulációs nyelvi eszközeit.

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP-leíró eszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP rekordeszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP olvasási rekordeszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP frissítési rekordeszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP-törlési rekordeszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP-végrehajtási entitáseszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Engedélyezze a DAB MCP-összesítő rekordeszközét.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

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

Állítsa be a végrehajtási időtúllépést másodpercben az összesítő rekordokat tartalmazó MCP-eszközhöz.

Alapértelmezett: 30. Tartomány: 1–600.

Megjegyzés:

Ez a lehetőség a Data API Builder 2.0 parancssori felületén és újabb verzióiban érhető el. Telepítse a legújabb stabil parancssori felületet a következővel dotnet tool install microsoft.dataapibuilder: .

Example

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

Eredményként kapott konfiguráció

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

--runtime.cache.enabled

Engedélyezze a DAB gyorsítótárát globálisan. Az egyes entitások gyorsítótárazását is engedélyeznie kell.

Example

dab configure \
  --runtime.cache.enabled true

Eredményként kapott konfiguráció

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

--runtime.cache.ttl-seconds

Testre szabhatja a DAB-gyorsítótár globális alapértelmezett idejét másodpercek alatt való élettartamra.

Example

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

Eredményként kapott konfiguráció

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

--runtime.compression.level

Megjegyzés:

Az ebben a szakaszban ismertetett Data API builder funkció a 2.0-s és újabb verziókban érhető el. További információ: A 2.0-s verzió újdonságai.

Állítsa be a HTTP-válasz tömörítési szintjét.

Engedélyezett értékek:

  • optimal— kiegyensúlyja a tömörítési arányt és a sebességet (alapértelmezett)
  • fastest—rangsorolja a tömörítési sebességet az arányhoz viszonyítva
  • none—letiltja a tömörítést

Example

dab configure \
  --runtime.compression.level optimal

Eredményként kapott konfiguráció

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

--runtime.host.mode

Állítsa be a gazdagép DAB-üzemmódját.

Engedélyezett értékek:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Eredményként kapott konfiguráció

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

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

Adatbázis-válasz maximális mérete megabájtban egyetlen eredményben. Az alapértelmezett érték 158.

Example

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

Eredményként kapott konfiguráció

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

--runtime.host.cors.origins

Felülírhatja az engedélyezett forrásokat a CORS-ban. Adjon meg értékeket szóközzel elválasztott listaként.

Example

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

Eredményként kapott konfiguráció

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

--runtime.host.cors.allow-credentials

Állítsa be a fejléc értékét Access-Control-Allow-Credentials .

Example

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

Eredményként kapott konfiguráció

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

--runtime.host.authentication.provider

Konfigurálja a hitelesítésszolgáltató nevét.

Example

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

Eredményként kapott konfiguráció

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

--runtime.host.authentication.jwt.audience

A JWT-jogkivonat egy vagy több címzettjének konfigurálása.

Example

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

Eredményként kapott konfiguráció

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

--runtime.host.authentication.jwt.issuer

Konfigurálja a JWT-jogkivonatot kibocsátó entitást.

Example

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

Eredményként kapott konfiguráció

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

--runtime.health.enabled

Engedélyezze vagy tiltsa le a globális állapotvégpontot. Az alapértelmezett érték true.

Example

dab configure \
  --runtime.health.enabled true

Eredményként kapott konfiguráció

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

--runtime.health.cache-ttl-seconds

A gyorsítótárazott állapot-ellenőrzési jelentések élettartamának másodpercben történő megélése. Az alapértelmezett érték 5. A minimális értéke .0

Example

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

Eredményként kapott konfiguráció

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

--runtime.health.max-query-parallelism

Egyidejű állapot-ellenőrzési lekérdezések maximális száma. Az alapértelmezett érték 4. Az értékek a támogatott tartományhoz 18vannak rögzítve.

Example

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

Eredményként kapott konfiguráció

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

--runtime.health.roles

Az átfogó állapoteredmények megtekintésére jogosult szerepkörök. Éles módban konfiguráljon legalább egy szerepkört.

Example

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

Eredményként kapott konfiguráció

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

--azure-key-vault.endpoint

Konfigurálja az Azure Key Vault végpontJÁNAK URL-címét.

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja az újrapróbálkozási szabályzat módot.

Engedélyezett értékek:

  • fixed
  • exponential

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja az újrapróbálkozási kísérletek maximális számát.

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja az újrapróbálkozások közötti kezdeti késleltetést másodpercben.

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja az újrapróbálkozások közötti maximális késleltetést másodpercben (exponenciális módban).

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja a kérések hálózati időtúllépését másodpercben.

Example

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

Eredményként kapott konfiguráció

{
  "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

A naplózás részletességének konfigurálása névtér szerint. Használja default a globális tartalék szinthez, vagy adjon meg egy névteret vagy osztálynevet utána --runtime.telemetry.log-level..

Engedélyezett értékek: Trace, Debug, Information, Warning, Error, Critical. None

Example

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

Eredményként kapott konfiguráció

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

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

Az Azure Log Analytics engedélyezése vagy letiltása.

Example

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

Eredményként kapott konfiguráció

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

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

Konfiguráljon egy, az Azure Log Analyticsben használt DAB-azonosító sztringet.

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja másodpercben a kiürítési időközt az Azure Log Analyticshez.

Example

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

Eredményként kapott konfiguráció

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

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

Egyéni táblanév konfigurálása az Azure Log Analyticshez.

Example

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

Eredményként kapott konfiguráció

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

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

A DCR nem módosítható azonosítójának konfigurálása az Azure Log Analyticshez.

Example

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

Eredményként kapott konfiguráció

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

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

DCE-végpont konfigurálása az Azure Log Analyticshez.

Example

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

Eredményként kapott konfiguráció

{
  "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

Engedélyezze vagy tiltsa le a fájlelfoglaló naplózását.

Example

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

Eredményként kapott konfiguráció

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

--runtime.telemetry.file.path

Konfigurálja a fájlelfoglaló naplózási útvonalát.

Example

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

Eredményként kapott konfiguráció

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

--runtime.telemetry.file.rolling-interval

Konfigurálja a fájlgyűjtő naplózásának gördülő időközét.

Engedélyezett értékek:

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

Example

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

Eredményként kapott konfiguráció

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

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

A megőrzött fájlok maximális számának konfigurálása.

Example

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

Eredményként kapott konfiguráció

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

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

Konfigurálja a maximális fájlméretkorlátot bájtban.

Example

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

Eredményként kapott konfiguráció

{
  "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

A szerepköröröklés alkalmazása után minden entitás feloldott engedélyeinek megjelenítése. Ezzel a beállítással megtekintheti, hogy az egyes szerepkörök valójában mit tehetnek anélkül, hogy a konfigurációt manuálisan indokolják.

Megjegyzés:

Az ebben a szakaszban ismertetett Data API builder funkció a 2.0-s és újabb verziókban érhető el. További információ: A 2.0-s verzió újdonságai.

Example

dab configure \
  --show-effective-permissions

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

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

Példa kimenet

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