Azure Synapse Notebook读取ADLS Gen2中config.ini文件失败求助

核心原因 #

configparser的read()方法默认只支持本地文件系统路径，没法直接解析ADLS Gen2的abfss://或HTTPS远程路径——哪怕权限、路径都没问题，也会因为加载不了文件内容，导致返回空配置节。

解决方案 #

方法1：先读文件内容到内存再解析 #

用Azure存储SDK把config.ini内容读到内存，再传给configparser处理：

from azure.storage.filedatalake import DataLakeServiceClient
import configparser
from azure.identity import DefaultAzureCredential

# 替换成你的存储账户信息
account_name = "你的存储账户名"
file_system_name = "容器名"
file_path = "目标文件夹路径/config.ini"

# 初始化ADLS客户端
service_client = DataLakeServiceClient(
    account_url=f"https://{account_name}.dfs.core.windows.net",
    credential=DefaultAzureCredential()
)

file_system_client = service_client.get_file_system_client(file_system=file_system_name)
file_client = file_system_client.get_file_client(file_path)

# 读取文件内容到内存
downloaded_bytes = file_client.download_file().readall()
config_content = downloaded_bytes.decode('utf-8')

# 解析配置
config = configparser.ConfigParser()
config.read_string(config_content)

# 验证结果
print(config.sections())

方法2：Synapse Spark池用挂载路径读取 #

如果是在Synapse Spark池运行，先把ADLS Gen2容器挂载到Spark文件系统，再用类本地路径读取：

import configparser

# 挂载ADLS（会话内执行一次即可）
spark.conf.set(
    "fs.azure.account.auth.type.你的存储账户名.dfs.core.windows.net",
    "OAuth"
)
spark.conf.set(
    "fs.azure.account.oauth.provider.type.你的存储账户名.dfs.core.windows.net",
    "org.apache.hadoop.fs.azurebfs.oauth2.ClientCredsTokenProvider"
)
spark.conf.set(
    "fs.azure.account.oauth2.client.id.你的存储账户名.dfs.core.windows.net",
    "你的服务主体ID"
)
spark.conf.set(
    "fs.azure.account.oauth2.client.secret.你的存储账户名.dfs.core.windows.net",
    "你的服务主体密钥"
)
spark.conf.set(
    "fs.azure.account.oauth2.client.endpoint.你的存储账户名.dfs.core.windows.net",
    "https://login.microsoftonline.com/你的租户ID/oauth2/token"
)

# 用挂载后的路径读取
config = configparser.ConfigParser()
config.read("/dbfs/mnt/你的挂载名/目标文件夹路径/config.ini")
print(config.sections())

方法3：检查config.ini格式合规性 #

确保你的config.ini符合标准格式，必须包含[节名]，不能有语法错误，比如：

[Database]
host=xxx.xxx.xxx.xxx
port=5432
username=admin

如果格式错了，哪怕内容读到了，configparser也会返回空节列表。可以先打印config_content确认内容是否完整加载。

验证步骤 #

1. 执行读取文件内容的代码，打印config_content，确认是否正确获取到config.ini的全部内容。
2. 检查config.ini格式，确保没有缺节名、语法错误。
3. 测试解析内存中的字符串，确认configparser能正常识别配置节。

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