빠른 시작: 모든 데이터베이스에 대해 Microsoft의 Data API Builder를 사용하여 App Builder 연결

데이터베이스를 App Builder에 빠르게 연결하고 REST API를 사용하여 모든 기능을 갖춘 앱을 빌드하고 싶으신가요? 이 가이드는 Microsoft의 DAB(Data API Builder)를 사용하여 지원되는 데이터베이스(SQL Server, MySQL, PostgreSQL 등)에서 REST API를 생성한 다음 App Builder에 직접 연결하는 방법을 안내합니다.

Data API Builder를 사용하는 이유

Microsoft의 DAB는 백엔드를 작성하지 않고 REST 또는 GraphQL을 통해 데이터베이스를 노출할 수 있는 빠르고 유연한 방법을 제공합니다. 상자에서 얻을 수 있는 것은 다음과 같습니다.

• REST 끝점: GET,,, PUT, PATCH​ ​POST​ ​DELETE
• 필터링, 정렬, 페이지 매김
• OpenAPI(Swagger) 지원
• Works with Tables, Views, Stored Procedures
• 인메모리 캐싱
• 오픈 소스 & 무료 사용

1단계: Data API Builder CLI 설치

NET을 사용하여 DAB CLI를 전역적으로 설치합니다.

dotnet tool install -g Microsoft.DataApiBuilder

이미 설치된 경우:

dotnet tool update -g Microsoft.DataApiBuilder

자세한 내용은 공식 설명서 DAB 설치 문서를 참조하십시오.

2단계: 데이터베이스 설정

SQL Server, MySQL 또는 PostgreSQL과 같은 데이터베이스를 사용할 준비가 되어 있어야 합니다. SQL Server Management Studio, MySQL Workbench 또는 선호하는 DB 도구를 사용하여 스핀업할 수 있습니다.

이 예제에서는 MSSQL 데이터베이스를 사용합니다.

3단계: DAB 구성 초기화

연결 문자열을 사용하여 기준 구성 파일을 만듭니다.

dab init --database-type "mssql" --host-mode "Development" --connection-string "Server=YOUR_SERVER;Database=YOUR_DB;Integrated Security=True;"

그런 다음 엔터티를 추가합니다.

dab add Products --source "Products" --permissions "anonymous:*"

그러면 테이블에 대한 REST 엔드포인트가 Products 추가됩니다. 이제 다음을 통해 /api/Products 상호 작용할 수 있습니다.

필요한 경우 CORS를 활성화합니다.

jsonCopyEdit"origins": ["*"]

기본 dab-config.json은 다음과 같습니다 (명확성을 위해 단순화 됨).

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "Server=YOUR_SERVER;Database=NorthwindCRUD;Integrated Security=True;"
  },
  "runtime": {
    "rest": {
      "enabled": true,
      "path": "/api"
    },
    "host": {
      "cors": {
        "origins": ["*"]
      },
      "authentication": {
        "provider": "StaticWebApps"
      },
      "mode": "development"
    }
  },
  "entities": {
    "Products": {
      "source": {
        "object": "Products",
        "type": "table"
      },
      "rest": { "enabled": true },
      "permissions": [
        {
          "role": "anonymous",
          "actions": [{ "action": "*" }]
        }
      ]
    }
  }
}

4단계: API 실행 및 테스트

다음을 사용하여 API를 시작합니다.

dab start

다음과 같은 출력이 표시됩니다.

Now listening on: http://localhost:5000

Swagger UI에서 엔드포인트를 테스트하려면 방문하십시오 http://localhost:5000/swagger/index.html.

5단계: App Builder에 연결

이제 API가 활성화되고 Swagger가 활성화되었으므로 App Builder로 쉽게 가져올 수 있습니다.

이 단계별 가이드를 따르세요

문제 해결 팁

문제	용액
🔄 CORS 문제	​host.cors 섹션에 추가 "origins": ["*"]​
❌ DELETE가 작동하지 않음	포함 여부 "permissions": "anonymous:*" 확인 DELETE
🔐 인증 문제	연결 문자열이 올바른 인증 방법을 사용하는지 확인합니다.
🧩 양식 CRUD 누락	양식 구성 요소가 OpenAPI에서 더 많은 것을 필요로 함 — 진행 중
🔑 OIDC가 필요하신가요?	​OpenID Connect GitHub 문제 추적

요약

몇 단계만 거치면 데이터베이스에서 REST API를 구축 및 테스트하고 App Builder에 연결할 수 있습니다. 레거시 데이터베이스로 작업하든 새로 시작하든, Data API Builder는 빠르게 진행할 수 있도록 지원하며 프런트엔드 App Builder 생명을 불어넣습니다.

추가 리소스

• 앱에서 데이터 사용(공식 문서)
• Form Builder 통합
• 그리드 원격 페이징
• CRUD 운영 가이드
• 플렉스 레이아웃 시스템