如何将CSV文件导入Azure Storage Table？是否需要新增PartitionKey和RowKey列

核心结论 #

你必须提供PartitionKey和RowKey两个属性才能成功插入数据，这是Azure Table Storage的强制要求。你当前CSV中不存在这两个字段，脚本直接读取空值触发报错。

报错原因 #

• Azure Table Storage 中的每一条实体（对应CSV的每一行）强制要求两个主键属性：PartitionKey（分区键）和RowKey（行键），二者组合作为实体的唯一标识，不能为空也不能缺失。
• 你现有的CSV仅包含res1~res6六个自定义字段，脚本中$PartitionKey = $CsvContent.PartitionKey和$RowKey = $CsvContent.RowKey两行读取不到对应值，会返回空值，创建DynamicTableEntity对象时参数非法，最终导致插入失败。

可选解决方案 #

方案1：修改CSV补充字段 #

直接在原CSV中新增PartitionKey和RowKey两列，逐行填充对应值即可：

• PartitionKey可按业务逻辑划分，同类数据使用相同的分区键，可提升后续查询性能，比如可以直接用res1字段的值作为分区键。
• RowKey需要保证同一个PartitionKey下唯一，可使用业务唯一标识、行序号、GUID等无重复的值。

方案2：修改脚本自动生成（无需修改原CSV） #

如果不想改动原有CSV文件，可以调整脚本逻辑，在循环内自动生成两个主键的值，示例修改后的代码如下：

$storageAccountKey = (Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName).Value[0]
$ctx = New-AzStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageAccountKey
$table = Get-AzStorageTable -Name $tableName -Context $ctx 

$CsvContents = Import-Csv -Path $Path
$CsvHeaders = ($CsvContents[0] | Get-Member -MemberType NoteProperty).Name | Where{$_ -ne "RowKey" -and $_ -ne "PartitionKey"}

# 新增行号变量用于生成唯一RowKey
$rowIndex = 0
Foreach($CsvContent in $CsvContents)
{
    # 自定义生成分区键，可根据业务场景调整，比如改用$CsvContent.res1
    $PartitionKey = "resource_data"
    # 自定义生成行键，也可以用New-Guid生成全局唯一值
    $RowKey = $rowIndex.ToString()

    $Entity = New-Object "Microsoft.Azure.Cosmos.Table.DynamicTableEntity" "$PartitionKey", "$RowKey"

    Foreach($CsvHeader in $CsvHeaders)
    {
        $Value = $CsvContent.$CsvHeader
        $Entity.Properties.Add($CsvHeader, $Value)
    }
    Write-Verbose "Inserting the entity into table storage."
    $result = $Table.Execute([Microsoft.Azure.Cosmos.Table.TableOperation]::Insert($Entity))
    $rowIndex++
}

注意事项 #

• PartitionKey的设计直接影响表存储的查询性能，相同PartitionKey的数据会存储在同一个存储节点，查询时携带PartitionKey过滤条件的执行效率会远高于全表扫描。
• 同一个PartitionKey下的RowKey不能重复，否则插入时会报实体冲突错误。

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