Azure 基础：File Storage

Azure Storage 是微软 Azure 云提供的云端存储解决方案，当前支持的存储类型有 Blob、Queue、File 和 Table。

笔者在前文中介绍了 Blob Storage 的基本用法，本文将介绍 File Storage 的主要使用方法。

File Storage 是什么？

Azure File Storage 是一个经过 Server Message Block (SMB) 协议提供云端文件共享的服务。经过 File Storage 共享的文件可以被加载为云端或本地主机的磁盘，应用程序能够经过文件 API 像访问本地文件同样访问这些文件。

下面是 File Storage 典型的应用场景：
1.    轻松迁移那些有磁盘读写操做的应用到云端。不用修改程序，只要经过 File Storage 加载相应的文件便可。
2.    存放共享的应用程序配置文件。
3.    存放日志等应用程序诊断数据。
4.    存放管理员的经常使用工具。

Azure File Storage的结构

下图描述了 File Storage 的基本组织结构：

Azure Storage Account:

Storage Account 是用来管理 Azure Storage 的一个命名空间，主要用来控制存储数据的访问权限和计费。对 Blob、Queue、File 和 Table 这些 Azure 提供的存储服务的访问控制都是经过 Storage Account 来进行的，因此要想使用 File Storage，须要先建立你的 Storage Account。

Share:

Share 是管理共享文件的单位，任何要共享的文件和目录都必须属于某个 Share。一个 Storage Account 下的 Share 数量是不受限制的，每一个 Share 中能够存听任何数量的文件。可是每一个 Share 中最多能存放 5TB 的数据。

Directory:

与 Blob Storage 不一样，File Storage 支持真正的文件目录。你能够根据须要来建立目录。

File:

File 是真正被共享的文件，每一个文件最大 1TB。

URL format:

与 Blob Storage 类似，File Storage 中的每一个文件均可以经过 URL 来访问。URL 的详细格式为：

https://<storage account>.file.core.windows.net/<share>/<directory/directories>/<filename>

下面是个更真实的例子：

https://nickdemo.file.core.windows.net/demofiles/temp.txt

若是您还不熟悉 Azure Storage Account 的使用，以及如何经过 WindowsAzure.Storage 库访问 Azure Storage，请参考前文《Azure Table storage 基本用法》中的介绍，这里就不重复了。

为了方便查看 C# 代码执行的结果，本文使用了 MS 发布的一个 Azure Storage 客户端工具：Microsoft Azure Storage Explorer，文中简称为 Storage Explorer。下面是 File Storage 的一个截图：

接下来咱们经过 C# 代码来介绍如何操做 File Storage。

建立 File Share

第一步咱们先建立名为 "mylogs" 的 Share：

// CloudStorageAccount 类表示一个 Azure Storage Account，咱们须要先建立它的实例，才能访问属于它的资源。
// 注意链接字符串中的xxx和yyy，分别对应Access keys中的Storage account name 和 key。
CloudStorageAccount storageAccount = CloudStorageAccount.Parse("DefaultEndpointsProtocol=https;AccountName=xxx;AccountKey=yyy");

// CloudFileClient 类是 Windows Azure File Service 客户端的逻辑表示，咱们须要使用它来配置和执行对 File Storage 的操做。
CloudFileClient fileClient = storageAccount.CreateCloudFileClient();
// CloudFileShare 表示一个 File Share 对象。
CloudFileShare share = fileClient.GetShareReference(shareName);
// 若是不存在就建立 File Share。
share.CreateIfNotExists();

运行上面的代码，而后打开 Storage Explorer，看到名为 "mylogs" 的 Share 已经建立了：

上传文件

File Storage 支持真正的文件目录。因此在上传文件前须要肯定要把文件上传到哪一个目录下。每个 File Share 都有一个根目录，咱们能够先取到这个根目录，而后再建立子目录或是直接上传文件。下面的代码会在根目录下建立一个叫 "web" 的子目录，而后上传文件 web.log 到 web 目录中：

// 得到根目录的引用。
CloudFileDirectory rootDir = share.GetRootDirectoryReference();
// 建立子目录 "web" 的引用。
CloudFileDirectory webDir = rootDir.GetDirectoryReference("web");
// 建立子目录 "web"。
webDir.CreateIfNotExists();
// 建立文件 "web.log" 的引用。
CloudFile cloudFile = webDir.GetFileReference("web.log");
string localFile = @"F:\temp\web.log";

using (var fileStream = System.IO.File.OpenRead(localFile))
{
    //上传文件。
    cloudFile.UploadFromStream(fileStream);
}

在 Storage Explorer 中检查下结果：

复制文件

Azure Storage 支持在 Blob Storage 和 File Storage 之间相互复制文件，但这样的操做涉及的访问权限管理相对复杂一些。本文仅介绍文件在同一个 File Storage 中的复制操做。下面的代码复制 web.log 文件并建立 web.copy.log 文件：

CloudFileShare share = GetFileShare(_currentShareName);
CloudFileDirectory rootDir = share.GetRootDirectoryReference();
CloudFileDirectory webDir = rootDir.GetDirectoryReference("web");

CloudFile cloudFile = webDir.GetFileReference("web.log");
if (cloudFile.Exists())
{
    //由 web.log 文件建立 web.copy.log 文件。
    CloudFile copyFile = webDir.GetFileReference("web.copy.log");
    copyFile.StartCopy(cloudFile);
}

查看复制操做的结果：

设置 Share 的最大容量

前面咱们提到每一个 Share 中最多能存放 5TB 的数据。但有时可能须要限制一下它的最大值，好比最多只能存放 1TB 的数据：

// 指定最大容量为 1024, 单位是 GB。
share.Properties.Quota = 1024;
share.SetProperties();

代码很简单，若是想要查看 Share 的最大容量是多少，直接取 share.Properties.Quota 属性的值就能够了。

如今咱们在云端有一个 1TB 大小的共享目录，如何利用一下呢？

把 Share 映射为本地机器的网络硬盘

用管理员权限启动 cmd.exe，执行下面的命令：

cmdkey /add:<storage-account-name>.file.core.windows.net /user:<storage-account-name> /pass:<storage-account-key>
net use z: \\<storage-account-name>.file.core.windows.net\mylogs

注意，请把上面命令中的 < storage-account-name > 和 < storage-account-key >进行替换。
再用非管理员权限启动 cmd.exe，再执行一次net use 命令：

net use z: \\<storage-account-name>.file.core.windows.net\mylogs

若是不第二次执行 net use 命令，资源管理器中是看不到驱动器盘符的：

注意：必定要在防火墙 Outbound 规则中放行 SMB 协议使用的 TCP 445 端口。

这就搞定了！乍一看仍是蛮有逼格的，至于能不能玩的爽就看您的网速给不给力了。

总结

虽然咱们看到 File Storage 和前文中介绍的 Blob Storage 存在着不少类似的地方，但本质上它们是不同的。Blob Storage 本质上是一个个网络上的文件，而 File Storage 则是经过 SMB 协议实现的网络共享文件，可以被操做系统映射成本地的磁盘是其最大特征。也只有这一点才能让应用程序经过文件操做 API 完成对远程文件的访问。