管理流體容器

容器是 Azure 流體轉送服務中不可部分完成的儲存體單位,並代表從流體工作階段儲存的資料,包括作業和快照集。 當使用者第一次加入或離開後重新加入時,流體執行階段會使用容器來解除凍結流體工作階段的狀態。

使用流體架構建置應用程式時,您必須考慮有關容器建立和管理的幾點事項,如下圖摘要所示。

Illustration of the architecture of a Fluid service and what parts are owned by developers vs Microsoft.

重要概念

容器權限

在大部分情況下,開發人員會想管理容器詳細目錄和容器權限。 這包括有權存取容器的對象,以及容器自訂名稱等中繼資料的相關資訊。

存取容器

容器會以容器識別碼來參考。 在與 Azure 流體轉送服務通訊時,流體執行階段將使用 JWT,使用者必須先要求此 JWT 才能建立或開啟容器。 任何具有有效 JWT 的流程都可以存取容器。 開發人員必須負責產生用於容器存取的 JWT,這可讓他們控制商務邏輯,從而根據案例適當地控制存取權限。 Azure 流體轉送服務不會知道哪些使用者可以存取容器。 如需本主題的詳細資訊,請參閱 Azure 流體轉送權杖合約

注意

JWT 欄位 documentID 對應至流體容器識別碼。

容器命名

在建立容器時,容器會由 Azure 流體轉送服務命名。 [建立] 動作會以 GUID 形式傳回容器名稱,而稍後必須使用該 GUID 開啟容器。 在大部分情況下,開發人員會想在自己的資料存放區中儲存此容器識別碼 GUID 以及自訂名稱,以便促進容器探索流程。

容器探索

開發人員負責與使用者探索現有容器相關的任何體驗和商務邏輯。 這可能採用基於下列所述可瀏覽容器清單的形式:使用者參與流體工作階段、在使用者之間直接共用容器,或以程式設計方式將容器指派給現有成品或流程。

範例容器建立流程

A diagram describing the container creation process data flows

在此範例中,應用程式/頁面會以一般 JWT (未繫結至特定容器) 載入,用戶端應用程式在建立新容器時會使用此 JWT。

用戶端應用程式使用流體架構 API 在 Azure 流體轉送服務中建立新容器,從而產生具有新指派容器識別碼的容器物件。 若要與容器進一步互動,則需要包含容器識別碼的新 JWT。

用戶端建立新容器之後,會將容器識別碼儲存在某個對應容器和使用者的系統中,以便管理權限。 此系統會驅動開發人員想要為使用者建立的任何容器探索/瀏覽體驗。

在與容器互動之前,用戶端會要求容器特定的 JWT,用於從流體架構執行階段至 Azure 流體轉送服務的後續呼叫。

匯出容器內容

如果應用程式儲存終端使用者可能須匯出的資料,則應用程式開發人員會負責使用容器中定義的分散式資料結構所代表的流體容器目前狀態,在應用程式中建置該匯出功能。 如需連線及開啟流體容器的詳細資訊,請參閱:容器 (fluidframework.com)。 如需使用控制平面 API 列出及刪除容器的詳細資訊,請參閱:在 Microsoft Azure 流體轉送伺服器中刪除流體容器

另請參閱