Compartir a través de

Comando init

Inicializa un nuevo archivo de configuración del generador de API de datos. El JSON resultante captura los detalles del origen de datos, los puntos de conexión habilitados (REST, GraphQL, MCP), la autenticación y los comportamientos en tiempo de ejecución.

Syntax

dab init [options]

Si el archivo de configuración de destino ya existe, el comando lo sobrescribe. No hay ninguna combinación. Use el control de versiones o las copias de seguridad si necesita conservar el archivo anterior.

Vista rápida

Opción Resumen
-c, --config Nombre del archivo de configuración de salida (valor predeterminado dab-config.json)

Autenticación

Opción Resumen
--auth.audience Notificación de audiencia de JWT
--auth.issuer Notificación del emisor de JWT
--auth.provider Proveedor de identidades (staticWebApps predeterminado)

Origen de datos

Opción Resumen
--connection-string Cadena de conexión de base de datos (admite @env())
--cosmosdb_nosql-container Nombre de contenedor noSQL de Cosmos DB (opcional)
--cosmosdb_nosql-database Nombre de base de datos NoSQL de Cosmos DB (necesario para cosmosdb_nosql)
--database-type Tipo de base de datos: mssql, mysql, postgresql, , cosmosdb_postgresqlcosmosdb_nosql
--set-session-context Habilitar el contexto de sesión de SQL Server (solo mssql)

GraphQL

Opción Resumen
--graphql.disabled Deprecated. Deshabilita GraphQL (usar --graphql.enabled false)
--graphql.enabled Habilitar GraphQL (valor predeterminado true)
--graphql.multiple-create.enabled Permitir varias mutaciones de creación (valor predeterminado false)
--graphql.path Prefijo de punto de conexión de GraphQL (predeterminado /graphql)
--graphql-schema Ruta de acceso al esquema graphQL (necesario para cosmosdb_nosql)

Host y autenticación

Opción Resumen
--host-mode Modo de host: desarrollo o producción (producción predeterminada)
--cors-origin Lista de orígenes permitidos (separados por comas)
--runtime.base-route Prefijo global para todos los puntos de conexión

MCP

Opción Resumen
--mcp.disabled Deprecated. Deshabilita MCP (use --mcp.enabled false)
--mcp.enabled Habilitar MCP (valor predeterminado true)
--mcp.path Prefijo de punto de conexión de MCP (predeterminado /mcp)

Nota:

La funcionalidad MCP formará parte de la versión 1.7.

REST

Opción Resumen
--rest.disabled Deprecated. Deshabilita REST (use --rest.enabled false)
--rest.enabled Habilitar REST (el valor predeterminado es true, prefiere más que --rest.disabled)
--rest.path Prefijo de punto de conexión REST (predeterminado /api, omitido para cosmosdb_nosql)
--rest.request-body-strict Exigir la validación estricta del cuerpo de la solicitud (valor predeterminado true, omitido para cosmosdb_nosql)

Importante

No combine las nuevas --*.enabled marcas y las marcas heredadas --*.disabled para el mismo subsistema en el mismo comando. Prefiere el --*.enabled patrón; las --rest.disabledopciones , --graphql.disabledy --mcp.disabled registran advertencias y se quitarán en versiones futuras.

-c, --config

Nombre del archivo de configuración de salida. El valor predeterminado es dab-config.json.

Example

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

Configuración resultante

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

--auth.audience

Notificación de audiencia de JWT.

Example

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

Configuración resultante

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

--auth.issuer

Notificación del emisor de JWT.

Example

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

Configuración resultante

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

--auth.provider

Proveedor de identidades. El valor predeterminado es StaticWebApps.

Example

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

Configuración resultante

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

--connection-string

Cadena de conexión de base de datos. Admite @env().

Example

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

Configuración resultante

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

--cors-origin

Lista separada por comas de orígenes permitidos.

Example

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

Configuración resultante

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

--cosmosdb_nosql-container

Nombre del contenedor NoSQL de Cosmos DB.

Example

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

Configuración resultante

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

--cosmosdb_nosql-database

Nombre de la base de datos NoSQL de Cosmos DB. Necesario para cosmosdb_nosql.

Example

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

Configuración resultante

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

--database-type

Especifica el motor de base de datos de destino. Valores admitidos: mssql, mysql, postgresql, cosmosdb_postgresql, cosmosdb_nosql.

Example

dab init --database-type mssql

Configuración resultante

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

--graphql.disabled

Deprecated. Deshabilita GraphQL. Prefiere --graphql.enabled false.

--graphql.enabled

Habilite el punto de conexión de GraphQL. El valor predeterminado es true.

Example

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

Configuración resultante

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

--graphql.multiple-create.enabled

Permite la creación de varias filas en una sola mutación. El valor predeterminado es false.

Example

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

Configuración resultante

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

--graphql.path

Prefijo de punto de conexión de GraphQL. El valor predeterminado es /graphql.

Example

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

Configuración resultante

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

--graphql-schema

Ruta de acceso a un archivo de esquema graphQL. Necesario para cosmosdb_nosql.

Example

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

Configuración resultante

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

--host-mode

Modo host. El valor predeterminado es Production.

Valores válidos: Development, Production.

Example

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

Configuración resultante

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

--mcp.disabled

Deprecated. Deshabilita MCP. Prefiere --mcp.enabled false.

--mcp.enabled

Habilite el punto de conexión de MCP. El valor predeterminado es true.

Example

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

Configuración resultante

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

--mcp.path

Prefijo de punto de conexión de MCP. El valor predeterminado es /mcp.

Example

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

Configuración resultante

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

--rest.disabled

Deprecated. Deshabilita REST. Prefiere --rest.enabled false.

--rest.enabled

Habilite el punto de conexión rest. El valor predeterminado es true.

Example

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

Configuración resultante

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

--rest.path

Prefijo de punto de conexión rest. El valor predeterminado es /api.

Nota:

Se omite para cosmosdb_nosql.

Example

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

Configuración resultante

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

--rest.request-body-strict

Controla el control de campos adicionales en los cuerpos de solicitud. El valor predeterminado es true.

  • true: rechaza campos extraños (HTTP 400).
  • false: omite campos adicionales.

Nota:

Se omite para cosmosdb_nosql.

Example

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

Configuración resultante

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

--runtime.base-route

Prefijo global antepuesto a todos los puntos de conexión. Debe comenzar con /.

Example

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

Configuración resultante

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

--set-session-context

Habilite el envío de datos a SQL Server mediante el contexto de sesión. Solo es válido para mssql. El valor predeterminado es false.

Example

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

Configuración resultante

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