用途:通过 MaxCompute(ODPS)的 Information Schema(IS)视图查询元数据,用于存储、成本、权限、任务和治理分析。仅限 IS 视图查询;DDL/DML、列表或一般 MaxCompute 用法应改用 MCP 工具(list_tables、get_table_schema)或 odpscmd。
主要能力:提供 31 个 IS 视图,如 TABLES、COLUMNS、PARTITIONS、TASKS、TASKS_HISTORY、TUNNELS_HISTORY、TABLE_PRIVILEGES、TABLE_ACCESS_INFO、QUOTA_USAGE、USERS、USER_ROLES、CATALOGS 等,覆盖表与列元数据、分区、任务历史、Tunnel 历史、权限、访问统计、配额监控等。
必要用法:每个租户级 IS 查询必须设置命名空间标志,否则所有查询会以 Table not found 失败。MCP 中用 hints={"odps.namespace.schema":"true"};odpscmd 中执行 SET odps.namespace.schema=true;。IS 视图需要租户级权限。执行通道优先 MCP,连接或鉴权失败时回退 odpscmd。
限制:历史视图(TASKS_HISTORY、TUNNELS_HISTORY)约 5 分钟延迟,实时视图约 3 小时;查询昨日数据建议 06:00 后。不支持跨元数据中心。分区表 last_access_time 为 NULL。禁止 SELECT *。JOIN IS 视图必须包含 table_catalog、table_schema、table_name 三字段键。项目级 IS 正在废弃(2024-03 起新项目不再自动安装)。
项目级适配:若环境仅支持项目级 IS,前缀改为 Information_Schema.*,MCP 中移除命名空间标志,odpscmd 中去掉 SET 语句。项目级缺少 CATALOGS、VOLUMES、FOREIGN_SERVERS、SCHEMAS、PARTITION_ACCESS_INFO、TABLE_ACCESS_INFO、QUOTA_USAGE 等视图,但独有 SCHEMA_PRIVILEGES,其 TASKS_HISTORY 多出 task_schema 列。
其他资源:references 目录提供 views-reference.md(31 视图完整字段)、verified-queries.md(30 个已验证 SQL 模板)、metrics.md、joins.md、playbooks.md、terminology.md(59 条术语映射)、ram-policies.md、mcp-tools-reference.md、TROUBLESHOOTING.md,以及脚本 scripts/odps_is_query.sh(16 种查询类型与自定义 SELECT,支持 -t 超时、-d 日期、-p 项目)。