[13]---Grain State狀態資料使用SQL Server資料庫儲存(ADO.NET) - iT 邦幫忙::一起幫忙解決難題，拯救 IT 人的一天

建立資料庫資料表以便儲存Grain State

官方提供的SQL script指令檔分為兩類，在 Main 的是用於建立基礎資料表/Store Procedure，在 Persistance 是建立用於Grain State Persistance，儲存Grain State狀態資料表相關的。

目前 Orleans 3.x對於MS-SQL Server的系統需求是 SQL Server 2012 以上，詳情可以直接看官方Github的原始檔內容註釋：
https://github.com/dotnet/orleans/blob/3.x/src/AdoNet/Shared/SQLServer-Main.sql#L29 ：

建立LocalDB資料庫的步驟如下：

以 SQL Server Management Studio (SSMS) 連線到LocalDB的SQL Server資料庫，並建立一個新的資料庫，例如：OrleansDemo
SSMS可以使用winget的指令列方式安裝：

winget install --id  Microsoft.SQLServerManagementStudio
下載 官方提供SQL script的 Main scripts：選SQL Server的script檔（SQLServer-Main.sql），並執行，以建立基礎Orleans指令動作資料表(dbo.OrleansQuery)：

注意：此script在執行時會需要沒有其他正在連線操作資料的情況，建議先確定沒有其他人/程式正在存取該資料庫，再執行此script。
下載 官方提供SQL script的 Persistance：選SQL Server的script檔（SQLServer-Persistence.sql），並執行，以建立儲存Orleans Grain State用資料表(dbo.OrleansStorage)：

使用ADO.NET Storage Provider儲存Grain State
在前天進度的原始碼git專案，將 Microsoft.Orleans.Persistence.AdoNet 和 System.Data.SqlClient 這兩個Nuget套件安裝到 src/Hosting/Server 路徑下的 RpcDemo.Hosting.AspNetCoreWebApi 專案，並將原本安裝的 Microsoft.Orleans.Persistence.AzureStorage 套件移除。
將RpcDemo.Hosting.AspNetCoreWebApi 專案中的Program.cs檔案內容修改如下：
using Orleans.Hosting;
var builder = WebApplication.CreateBuilder(args);
// Add Orleans co-hosting
builder.Host.UseOrleans(siloBuilder =>
   siloBuilder.UseLocalhostClustering();
   siloBuilder.AddAdoNetGrainStorage("demo_counters", 
   options =>
      options.Invariant = "System.Data.SqlClient";
      options.ConnectionString = "Server=(localdb)\\mssqllocaldb;Database=OrleansDemo;Trusted_Connection=True;";
      options.UseJsonFormat = true;
 other builder & app code...
在呼叫 AddAdoNetGrainStorage() 設定 AdoNetGrainStorageOptions 型別的 options => { ... } Lambda表示式中，Invariant要對應填入官網說明指定的 ADO.NET invariant ，所以就填入 System.Data.SqlClient。

然後就可以跟先前使用Azure Table/Blob Storage的版本一樣跑起來，使用WebAPI專案的Swagger UI來測試Grain State的讀寫。
Azure雲端有使用AzureAD或受控識別(Managed Identity)的SQL Server設定
當需要使用Azure雲端有Azure AD驗證或『受控識別(Managed Identity)』權限保護的SQL Server資料庫時，Silo專案還需多安裝 Azure.Identity Nuget套件，並且 在 AddAdoNetGrainStorage() 擴充方法中AdoNetGrainStorageOptions 型別的option設定，其連線字串格式要改成如下：
options.ConnectionString = "Server=tcp:<my-sql-server>.database.windows.net;Authentication=Active Directory Default; Database=<target-database-name>;"
將上述的 <my-sql-server>.database.windows.net 和 <target-database-name> 替換成Azure雲端SQL Server的URL位址和目的資料庫，其中 Authentication=Active Directory Default 代表使用AzureAD驗證，這個在地端執行時，SQL資料庫連線會使用當時該執行者的Azure AD User權限，而部署上Azure雲端環境之後會自動使用在部署端設定好的受控識別(Managed Identity)身份來驗證。
今天講述的都是Windows Only環境，有點不公平，而且原本 .NET 6上使用Orleans就是跨Windows/macOS/Linux這三種OS的，明天繼續介紹如何使用ADO.NET Storage Provider在另一個跨平台的開源PostgreSQL資料庫來儲存Grain State。