如何通过API调用获取Palantir Foundry中数据集的完整metadata

方式1：使用官方Python SDK（最推荐，适合Python开发场景） #

这是最便捷的实现方式，SDK已经封装好了签名、请求逻辑，不用自己处理底层接口适配。

• 安装依赖：执行命令pip install palantir-foundry完成SDK安装
• 配置认证：先在Foundry平台的用户设置页生成个人访问令牌（PAT），记得勾选datasets:read权限；之后配置两个环境变量：FOUNDRY_API_TOKEN填你生成的PAT，FOUNDRY_HOST填你所在Foundry实例的域名，比如your-company.palantirfoundry.com
• 调用接口获取元数据：示例代码如下

from palantir.datasets import Dataset

# 传入数据集的完整路径或者*RID*都可以定位到目标数据集
ds = Dataset("/业务域/数据项目/目标数据集名称")
full_metadata = ds.get_metadata()

# 可打印查看所有元数据字段
print(full_metadata)

返回的元数据会包含数据集RID、创建/更新时间、所有者信息、表结构schema、当前活跃事务ID、分支列表、存储占用大小、绑定的标签、权限配置等全量信息。

方式2：直接调用REST API（适合非Python开发场景） #

如果你的技术栈不用Python，可以直接调用底层的Catalog服务API。

• 准备认证信息：和第一种方式一样，先生成有datasets:read权限的个人访问令牌（PAT）
• 构造请求地址：格式为https://<你的Foundry实例域名>/foundry-catalog/api/catalog/datasets/<目标数据集RID>
• 发送GET请求：请求头必须携带授权字段，示例curl命令如下：

curl -H "Authorization: Bearer 替换为你的PAT" https://your-company.palantirfoundry.com/foundry-catalog/api/catalog/datasets/ri.foundry.main.dataset.xxxxxxx

如果你需要获取细分的元数据，可以在上述请求路径后加后缀：加/schemas获取表结构信息，加/transactions获取历史事务记录，加/permissions获取权限配置信息。

注意事项 #

• 你的PAT必须对目标数据集有至少查看权限，否则会返回403无权限错误
• 数据集RID可以在数据集详情页的「关于」选项卡中找到，如果只有数据集路径，可以先调用路径转RID的接口拿到RID再请求元数据
• 不同版本的Foundry实例返回的元数据字段可能有细微差异，以你所在实例的内置API文档为准

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