Condividi tramite

configure comando

Configurare le proprietà di runtime e origine dati che non sono specifiche dell'entità in un file di configurazione di Generatore API dati esistente. Le opzioni non specificate lasciano invariati i valori esistenti. Se un'opzione specificata non è valida, l'intero aggiornamento ha esito negativo (tutto o niente).

Acronimi usati in questo riferimento: Model Context Protocol (MCP), data manipulation language (DML), time to live (TTL), JSON Web Token (JWT), release candidate (RC), regola di raccolta dati (DCR) ed endpoint di raccolta dati (DCE).

Annotazioni

Questo comando non modifica la entities sezione. Usare dab update per le modifiche delle entità.

Sintassi

dab configure [options]

Importante

Le impostazioni di OpenTelemetry e Application Insights sono configurate con dab add-telemetry, non dab configure. Vedere concept/monitor/open-telemetry.md e concept/monitor/application-insights.md.

Sguardo rapido

Opzione Riassunto
-c, --config Percorso del file di configurazione (impostazione predefinita dab-config.json).

Sezione Origine dati

Opzione Riassunto
--data-source.database-type Impostare il tipo di database.
--data-source.connection-string Impostare la stringa di connessione del database.
--data-source.options.database Nome del database per Cosmos DB per NoSql.
--data-source.options.container Nome del contenitore per Cosmos DB per NoSql.
--data-source.options.schema Percorso dello schema per Cosmos DB per NoSql.
--data-source.options.set-session-context Abilitare il contesto della sessione.
--data-source.health.name Identificatore per l'origine dati nel report controllo integrità.
--data-source.user-delegated-auth.enabled Abilitare l'autenticazione obo delegata dall'utente.
--data-source.user-delegated-auth.database-audience Destinatari del token SQL downstream.

Sezione GraphQL

Opzione Riassunto
--runtime.graphql.depth-limit Limitare la profondità massima della query.
--runtime.graphql.enabled Abilitare o disabilitare l'endpoint GraphQL.
--runtime.graphql.path Personalizzare il percorso dell'endpoint GraphQL.
--runtime.graphql.allow-introspection Consentire o negare l'introspezione graphQL.
--runtime.graphql.multiple-mutations.create.enabled Abilitare le mutazioni a più creazione.

Sezione REST

Opzione Riassunto
--runtime.rest.enabled Abilitare o disabilitare l'endpoint REST.
--runtime.rest.path Personalizzare il percorso dell'endpoint REST.
--runtime.rest.request-body-strict Applicare la rigorosa convalida del corpo della richiesta REST.

Sezione MCP

Opzione Riassunto
--runtime.mcp.enabled Abilitare o disabilitare l'endpoint MCP.
--runtime.mcp.path Personalizzare il percorso dell'endpoint MCP.
--runtime.mcp.description Impostare la descrizione del server MCP.
--runtime.mcp.dml-tools Abilitare o disabilitare tutti gli strumenti DML MCP.
--runtime.mcp.dml-tools.describe-entities Abilitare o disabilitare lo strumento describe-entities.
--runtime.mcp.dml-tools.create-record Abilitare o disabilitare lo strumento create-record.
--runtime.mcp.dml-tools.read-records Abilitare o disabilitare lo strumento read-records.
--runtime.mcp.dml-tools.update-record Abilitare o disabilitare lo strumento update-record.
--runtime.mcp.dml-tools.delete-record Abilitare o disabilitare lo strumento delete-record.
--runtime.mcp.dml-tools.execute-entity Abilitare o disabilitare lo strumento execute-entity.
--runtime.mcp.dml-tools.aggregate-records.enabled Abilitare o disabilitare lo strumento aggregate-records.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Timeout di esecuzione in secondi per record aggregati.

Sezione Cache

Opzione Riassunto
--runtime.cache.enabled Abilitare o disabilitare la cache globale.
--runtime.cache.ttl-seconds Durata (TTL) della cache globale in secondi.
--runtime.compression.level Impostare il livello di compressione della risposta HTTP.

Sezione Host

Opzione Riassunto
--runtime.host.mode Impostare la modalità host: sviluppo o produzione.
--runtime.host.cors.origins Origini CORS consentite.
--runtime.host.cors.allow-credentials Impostare CORS allow-credentials (Credenziali consentite CORS).
--runtime.host.authentication.provider Provider di autenticazione.
--runtime.host.authentication.jwt.audience Attestazione del gruppo di destinatari JWT.
--runtime.host.authentication.jwt.issuer Attestazione dell'autorità di certificazione JWT.

Autorizzazioni valide

Opzione Riassunto
--show-effective-permissions Visualizzare le autorizzazioni risolte per tutte le entità.

Sezione Key Vault

Opzione Riassunto
--azure-key-vault.endpoint Endpoint di base di Azure Key Vault.
--azure-key-vault.retry-policy.mode Modalità dei criteri di ripetizione dei tentativi.
--azure-key-vault.retry-policy.max-count Numero massimo di tentativi.
--azure-key-vault.retry-policy.delay-seconds Ritardo tra i tentativi.
--azure-key-vault.retry-policy.max-delay-seconds Ritardo massimo per i tentativi esponenziali.
--azure-key-vault.retry-policy.network-timeout-seconds Timeout per le chiamate di rete.

Sezione Telemetria

Opzione Riassunto
--runtime.telemetry.azure-log-analytics.enabled Abilitare i dati di telemetria di Azure Log Analytics.
--runtime.telemetry.azure-log-analytics.dab-identifier Distinguere l'origine del log.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Frequenza di scaricamento in secondi.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Nome tabella personalizzato.
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id ID regola raccolta dati.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Endpoint raccolta dati.
--runtime.telemetry.file.enabled Abilitare la telemetria del sink di file.
--runtime.telemetry.file.path Percorso del file di log.
--runtime.telemetry.file.rolling-interval Intervallo di rotazione.
--runtime.telemetry.file.retained-file-count-limit Numero massimo di file conservati.
--runtime.telemetry.file.file-size-limit-bytes Dimensioni massime per file prima del rollback.

-c, --config

Percorso del file di configurazione. Per impostazione predefinita, a dab-config.json meno che non dab-config.<DAB_ENVIRONMENT>.json esista, dove DAB_ENVIRONMENT è una variabile di ambiente.

Example

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

--data-source.database-type

Tipo di database.

Valori consentiti:

  • MSSQL
  • PostgreSQL
  • CosmosDB_NoSQL
  • MySQL

Example

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

Configurazione risultante

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

--data-source.connection-string

Stringa di connessione per l'origine dati.

Example

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

Configurazione risultante

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

--data-source.options.database

Nome del database per Cosmos DB per NoSql.

Example

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

Configurazione risultante

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

--data-source.options.container

Nome del contenitore per Cosmos DB per NoSql.

Example

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

Configurazione risultante

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

--data-source.options.schema

Percorso dello schema per Cosmos DB per NoSql.

Example

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

Configurazione risultante

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

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

Abilitare il contesto della sessione.

Valori consentiti:

  • true (impostazione predefinita)
  • false

Example

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

Configurazione risultante

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

--data-source.health.name

Identificatore per l'origine dati nel report controllo integrità.

Example

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

Configurazione risultante

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

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

Abilitare o disabilitare l'autenticazione delegata dall'utente on-Behalf-Of (OBO). Supportato solo per le mssql origini dati.

Annotazioni

La funzionalità Generatore API dati 2.0 descritta in questa sezione è attualmente in anteprima e potrebbe cambiare prima della disponibilità generale. Per altre informazioni, vedere Novità della versione 2.0.

Example

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

Configurazione risultante

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

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

Impostare il gruppo di destinatari per il token SQL downstream quando OBO è abilitato.

Example

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

Configurazione risultante

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

--runtime.graphql.depth-limit

Profondità massima consentita della query nidificata.

Valori consentiti:

  • $(0,2147483647]$ (incluso)
  • -1 per rimuovere il limite

Example

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

Configurazione risultante

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

--runtime.graphql.enabled

Abilitare l'endpoint GraphQL di DAB.

Example

dab configure \
  --runtime.graphql.enabled false

Configurazione risultante

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

--runtime.graphql.path

Personalizzare il percorso dell'endpoint GraphQL di DAB. Prefisso percorso con /.

Example

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

Configurazione risultante

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

--runtime.graphql.allow-introspection

Consentire o negare le richieste di introspezione graphQL.

Example

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

Configurazione risultante

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

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

Abilitare o disabilitare le operazioni di creazione di più mutazioni nello schema GraphQL generato.

Example

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

Configurazione risultante

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

--runtime.rest.enabled

Abilitare l'endpoint REST di DAB.

Example

dab configure \
  --runtime.rest.enabled false

Configurazione risultante

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

--runtime.rest.path

Personalizzare il percorso dell'endpoint REST di DAB. Prefisso percorso con /.

Example

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

Configurazione risultante

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

--runtime.rest.request-body-strict

Non consentire campi del corpo della richiesta REST estranei.

Example

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

Configurazione risultante

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

--runtime.mcp.enabled

Abilitare l'endpoint MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

dab configure \
  --runtime.mcp.enabled false

Configurazione risultante

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

--runtime.mcp.path

Personalizzare il percorso dell'endpoint MCP di DAB. Prefisso percorso con /.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

--runtime.mcp.description

Impostare la descrizione del server MCP da esporre nella risposta inizializzata.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

--runtime.mcp.dml-tools

Abilitare l'endpoint degli strumenti MCP DML di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Per altre informazioni sugli strumenti DML MCP, vedere Strumenti del linguaggio di manipolazione dei dati di SQL MCP Server.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento MCP di DAB per descrivere le entità.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento MCP per la creazione di record di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento di lettura record MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento del record di aggiornamento MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento di eliminazione MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento di esecuzione MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Abilitare lo strumento di aggregazione MCP di DAB.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

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

Impostare il timeout di esecuzione in secondi per lo strumento MCP aggregate-records.

Impostazione predefinita: 30. Intervallo: 1-600.

Annotazioni

Questa opzione è disponibile nell'interfaccia della 2.0.0-rc riga di comando. Il generatore di API dati 2.0 è attualmente in anteprima. Eseguire l'installazione con dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

Example

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

Configurazione risultante

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

--runtime.cache.enabled

Abilitare la cache di DAB a livello globale. È anche necessario abilitare la memorizzazione nella cache per ogni entità.

Example

dab configure \
  --runtime.cache.enabled true

Configurazione risultante

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

--runtime.cache.ttl-seconds

Personalizzare il tempo predefinito predefinito globale della cache DAB in secondi.

Example

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

Configurazione risultante

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

--runtime.compression.level

Annotazioni

La funzionalità Generatore API dati 2.0 descritta in questa sezione è attualmente in anteprima e potrebbe cambiare prima della disponibilità generale. Per altre informazioni, vedere Novità della versione 2.0.

Impostare il livello di compressione della risposta HTTP.

Valori consentiti:

  • optimal— bilancia il rapporto di compressione e la velocità (impostazione predefinita)
  • fastest— assegna priorità alla velocità di compressione rispetto al rapporto
  • none— disabilita la compressione

Example

dab configure \
  --runtime.compression.level optimal

Configurazione risultante

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

--runtime.host.mode

Impostare la modalità di esecuzione host di DAB.

Valori consentiti:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Configurazione risultante

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

--runtime.host.cors.origins

Sovrascrivere le origini consentite in CORS. Specificare i valori come elenco delimitato da spazi.

Example

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

Configurazione risultante

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

--runtime.host.cors.allow-credentials

Impostare il valore per l'intestazione Access-Control-Allow-Credentials .

Example

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

Configurazione risultante

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

--runtime.host.authentication.provider

Configurare il nome del provider di autenticazione.

Example

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

Configurazione risultante

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

--runtime.host.authentication.jwt.audience

Configurare uno o più destinatari previsti del token JWT.

Example

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

Configurazione risultante

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

--runtime.host.authentication.jwt.issuer

Configurare l'entità che ha emesso il token JWT.

Example

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

Configurazione risultante

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

--azure-key-vault.endpoint

Configurare l'URL dell'endpoint di Azure Key Vault.

Example

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

Configurazione risultante

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

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

Configurare la modalità dei criteri di ripetizione dei tentativi.

Valori consentiti:

  • fixed
  • exponential

Example

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

Configurazione risultante

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

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

Configurare il numero massimo di tentativi.

Example

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

Configurazione risultante

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

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

Configurare il ritardo iniziale tra tentativi in secondi.

Example

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

Configurazione risultante

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

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

Configurare il ritardo massimo tra i tentativi in secondi (per la modalità esponenziale).

Example

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

Configurazione risultante

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

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

Configurare il timeout di rete per le richieste in secondi.

Example

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

Configurazione risultante

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

Abilitare o disabilitare Azure Log Analytics.

Example

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

Configurazione risultante

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

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

Configurare una stringa di identificatore DAB usata in Azure Log Analytics.

Example

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

Configurazione risultante

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

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

Configurare l'intervallo di scaricamento in secondi per Azure Log Analytics.

Example

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

Configurazione risultante

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

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

Configurare il nome di tabella personalizzato per Azure Log Analytics.

Example

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

Configurazione risultante

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

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

Configurare l'ID non modificabile DCR per Azure Log Analytics.

Example

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

Configurazione risultante

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

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

Configurare l'endpoint DCE per Azure Log Analytics.

Example

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

Configurazione risultante

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

Abilitare o disabilitare la registrazione del sink di file.

Example

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

Configurazione risultante

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

--runtime.telemetry.file.path

Configurare il percorso per la registrazione del sink di file.

Example

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

Configurazione risultante

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

--runtime.telemetry.file.rolling-interval

Configurare l'intervallo di sequenza per la registrazione del sink di file.

Valori consentiti:

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

Example

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

Configurazione risultante

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

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

Configurare il numero massimo di file conservati.

Example

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

Configurazione risultante

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

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

Configurare il limite massimo di dimensioni dei file in byte.

Example

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

Configurazione risultante

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

Visualizzare le autorizzazioni risolte per ogni entità dopo l'applicazione dell'ereditarietà del ruolo. Usare questa opzione per vedere cosa può effettivamente fare ogni ruolo senza ragionare manualmente tramite la configurazione.

Annotazioni

La funzionalità Generatore API dati 2.0 descritta in questa sezione è attualmente in anteprima e potrebbe cambiare prima della disponibilità generale. Per altre informazioni, vedere Novità della versione 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

Output di esempio

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