使用Python向GridDB容器插入数据时遇[Name not found]错误求助

错误原因定位 #

错误码151505对应的「Name not found」，尽管你确认容器存在，但核心问题大概率是客户端与集群的连接未关联到容器所在的命名空间，或是连接配置偏差导致集群无法识别容器请求。

可行解决方案 #

1. 使用带命名空间的完整路径访问容器 #

GridDB中不同用户创建的容器会归属到对应用户的命名空间下。若你通过admin用户在Web控制台创建容器，需在代码中使用完整命名路径访问：

# 修改get_container参数为带命名空间的路径
container = gridstore.get_container("/admin/SampleContainer")

如果容器在public空间创建，替换为"/public/SampleContainer"。

2. 切换为单播地址连接集群 #

多播地址（239.0.0.1）可能受网络配置限制（如防火墙、多播未开启），导致客户端无法正确发现集群节点。改用GridDB节点的单播IP地址连接：

gridstore = factory.get_store({
    "host": "你的GridDB节点IP（如127.0.0.1）",
    "port": 10001,
    "cluster_name": "defaultCluster",
    "username": "admin",
    "password": "admin"
})

替换为实际的节点IP（本地测试可用127.0.0.1）。

3. 显式指定容器类型获取容器 #

若容器为特定类型（集合/时间序列），在get_container中添加类型参数避免匹配失败：

# 集合类型容器
container = gridstore.get_container("SampleContainer", griddb.ContainerType.COLLECTION)
# 时间序列容器则替换为griddb.ContainerType.TIME_SERIES

4. 验证集群连接与容器列表 #

在代码中添加容器列表查询，确认客户端是否能获取到集群内的容器：

# 获取所有容器列表
containers = gridstore.get_container_names(griddb.ContainerType.ALL)
print("Available containers:", containers)

若输出中无SampleContainer，说明客户端未连接到正确集群，需检查集群地址、端口、集群名称是否完全匹配。

5. 检查容器权限配置 #

在Web控制台进入容器权限设置页面，确认admin用户拥有该容器的读/写权限。

修复后的示例代码 #

import griddb_python as griddb

try:
    factory = griddb.StoreFactory.get_instance()
    # 使用单播地址连接集群
    gridstore = factory.get_store({
        "host": "127.0.0.1",
        "port": 10001,
        "cluster_name": "defaultCluster",
        "username": "admin",
        "password": "admin"
    })

    # 验证连接，输出可用容器
    containers = gridstore.get_container_names(griddb.ContainerType.ALL)
    print("Available containers:", containers)

    # 通过完整命名路径获取容器
    container = gridstore.get_container("/admin/SampleContainer")

    if container is None:
        print("Container not found!")
        exit()

    row_data = ["ID001", "Alice", "New York", "Developer"]
    container.put(row_data)

    print("Data inserted successfully!")

except griddb.GSException as e:
    print("Error occurred:", e)

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