PowerBI创建IBM Netezza数据源API：POST请求JSON体参数说明

我来帮你梳理通过PowerBI REST API创建IBM Netezza数据源时，JSON请求体里的所有关键参数，结合官方给出的示例逐一拆解：

完整官方示例请求体 #

{ 
  "name": "IBM Netezza Data Source", 
  "connectionDetails": "{\"server\":\"MQPDAQ01.AM.LILLY.COM\", \"database\":\"GMDM_STG_QAR\"}", 
  "type": "ODBC", 
  "credentialDetails": { 
    "credentials": "ABEF==", 
    "encryptionAlgorithm": "RSA-OAEP", 
    "encryptedConnection": "Encrypted|NotEncrypted", 
    "privacyLevel": "None|Public|Organizational|Private", 
    "credentialType": "Basic|Windows|Anonymous|…" 
  } 
}

逐个参数说明 #

基础信息参数

• name：自定义的数据源名称，只要方便你后续识别即可，比如示例里的"IBM Netezza Data Source"。
• type：固定为"ODBC"，因为PowerBI是通过ODBC驱动连接IBM Netezza的，这个值不能修改。

连接配置 (connectionDetails)

这是一个转义后的JSON字符串（必须用双引号包裹，内部的引号要加反斜杠转义），包含Netezza的核心连接信息：

• server：Netezza服务器的地址，可以是域名（如示例中的MQPDAQ01.AM.LILLY.COM）或IP地址。如果使用非默认端口，需要在地址后加上:<端口号>（Netezza默认端口通常是5480）。
• database：你要连接的Netezza数据库名称，比如示例里的"GMDM_STG_QAR"。

凭据认证配置 (credentialDetails)

这部分用来设置连接Netezza的安全认证信息，每个子参数都很关键：

• credentials：加密后的凭据内容，示例中的"ABEF=="是Base64编码的加密结果。你需要先将用户名:密码的字符串用指定的encryptionAlgorithm加密，再转换为Base64格式后填入。
• encryptionAlgorithm：加密凭据时使用的算法，推荐用示例里的"RSA-OAEP"，这是PowerBI API支持的安全加密方式，能保障凭据传输过程不被泄露。
• encryptedConnection：指定连接是否加密，二选一："Encrypted"（启用加密）或"NotEncrypted"（不加密），根据你的Netezza服务器配置选择。
• privacyLevel：数据隐私级别，可选值包括"None"、"Public"、"Organizational"、"Private"，决定了该数据源在PowerBI中的共享范围，需符合你的组织数据政策。
• credentialType：认证类型，IBM Netezza通常使用"Basic"（用户名密码认证），其他选项如"Windows"、"Anonymous"一般不适用，除非你的Netezza配置了对应认证方式。

重要提示 #

一定要注意connectionDetails的格式：它必须是转义后的JSON字符串，而不是直接的JSON对象。如果直接写connectionDetails: {server: "..."}，API会返回格式错误，必须写成"{\"server\":\"...\", \"database\":\"...\"}"这种转义后的形式。

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