`init` コマンド

新しいデータ API ビルダーの構成ファイルを初期化します。結果の JSON は、データソースの詳細、有効なエンドポイント (REST、GraphQL、MCP)、認証、ランタイム動作をキャプチャします。

構文

dab init [options]

ターゲット構成ファイルが既に存在する場合は、コマンドによって上書きされます。マージはありません。前のファイルを保持する必要がある場合は、バージョン管理またはバックアップを使用します。

チラッ

Option	概要
`-c, --config`	出力構成ファイル名 (既定の dab-config.json)

Authentication

Option	概要
`--auth.audience`	JWT 対象ユーザー要求
`--auth.issuer`	JWT 発行者要求
`--auth.provider`	ID プロバイダー (既定の StaticWebApps)

データソース

Option	概要
`--connection-string`	データベース接続文字列 ( `@env()`をサポート)
`--cosmosdb_nosql-container`	Cosmos DB NoSQL コンテナー名 (省略可能)
`--cosmosdb_nosql-database`	Cosmos DB NoSQL データベース名 (cosmosdb_nosqlに必要)
`--database-type`	データベースの種類: `mssql`、 `mysql`、 `postgresql`、 `cosmosdb_postgresql`、 `cosmosdb_nosql`
`--set-session-context`	SQL Server セッションコンテキストを有効にする (mssql のみ)

GraphQL

Option	概要
`--graphql.disabled`	Deprecated. GraphQL を無効にします ( `--graphql.enabled false`を使用)
`--graphql.enabled`	GraphQL を有効にする (既定値は true)
`--graphql.multiple-create.enabled`	複数の作成の変更を許可する (既定値は false)
`--graphql.path`	GraphQL エンドポイントプレフィックス (既定の /graphql)
`--graphql-schema`	GraphQL スキーマへのパス (cosmosdb_nosqlに必要)

ホストと認証

Option	概要
`--host-mode`	ホストモード: 開発または運用 (既定の運用)
`--cors-origin`	許可される配信元リスト (コンマ区切り)
`--runtime.base-route`	すべてのエンドポイントのグローバルプレフィックス

MCP

Option	概要
`--mcp.disabled`	Deprecated. MCP を無効にします ( `--mcp.enabled false`を使用)
`--mcp.enabled`	MCP を有効にする (既定値は true)
`--mcp.path`	MCP エンドポイントプレフィックス (既定の /mcp)

注

MCP 機能はバージョン 1.7 の一部になります。

REST

Option	概要
`--rest.disabled`	Deprecated. REST を無効にします ( `--rest.enabled false`を使用)
`--rest.enabled`	REST を有効にする (既定値は true、 `--rest.disabled`よりも優先)
`--rest.path`	REST エンドポイントプレフィックス (既定の /api、cosmosdb_nosqlでは無視)
`--rest.request-body-strict`	厳密な要求本文の検証を適用する (既定では true、cosmosdb_nosqlでは無視されます)

Important

同じコマンド内の同じサブシステムに対して、新しい --*.enabled フラグとレガシ --*.disabled フラグを混在させないでください。 --*.enabledパターンを優先します。--rest.disabled、--graphql.disabled、および--mcp.disabledオプションは警告をログに記録し、今後のバージョンで削除されます。

`-c, --config`

出力構成ファイル名。既定値は dab-config.json です。

Example

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

結果の構成

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

`--auth.audience`

JWT 対象ユーザーの要求。

Example

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

結果の構成

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

`--auth.issuer`

JWT 発行者要求。

Example

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

結果の構成

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

`--auth.provider`

ID プロバイダー。既定値は StaticWebApps です。

Example

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

結果の構成

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

`--connection-string`

データベース接続文字列。 @env() をサポートしています。

Example

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

結果の構成

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

`--cors-origin`

許可される配信元のコンマ区切りの一覧。

Example

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

結果の構成

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

`--cosmosdb_nosql-container`

Cosmos DB NoSQL コンテナー名。

Example

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

結果の構成

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

`--cosmosdb_nosql-database`

Cosmos DB NoSQL データベース名。 cosmosdb_nosqlに必要です。

Example

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

結果の構成

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

`--database-type`

ターゲットデータベースエンジンを指定します。サポートされる値: mssql、mysql、postgresql、cosmosdb_postgresql、cosmosdb_nosql。

Example

dab init --database-type mssql

結果の構成

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

`--graphql.disabled`

Deprecated. GraphQL を無効にします。 --graphql.enabled falseを優先します。

`--graphql.enabled`

GraphQL エンドポイントを有効にします。既定値は true です。

Example

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

結果の構成

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

`--graphql.multiple-create.enabled`

1 つの変更で複数の行を作成できます。既定値は false です。

Example

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

結果の構成

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

`--graphql.path`

GraphQL エンドポイントプレフィックス。既定値は /graphql です。

Example

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

結果の構成

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

`--graphql-schema`

GraphQL スキーマファイルへのパス。 cosmosdb_nosqlに必要です。

Example

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

結果の構成

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

`--host-mode`

ホストモード。既定値は Production です。

有効な値: Development、Production。

Example

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

結果の構成

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

`--mcp.disabled`

Deprecated. MCP を無効にします。 --mcp.enabled falseを優先します。

`--mcp.enabled`

MCP エンドポイントを有効にします。既定値は true です。

Example

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

結果の構成

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

`--mcp.path`

MCP エンドポイントプレフィックス。既定値は /mcp です。

Example

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

結果の構成

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

`--rest.disabled`

Deprecated. REST を無効にします。 --rest.enabled falseを優先します。

`--rest.enabled`

REST エンドポイントを有効にします。既定値は true です。

Example

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

結果の構成

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

`--rest.path`

REST エンドポイントプレフィックス。既定値は /api です。

注

cosmosdb_nosqlの場合は無視されます。

Example

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

結果の構成

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

`--rest.request-body-strict`

要求本文の追加フィールドの処理を制御します。既定値は true です。

true: 余分なフィールド (HTTP 400) を拒否します。
false: 追加のフィールドを無視します。

注

cosmosdb_nosqlの場合は無視されます。

Example

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

結果の構成

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

`--runtime.base-route`

すべてのエンドポイントの前に付加されるグローバルプレフィックス。 /で始まる必要があります。

Example

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

結果の構成

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

`--set-session-context`

セッションコンテキストを使用して SQL Server へのデータ送信を有効にします。 mssqlに対してのみ有効です。既定値は false です。

Example

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

結果の構成

{
  "runtime": {
    "mssql": {
      "set-session-context": true
    }
  }
}

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-07

次の方法で共有

init コマンド

構文

チラッ

Authentication

データ ソース

GraphQL

ホストと認証

MCP

REST

-c, --config

Example

結果の構成

--auth.audience

Example

結果の構成

--auth.issuer

Example

結果の構成

--auth.provider

Example

結果の構成

--connection-string

Example

結果の構成

--cors-origin

Example

結果の構成

--cosmosdb_nosql-container

Example

結果の構成

--cosmosdb_nosql-database

Example

結果の構成

--database-type

Example

結果の構成

--graphql.disabled

--graphql.enabled

Example

結果の構成

--graphql.multiple-create.enabled

Example

結果の構成

--graphql.path

Example

結果の構成

--graphql-schema

Example

結果の構成

--host-mode

Example

結果の構成

--mcp.disabled

--mcp.enabled

Example

結果の構成

--mcp.path

Example

結果の構成

--rest.disabled

--rest.enabled

Example

結果の構成

--rest.path

Example

結果の構成

--rest.request-body-strict

Example

結果の構成

--runtime.base-route

Example

結果の構成

--set-session-context

Example

結果の構成

フィードバック

その他のリソース

`init` コマンド

データソース

`-c, --config`

`--auth.audience`

`--auth.issuer`

`--auth.provider`

`--connection-string`

`--cors-origin`

`--cosmosdb_nosql-container`

`--cosmosdb_nosql-database`

`--database-type`

`--graphql.disabled`

`--graphql.enabled`

`--graphql.multiple-create.enabled`

`--graphql.path`

`--graphql-schema`

`--host-mode`

`--mcp.disabled`

`--mcp.enabled`

`--mcp.path`

`--rest.disabled`

`--rest.enabled`

`--rest.path`

`--rest.request-body-strict`

`--runtime.base-route`

`--set-session-context`