Azure Data Factory无法预览Excel文件数据问题咨询

问题详情 #

Excel文件本身包含有效数据，但在Azure Data Factory（ADF）中执行数据集预览操作时无任何数据显示。相关配置情况：

• 数据集连接至.xlsx格式文件，通过传入sheetName参数指定工作表进行预览
• 已将该数据集关联至复制活动，但预览结果仍为空

数据集JSON配置如下：

{
    "name": "wwpRater_source_excel",
    "properties": {
        "linkedServiceName": {
            "referenceName": "agrlatitudelivestorage",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "sheetName": {
                "type": "string"
            }
        },
        "folder": {
            "name": "wwpRater/Source"
        },
        "annotations": [],
        "type": "Excel",
        "typeProperties": {
            "sheetName": {
                "value": "@dataset().sheetName",
                "type": "Expression"
            },
            "location": {
                "type": "AzureBlobFSLocation",
                "fileName": "wwpRater.xlsx",
                "folderPath": "wwp-rater",
                "fileSystem": "bronze-silver"
            },
            "firstRowAsHeader": true
        },
        "schema": []
    },
    "type": "Microsoft.DataFactory/factories/datasets"
}

排查与解决步骤 #

• 验证参数准确性：预览时输入的sheetName参数值必须和Excel中实际工作表名称完全匹配，注意大小写、空格、特殊字符（比如工作表名是"Data Sheet"还是"DataSheet"，有没有末尾空格）
• 临时替换参数测试：把数据集里的sheetName表达式换成固定值（比如"sheetName": "你的工作表名"），测试是否能正常预览，排查参数表达式是否存在问题
• 检查Excel文件状态：本地打开Excel确认数据无损坏；避免使用包含宏、复杂数组公式的文件；如果数据区域不是从A1开始，或者存在大量空行/空列，ADF可能无法正确识别有效数据范围
• 导入数据集Schema：当前数据集schema为空，手动点击数据集编辑页面的「导入Schema」按钮，让ADF自动识别列结构，再尝试预览
• 确认Linked Service权限：检查关联的Blob存储Linked Service（agrlatitudelivestorage）是否拥有目标文件的读取权限，比如存储账户访问密钥是否有效、托管标识是否配置了正确的Blob读取角色
• 测试复制活动运行：直接触发复制活动执行，查看运行日志中的报错信息——有时候预览功能的限制比实际运行严格，日志能提供更精准的问题线索

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