如何在Azure Storage Data Lake Gen2中添加索引标签？

针对层级命名空间的ADLS Gen2账户，确实无法通过Blob API添加标签，得用DataLake客户端原生的标签操作方法。下面是两种可行的实现方式：

方式一：上传文件后添加标签 #

直接在上传完成后调用SetTagsAsync方法为文件设置可索引的标签：

private async Task UploadFileWithTags(DataLakeDirectoryClient directory, string fileName, Stream content)
{
    DataLakeFileClient file = directory.GetFileClient(fileName);
    await file.UploadAsync(content);
    
    // 设置索引标签（键值对形式）
    var tags = new Dictionary<string, string>
    {
        { "Department", "Finance" },
        { "FileCategory", "Report" },
        { "Year", "2024" }
    };
    await file.SetTagsAsync(tags);
    
    PathProperties properties = file.GetProperties();
}

方式二：上传时直接指定标签 #

也可以在上传阶段通过UploadOptions直接传入标签，一步完成上传和标签设置：

private async Task UploadFileWithTagsOnUpload(DataLakeDirectoryClient directory, string fileName, Stream content)
{
    DataLakeFileClient file = directory.GetFileClient(fileName);
    
    // 构造上传选项，包含标签
    var uploadOptions = new DataLakeFileUploadOptions
    {
        Tags = new Dictionary<string, string>
        {
            { "Department", "HR" },
            { "FileCategory", "EmployeeData" }
        }
    };
    
    await file.UploadAsync(content, uploadOptions);
    PathProperties properties = file.GetProperties();
}

注意事项 #

• 标签是Azure存储专为快速查询设计的可索引元数据，和普通元数据不同，支持通过FindFilesByTags等方法高效检索文件。
• 标签的键值对需符合Azure存储的规则：键不能超过128字符，值不能超过256字符，且不区分大小写。

内容的提问来源于stack exchange，提问作者CloudAnywhere