Partilhar via

init comando

Inicialize um novo arquivo de configuração do construtor de API de dados. O JSON resultante captura detalhes da fonte de dados, pontos de extremidade habilitados (REST, GraphQL, MCP), autenticação e comportamentos de tempo de execução.

Sintaxe

dab init [options]

Se o arquivo de configuração de destino já existir, o comando o substituirá. Não há fusão. Use controle de versão ou backups se precisar preservar o arquivo anterior.

Visão rápida

Opção Resumo
-c, --config Nome do arquivo de configuração de saída (padrão dab-config.json)

Authentication

Opção Resumo
--auth.audience Reivindicação de audiência JWT
--auth.issuer Reclamação do emissor JWT
--auth.provider Provedor de identidade (padrão StaticWebApps)

Fonte de dados

Opção Resumo
--connection-string Cadeia de conexão de banco de dados (suporta @env())
--cosmosdb_nosql-container Nome do contêiner NoSQL do Cosmos DB (opcional)
--cosmosdb_nosql-database Nome do banco de dados NoSQL do Cosmos DB (necessário para cosmosdb_nosql)
--database-type Tipo de base de dados: mssql, mysql, postgresql, cosmosdb_postgresql, cosmosdb_nosql
--set-session-context Habilitar o contexto de sessão do SQL Server (somente mssql)

GraphQL

Opção Resumo
--graphql.disabled Deprecated. Desativa o GraphQL (use --graphql.enabled false)
--graphql.enabled Ativar GraphQL (padrão true)
--graphql.multiple-create.enabled Permitir múltiplas mutações de criação (falso padrão)
--graphql.path Prefixo do ponto de extremidade GraphQL (padrão /graphql)
--graphql-schema Caminho para o esquema GraphQL (necessário para cosmosdb_nosql)

Host e autenticação

Opção Resumo
--host-mode Modo host: Desenvolvimento ou Produção (produção padrão)
--cors-origin Lista de origens permitidas (separada por vírgula)
--runtime.base-route Prefixo global para todos os pontos finais

MCP

Opção Resumo
--mcp.disabled Deprecated. Desativa o MCP (uso --mcp.enabled false)
--mcp.enabled Ativar MCP (padrão true)
--mcp.path Prefixo do ponto de extremidade MCP (padrão /mcp)

Observação

A capacidade MCP fará parte da versão 1.7.

REST

Opção Resumo
--rest.disabled Deprecated. Desabilita REST (uso --rest.enabled false)
--rest.enabled Ativar REST (padrão true, preferir sobre --rest.disabled)
--rest.path Prefixo do ponto de extremidade REST (padrão /api, ignorado por cosmosdb_nosql)
--rest.request-body-strict Impor validação estrita do corpo da solicitação (padrão true, ignorado por cosmosdb_nosql)

Importante

Não misture os novos --*.enabled sinalizadores e os sinalizadores herdados --*.disabled do mesmo subsistema no mesmo comando. Prefira o --*.enabled padrão, --graphql.disabledo --rest.disabled, e --mcp.disabled as opções registram avisos e serão removidos em versões futuras.

-c, --config

Nome do arquivo de configuração de saída. A predefinição é dab-config.json.

Example

dab init --database-type mssql --config dab-config.local.json

Configuração resultante

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "@env('MSSQL_CONNECTION_STRING')"
  }
}

--auth.audience

Reivindicação do público JWT.

Example

dab init --database-type mssql --auth.audience "https://example.com/api"

Configuração resultante

{
  "runtime": {
    "authentication": {
      "audience": "https://example.com/api"
    }
  }
}

--auth.issuer

Reclamação do emissor JWT.

Example

dab init --database-type mssql --auth.issuer "https://login.microsoftonline.com/{tenant-id}/v2.0"

Configuração resultante

{
  "runtime": {
    "authentication": {
      "issuer": "https://login.microsoftonline.com/{tenant-id}/v2.0"
    }
  }
}

--auth.provider

Provedor de identidade. A predefinição é StaticWebApps.

Example

dab init --database-type mssql --auth.provider AzureAD

Configuração resultante

{
  "runtime": {
    "authentication": {
      "provider": "AzureAD"
    }
  }
}

--connection-string

Cadeia de conexão de banco de dados. Suporta @env().

Example

dab init --database-type mssql --connection-string "@env('MSSQL_CONNECTION_STRING')"

Configuração resultante

{
  "data-source": {
    "connection-string": "@env('MSSQL_CONNECTION_STRING')"
  }
}

--cors-origin

Lista de origens permitidas separadas por vírgula.

Example

dab init --database-type mssql --cors-origin "https://app.example.com,https://admin.example.com"

Configuração resultante

{
  "runtime": {
    "cors": {
      "origins": [ "https://app.example.com", "https://admin.example.com" ]
    }
  }
}

--cosmosdb_nosql-container

Nome do contêiner NoSQL do Cosmos DB.

Example

dab init --database-type cosmosdb_nosql --cosmosdb_nosql-container MyContainer

Configuração resultante

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "options": {
      "container": "MyContainer"
    }
  }
}

--cosmosdb_nosql-database

Nome do banco de dados NoSQL do Cosmos DB. Necessário para cosmosdb_nosql.

Example

dab init --database-type cosmosdb_nosql --cosmosdb_nosql-database MyDb

Configuração resultante

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "options": {
      "database": "MyDb"
    }
  }
}

--database-type

Especifica o mecanismo de banco de dados de destino. Valores suportados: mssql, mysql, postgresql, cosmosdb_postgresql, cosmosdb_nosql.

Example

dab init --database-type mssql

Configuração resultante

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

--graphql.disabled

Deprecated. Desativa o GraphQL. Prefira --graphql.enabled false.

--graphql.enabled

Habilite o ponto de extremidade GraphQL. A predefinição é true.

Example

dab init --database-type mssql --graphql.enabled false

Configuração resultante

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

--graphql.multiple-create.enabled

Permite a criação de várias linhas em uma única mutação. A predefinição é false.

Example

dab init --database-type mssql --graphql.multiple-create.enabled true

Configuração resultante

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

--graphql.path

Prefixo do ponto de extremidade GraphQL. A predefinição é /graphql.

Example

dab init --database-type mssql --graphql.path /gql

Configuração resultante

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

--graphql-schema

Caminho para um arquivo de esquema GraphQL. Necessário para cosmosdb_nosql.

Example

dab init --database-type cosmosdb_nosql --graphql-schema ./schema.gql

Configuração resultante

{
  "runtime": {
    "graphql": {
      "schema": "./schema.gql"
    }
  }
}

--host-mode

Modo de anfitrião. A predefinição é Production.

Valores válidos: Development, Production.

Example

dab init --database-type mssql --host-mode development

Configuração resultante

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

--mcp.disabled

Deprecated. Desativa o MCP. Prefira --mcp.enabled false.

--mcp.enabled

Habilite o ponto de extremidade MCP. A predefinição é true.

Example

dab init --database-type mssql --mcp.enabled false

Configuração resultante

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

--mcp.path

Prefixo do ponto de extremidade MCP. A predefinição é /mcp.

Example

dab init --database-type mssql --mcp.path /model

Configuração resultante

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

--rest.disabled

Deprecated. Desativa o REST. Prefira --rest.enabled false.

--rest.enabled

Habilite o ponto de extremidade REST. A predefinição é true.

Example

dab init --database-type mssql --rest.enabled false

Configuração resultante

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

--rest.path

Prefixo do ponto de extremidade REST. A predefinição é /api.

Observação

Ignorado para cosmosdb_nosql.

Example

dab init --database-type mssql --rest.path /rest

Configuração resultante

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

--rest.request-body-strict

Controla o manuseio de campos extras em corpos de solicitação. A predefinição é true.

  • true: Rejeita campos estranhos (HTTP 400).
  • false: Ignora campos extras.

Observação

Ignorado para cosmosdb_nosql.

Example

dab init --database-type mssql --rest.request-body-strict false

Configuração resultante

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

--runtime.base-route

Prefixo global prefixado para todos os pontos de extremidade. Deve começar com /.

Example

dab init --database-type mssql --runtime.base-route /v1

Configuração resultante

{
  "runtime": {
    "base-route": "/v1"
  }
}

--set-session-context

Habilite o envio de dados para o SQL Server usando o contexto da sessão. Válido apenas para mssql. A predefinição é false.

Example

dab init --database-type mssql --set-session-context true

Configuração resultante

{
  "runtime": {
    "mssql": {
      "set-session-context": true
    }
  }
}
  • Last updated on