Azure Storage 系列（五）通過Azure.Cosmos.Table 類庫在.Net 上使用 Table Storage

一，引言

　　上一篇文章我們在.NET 專案中新增了 “WindowsAzure.Storage” 的 NuGet 包進行操作Table 資料，但是使用的 “WindowsAzure.Storage”  NeGet 以及沒微遺棄了，所以我們今天繼續講 Azure Table Storage，使用新的 Nuget  包--- “Microsoft.Azure.Cosmos.Table” 來操作 Table 資料。

nuget 連結：https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Table

我們可以看到 當前neget 包 允許使用 Microsoft Azure CosmosDB 表 API 以及 Azure 表儲存。

--------------------我是分割線--------------------

Azure Storage 儲存系列：

1，Azure Storage 系列（一）入門簡介

2，Azure Storage 系列（二） .NET Core Web 專案中操作 Blob 儲存

3，Azure Storage 系列（三）Blob 引數設定說明

4，Azure Storage 系列（四）在.Net 上使用Table Storage 

5，Azure Storage 系列（五）通過Azure.Cosmos.Table 類庫在.Net 上使用 Table Storage  

二，正文

1，安裝 “Microsoft.Azure.Cosmos.Table” 的 NuGet

 

 使用程式包管理控制檯進行安裝

Install-Package Microsoft.Azure.Cosmos.Table -Version 1.0.8

2，建立ITableServiceV2 介面，和 TableServiceV2 實現類，控制器方法等

　　因為使用的 “Microsoft.Azure.Cosmos.Table” 的Nuget 和 “WindowsAzure.Storage” Nuget 中對 Table Storage 的操作中使用的方法，以及類都是一樣的，只是名稱空間不一樣，所以程式碼上差別不太大。所以大家可以看一下具體程式碼和已遺棄的方法進行對比。

完整程式碼：

public interface ITableServiceV2
    {
        /// <summary>
        /// AddEntity(abandoned)
        /// </summary>
        /// <param name="user">user</param>
        /// <returns></returns>
        Task AddEntity(UserInfoV2 user);

        /// <summary>
        /// BatchAddEntities(abandoned)
        /// </summary>
        /// <param name="users">users</param>
        /// <returns></returns>
        Task BatchAddEntities(List<UserInfoV2> users);

        /// <summary>
        /// QueryUsers(abandoned)
        /// </summary>
        /// <param name="filter">filter</param>
        /// <returns></returns>
        IEnumerable<UserInfoV2> QueryUsers(string filter);

        /// <summary>
        /// UpdateEntity(abandoned)
        /// </summary>
        /// <param name="user">user</param>
        /// <returns></returns>
        Task UpdateEntity(UserInfoV2 user);

        /// <summary>
        /// DeleteEntity(abandoned)
        /// </summary>
        /// <param name="user">user</param>
        /// <returns></returns>
        Task DeleteEntity(UserInfoV2 user);

        /// <summary>
        /// DeleteTable(abandoned)
        /// </summary>
        /// <param name="tableName">tableName</param>
        /// <returns></returns>
        Task DeleteTable(string tableName);
    }

public class TableServiceV2 : ITableServiceV2
    {
        private readonly CloudStorageAccount _cloudStorageClient;
        public TableServiceV2(CloudStorageAccount cloudStorageClient)
        {
            _cloudStorageClient = cloudStorageClient;
        }

        #region 01，新增表資料+async Task AddEntity(UserInfo user)
        /// <summary>
        /// 新增表資料
        /// </summary>
        /// <param name="user">使用者資料</param>
        /// <returns></returns>
        public async Task AddEntity(UserInfoV2 user)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");
            await cloudTable.CreateIfNotExistsAsync();

            var tableOperation = TableOperation.Insert(user);
            await cloudTable.ExecuteAsync(tableOperation);
        } 
        #endregion

        public async Task BatchAddEntities(List<UserInfoV2> users)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");
            await cloudTable.CreateIfNotExistsAsync();

            var tableBatchOperation = new TableBatchOperation();
            foreach (UserInfoV2 item in users)
            {
                tableBatchOperation.Insert(item);
            }

            await cloudTable.ExecuteBatchAsync(tableBatchOperation);
        }

        public async Task DeleteEntity(UserInfoV2 user)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");

            var queryOperation = TableOperation.Retrieve<UserInfoV2>(user.PartitionKey, user.RowKey);

            var tableResult = await cloudTable.ExecuteAsync(queryOperation);
            if (tableResult.Result is UserInfoV2 userInfo)
            {
                var deleteOperation = TableOperation.Delete(userInfo);
                await cloudTable.ExecuteAsync(deleteOperation);
            }
        }

        public async Task DeleteTable(string tableName)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference(tableName);
            await cloudTable.DeleteIfExistsAsync();
        }

        public IEnumerable<UserInfoV2> QueryUsers(string filter)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");

            TableQuery<UserInfoV2> query = new TableQuery<UserInfoV2>().Where(filter);

            var users = cloudTable.ExecuteQuery(query);
            foreach (var item in users)
            {
                yield return item;
            }
        }

        public async Task UpdateEntity(UserInfoV2 user)
        {
            var cloudTableClient = _cloudStorageClient.CreateCloudTableClient();
            var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");

            var queryOperation = TableOperation.Retrieve<UserInfoV2>(user.PartitionKey, user.RowKey);

            var tableResult = await cloudTable.ExecuteAsync(queryOperation);
            if (tableResult.Result is UserInfoV2 userInfo)
            {
                user.ETag = userInfo.ETag;
                var deleteOperation = TableOperation.Replace(user);
                await cloudTable.ExecuteAsync(deleteOperation);
            }
        }
    }

[Route("TableV2")]
    public class TableExplorerV2Controller : Controller
    {
        private readonly ITableServiceV2 _tableService;

        public TableExplorerV2Controller(ITableServiceV2 tableService)
        {
            this._tableService = tableService;
        }

        [HttpPost("AddUser")]
        public async Task<ActionResult> AddEntity([FromBody] UserInfoV2 user)
        {
            await _tableService.AddEntity(new UserInfoV2("huge", "610124199012221000") { Email = "huge@qq.com", TelNum = "13000000000" });
            return Ok();
        }

        [HttpPost("AddBatchUser")]
        public async Task<ActionResult> AddEntities([FromBody] List<UserInfoV2> users)
        {
            List<UserInfoV2> userList = new List<UserInfoV2>();
            userList.Add(new UserInfoV2("wangwei", "610124199012221001") { Email = "wangwei@qq.com", TelNum = "13000000001" });
            userList.Add(new UserInfoV2("wangwei", "610124199012221002") { Email = "wangwei@qq.com", TelNum = "13000000002" });
            userList.Add(new UserInfoV2("wangwei", "610124199012221003") { Email = "wangwei@qq.com", TelNum = "13000000003" });
            await _tableService.BatchAddEntities(userList);
            return Ok();
        }

        [HttpGet("Users")]
        public ActionResult QueryUsers()
        {
            var filter = TableQuery.CombineFilters(TableQuery.GenerateFilterCondition("PartitionKey", QueryComparisons.Equal, "wangwei"), TableOperators.And, TableQuery.GenerateFilterCondition("RowKey", QueryComparisons.Equal, "610124199012221001"));

            return Ok(_tableService.QueryUsers(filter));
        }

        [HttpPut("UpdateUser")]
        public async Task<ActionResult> UpdateUser([FromBody] UserInfoV2 user)
        {
            await _tableService.UpdateEntity(new UserInfoV2("huge", "610124199012221000") { Email = "huge@163.com", TelNum = "15000000000" });
            return Ok();
        }

        [HttpDelete("DeleteEntity")]
        public async Task<ActionResult> DeleteEntity([FromBody] UserInfoV2 user)
        {
            await _tableService.DeleteEntity(new UserInfoV2("wangwei", "610124199012221003"));
            return Ok();
        }

        [HttpDelete("{tableName}")]
        public async Task<ActionResult> DeleteTable(string tableName)
        {
            await _tableService.DeleteTable(tableName);
            return Ok();
        }
    }

3，新增對 TableServiceV2 ,CloudStorageAccount 的注入

services.AddSingleton(x => new Microsoft.Azure.Cosmos.Table.CloudStorageAccount(new Microsoft.Azure.Cosmos.Table.StorageCredentials("cnbateblogaccount", "FU01h022mn1JjONp+ta0DAXOO7ThK3diYhd4xrm0Hpg891n9nycsTLGZXXXXnJpGvTIZvO5VCVFhGOfV0wndOOQ=="), true));
services.AddSingleton<ITableServiceV2, TableServiceV2>();

4，測試使用新的 Nuget 包中的方法是否能正常操作 Table 表資料

新增使用者資料，我們在 postman 中呼叫新增使用者表資料介面

 我們可以看到，在Azure Portal 上已經建立出一個叫 “USERINFOV2” 的表資訊（注意，大家不要疑惑，可以看看上面新增使用者的Service方法，我這裡有兩行程式碼）

var cloudTable = cloudTableClient.GetTableReference("USERINFOV2");
await cloudTable.CreateIfNotExistsAsync();

接下來我們在Cloud Explorer 檢視 “USERINFOV2” Table 的表資訊

 查詢使用者資料，我這裡還是使用兩個查詢條件聯合進行查詢，分別是 “PartitionKey” 和 “RowKey” 作為查詢的 Key，通過 “Partition” 等於 “wangwei” 和 “RowKey” 等於 “610124199012221001” 

 注意（我提前已經將呼叫了批量新增使用者的介面，將 PartitionKey 等於 "wangwu" 的三條資料新增到 Table 中了）

 

 

 OK，剩餘的更新，刪除就不再演示了，大家可以自行進行校驗，今天的分享內容到此結束。

三，結尾

github：https://github.com/yunqian44/Azure.Storage.git

作者：Allen 

版權：轉載請在文章明顯位置註明作者及出處。如發現錯誤，歡迎批評指正。