如何通过Azure函数输出绑定实现日志文件内容追加而非覆盖

问题根因 #

你当前使用的默认Blob输出绑定为块Blob覆盖写模式，每次函数触发时输出绑定都会初始化一个空流，最终提交时会用本次写入的内容完全替换原有Blob，因此即便你对Stream做偏移处理也无法实现追加效果。

解决方案：使用追加Blob（AppendBlob）类型的输出绑定 #

Azure Blob存储专门提供了追加Blob类型适配日志类追加写入场景，Azure Functions的Blob输出绑定原生支持该类型，无需自行处理流偏移或内容拼接。

第一步：修改绑定配置 #

给logBlob的绑定配置新增"blobType": "AppendBlob"属性，明确指定该Blob为追加类型：

{
  "bindings": [
    {
      "name": "myBlob",
      "path": "images/{name}.{extension}",
      "connection": "AzureWebJobsStorage",
      "direction": "in",
      "type": "blobTrigger"
    },
    {
      "name": "outputBlob",
      "direction": "out",
      "type": "blob",
      "path": "files/{name}-copy.txt",
      "connection": "AzureWebJobsStorage"
    },
    {
      "name": "logBlob",
      "path": "logs/uploadlog.txt",
      "connection": "AzureWebJobsStorage",
      "direction": "out",
      "type": "blob",
      "blobType": "AppendBlob"
    }
  ]
}

第二步：修改函数代码 #

将原来的Stream logBlob参数改为CloudAppendBlob logBlob，直接调用对应的追加写入方法即可：

using System.Text;
using System.IO;
using Microsoft.WindowsAzure.Storage.Blob;

public static void Run(Stream myBlob, string name, string extension, Stream outputBlob, CloudAppendBlob logBlob, ILogger log)
{
    log.LogInformation($"C# Blob trigger function Processed text file blob\n Name:{name} \n Size: {myBlob.Length} Bytes");
 
    string details = "A file has been uploaded called : " + name + "." + extension;
    // 新增时间戳和换行符方便日志查看，可根据需求调整格式
    string logitem= DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm:ss") + " The following file was uploaded: " + name + Environment.NewLine;

    // 原有生成单独信息文件的逻辑保持不变
    outputBlob.Write(Encoding.ASCII.GetBytes(details),0,details.Length); 

    // 自动处理Blob不存在时初始化、已有内容追加的逻辑
    logBlob.AppendTextAsync(logitem).Wait();
}

注意事项 #

• 追加Blob天然支持并发写入，多个函数实例同时触发时也不会出现内容覆盖，非常适合日志场景
• 如果你使用的是.NET Isolated模式的函数，只需将参数替换为Azure.Storage.Blobs.Specialized.AppendBlobClient类型，调用AppendTextAsync方法逻辑一致

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