configure kommando`

Konfigurera körnings- och datakällans egenskaper som inte är entitetsspecifika i en befintlig konfigurationsfil för Data API Builder. Ospecificerade alternativ lämnar befintliga värden oförändrade. Om ett angivet alternativ är ogiltigt misslyckas hela uppdateringen (allt eller inget).

Förkortningar som används i den här referensen: Model Context Protocol (MCP), datamanipuleringsspråk (DML), time to live (TTL), JSON Web Token (JWT), versionskandidat (RC), datainsamlingsregel (DCR) och datainsamlingsslutpunkt (DCE).

Anmärkning

Det här kommandot ändrar inte avsnittet entities . Används dab update för entitetsändringar.

Syntax

dab configure [options]

Viktigt!

OpenTelemetry- och Application Insights-inställningar konfigureras med dab add-telemetry, inte dab configure. Se concept/monitor/open-telemetry.md and concept/monitor/application-insights.md.

Snabbblick

Option Sammanfattning
-c, --config Sökväg till konfigurationsfilen (standard dab-config.json).

Avsnittet Datakälla

Option Sammanfattning
--data-source.database-type Ange databastyp.
--data-source.connection-string Ange databasanslutningssträngen.
--data-source.options.database Databasnamn för Cosmos DB för NoSql.
--data-source.options.container Containernamn för Cosmos DB för NoSql.
--data-source.options.schema Schemasökväg för Cosmos DB för NoSql.
--data-source.options.set-session-context Aktivera sessionskontext.
--data-source.health.name Identifierare för datakälla i hälsokontrollrapporten.
--data-source.user-delegated-auth.enabled Aktivera användardelegering av OBO-autentisering.
--data-source.user-delegated-auth.database-audience Målgrupp för den underordnade SQL-token.

GraphQL-avsnitt

Option Sammanfattning
--runtime.graphql.depth-limit Begränsa maximalt frågedjup.
--runtime.graphql.enabled Aktivera eller inaktivera GraphQL-slutpunkt.
--runtime.graphql.path Anpassa GraphQL-slutpunktssökvägen.
--runtime.graphql.allow-introspection Tillåt eller neka GraphQL-introspektion.
--runtime.graphql.multiple-mutations.create.enabled Aktivera mutationer med flera skapande.

REST-avsnitt

Option Sammanfattning
--runtime.rest.enabled Aktivera eller inaktivera REST-slutpunkt.
--runtime.rest.path Anpassa REST-slutpunktssökvägen.
--runtime.rest.request-body-strict Framtvinga strikt validering av REST-begärandetext.

MCP-avsnitt

Option Sammanfattning
--runtime.mcp.enabled Aktivera eller inaktivera MCP-slutpunkt.
--runtime.mcp.path Anpassa MCP-slutpunktssökvägen.
--runtime.mcp.description Ange MCP-serverbeskrivningen.
--runtime.mcp.dml-tools Aktivera eller inaktivera alla MCP DML-verktyg.
--runtime.mcp.dml-tools.describe-entities Aktivera eller inaktivera verktyget describe-entities.
--runtime.mcp.dml-tools.create-record Aktivera eller inaktivera verktyget create-record.
--runtime.mcp.dml-tools.read-records Aktivera eller inaktivera verktyget read-records.
--runtime.mcp.dml-tools.update-record Aktivera eller inaktivera uppdateringspostverktyget.
--runtime.mcp.dml-tools.delete-record Aktivera eller inaktivera verktyget delete-record.
--runtime.mcp.dml-tools.execute-entity Aktivera eller inaktivera verktyget execute-entity.
--runtime.mcp.dml-tools.aggregate-records.enabled Aktivera eller inaktivera verktyget för aggregeringsposter.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Tidsgräns för körning i sekunder för aggregerade poster.

Cacheavsnitt

Option Sammanfattning
--runtime.cache.enabled Aktivera eller inaktivera global cache.
--runtime.cache.ttl-seconds Global cache-TTL i sekunder.
--runtime.compression.level Ange HTTP-svarskomprimeringsnivå.

Värdavsnitt

Option Sammanfattning
--runtime.host.mode Ange värdläge: Utveckling eller produktion.
--runtime.host.cors.origins Tillåtna CORS-ursprung.
--runtime.host.cors.allow-credentials Ange CORS-tillåtna autentiseringsuppgifter.
--runtime.host.authentication.provider Autentiseringsprovider.
--runtime.host.authentication.jwt.audience JWT-målgruppsanspråk.
--runtime.host.authentication.jwt.issuer JWT-utfärdaranspråk.

Gällande behörigheter

Option Sammanfattning
--show-effective-permissions Visa lösta behörigheter för alla entiteter.

Key Vault-avsnitt

Option Sammanfattning
--azure-key-vault.endpoint Azure Key Vault-basslutpunkt.
--azure-key-vault.retry-policy.mode Försök med principläge igen.
--azure-key-vault.retry-policy.max-count Maximalt antal återförsök.
--azure-key-vault.retry-policy.delay-seconds Fördröjning mellan återförsök.
--azure-key-vault.retry-policy.max-delay-seconds Maximal fördröjning för exponentiella återförsök.
--azure-key-vault.retry-policy.network-timeout-seconds Tidsgräns för nätverkssamtal.

Avsnittet Telemetri

Option Sammanfattning
--runtime.telemetry.azure-log-analytics.enabled Aktivera Azure Log Analytics-telemetri.
--runtime.telemetry.azure-log-analytics.dab-identifier Särskilja loggens ursprung.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Spola kadens i sekunder.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Anpassat tabellnamn.
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id Regel-ID för datainsamling.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Slutpunkt för datainsamling.
--runtime.telemetry.file.enabled Aktivera telemetri för filmottagare.
--runtime.telemetry.file.path Sökväg till loggfilen.
--runtime.telemetry.file.rolling-interval Rullande intervall.
--runtime.telemetry.file.retained-file-count-limit Maximalt antal filer som behålls.
--runtime.telemetry.file.file-size-limit-bytes Maximal storlek per fil innan den rullas.

-c, --config

Sökväg till konfigurationsfilen. Standardvärdet dab-config.json är om det inte dab-config.<DAB_ENVIRONMENT>.json finns, där DAB_ENVIRONMENT är en miljövariabel.

Example

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

--data-source.database-type

Databastyp.

Tillåtna värden:

  • MSSQL
  • PostgreSQL
  • CosmosDB_NoSQL
  • MySQL

Example

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

Resulterande konfiguration

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

--data-source.connection-string

Anslutningssträng för datakällan.

Example

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

Resulterande konfiguration

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

--data-source.options.database

Databasnamn för Cosmos DB för NoSql.

Example

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

Resulterande konfiguration

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

--data-source.options.container

Containernamn för Cosmos DB för NoSql.

Example

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

Resulterande konfiguration

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

--data-source.options.schema

Schemasökväg för Cosmos DB för NoSql.

Example

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

Resulterande konfiguration

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

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

Aktivera sessionskontext.

Tillåtna värden:

  • true (standardinställning)
  • false

Example

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

Resulterande konfiguration

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

--data-source.health.name

Identifierare för datakälla i hälsokontrollrapporten.

Example

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

Resulterande konfiguration

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

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

Aktivera eller inaktivera OBO-användardelad autentisering (On-Behalf-Of). Stöds endast för mssql datakällor.

Anmärkning

Funktionerna i Data API Builder 2.0 som beskrivs i det här avsnittet är för närvarande i förhandsversion och kan komma att ändras före allmän tillgänglighet. Mer information finns i Nyheter i version 2.0.

Example

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

Resulterande konfiguration

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

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

Ange målgruppen för den underordnade SQL-token när OBO är aktiverat.

Example

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

Resulterande konfiguration

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

--runtime.graphql.depth-limit

Maximalt tillåtet djup för den kapslade frågan.

Tillåtna värden:

  • $(0,2147483647]$ (inklusive)
  • -1 för att ta bort gränsen

Example

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

Resulterande konfiguration

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

--runtime.graphql.enabled

Aktivera DAB:s GraphQL-slutpunkt.

Example

dab configure \
  --runtime.graphql.enabled false

Resulterande konfiguration

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

--runtime.graphql.path

Anpassa DAB:s GraphQL-slutpunktssökväg. Prefixsökväg med /.

Example

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

Resulterande konfiguration

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

--runtime.graphql.allow-introspection

Tillåt eller neka GraphQL-introspektionsbegäranden.

Example

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

Resulterande konfiguration

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

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

Aktivera eller inaktivera åtgärder för att skapa flera mutationer i det genererade GraphQL-schemat.

Example

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

Resulterande konfiguration

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

--runtime.rest.enabled

Aktivera DAB:s REST-slutpunkt.

Example

dab configure \
  --runtime.rest.enabled false

Resulterande konfiguration

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

--runtime.rest.path

Anpassa DAB:s REST-slutpunktssökväg. Prefixsökväg med /.

Example

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

Resulterande konfiguration

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

--runtime.rest.request-body-strict

Förhindra överflödiga REST-begärandetextfält.

Example

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

Resulterande konfiguration

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

--runtime.mcp.enabled

Aktivera DAB:s MCP-slutpunkt.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

dab configure \
  --runtime.mcp.enabled false

Resulterande konfiguration

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

--runtime.mcp.path

Anpassa DAB:s MCP-slutpunktssökväg. Prefixsökväg med /.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

--runtime.mcp.description

Ange mcp-serverbeskrivningen som ska exponeras i det initierade svaret.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

--runtime.mcp.dml-tools

Aktivera DAB:s MCP DML-verktygsslutpunkt.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Mer information om MCP DML-verktyg finns i SPRÅKverktyg för SQL MCP Server-datamanipulering.

Example

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

Resulterande konfiguration

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

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

Aktivera VERKTYGET FÖR MCP-beskrivning av entiteter i DAB.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera DAB:s mcp-verktyg för att skapa poster.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera DAB:s läspostverktyg för MCP.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera DAB:s mcp-uppdateringspostverktyg.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera DAB:s verktyg för MCP-borttagningspost.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera ENTitetsverktyget för DAB-körning av MCP.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Aktivera DAB:s verktyg för MCP-aggregeringsposter.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

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

Ange tidsgränsen för körningen i sekunder för mcp-verktyget aggregate-records.

Förvald: 30. Intervall: 1–600.

Anmärkning

Det här alternativet är tillgängligt i 2.0.0-rc CLI. Data API Builder 2.0 är för närvarande i förhandsversion. Installera med dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Resulterande konfiguration

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

--runtime.cache.enabled

Aktivera DAB:s cache globalt. Du måste också aktivera cachelagring för varje entitet.

Example

dab configure \
  --runtime.cache.enabled true

Resulterande konfiguration

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

--runtime.cache.ttl-seconds

Anpassa DAB-cachens globala standardtid till live i sekunder.

Example

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

Resulterande konfiguration

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

--runtime.compression.level

Anmärkning

Funktionerna i Data API Builder 2.0 som beskrivs i det här avsnittet är för närvarande i förhandsversion och kan komma att ändras före allmän tillgänglighet. Mer information finns i Nyheter i version 2.0.

Ange HTTP-svarskomprimeringsnivån.

Tillåtna värden:

  • optimal— balanserar komprimeringsförhållande och hastighet (standard)
  • fastest— prioriterar komprimeringshastighet över förhållande
  • none– inaktiverar komprimering

Example

dab configure \
  --runtime.compression.level optimal

Resulterande konfiguration

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

--runtime.host.mode

Ange värdkörningsläget för DAB.

Tillåtna värden:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Resulterande konfiguration

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

--runtime.host.cors.origins

Skriv över tillåtet ursprung i CORS. Ange värden som en blankstegsavgränsad lista.

Example

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

Resulterande konfiguration

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

--runtime.host.cors.allow-credentials

Ange värdet för Access-Control-Allow-Credentials rubriken.

Example

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

Resulterande konfiguration

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

--runtime.host.authentication.provider

Konfigurera namnet på autentiseringsprovidern.

Example

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

Resulterande konfiguration

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

--runtime.host.authentication.jwt.audience

Konfigurera en eller flera avsedda mottagare av JWT-token.

Example

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

Resulterande konfiguration

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

--runtime.host.authentication.jwt.issuer

Konfigurera entiteten som utfärdade JWT-token.

Example

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

Resulterande konfiguration

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

--azure-key-vault.endpoint

Konfigurera URL:en för Azure Key Vault-slutpunkten.

Example

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

Resulterande konfiguration

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

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

Konfigurera återförsöksprincipläget.

Tillåtna värden:

  • fixed
  • exponential

Example

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

Resulterande konfiguration

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

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

Konfigurera det maximala antalet återförsök.

Example

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

Resulterande konfiguration

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

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

Konfigurera den inledande fördröjningen mellan återförsök i sekunder.

Example

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

Resulterande konfiguration

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

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

Konfigurera den maximala fördröjningen mellan återförsök i sekunder (för exponentiellt läge).

Example

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

Resulterande konfiguration

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

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

Konfigurera tidsgränsen för nätverket för begäranden i sekunder.

Example

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

Resulterande konfiguration

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

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

Aktivera eller inaktivera Azure Log Analytics.

Example

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

Resulterande konfiguration

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

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

Konfigurera en DAB-identifierarsträng som används i Azure Log Analytics.

Example

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

Resulterande konfiguration

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

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

Konfigurera tömningsintervall i sekunder för Azure Log Analytics.

Example

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

Resulterande konfiguration

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

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

Konfigurera anpassat tabellnamn för Azure Log Analytics.

Example

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

Resulterande konfiguration

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

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

Konfigurera DCR oföränderligt ID för Azure Log Analytics.

Example

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

Resulterande konfiguration

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

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

Konfigurera DCE-slutpunkt för Azure Log Analytics.

Example

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

Resulterande 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

Aktivera eller inaktivera loggning av filmottagare.

Example

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

Resulterande konfiguration

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

--runtime.telemetry.file.path

Konfigurera sökvägen för loggning av filmottagare.

Example

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

Resulterande konfiguration

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

--runtime.telemetry.file.rolling-interval

Konfigurera rullande intervall för loggning av filmottagare.

Tillåtna värden:

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

Example

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

Resulterande konfiguration

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

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

Konfigurera maximalt antal kvarhållna filer.

Example

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

Resulterande konfiguration

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

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

Konfigurera maximal filstorleksgräns i byte.

Example

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

Resulterande 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

Visa de lösta behörigheterna för varje entitet efter att rollarv har tillämpats. Använd det här alternativet om du vill se vad varje roll faktiskt kan göra utan att resonera genom konfigurationen manuellt.

Anmärkning

Funktionerna i Data API Builder 2.0 som beskrivs i det här avsnittet är för närvarande i förhandsversion och kan komma att ändras före allmän tillgänglighet. Mer information finns i Nyheter i 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

Exempel på utdata

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