`configure` 명령

기존 데이터 API 작성기 구성 파일에서 엔터티별이 아닌 런타임 및 데이터 원본 속성을 구성합니다. 지정되지 않은 옵션은 기존 값을 변경하지 않고 그대로 둡니다. 제공된 옵션이 유효하지 않으면 전체 업데이트가 실패합니다(전부 또는 없음).

이 참조에 사용되는 약어: MCP(모델 컨텍스트 프로토콜), DML(데이터 조작 언어), TTL(Time to Live), JWT(JSON Web Token), RC(릴리스 후보), DCR(데이터 수집 규칙) 및 DCE(데이터 수집 엔드포인트).

비고

이 명령은 섹션을 entities 변경하지 않습니다. 엔터티 변경에 사용합니다 dab update .

Syntax

dab configure [options]

중요합니다

OpenTelemetry 및 Application Insights 설정은 .dab add-telemetrydab configure concept/monitor/open-telemetry.md 및 concept/monitor/application-insights.md를 참조하세요.

한눈에 보기

Option	요약
`-c, --config`	구성 파일의 경로(기본값 `dab-config.json`)입니다.

데이터 원본 섹션

Option	요약
`--data-source.database-type`	데이터베이스 유형을 설정합니다.
`--data-source.connection-string`	데이터베이스 연결 문자열을 설정합니다.
`--data-source.options.database`	NoSql용 Cosmos DB의 데이터베이스 이름입니다.
`--data-source.options.container`	NoSql용 Cosmos DB의 컨테이너 이름입니다.
`--data-source.options.schema`	NoSql용 Cosmos DB에 대한 스키마 경로입니다.
`--data-source.options.set-session-context`	세션 컨텍스트를 사용하도록 설정합니다.
`--data-source.health.name`	상태 검사 보고서의 데이터 원본에 대한 식별자입니다.
`--data-source.user-delegated-auth.enabled`	OBO 사용자 위임 인증을 사용하도록 설정합니다.
`--data-source.user-delegated-auth.database-audience`	다운스트림 SQL 토큰의 대상 그룹입니다.

GraphQL 섹션

Option	요약
`--runtime.graphql.depth-limit`	최대 쿼리 깊이를 제한합니다.
`--runtime.graphql.enabled`	GraphQL 엔드포인트를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.graphql.path`	GraphQL 엔드포인트 경로를 사용자 지정합니다.
`--runtime.graphql.allow-introspection`	GraphQL 내성 검사를 허용하거나 거부합니다.
`--runtime.graphql.multiple-mutations.create.enabled`	다중 만들기 변형을 사용하도록 설정합니다.

REST 섹션

Option	요약
`--runtime.rest.enabled`	REST 엔드포인트를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.rest.path`	REST 엔드포인트 경로를 사용자 지정합니다.
`--runtime.rest.request-body-strict`	엄격한 REST 요청 본문 유효성 검사를 적용합니다.

MCP 섹션

Option	요약
`--runtime.mcp.enabled`	MCP 엔드포인트를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.path`	MCP 엔드포인트 경로를 사용자 지정합니다.
`--runtime.mcp.description`	MCP 서버 설명을 설정합니다.
`--runtime.mcp.dml-tools`	모든 MCP DML 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.describe-entities`	설명 엔터티 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.create-record`	레코드 만들기 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.read-records`	읽기 레코드 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.update-record`	업데이트 레코드 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.delete-record`	삭제 레코드 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.execute-entity`	실행 엔터티 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.aggregate-records.enabled`	집계 레코드 도구를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.mcp.dml-tools.aggregate-records.query-timeout`	집계 레코드에 대한 실행 시간 제한(초)입니다.

캐시 섹션

Option	요약
`--runtime.cache.enabled`	전역 캐시를 사용하거나 사용하지 않도록 설정합니다.
`--runtime.cache.ttl-seconds`	전역 캐시 TTL(초)입니다.
`--runtime.compression.level`	HTTP 응답 압축 수준을 설정합니다.

호스트 섹션

Option	요약
`--runtime.host.mode`	호스트 모드 설정: 개발 또는 프로덕션.
`--runtime.host.cors.origins`	허용되는 CORS 원본입니다.
`--runtime.host.cors.allow-credentials`	CORS 허용 자격 증명을 설정합니다.
`--runtime.host.authentication.provider`	인증 공급자입니다.
`--runtime.host.authentication.jwt.audience`	JWT 대상 그룹 클레임입니다.
`--runtime.host.authentication.jwt.issuer`	JWT 발급자 클레임입니다.

유효 권한

Option	요약
`--show-effective-permissions`	모든 엔터티에 대해 확인된 권한을 표시합니다.

Key Vault 섹션

Option	요약
`--azure-key-vault.endpoint`	Azure Key Vault 기본 엔드포인트.
`--azure-key-vault.retry-policy.mode`	정책 모드를 다시 시도합니다.
`--azure-key-vault.retry-policy.max-count`	최대 재시도 횟수입니다.
`--azure-key-vault.retry-policy.delay-seconds`	재시도 사이의 지연입니다.
`--azure-key-vault.retry-policy.max-delay-seconds`	지수 재시도의 최대 지연 시간입니다.
`--azure-key-vault.retry-policy.network-timeout-seconds`	네트워크 호출에 대한 시간 제한입니다.

원격 분석 섹션

Option	요약
`--runtime.telemetry.azure-log-analytics.enabled`	Azure Log Analytics 원격 분석을 사용하도록 설정합니다.
`--runtime.telemetry.azure-log-analytics.dab-identifier`	로그 원본을 구분합니다.
`--runtime.telemetry.azure-log-analytics.flush-interval-seconds`	플러시 주기(초)입니다.
`--runtime.telemetry.azure-log-analytics.auth.custom-table-name`	사용자 지정 테이블 이름입니다.
`--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id`	데이터 수집 규칙 ID입니다.
`--runtime.telemetry.azure-log-analytics.auth.dce-endpoint`	데이터 수집 엔드포인트입니다.
`--runtime.telemetry.file.enabled`	파일 싱크 원격 분석을 사용하도록 설정합니다.
`--runtime.telemetry.file.path`	로그 파일의 경로입니다.
`--runtime.telemetry.file.rolling-interval`	롤링 간격입니다.
`--runtime.telemetry.file.retained-file-count-limit`	보존된 최대 파일 수입니다.
`--runtime.telemetry.file.file-size-limit-bytes`	롤링 전 파일당 최대 크기입니다.

`-c, --config`

구성 파일의 경로입니다. dab-config.json 환경 변수는 존재하지 dab-config.<DAB_ENVIRONMENT>.json 않는 한 DAB_ENVIRONMENT 기본값으로 설정됩니다.

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

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

`--data-source.database-type`

데이터베이스 유형입니다.

허용되는 값:

MSSQL
PostgreSQL
CosmosDB_NoSQL
MySQL

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--data-source.connection-string`

데이터 원본에 대한 연결 문자열입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--data-source.options.database`

NoSql용 Cosmos DB의 데이터베이스 이름입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--data-source.options.container`

NoSql용 Cosmos DB의 컨테이너 이름입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--data-source.options.schema`

NoSql용 Cosmos DB에 대한 스키마 경로입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

세션 컨텍스트를 사용하도록 설정합니다.

허용되는 값:

true(기본값)
false

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--data-source.health.name`

상태 검사 보고서의 데이터 원본에 대한 식별자입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

OBO(On-Behalf-Of) 사용자 위임 인증을 사용하거나 사용하지 않도록 설정합니다. 데이터 원본에 대해서만 mssql 지원됩니다.

비고

이 섹션에 설명된 Data API Builder 2.0 기능은 현재 미리 보기 상태이며 일반 공급 전에 변경될 수 있습니다. 자세한 내용은 버전 2.0의 새로운 기능입니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

OBO를 사용하는 경우 다운스트림 SQL 토큰에 대한 대상 그룹을 설정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.graphql.depth-limit`

중첩된 쿼리의 최대 허용 깊이입니다.

허용되는 값:

$(0,2147483647]$ (포함)
-1 제한을 제거하려면

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.graphql.enabled`

DAB의 GraphQL 엔드포인트를 사용하도록 설정합니다.

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.graphql.enabled false

dab configure ^
  --runtime.graphql.enabled false

결과 구성

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

`--runtime.graphql.path`

DAB의 GraphQL 엔드포인트 경로를 사용자 지정합니다. 접두사 경로에 ./

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.graphql.allow-introspection`

GraphQL 내성 요청을 허용하거나 거부합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

생성된 GraphQL 스키마에서 다중 변형 만들기 작업을 사용하거나 사용하지 않도록 설정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.rest.enabled`

DAB의 REST 엔드포인트를 사용하도록 설정합니다.

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.rest.enabled false

dab configure ^
  --runtime.rest.enabled false

결과 구성

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

`--runtime.rest.path`

DAB의 REST 엔드포인트 경로를 사용자 지정합니다. 접두사 경로에 ./

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.rest.request-body-strict`

불필요한 REST 요청 본문 필드를 금지합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.mcp.enabled`

DAB의 MCP 엔드포인트를 사용하도록 설정합니다.

비고

이 옵션은 CLI에서 2.0.0-rc 사용할 수 있습니다. 데이터 API 작성기 2.0은 현재 미리 보기로 제공됩니다. 를 사용하여 설치합니다 dotnet tool install microsoft.dataapibuilder --version 2.0.0-rc --prerelease.

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.mcp.enabled false

dab configure ^
  --runtime.mcp.enabled false

결과 구성

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

`--runtime.mcp.path`

DAB의 MCP 엔드포인트 경로를 사용자 지정합니다. 접두사 경로에 ./

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.mcp.description`

초기화된 응답에 노출되도록 MCP 서버 설명을 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.mcp.dml-tools`

DAB의 MCP DML 도구 엔드포인트를 사용하도록 설정합니다.

비고

MCP DML 도구에 대한 자세한 내용은 SQL MCP Server 데이터 조작 언어 도구를 참조하세요.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 설명 엔터티 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 레코드 만들기 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 읽기 레코드 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 업데이트 레코드 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 삭제 레코드 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 실행 엔터티 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

DAB의 MCP 집계 레코드 도구를 사용하도록 설정합니다.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

집계 레코드 MCP 도구에 대한 실행 제한 시간(초)을 설정합니다.

기본값: 30. 범위: 1-600.

비고

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.cache.enabled`

DAB의 캐시를 전역적으로 사용하도록 설정합니다. 또한 각 엔터티에 대해 캐싱을 사용하도록 설정해야 합니다.

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.cache.enabled true

dab configure ^
  --runtime.cache.enabled true

결과 구성

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

`--runtime.cache.ttl-seconds`

DAB 캐시의 전역 기본 시간(초)을 사용자 지정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.compression.level`

비고

이 섹션에 설명된 Data API Builder 2.0 기능은 현재 미리 보기 상태이며 일반 공급 전에 변경될 수 있습니다. 자세한 내용은 버전 2.0의 새로운 기능입니다.

HTTP 응답 압축 수준을 설정합니다.

허용되는 값:

optimal- 압축 비율과 속도의 균형을 조정합니다(기본값)
fastest- 비율보다 압축 속도 우선 순위 지정
none-압축을 사용하지 않도록 설정

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.compression.level optimal

dab configure ^
  --runtime.compression.level optimal

결과 구성

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

`--runtime.host.mode`

DAB의 호스트 실행 모드를 설정합니다.

허용되는 값:

Development
Production

예시

배쉬
명령 프롬프트

dab configure \
  --runtime.host.mode Development

dab configure ^
  --runtime.host.mode Development

결과 구성

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

`--runtime.host.cors.origins`

CORS에서 허용된 원본을 덮어씁니다. 값을 공백으로 구분된 목록으로 제공합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.host.cors.allow-credentials`

헤더의 값을 Access-Control-Allow-Credentials 설정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.host.authentication.provider`

인증 공급자의 이름을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.host.authentication.jwt.audience`

JWT 토큰의 의도된 받는 사람을 하나 이상 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.host.authentication.jwt.issuer`

JWT 토큰을 발급한 엔터티를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--azure-key-vault.endpoint`

Azure Key Vault 엔드포인트 URL을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

재시도 정책 모드를 구성합니다.

허용되는 값:

fixed
exponential

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

최대 재시도 횟수를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

다시 시도 사이의 초기 지연 시간(초)을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

재시도 사이의 최대 지연 시간(초)을 구성합니다(지수 모드의 경우).

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

요청에 대한 네트워크 시간 제한을 초 단위로 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

Azure Log Analytics를 사용하거나 사용하지 않도록 설정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

Azure Log Analytics에서 사용되는 DAB 식별자 문자열을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

Azure Log Analytics에 대한 플러시 간격(초)을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

Azure Log Analytics에 대한 사용자 지정 테이블 이름을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

Azure Log Analytics에 대한 DCR 변경할 수 없는 ID를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

Azure Log Analytics에 대한 DCE 엔드포인트를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

파일 싱크 로깅을 사용하거나 사용하지 않도록 설정합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.telemetry.file.path`

파일 싱크 로깅에 대한 경로를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

`--runtime.telemetry.file.rolling-interval`

파일 싱크 로깅에 대한 롤링 간격을 구성합니다.

허용되는 값:

Minute
Hour
Day
Month
Year
Infinite

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

보존된 파일의 최대 수를 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

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

최대 파일 크기 제한(바이트)을 구성합니다.

예시

배쉬
명령 프롬프트

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

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

결과 구성

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

역할 상속이 적용된 후 모든 엔터티에 대해 확인된 권한을 표시합니다. 이 옵션을 사용하여 구성을 수동으로 추론하지 않고 각 역할이 실제로 수행할 수 있는 작업을 확인합니다.

비고

이 섹션에 설명된 Data API Builder 2.0 기능은 현재 미리 보기 상태이며 일반 공급 전에 변경될 수 있습니다. 자세한 내용은 버전 2.0의 새로운 기능입니다.

예시

배쉬
명령 프롬프트

dab configure \
  --show-effective-permissions

dab configure \
  --show-effective-permissions --config my-config.json

dab configure ^
  --show-effective-permissions

dab configure ^
  --show-effective-permissions --config my-config.json

예제 출력

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 2026-04-01

다음을 통해 공유

configure 명령

Syntax

한눈에 보기

데이터 원본 섹션

GraphQL 섹션

REST 섹션

MCP 섹션

캐시 섹션

호스트 섹션

유효 권한

Key Vault 섹션

원격 분석 섹션

-c, --config

예시

--data-source.database-type

예시

결과 구성

--data-source.connection-string

예시

결과 구성

--data-source.options.database

예시

결과 구성

--data-source.options.container

예시

결과 구성

--data-source.options.schema

예시

결과 구성

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

예시

결과 구성

--data-source.health.name

예시

결과 구성

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

예시

결과 구성

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

예시

결과 구성

--runtime.graphql.depth-limit

예시

결과 구성

--runtime.graphql.enabled

예시

결과 구성

--runtime.graphql.path

예시

결과 구성

--runtime.graphql.allow-introspection

예시

결과 구성

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

예시

결과 구성

--runtime.rest.enabled

예시

결과 구성

--runtime.rest.path

예시

결과 구성

--runtime.rest.request-body-strict

예시

결과 구성

--runtime.mcp.enabled

예시

결과 구성

--runtime.mcp.path

예시

결과 구성

--runtime.mcp.description

예시

결과 구성

--runtime.mcp.dml-tools

예시

결과 구성

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

예시

`configure` 명령

`-c, --config`

`--data-source.database-type`

`--data-source.connection-string`

`--data-source.options.database`

`--data-source.options.container`

`--data-source.options.schema`

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

`--data-source.health.name`

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

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

`--runtime.graphql.depth-limit`

`--runtime.graphql.enabled`

`--runtime.graphql.path`

`--runtime.graphql.allow-introspection`

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

`--runtime.rest.enabled`

`--runtime.rest.path`

`--runtime.rest.request-body-strict`

`--runtime.mcp.enabled`

`--runtime.mcp.path`

`--runtime.mcp.description`

`--runtime.mcp.dml-tools`

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

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

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

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

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

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

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

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

`--runtime.cache.enabled`

`--runtime.cache.ttl-seconds`

`--runtime.compression.level`

`--runtime.host.mode`

`--runtime.host.cors.origins`

`--runtime.host.cors.allow-credentials`

`--runtime.host.authentication.provider`

`--runtime.host.authentication.jwt.audience`

`--runtime.host.authentication.jwt.issuer`

`--azure-key-vault.endpoint`

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

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

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

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

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

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