大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:Azure Blob

· 52CE 我爱测

默认情况下,如果未配置 ,Doris 会使用操作系统默认的 CA 证书。在大多数环境中,不需要手动设置该参数。建议在以下场景中显式配置:

自 3.1.3 版本起,Doris 支持访问 Azure Blob 存储。

本文档介绍访问 Microsoft Azure Blob 存储所需的参数,这些参数适用于以下场景:

  • Catalog 属性
  • Table Valued Function 属性
  • Broker Load 属性
  • Export 属性
  • Outfile 属性
  • Backup / Restore 属性

Azure Blob 存储目前不支持 ARM 架构。

配置 BE 端 HTTPS CA 证书

自 Doris 3.1.5 和 4.0.5 起,当 Doris BE 通过 HTTPS 访问 Azure Blob Storage 时,可以在 be.conf 中显式配置 ca_cert_file_paths。

默认情况下,如果未配置 ca_cert_file_paths,Doris 会使用操作系统默认的 CA 证书。在大多数环境中,不需要手动设置该参数。建议在以下场景中显式配置:

  • BE 节点未安装系统 CA 证书,或系统 CA 证书包版本过旧。
  • BE 节点运行在精简容器或镜像中,未包含 ca-certificates 包。
  • BE 节点上的默认 CA 文件路径无效,或 Doris 进程没有该 CA 文件的读取权限。
  • 环境中使用了自签名证书、私有 CA,或者会重签 TLS 流量的企业代理或网关。
  • 访问 Azure Blob Storage 时出现 Problem with the SSL CA cert 或 curl 77: Problem with the SSL CA cert (path? access rights?) 等错误。

对于不支持 ca_cert_file_paths 的版本: ca_cert_file_paths 参数自 Doris 3.1.5 和 4.0.5 起可用。如果你使用的是更早的版本并遇到 SSL CA 证书错误,需要确保系统 CA 证书已正确安装,并且 CA 证书包位于 /etc/ssl/certs/ca-certificates.crt:

  • RHEL / CentOS / RockyLinux:
    yum install -y ca-certificates
    update-ca-trust
    ln -s /etc/pki/ca-trust/extracted/openssl/ca-bundle.trust.crt /etc/ssl/certs/ca-certificates.crt
    
  • Debian / Ubuntu: apt-get install -y ca-certificates

然后重启所有 BE 节点。更多证书相关问题,请参阅 数据湖 FAQ - 证书问题。

示例:

# be.conf
ca_cert_file_paths = /etc/ssl/certs/ca-certificates.crt

常见的系统 CA 文件路径包括:

  • Debian / Ubuntu:/etc/ssl/certs/ca-certificates.crt
  • CentOS / RockyLinux:/etc/pki/ca-trust/extracted/openssl/ca-bundle.trust.crt

需要在所有可能访问 Azure Blob Storage 的 BE 节点上配置该参数,并确保 Doris 进程对证书文件有读取权限。修改 be.conf 后,需要重启对应的 BE 节点使配置生效。

参数总览

属性名称 曾用名 描述 默认值 是否必须
azure.account_name Azure 存储账户名称(Account Name),即在 Azure 门户中创建的存储账户名称。 是
azure.account_key Azure Blob 存储的 Account Key 是
azure.endpoint Azure Blob 存储的访问端点,格式通常为 https://<account_name>.blob.core.windows.net 是
fs.azure.support 是否启用 Azure Blob 存储 true 是
  • 启用 Azure Blob 存储

    必须显示的配置 "provider" = "AZURE" 或 "fs.azure.support" = "true" 以表明启用 Azure Blob 存储。

  • 获取 azure.account_name

    1. 登录 Azure 门户
    2. 打开 存储帐户 (Storage Accounts),选择目标账户
    3. 在 概述 (Overview) 页面可看到 存储帐户名称 (Account Name)
    "azure.account_name" = "myblobstorage"
    
  • 获取 azure.account_key

    1. 登录 Azure 门户
    2. 打开 存储帐户 (Storage Accounts),选择目标账户
    3. 在左侧导航栏选择 访问密钥 (Access keys)
    4. 在 key1 或 key2 中点击「显示密钥」,复制 Key 值
    "azure.account_key" = "EXAMPLE_I_A...=="
    

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。