如何将RavenDB的CSV导入集成到PowerShell/Bash脚本，替代Ranorex手动操作？

嘿，我来帮你搞定这个RavenDB CSV导入的脚本化问题！之前我也遇到过类似的需求，不想依赖GUI操作，直接用脚本搞定更靠谱，完全可以替代Ranorex里的手动点击步骤。

RavenDB自带了命令行工具（Windows下是raven.exe，Linux/macOS是ravendb），直接用它就能完成CSV导入，不需要手动操作UI。基础命令格式如下：

ravendb csv-import --database <数据库名> --file <CSV文件路径> --collection <目标集合名>

常用的可选参数还包括：

• --skip-first-line：如果CSV第一行是表头，跳过它
• --delimiter <字符>：指定CSV分隔符（默认是逗号）
• --quote <字符>：指定CSV的引号字符（默认是双引号）

举个实际例子：

# Windows下用raven.exe
"C:\Program Files\RavenDB\Server\raven.exe" csv-import --database ECommerceDB --file C:\data\products.csv --collection Products --skip-first-line

# Linux/macOS下用ravendb
/usr/local/bin/ravendb csv-import --database ECommerceDB --file /data/products.csv --collection Products --skip-first-line

完全可以把这个导入流程写成脚本，彻底替代Ranorex里的“选择文件”和“点击导入”操作。下面给你两种脚本方案：

PowerShell脚本示例 #

如果你的环境是Windows，用PowerShell写脚本很方便，还可以结合RavenDB的REST API（适合命令行工具不在PATH里的情况）：

# 配置参数
$dbName = "ECommerceDB"
$csvPath = "C:\data\products.csv"
$collectionName = "Products"
$ravenExePath = "C:\Program Files\RavenDB\Server\raven.exe"

# 方案1：直接调用RavenDB命令行工具
& $ravenExePath csv-import `
    --database $dbName `
    --file $csvPath `
    --collection $collectionName `
    --skip-first-line

# 方案2：用REST API导入（更灵活，适合远程调用）
$apiUrl = "http://localhost:8080/databases/$dbName/bulk_docs"

# 读取CSV并转换为JSON数组
$csvContent = Get-Content $csvPath -Raw
$csvObjects = ConvertFrom-Csv $csvContent

# 构造RavenDB批量导入的请求体
$bulkBody = @{
    Documents = $csvObjects | ForEach-Object {
        @{
            Id = "$collectionName/$($_.ProductId)" # 自定义文档ID，也可以省略让RavenDB自动生成
            Data = $_
        }
    }
} | ConvertTo-Json -Depth 10

# 发送POST请求完成导入
Invoke-RestMethod -Uri $apiUrl -Method Post -Body $bulkBody -ContentType "application/json"

Bash脚本示例 #

如果是Linux/macOS环境，用Bash脚本配合curl和jq（需要先安装jq：sudo apt install jq或brew install jq）：

#!/bin/bash

# 配置参数
DB_NAME="ECommerceDB"
CSV_PATH="/data/products.csv"
COLLECTION_NAME="Products"
RAVEN_BIN="/usr/local/bin/ravendb"
API_URL="http://localhost:8080/databases/$DB_NAME/bulk_docs"

# 方案1：调用RavenDB命令行工具
$RAVEN_BIN csv-import \
    --database "$DB_NAME" \
    --file "$CSV_PATH" \
    --collection "$COLLECTION_NAME" \
    --skip-first-line

# 方案2：用curl调用REST API
# 将CSV转换为JSON数组（根据你的CSV列调整字段映射）
CSV_JSON=$(jq -Rsn '
    [inputs | split(",") | {ProductId: .[0], Name: .[1], Price: .[2]}]
' "$CSV_PATH")

# 构造批量导入请求体
BULK_JSON=$(jq -n --argjson docs "$CSV_JSON" '{Documents: $docs | map({Id: "'"$COLLECTION_NAME"'/\(.ProductId)", Data: .})}')

# 发送请求
curl -X POST "$API_URL" \
    -H "Content-Type: application/json" \
    -d "$BULK_JSON"

用命令行或REST API的方式，比Ranorex的UI自动化更可靠：

• 不需要依赖UI元素的定位（比如“选择文件”按钮、“导入”按钮），避免UI更新导致脚本失效
• 执行速度更快，不需要等待GUI加载
• 可以轻松集成到CI/CD流程中，实现自动化数据导入

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