[ PROMPT_NODE_26432 ]
node
[ SKILL_DOCUMENTATION ]
# Node 端点 - 知识图谱探索
## 目的
Node 端点从 Data Commons 知识图谱中检索属性关系和值。它返回有关连接节点的有向边(属性)的信息,从而能够发现图结构中的连接。
## 核心能力
Node API 执行三个主要功能:
1. 检索与节点关联的属性标签
2. 获取跨节点的特定属性值
3. 发现通过关系链接的所有连接节点
## 可用方法
### 1. fetch()
使用带有箭头表示法的关系表达式检索属性。
**关键参数:**
- `node_dcids`: 目标节点标识符
- `expression`: 使用箭头 (`->`, `<-`, ``: 出向属性(从节点到值)
- `<-`: 入向属性(从值到节点)
- `name"
)
# 获取入向属性(指向此节点的内容)
response = client.node.fetch(
node_dcids=["geoId/06"],
expression="<-containedInPlace"
)
### 2. fetch_property_labels()
获取属性标签而不检索值——对于发现存在哪些属性非常有用。
**参数:**
- `node_dcids`: 节点标识符
- `out`: 布尔值——True 表示出向属性,False 表示入向属性
**示例用法:**
python
# 获取加州的所有出向属性标签
labels = client.node.fetch_property_labels(
node_dcids=["geoId/06"],
out=True
)
# 获取所有入向属性标签
labels = client.node.fetch_property_labels(
node_dcids=["geoId/06"],
out=False
)
### 3. fetch_property_values()
获取带有可选过滤器的特定属性值。
**参数:**
- `node_dcids`: 节点标识符
- `property`: 要查询的属性名称
- `out`: 方向(True 表示出向,False 表示入向)
- `limit`: 返回值的最大数量
**示例用法:**
python
# 获取加州的名称属性
values = client.node.fetch_property_values(
node_dcids=["geoId/06"],
property="name",
out=True
)
### 4. fetch_all_classes()
列出 Data Commons 图谱中的所有实体类型(类节点)。
**E