@clickzetta/cz-cli-darwin-x64 0.3.75 → 0.3.78

package/bin/skills/lakehouse-doc/references/multi_cloud_instance_manage_with_mcp_server.md

@@ -1,281 +0,0 @@
-# 云器 Lakehouse多云多环境管理指南
-
-## 概述
-
-本文档介绍如何通过 Claude Desktop 和云器 Lakehouse MCP Server 实现多云多环境的统一管理，为企业级用户提供简单、高效的数据湖仓管理体验，实现全链路的自然语言对话方式。
-
-```
-我有哪些Lakehouse环境？
-帮我看下生产环境的每个实例里都有哪些workspaces
-帮我切换到腾讯云上海生产环境
-我当前的上下文是？
-有哪些workspaces？
-帮我切到test_ws
-我有哪些计算集群和schema？
-帮我切到DEFAULT
-```
-
-## 使用场景
-
-在企业数字化转型过程中，常见以下多环境管理挑战：
-
-* **多云部署**：同时使用阿里云、腾讯云、AWS等不同云厂商
-* **环境隔离**：开发、测试、生产环境需要独立管理
-* **地域分布**：上海、北京、广州等不同地域的数据中心
-* **资源切换**：需要频繁在不同环境间切换进行运维
-
-传统方式需要登录多个控制台，操作复杂且容易出错。本方案提供了统一的解决方案。
-
-## 技术架构
-
-### 核心组件
-
-1. **Claude Desktop**：AI助手客户端，提供自然语言交互界面
-2. **云器 Lakehouse MCP Server**：模型上下文协议服务器，连接Claude与云器Lakehouse
-3. **云器 Lakehouse**：云原生数据湖仓平台，支持多云部署
-
-### 技术优势
-
-* **自然语言交互**：通过对话方式管理复杂的多云环境
-* **统一管理界面**：一个客户端管理所有云环境
-* **实时状态监控**：随时查看环境健康状态
-* **智能切换**：自动处理连接的建立和环境的切换
-
-## 快速开始
-
-### 步骤1：环境配置
-
-首先需要配置多个 Lakehouse 实例的连接信息（简化过）：
-
-```json
-{
-  "connections": {
-    "aliyun_shanghai_prod": {
-      "service": "cn-shanghai-alicloud.api.clickzetta.com",
-      "workspace": "quick_start",
-      "schema": "mcp_demo"
-    },
-    "tencent_shanghai_prod": {
-      "service": "ap-shanghai-tencentcloud.api.clickzetta.com", 
-      "workspace": "quick_start",
-      "schema": "mcp_demo"
-    },
-    "aws_north-1_prod": {
-      "service": "cn-north-1-aws.api.clickzetta.com",
-      "workspace": "quick_start", 
-      "schema": "public"
-    }
-  }
-}
-```
-
-### 步骤2：启动Claude Desktop
-
-安装并启动Claude Desktop，确保已配置云器 MCP Server。
-
-### 步骤3：开始管理
-
-通过自然语言与Claude交互，即可开始多云环境管理。
-
-## 实际使用案例
-
-以下是一个真实的多云环境管理会话示例：
-
-### 环境发现
-
-**用户**："我有哪些Lakehouse环境？"
-
-**系统响应**：自动扫描并展示所有配置的环境：
-
-```
-✅ 找到 9 个连接配置
-
-🟢 当前活跃环境
-aliyun_shanghai_prod (默认环境)
-
-📋 所有可用环境
-生产环境：
-1. aliyun_shanghai_prod ⭐ (当前使用)
-2. tencent_shanghai_prod  
-3. tencent_beijing_prod
-4. tencent_guangzhou_prod
-5. aws_north-1_prod
-
-测试环境：
-6. uat
-7. uat_1  
-8. uat_1_1
-9. uat_2
-```
-
-### 批量环境探索
-
-**用户**："帮我看下生产环境的每个实例里都有哪些workspaces"
-
-**系统操作**：
-
-* 自动遍历所有生产环境
-* 逐一连接各云厂商实例
-* 收集 workspace 信息
-* 生成统一报告
-
-**结果展示**：
-
-| 环境 | Workspace 数量 | 详细信息 |
-| :--- | :--- | :--- |
-| 阿里云上海 | 4个 | quick_start, lakehouse_quick_experience, ns227206, spark_migration |
-| 腾讯云上海 | 2个 | quick_start, test_ws |
-| 腾讯云北京 | 1个 | quick_start |
-| 腾讯云广州 | 1个 | quick_start |
-| AWS北区 | 2个 | quick_start, iceberg_lakehouse_s3 |
-
-### 智能环境切换
-
-**用户**："帮我切换到腾讯云上海生产环境"
-
-**系统处理**：
-
-```
-✅ 切换成功！
-原环境: aliyun_shanghai_prod  
-新环境: tencent_shanghai_prod
-服务端点: ap-shanghai-tencentcloud.api.clickzetta.com
-处理时间: 1.13秒
-
-📍 当前环境配置
-工作空间: quick_start
-模式: mcp_demo  
-虚拟集群: default_ap
-```
-
-### 上下文感知
-
-**用户**："我当前的上下文是？"
-
-**系统响应**：
-
-```
-📍 您当前的上下文信息
-连接环境: 腾讯云上海生产环境
-
-🔧 环境配置
-实例ID: 270738
-工作空间: quick_start  
-数据模式: mcp_demo
-虚拟集群: default_ap
-
-👤 用户信息
-用户名: qiliang
-用户ID: 2162115
-```
-
-### 资源管理
-
-**用户**："我有哪些计算集群和schema？"
-
-**系统分析**：
-
-```
-⚡ 计算集群 (VCLUSTERS) - 2个
-1. DEFAULT (通用型) - SUSPENDED 
-2. DEFAULT_AP (分析型) - RUNNING ⭐
-
-📁 Schema (数据模式) - 2个  
-1. information_schema (系统Schema)
-2. public (公共Schema)
-```
-
-## 核心功能详解
-
-### 1. 环境发现与管理
-
-* **自动扫描**：发现所有已配置的Lakehouse实例
-* **健康检查**：实时监控环境连接状态
-* **智能分类**：按云厂商、地域、用途自动分组
-
-### 2. 无缝环境切换
-
-* **一键切换**：自然语言指令即可切换环境
-* **连接管理**：自动处理连接建立和断开
-* **状态保持**：切换后保持上下文信息
-
-### 3. 统一资源视图
-
-* **工作空间管理**：查看和切换workspace
-* **计算资源**：管理虚拟集群(VCluster)
-* **数据组织**：Schema和表结构查看
-
-### 4. 智能操作建议
-
-* **上下文感知**：理解当前所在环境
-* **操作提示**：提供下一步操作建议
-* **错误处理**：自动处理连接异常
-
-## 管理工具介绍
-
-### 云器 Lakehouse MCP Server
-
-**功能特性**：
-
-* 50+ 数据操作工具
-* 多云环境连接管理
-* 实时状态监控
-* 智能错误恢复
-
-**核心工具**：
-
-| 工具类别 | 主要功能 | 典型工具 |
-| :--- | :--- | :--- |
-| 环境管理 | 实例切换、上下文查看 | `switch_lakehouse_instance`, `switch_workspace`, `get_current_context` |
-| 资源管理 | 对象查看、创建删除 | `show_object_list`, `create_table` |
-| 数据操作 | 查询、导入导出 | `read_query`, `import_data_src` |
-| 计算管理 | 集群管理、任务监控 | `alter_vcluster`, `show_job_history` |
-
-### Claude Desktop
-
-**交互优势**：
-
-* 自然语言理解
-* 上下文记忆
-* 智能建议
-* 可视化展示
-
-## 企业应用场景
-
-### 场景1：开发运维
-
-```
-开发者: "切换到开发环境，查看今天的任务执行情况"系统: 自动切换到开发环境，展示任务历史和状态
-```
-
-### 场景2：数据分析
-
-```
-分析师: "切换到生产环境，查看销售数据表结构"系统: 切换环境，展示表Schema和数据预览
-```
-
-### 场景3：跨云对比
-
-```
-架构师: "对比不同云环境的资源配置"系统: 生成跨云环境资源对比报告
-```
-
-## 最佳实践
-
-### 1. 环境命名规范
-
-* **云厂商标识**：aliyun, tencent, aws
-* **地域标识**：shanghai, beijing, guangzhou
-* **环境类型**：prod, test, dev
-
-示例：`tencent_shanghai_prod`
-
-### 2. 权限管理
-
-* 生产环境：限制特定用户访问
-* 测试环境：开发团队共享
-* 开发环境：个人专用
-
-## 结语
-
-云器 Lakehouse 多云多环境管理方案为企业提供了统一、智能、高效的数据湖仓管理体验。通过自然语言交互，大大降低了多云环境管理的复杂度，提升了运维效率。随着AI技术的不断发展，我们将持续优化产品体验，为用户创造更大价值。