configure příkaz

Nakonfigurujte vlastnosti modulu runtime a zdroje dat, které nejsou specifické pro entitu v existujícím konfiguračním souboru tvůrce rozhraní Data API. Nezadané možnosti ponechá existující hodnoty beze změny. Pokud je některá z uvedených možností neplatná, celá aktualizace selže (vše nebo nic).

Zkratky používané v tomto odkazu: Model Context Protocol (MCP), jazyk pro manipulaci s daty (DML), doba života (TTL), webový token JSON (JWT), release candidate (RC), pravidlo shromažďování dat (DCR) a koncový bod shromažďování dat (DCE).

Poznámka:

Tento příkaz nezmění entities oddíl. Slouží dab update ke změnám entit.

Syntaxe

dab configure [options]

Důležité

Nastavení OpenTelemetry a Application Insights se konfigurují s dab add-telemetry, nikoli dab configure. Viz koncept/monitor/open-telemetry.md a concept/monitor/application-insights.md.

Rychlý přehled

Možnost Shrnutí
-c, --config Cesta ke konfiguračnímu souboru (výchozí dab-config.json).

Oddíl zdroje dat

Možnost Shrnutí
--data-source.database-type Nastavte typ databáze.
--data-source.connection-string Nastavte připojovací řetězec databáze.
--data-source.options.database Název databáze pro Cosmos DB for NoSql
--data-source.options.container Název kontejneru pro Cosmos DB for NoSql
--data-source.options.schema Cesta schématu pro Cosmos DB for NoSql
--data-source.options.set-session-context Povolte nebo zakažte kontext relace. Výchozí hodnota: false.
--data-source.health.enabled Povolte nebo zakažte kontrolu stavu zdroje dat.
--data-source.health.name Identifikátor zdroje dat v sestavě kontroly stavu
--data-source.health.threshold-ms Prahová hodnota dotazu kontroly stavu v milisekundách
--data-source.user-delegated-auth.enabled Povolte ověřování delegované uživatelem OBO.
--data-source.user-delegated-auth.provider Nastavte zprostředkovatele identity OBO.
--data-source.user-delegated-auth.database-audience Cílová cílová skupina pro podřízený token SQL
--data-source-files Odkazovat na další konfigurační soubory zdroje dat.

Část GraphQL

Možnost Shrnutí
--runtime.graphql.depth-limit Omezte maximální hloubku dotazu.
--runtime.graphql.enabled Povolení nebo zakázání koncového bodu GraphQL
--runtime.graphql.path Přizpůsobte cestu ke koncovému bodu GraphQL.
--runtime.graphql.allow-introspection Povolit nebo odepřít introspekci GraphQL
--runtime.graphql.multiple-mutations.create.enabled Povolte vícenásobné vytvoření mutací.

Oddíl REST

Možnost Shrnutí
--runtime.rest.enabled Povolte nebo zakažte koncový bod REST.
--runtime.rest.path Přizpůsobte cestu ke koncovému bodu REST.
--runtime.rest.request-body-strict Vynucujte přísné ověření textu požadavku REST.

Oddíl stránkování

Možnost Shrnutí
--runtime.pagination.max-page-size Maximální velikost stránky pro stránkované výsledky
--runtime.pagination.default-page-size Výchozí velikost stránky pro stránkované výsledky
--runtime.pagination.next-link-relative Použijte relativní adresy URL v dalších odkazech stránkování REST.

Oddíl MCP

Možnost Shrnutí
--runtime.mcp.enabled Povolení nebo zakázání koncového bodu MCP
--runtime.mcp.path Přizpůsobte cestu ke koncovému bodu MCP.
--runtime.mcp.description Nastavte popis serveru MCP.
--runtime.mcp.dml-tools Povolte nebo zakažte všechny nástroje MCP DML.
--runtime.mcp.dml-tools.describe-entities Povolte nebo zakažte nástroj describe-entities.
--runtime.mcp.dml-tools.create-record Povolte nebo zakažte nástroj pro vytvoření záznamu.
--runtime.mcp.dml-tools.read-records Povolte nebo zakažte nástroj pro čtení záznamů.
--runtime.mcp.dml-tools.update-record Povolte nebo zakažte nástroj pro záznam aktualizací.
--runtime.mcp.dml-tools.delete-record Povolte nebo zakažte nástroj pro odstranění záznamu.
--runtime.mcp.dml-tools.execute-entity Povolte nebo zakažte nástroj execute-entity.
--runtime.mcp.dml-tools.aggregate-records Povolte nebo zakažte nástroj agregačních záznamů.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Časový limit spuštění v sekundách pro agregované záznamy

Oddíl Mezipaměti

Možnost Shrnutí
--runtime.cache.enabled Povolte nebo zakažte globální mezipaměť.
--runtime.cache.ttl-seconds Hodnota TTL globální mezipaměti v sekundách
--runtime.compression.level Nastavte úroveň komprese odpovědí HTTP.

Oddíl hostitelů

Možnost Shrnutí
--runtime.host.mode Nastavit režim hostitele: Vývoj nebo Výroba.
--runtime.host.max-response-size-mb Maximální velikost odpovědi v megabajtech
--runtime.host.cors.origins Povolené zdroje CORS.
--runtime.host.cors.allow-credentials Nastavte CORS pro povolení přihlašovacích údajů.
--runtime.host.authentication.provider Zprostředkovatel ověřování.
--runtime.host.authentication.jwt.audience Deklarace cílové skupiny JWT.
--runtime.host.authentication.jwt.issuer Deklarace identity vystavitele JWT

Oddíl Stav

Možnost Shrnutí
--runtime.health.enabled Povolte nebo zakažte globální koncový bod stavu.
--runtime.health.cache-ttl-seconds Hodnota TTL mezipaměti pro sestavy kontroly stavu
--runtime.health.max-query-parallelism Maximální počet souběžných dotazů na kontrolu stavu
--runtime.health.roles Role mají povoleno zobrazit komplexní výsledky stavu.

Efektivní oprávnění

Možnost Shrnutí
--show-effective-permissions Zobrazení vyřešených oprávnění pro všechny entity

Oddíl služby Key Vault

Možnost Shrnutí
--azure-key-vault.endpoint Základní koncový bod služby Azure Key Vault
--azure-key-vault.retry-policy.mode Opakujte režim zásad.
--azure-key-vault.retry-policy.max-count Maximální počet pokusů o opakování
--azure-key-vault.retry-policy.delay-seconds Zpoždění mezi opakovanými pokusy.
--azure-key-vault.retry-policy.max-delay-seconds Maximální zpoždění exponenciálních opakování.
--azure-key-vault.retry-policy.network-timeout-seconds Časový limit pro síťová volání vypršel.

Oddíl Telemetrie

Možnost Shrnutí
--runtime.telemetry.log-level Nakonfigurujte úroveň podrobností protokolování podle oboru názvů.
--runtime.telemetry.azure-log-analytics.enabled Povolte telemetrii Azure Log Analytics.
--runtime.telemetry.azure-log-analytics.dab-identifier Rozlišovat původ protokolu.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Vyprázdnění tempa v sekundách.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Název vlastní tabulky
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id ID pravidla shromažďování dat.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Koncový bod shromažďování dat.
--runtime.telemetry.file.enabled Povolte telemetrii jímky souborů.
--runtime.telemetry.file.path Cesta k souboru protokolu
--runtime.telemetry.file.rolling-interval Klouzavý interval.
--runtime.telemetry.file.retained-file-count-limit Maximální počet uchovávaných souborů.
--runtime.telemetry.file.file-size-limit-bytes Maximální velikost souboru před vrácením.

-c, --config

Cesta ke konfiguračnímu souboru. Výchozí hodnota je dab-config.json , pokud dab-config.<DAB_ENVIRONMENT>.json neexistuje, kde DAB_ENVIRONMENT je proměnná prostředí.

Example

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

--data-source.database-type

Typ databáze.

Povolené hodnoty:

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

Example

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

Výsledná konfigurace

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

--data-source.connection-string

Připojovací řetězec pro zdroj dat.

Example

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

Výsledná konfigurace

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

--data-source-files

Odkazovat na další konfigurační soubory zdroje dat z kořenového konfiguračního souboru.

Example

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

Výsledná konfigurace

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

--data-source.options.database

Název databáze pro Cosmos DB for NoSql

Example

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

Výsledná konfigurace

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

--data-source.options.container

Název kontejneru pro Cosmos DB for NoSql

Example

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

Výsledná konfigurace

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

--data-source.options.schema

Cesta schématu pro Cosmos DB for NoSql

Example

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

Výsledná konfigurace

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

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

Povolte kontext relace.

Povolené hodnoty:

  • true
  • false (výchozí)

Example

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

Výsledná konfigurace

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

--data-source.health.enabled

Povolte nebo zakažte kontrolu stavu zdroje dat. Výchozí hodnota je true.

Example

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

Výsledná konfigurace

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

--data-source.health.name

Identifikátor zdroje dat v sestavě kontroly stavu

Example

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

Výsledná konfigurace

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

--data-source.health.threshold-ms

Maximální doba trvání v milisekundách dotazu na kontrolu stavu zdroje dat Výchozí hodnota je 1000.

Example

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

Výsledná konfigurace

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

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

Povolte nebo zakažte ověřování delegované uživatelemBehalf-Of (OBO). Podporováno pouze pro mssql zdroje dat.

Poznámka:

Funkce Tvůrce rozhraní Data API popsaná v této části je k dispozici ve verzi 2.0 a novější. Další informace najdete v tématu Co je nového ve verzi 2.0.

Example

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

Výsledná konfigurace

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

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

Nastavte zprostředkovatele identity pro ověřování delegované uživatelemBehalf-Of (OBO). V současné době se podporuje pouze EntraId .

Poznámka:

Funkce Tvůrce rozhraní Data API popsaná v této části je k dispozici ve verzi 2.0 a novější. Další informace najdete v tématu Co je nového ve verzi 2.0.

Example

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

Výsledná konfigurace

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

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

Nastavte cílovou skupinu pro podřízený token SQL, když je povolený objekt OBO.

Example

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

Výsledná konfigurace

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

--runtime.graphql.depth-limit

Maximální povolená hloubka vnořeného dotazu

Povolené hodnoty:

  • $(0 2147483647]$ (včetně)
  • -1 odebrání limitu

Example

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

Výsledná konfigurace

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

--runtime.graphql.enabled

Povolte koncový bod GraphQL jazyka DAB.

Example

dab configure \
  --runtime.graphql.enabled false

Výsledná konfigurace

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

--runtime.graphql.path

Přizpůsobte cestu koncového bodu GraphQL jazyka DAB. Cesta předpony s /.

Example

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

Výsledná konfigurace

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

--runtime.graphql.allow-introspection

Povolit nebo odepřít požadavky introspekce GraphQL

Example

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

Výsledná konfigurace

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

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

Povolte nebo zakažte operace vytváření vícenásobných mutací ve vygenerovaném schématu GraphQL.

Example

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

Výsledná konfigurace

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

--runtime.rest.enabled

Povolte koncový bod REST DAB.

Example

dab configure \
  --runtime.rest.enabled false

Výsledná konfigurace

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

--runtime.rest.path

Přizpůsobte cestu koncového bodu REST jazyka DAB. Cesta předpony s /.

Example

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

Výsledná konfigurace

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

--runtime.rest.request-body-strict

Zakažte nadbytečná pole textu požadavku REST.

Example

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

Výsledná konfigurace

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

--runtime.pagination.max-page-size

Maximální velikost stránky pro stránkované výsledky Výchozí hodnota je 100000. Minimum je 1.

Example

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

Výsledná konfigurace

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

--runtime.pagination.default-page-size

Výchozí velikost stránky pro stránkované výsledky Výchozí hodnota je 100. Minimum je 1.

Example

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

Výsledná konfigurace

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

--runtime.pagination.next-link-relative

V hodnotách stránkování nextLink REST používejte relativní adresy URL místo absolutních adres URL. Výchozí hodnota je false.

Example

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

Výsledná konfigurace

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

--runtime.mcp.enabled

Povolte koncový bod MCP DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

dab configure \
  --runtime.mcp.enabled false

Výsledná konfigurace

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

--runtime.mcp.path

Přizpůsobte cestu ke koncovému bodu MCP DAB. Cesta předpony s /.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

--runtime.mcp.description

Nastavte popis serveru MCP, který se má zobrazit v inicializované odpovědi.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

--runtime.mcp.dml-tools

Povolte koncový bod nástrojů DAB MCP DML.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Další informace o nástrojích MCP DML naleznete v tématu SQL MCP Server nástroje jazyka pro manipulaci s daty.

Example

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

Výsledná konfigurace

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

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

Povolte nástroj MCP DAB s popisem entit.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj pro vytvoření záznamu v JAZYCE DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj pro čtení záznamu MCP v JAZYCE DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj pro aktualizaci záznamů MCP v JAZYCE DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj pro odstranění záznamu MCP v JAZYCE DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj pro spuštění entity v JAZYCE DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Povolte nástroj PRO AGregační záznamy DAB.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

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

Nastavte časový limit provádění v sekundách pro nástroj MCP agregovaných záznamů.

Výchozí hodnota: 30. Rozsah: 1–600.

Poznámka:

Tato možnost je dostupná v rozhraní příkazového řádku data API 2.0 a novějším. Nainstalujte nejnovější stabilní rozhraní příkazového řádku pomocí dotnet tool install microsoft.dataapibuilderrozhraní příkazového řádku .

Example

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

Výsledná konfigurace

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

--runtime.cache.enabled

Povolte globální mezipaměť DAB. Pro každou entitu musíte také povolit ukládání do mezipaměti.

Example

dab configure \
  --runtime.cache.enabled true

Výsledná konfigurace

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

--runtime.cache.ttl-seconds

Přizpůsobte globální výchozí čas mezipaměti DAB tak, aby se v sekundách prožil.

Example

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

Výsledná konfigurace

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

--runtime.compression.level

Poznámka:

Funkce Tvůrce rozhraní Data API popsaná v této části je k dispozici ve verzi 2.0 a novější. Další informace najdete v tématu Co je nového ve verzi 2.0.

Nastavte úroveň komprese odpovědí HTTP.

Povolené hodnoty:

  • optimal– vyrovnává poměr komprese a rychlost (výchozí)
  • fastest– určuje prioritu rychlosti komprese oproti poměru.
  • none– zakáže kompresi.

Example

dab configure \
  --runtime.compression.level optimal

Výsledná konfigurace

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

--runtime.host.mode

Nastavte režim spuštění hostitele jazyka DAB.

Povolené hodnoty:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Výsledná konfigurace

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

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

Maximální velikost v megabajtech pro odpověď databáze v jednom výsledku. Výchozí hodnota je 158.

Example

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

Výsledná konfigurace

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

--runtime.host.cors.origins

Přepsat povolené původy v CORS. Zadejte hodnoty jako seznam oddělený mezerami.

Example

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

Výsledná konfigurace

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

--runtime.host.cors.allow-credentials

Nastavte hodnotu záhlaví Access-Control-Allow-Credentials .

Example

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

Výsledná konfigurace

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

--runtime.host.authentication.provider

Nakonfigurujte název zprostředkovatele ověřování.

Example

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

Výsledná konfigurace

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

--runtime.host.authentication.jwt.audience

Nakonfigurujte jednoho nebo více zamýšlených příjemců tokenu JWT.

Example

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

Výsledná konfigurace

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

--runtime.host.authentication.jwt.issuer

Nakonfigurujte entitu, která vydala token JWT.

Example

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

Výsledná konfigurace

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

--runtime.health.enabled

Povolte nebo zakažte globální koncový bod stavu. Výchozí hodnota je true.

Example

dab configure \
  --runtime.health.enabled true

Výsledná konfigurace

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

--runtime.health.cache-ttl-seconds

Doba života v sekundách pro sestavy kontroly stavu uložená v mezipaměti Výchozí hodnota je 5. Minimum je 0.

Example

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

Výsledná konfigurace

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

--runtime.health.max-query-parallelism

Maximální počet souběžných dotazů na kontrolu stavu Výchozí hodnota je 4. Hodnoty jsou uchycené na podporovaný rozsah 1 průchozí 8.

Example

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

Výsledná konfigurace

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

--runtime.health.roles

Role mají povoleno zobrazit komplexní výsledky stavu. V produkčním režimu nakonfigurujte aspoň jednu roli.

Example

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

Výsledná konfigurace

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

--azure-key-vault.endpoint

Nakonfigurujte adresu URL koncového bodu služby Azure Key Vault.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte režim zásad opakování.

Povolené hodnoty:

  • fixed
  • exponential

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte maximální počet pokusů o opakování.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte počáteční prodlevu mezi opakovanými pokusy v sekundách.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte maximální prodlevu mezi opakovanými pokusy v sekundách (pro exponenciální režim).

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte časový limit sítě pro požadavky v sekundách.

Example

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

Výsledná konfigurace

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

Nakonfigurujte úroveň podrobností protokolování podle oboru názvů. Slouží default pro globální úroveň náhradní lokality nebo zadejte obor názvů nebo název třídy za --runtime.telemetry.log-level..

Povolené hodnoty: Trace, Debug, Information, Warning, Error, Critical, , None.

Example

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

Výsledná konfigurace

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

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

Povolte nebo zakažte Azure Log Analytics.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte řetězec identifikátoru DAB používaný ve službě Azure Log Analytics.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte interval v sekundách pro Azure Log Analytics.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte vlastní název tabulky pro Azure Log Analytics.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte neměnné ID DCR pro Azure Log Analytics.

Example

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

Výsledná konfigurace

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

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

Konfigurace koncového bodu DCE pro Azure Log Analytics

Example

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

Výsledná konfigurace

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

Povolte nebo zakažte protokolování jímky souborů.

Example

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

Výsledná konfigurace

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

--runtime.telemetry.file.path

Nakonfigurujte cestu pro protokolování jímky souborů.

Example

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

Výsledná konfigurace

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

--runtime.telemetry.file.rolling-interval

Nakonfigurujte klouzavý interval pro protokolování jímky souborů.

Povolené hodnoty:

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

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte maximální počet uchovávaných souborů.

Example

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

Výsledná konfigurace

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

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

Nakonfigurujte maximální limit velikosti souboru v bajtech.

Example

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

Výsledná konfigurace

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

Po použití dědičnosti rolí zobrazte vyřešená oprávnění pro každou entitu. Tuto možnost použijte, pokud chcete zjistit, co jednotlivé role ve skutečnosti mohou dělat bez nutnosti ručního zdůvodnění konfigurace.

Poznámka:

Funkce Tvůrce rozhraní Data API popsaná v této části je k dispozici ve verzi 2.0 a novější. Další informace najdete v tématu Co je nového ve verzi 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

Příklad výstupu

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