M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions m365con.net

블로그 · Mirko Peters

Microsoft Fabric Apps: 개요와 사용 방법

By ·

Fabric Apps(미리 보기)를 사용하면 개발자가 TypeScript로 Microsoft Fabric에서 데이터 기반 앱을 만들 수 있습니다. 이 가이드에서는 이 기능의 개요, 관리자 설정, 앱 만들기와 배포 방법, 권한, 그리고 현재 제한 사항을 다룹니다.

Automatically translated with AI from the original post. Read the English original

Fabric Apps는 데이터 기반 애플리케이션을 만들기 위한 Microsoft Fabric 기능으로, 현재 미리 보기 단계입니다. 개발자는 TypeScript로 데이터 모델을 작성하고, Fabric은 데이터베이스 스키마, GraphQL API, 로그인 및 호스팅을 생성합니다. 보고서 작성자가 아닌 개발자를 대상으로 하며, Power BI 앱과는 별개의 기능입니다.

핵심 포인트

  • Fabric Apps는 Rayfin SDK를 기반으로 한 미리 보기 기능입니다. 개발자는 TypeScript로 데이터 모델을 정의하고, Fabric은 데이터베이스, GraphQL API, 인증 및 호스팅을 생성합니다.
  • 테넌트 관리자는 먼저 Fabric 관리 포털의 테넌트 설정에서 Fabric Apps(미리 보기)를 사용하도록 설정해야 합니다. 전체 조직에 적용하거나 특정 보안 그룹에만 적용할 수 있습니다.
  • 작업 영역에 Fabric 용량이 할당되어 있어야 합니다. Fabric Apps 서비스는 이 용량의 용량 단위를 사용합니다.
  • 배포 후에는 Microsoft Entra ID를 통한 Fabric SSO로만 로그인할 수 있습니다. 이메일과 암호 로그인은 로컬 개발에서만 작동합니다.
  • Microsoft는 다대다 관계 미지원, 복합 키 미지원, ALM 미지원, 프라이빗 링크 미지원 등의 제한 사항을 나열하고 있으므로, 설계를 확정하기 전에 반드시 확인하시기 바랍니다.

Fabric Apps의 기능

Microsoft Learn에서는 Fabric Apps가 Rayfin SDK를 기반으로 한다고 설명합니다. 예를 들어 @entity(), @text(), @uuid()와 같은 데코레이터로 TypeScript 클래스를 꾸밉니다. 이 모델을 바탕으로 Fabric은 다음을 생성합니다.

  • 관리형 저장소인 Fabric의 SQL 데이터베이스에 생성되는 데이터베이스 테이블
  • 앱 백엔드 URL의 /api/graphql 경로에 있는 GraphQL 엔드포인트
  • @role 데코레이터를 통한 행 수준 권한 부여 규칙
  • 형식이 지정된 클라이언트 메서드
  • 프런트엔드용 정적 호스팅

rayfin up으로 배포하면 Fabric은 앱 아래에 하위 항목을 생성합니다. Fabric의 SQL 데이터베이스, Authentication, Static Content가 여기에 포함됩니다. 각 앱에는 https://<your-app>-app.rayfin.windows.net/ 형식의 백엔드 엔드포인트가 하나씩 있으며, 데이터용 /api/graphql 경로와 인증용 /auth 경로를 사용합니다.

문서에 나와 있는 그 밖의 기능으로는 레이크하우스, 웨어하우스, Fabric의 SQL 데이터베이스 또는 시맨틱 모델에 대한 형식이 지정된 커넥터와, 액세스 정책을 적용할 수 있는 형식이 지정된 파일 스토리지가 있습니다.

적합한 사용 사례

Microsoft는 빠른 프로토타이핑, 내부 도구 및 대시보드, Fabric 커넥터를 활용한 데이터 탐색, 지속적인 상태 저장이 필요한 AI 또는 에이전트 앱을 적합한 사례로 꼽습니다. 반면 복잡한 다단계 트랜잭션이나 저장 프로시저가 필요한 앱, 사용자 지정 인증 공급자가 필요한 앱은 적합하지 않을 수 있다고 설명합니다.

1단계: 테넌트 설정 사용하도록 설정

이 작업은 관리자가 수행해야 하며, 사용자가 항목을 만들기 전에 완료되어야 합니다.

  1. Fabric 관리 포털에 로그인합니다.
  2. 테넌트 설정을 엽니다.
  3. Fabric Apps(미리 보기)에서 토글을 사용으로 설정합니다.
  4. 전체 조직 또는 특정 보안 그룹을 선택합니다.
  5. 적용을 선택합니다.

변경 내용이 적용되기까지 몇 분 정도 걸릴 수 있습니다.

2단계: 작업 영역 준비

워크스페이스에 Fabric 용량이 할당되어 있어야 합니다. 워크스페이스를 만들 때 용량을 선택하십시오. 앱을 만들려면 워크스페이스에서 참가자(Contributor) 또는 관리자(Admin) 권한이 있어야 합니다. 로컬 작업을 하려면 Node.js 20 이상을 설치하십시오.

3단계: 앱 항목 만들기

  1. 왼쪽 탐색 창에서 워크스페이스를 선택하고 워크스페이스를 엽니다.
  2. 새 항목을 선택하고 App을 검색한 다음 선택합니다.
  3. 이름을 입력하고 만들기를 선택합니다.

그러면 포털에 프로젝트를 로컬로 다운로드하는 명령이 표시됩니다. 형식은 다음과 같습니다.

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

4단계: 개발 및 배포

프로젝트를 편집하거나 GitHub Copilot과 함께 작업한 다음, npm run dev로 Fabric 백엔드에 대해 테스트합니다. npx rayfin up으로 배포합니다. 다른 워크스페이스에 배포하려면 --workspace <workspacename>를 추가합니다. npx rayfin up status로 백엔드를 확인합니다.

FAQ의 예시 주석에는 npx rayfin up staticapp deploy로 정적 콘텐츠만 배포하면 초기 배포 후 30~60초가 걸린다고 나와 있습니다. 하지만 해당 페이지의 내용에는 최초 배포에 걸리는 시간에 대한 설명이 없습니다. 정적 전용 배포로는 초기 원격 앱을 만들 수 없으므로, 먼저 npx rayfin up을 한 번 실행하십시오. 롤백하려면 이전 git 커밋을 체크아웃한 후 npx rayfin up을 다시 실행합니다.

Fabric 포털에서 확인할 수 있는 내용

rayfin up을 실행하면 앱 항목 아래에 rayfin.yml 구성을 기반으로 Fabric이 생성한 하위 항목이 표시됩니다.

  • Fabric의 SQL 데이터베이스: 데코레이터의 스키마가 적용된 관리형 데이터베이스입니다. 포털에서는 읽기 전용이므로 스키마는 코드를 통해 변경하십시오.
  • 인증: Microsoft Entra ID를 통해 Fabric이 중개하는 로그인입니다. SQL 데이터베이스에서 인증된 사용자를 확인할 수 있습니다.
  • 정적 콘텐츠: 빌드된 프런트엔드 자산이며, 호스팅 URL에서 제공되고 배포할 때마다 업데이트됩니다. 개요에 따르면 정적 호스팅에는 Fabric 항목 액세스가 필요하거나 익명 액세스를 허용할 수 있습니다.

인증 및 권한

Learn 문서에서는 배포된 앱에는 Fabric SSO를, 로컬 개발에는 이메일과 암호를 사용한다고 설명합니다. 이메일과 암호 로그인은 배포 후에는 작동하지 않으며, 배포하려면 Fabric 인증이 사용하도록 설정되어 있어야 합니다.

항목 권한은 워크스페이스 역할과 별개입니다.

| 권한 | 허용 항목 | |---|---| | 실행 및 상호 작용 | 앱을 열고 사용하며 백엔드 API를 호출합니다. 모든 워크스페이스 멤버에게 기본으로 부여됩니다. | | 편집(쓰기) | 배포, 스키마 변경, 설정 업데이트, 하위 서비스 관리 | | 다시 공유 | 다른 사용자에게 액세스 권한을 부여합니다. 워크스페이스의 관리자 역할이 필요합니다. |

Fabric 관리자는 다른 사용자가 앱을 로드하지 못하도록 일시적으로 차단할 수 있습니다. 이때도 소유자는 앱을 열 수 있습니다.

보안의 일부는 여전히 사용자의 몫입니다. Microsoft는 비밀 정보를 코드와 프런트엔드 자산에 포함하지 말 것을 권장하며, 로그인한 사용자가 보고 수행할 수 있는 작업은 코드가 결정한다고 설명합니다.

먼저 확인해야 할 제한 사항

FAQ에는 현재 다음과 같은 제한 사항이 나와 있습니다.

  • 다대다 관계와 복합 기본 키를 지원하지 않습니다(모든 엔터티에는 id라는 이름의 단일 UUID 필드가 있어야 합니다).
  • 사용자 지정 인증 공급자를 지원하지 않습니다.
  • 기본으로 다중 환경 관리를 지원하지 않습니다.
  • 워크스페이스 아웃바운드 액세스 보호를 지원하지 않습니다.
  • 테넌트 수준 또는 워크스페이스 수준 프라이빗 링크를 지원하지 않습니다.
  • 애플리케이션 수명 주기 관리(ALM)를 지원하지 않습니다.
  • Fluent GraphQL 클라이언트에서는 count()를 사용할 수 없습니다.

데이터 모델은 데코레이터를 사용하여 TypeScript로 작성합니다.

자주 발생하는 문제

Microsoft는 빌드 오류의 가장 흔한 원인으로 프로덕션 빌드 누락을 꼽으므로, 먼저 npm run build를 실행하십시오. 용량 또는 권한 오류가 발생하면 워크스페이스에 용량이 있는지, 그리고 해당 워크스페이스에서 항목을 만들거나 변경할 수 있는지 확인하십시오. 스키마 오류가 발생하면 마지막으로 성공한 배포 이후의 변경 사항을 검토하십시오. 문제 해결 페이지에서는 앱 코드가 기준(source of truth)이라고 설명합니다. Fabric 포털이나 SQL 도구로 원격 스키마를 변경하지 마십시오. 기존 열을 제거하거나 변경하면 앱과 배포가 중단될 수 있습니다. 스키마 변경은 코드에서 수행하고 npx rayfin up db apply로 적용하십시오.

관련 자료

데이터 원본

FAQ

Fabric Apps는 정식 출시되었나요?

아니요. Microsoft Learn에서는 Fabric Apps를 미리 보기 기능으로 표시하고 있으며, 아직 모든 리전에서 사용할 수 있는 것은 아니라고 설명합니다. 이 글을 작성하면서 참고한 페이지에는 정식 출시 날짜가 나와 있지 않습니다.

Fabric 앱은 누가 만들 수 있나요?

Microsoft Learn에 따르면, Fabric 용량이 있는 Fabric 작업 영역에서 참여자 또는 관리자 권한이 필요하며, 테넌트 관리자가 Fabric Apps(미리 보기) 테넌트 설정을 사용하도록 설정해야 합니다. 로컬 개발에는 Node.js 20 이상이 필요합니다.

배포된 Fabric Apps는 어떤 로그인 방식을 지원하나요?

Microsoft Learn에 따르면 배포된 앱은 Microsoft Entra 單一 로그인인 Fabric SSO만 사용합니다. 이메일과 암호 로그인은 로컬 개발에서만 사용할 수 있으며, 인증을 사용하지 않도록 설정한 상태에서는 배포할 수 없습니다.

Fabric 앱에서 기존 데이터베이스를 사용할 수 있나요?

아니요. Microsoft Learn FAQ에 따르면 Fabric Apps는 TypeScript 모델을 기준으로 스키마를 관리하며, 미리 정의된 스키마를 가진 데이터베이스를 연결할 수는 없습니다. Fabric의 기존 레이크하우스, 웨어하우스 또는 SQL 데이터베이스에 접근하려면 커넥터를 추가해야 합니다.

Microsoft 문서에 Fabric Apps의 가격이 설명되어 있나요?

아니요. 참고한 페이지에는 가격 정보가 없습니다. 개요에서는 작업 영역에 Fabric 용량이 필요하며 Fabric Apps 서비스가 해당 용량의 용량 단위를 사용한다고만 설명합니다. FAQ에서는 성능이 Fabric 용량에 따라 달라진다고 안내합니다.

Entities in this article

이 글의 주제:

Microsoft Fabric Apps – Microsoft의 분석 및 BI 도구 Microsoft Fabric – Microsoft의 분석 및 BI 도구 Fabric capacity – 개념 Fabric tenant settings – 개념

Related articles

Microsoft Fabric에 관한 다른 글:

RSS