如何使用Fabric CLI将DataPipeline、Warehouse、Notebook导入Fabric工作区？

问题背景 #

尝试将DataPipeline、Notebook和Warehouse文件导入远程Fabric工作区，目标API为https://api.fabric.microsoft.com/.default

已尝试操作 #

• 连接工作区：

  fab auth login -u $(fabricClientId) -p $(fabricClientSecret) --tenant $(fabricTenantId)
  

  状态：已通过
• 进入工作区：

  fab cd $(fabricWorkspaceId)
  

  状态：已通过
• 导入数据管道定义：

  fab import ordersETL.DataPipeline -i ./artifacts/ordersETL.DataPipeline -f
  

  状态：失败，错误信息： x import: [InvalidPath] Invalid path '/pl_parallel_tasks.DataPipeline'
• 导入Warehouse：因无法导入Warehouse定义，尝试使用mkdir命令：

  fab mkdir salesDW.Warehouse
  

  状态：失败，错误信息： x mkdir: [InvalidPath] Invalid path '/salesDW.Warehouse'

核心问题 #

如何使用Fabric CLI正确导入DataPipeline、Warehouse和Notebook？

错误原因 #

出现InvalidPath错误是因为Fabric CLI的资源路径规则：

• 资源名称不能用.作为分隔符，层级划分用/，或直接使用纯名称
• 不同资源类型的创建/导入命令不同，Warehouse无法通过mkdir创建

正确操作步骤 #

1. 导入DataPipeline

导入时需指定资源类型，避免路径解析错误，正确命令格式：

# 直接导入到工作区根目录，资源名称为ordersETL
fab import ordersETL -i ./artifacts/ordersETL.DataPipeline -t DataPipeline -f
# 或指定层级路径（如归类到pipelines目录）
fab import pipelines/ordersETL -i ./artifacts/ordersETL.DataPipeline -t DataPipeline -f

参数说明：

• -t DataPipeline：明确指定资源类型，避免路径识别错误
• -f：强制覆盖已有同名资源（按需使用）

2. 创建/导入Warehouse

Warehouse需用create命令新建，或通过定义文件导入：

# 新建Warehouse资源
fab create salesDW -t Warehouse
# 若有导出的Warehouse定义文件，使用导入命令
fab import salesDW -i ./artifacts/salesDW.Warehouse -t Warehouse -f

3. 导入Notebook

导入逻辑与DataPipeline一致，指定资源类型和正确路径：

# 直接导入到工作区根目录，资源名称为salesAnalysis
fab import salesAnalysis -i ./artifacts/salesAnalysis.Notebook -t Notebook -f
# 或指定层级路径（如归类到notebooks目录）
fab import notebooks/salesAnalysis -i ./artifacts/salesAnalysis.Notebook -t Notebook -f

通用注意事项 #

• 确保待导入的.DataPipeline、.Warehouse、.Notebook文件是从Fabric工作区正确导出的，格式合规
• 可用fab list命令查看当前工作区已有资源，确认路径格式规范
• 层级目录使用/作为分隔符，禁止用.替代

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