Fabric 應用程式透過提供現成的驗證、資料持久化及靜態主機架構,幫助您更快建置並交付後端服務。 這個快速入門指南教你如何在 Fabric 上建立你的第一個應用程式。
先決條件
- 可存取 Fabric 或具有 Power BI Pro 授權的 Microsoft 帳戶。
- 一個您擁有貢獻者或管理員權限的工作空間。
- Node.js 最新版本
從無到成為一個運行中的應用程式
建立並執行一個包含四個指令的 Fabric 應用程式。 Rayfin 會把你的後端部署到 Microsoft Fabric,然後你在本地針對它執行前端。 你不會在本地執行後端。
npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev
執行 npx rayfin up status 以確認後端部署。
讓代理人來建立應用程式
請將以下提示複製到 GitHub Copilot 或其他有存取終端機權限的程式代理程式中:
Set up a new Rayfin app for me, end to end.
Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.
Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.
在部署應用程式前,先檢查產生的檔案和指令輸出。
從入口網站建立應用程式
開啟適用於您授權選項的入口網站並登入:
- 若要體驗 Power BI Pro,請使用具有 Power BI Pro 的帳戶開啟 Power BI 入口網站。
- 若要使用容量備份應用程式,請開啟 Fabric 入口網站。
選取工作區
選擇您擁有貢獻者或管理員權限的工作區。 若要使用 Power BI Pro 體驗,請使用 Pro 工作區;若要使用由容量支援的應用程式,請使用已指派給 Fabric 容量的工作區,或使用啟用中的 Fabric 試用版。
如果您沒有現有的工作區,請建立一個:
- 在左側導覽中選擇 工作區 。
- 選擇 新工作區。
- 輸入工作區的名稱。
- 為您的部署選擇工作空間授權模式:選擇 Pro 以享受 Power BI Pro 體驗,或為容量支援應用程式選擇適當的容量選項。
Pro 選項不需要指定 Fabric 容量。 在建立應用程式前,請先查看 Power BI Pro 的限制。 對於任一選項,請繼續執行以下應用程式建立步驟。
建立一個新的 Fabric 應用程式
- 在工作區檢視中,選擇 新項目。
- 在物品類型列表中搜尋 「App 」或捲動尋找。
- 選擇 應用程式 項目以開啟建立對話框。
- 輸入你的Fabric應用程式名稱(例如
my-rayfin-app)。 - 選取 ,創建。
開啟、編輯並部署你的應用程式
你可以用 Rayfin CLI 在本地開發。
開啟你選擇的終端機。
請使用入口網站中顯示的 CLI 指令腳本,並在終端機執行,本地下載應用程式。
範例
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>去專案目錄看看。
cd <your project directory>您可以直接編輯程式碼,或在 GitHub Copilot 的協助下自訂您的應用程式。
用 Fabric 後端的指令測試本地變更。
npm run dev發佈你的變更時,請用以下方式:
npx rayfin up要部署到另一個工作區,你可以提供參數
--workspace。npx rayfin up --workspace <workspacename>要在這兩個工作區間切換,執行
npx rayfin switch --workspace <workspace>。
下一步
- 探索 資料模型與裝飾工具 ,定義你的後端架構。
- 學習如何用 GraphQL 指南連接前端。
- 使用 Authentication 設定驗證。