使用put_container修改GridDB容器列定义时遇‘Container not found’错误

问题场景 #

我在Python应用中尝试为已有的GridDB容器添加列，但在创建容器后修改ColumnInfo时触发了“Container not found”错误。代码如下：

import griddb_python as griddb  

# Original container creation works fine  

container_info = griddb.ContainerInfo("sensor_data",  
    [ 
        ["timestamp", griddb.Type.TIMESTAMP],  
        ["sensor_id", griddb.Type.STRING],  
        ["temperature", griddb.Type.DOUBLE] 
    ],  
    griddb.ContainerType.TIME_SERIES, True)  
container = store.put_container(container_info) 
# This fails with "Container not found" error  

try:  
 new_column_info = griddb.ContainerInfo("sensor_data", 
    [  
        ["timestamp", griddb.Type.TIMESTAMP],  
        ["sensor_id", griddb.Type.STRING],  
        ["temperature", griddb.Type.DOUBLE],  
        ["humidity", griddb.Type.DOUBLE]  
    ],  
    griddb.ContainerType.TIME_SERIES, True) 

 modified_container = store.put_container(new_column_info) # FAILS HERE  

except Exception as e: 
    print(f"Error: {e}")

问题解答 #

1. 为何使用修改后的ColumnInfo调用put_container()会抛出“Container not found”错误？ #

put_container()的设计逻辑是：容器不存在时创建它；容器已存在时，必须严格匹配原有容器的所有元数据（列结构、容器类型等）。如果传入的ContainerInfo和已有容器结构不一致，它不会执行修改操作，反而返回“Container not found”——这是GridDB的保护机制，防止意外修改或覆盖已有容器结构。你传入的新列信息多了一列，和原有容器不匹配，因此触发错误。

2. 是否有其他API方法可用于为已有容器添加列？ #

有的，GridDB提供alter_container()方法专门用于修改已有容器的Schema，包括添加新列。Python客户端中，需先获取目标容器对象，再调用该方法传入新增列信息。示例代码如下：

# 获取已存在的容器
container = store.get_container("sensor_data")
# 定义要新增的列
new_columns = [["humidity", griddb.Type.DOUBLE]]
# 执行添加列操作
container.alter_container(new_columns)

3. 是否需要删除并重新创建容器，还是可以就地修改schema？ #

不需要删除重建容器，GridDB支持就地修改Schema，通过alter_container()方法就能直接在已有容器上添加新列，既保留原有数据，又能高效完成Schema扩展。但有以下限制：

• 仅支持添加新列，无法修改已有列的数据类型或删除现有列
• 针对时间序列容器，新增列不能设置为分区键或主键

内容的提问来源于Stack Exchange，提问作者Habib ur Rehman