Alibabacloud Tablestore Ops — 阿里云 Tablestore 运维

Tablestore 只读操作 本技能提供基于 CLI 的只读操作，用于查询阿里云 Tablestore（OTS）实例和数据表。Tablestore 是一个完全托管的 NoSQL 数据库服务，支持存储和访问大量结构化数据。 架构：Aliyun CLI（otsutil）→ Tablestore 实例 → 数据表（宽表 / 时间序列） 范围：本技能仅涵盖读取/查询操作，不包括创建、更新或删除操作。 前提条件 Tablestore 服务必须已激活。请参阅阿里云控制台 从 RAM 控制台获取 AccessKey ID 和 AccessKey Secret 预检查：Aliyun CLI（版本 3.3.0+） Tablestore 操作通过 aliyun otsutil 命令执行，该命令是 Aliyun CLI 的一部分。 重要：otsutil 子命令仅在 Aliyun CLI 版本 3.3.0 或更高版本中可用。Homebrew 版本可能过时 - 直接从官方 CDN 下载。请参阅 references/cli-installation-guide.md 获取安装说明。 安装 安装 Aliyun CLI（版本 3.3.0+） 警告：Homebrew 版本（brew install aliyun-cli）可能不包括 otsutil。始终从官方 CDN 下载以确保获取版本 3.3.0+ 并支持 otsutil。 选项 1：下载二进制文件（推荐） 平台 下载 Mac（通用） Mac 通用 Linux（AMD64） Linux AMD64 Linux（ARM64） Linux ARM64 Windows（64 位） Windows 选项 2：Mac GUI 安装程序 下载 Mac PKG 并双击安装。 macOS / Linux 二进制设置 # 下载（例如 macOS 通用） curl -L -o aliyun-cli.tgz https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz # 解压 tar -xzf aliyun-cli.tgz # 移动到 PATH sudo mv aliyun /usr/local/bin/ # 验证安装和版本（必须为 3.3.0+） aliyun version # 验证 otsutil 是否可用 aliyun otsutil help Windows 设置 从上面的下载链接下载 zip 文件 解压 zip 文件以获取 aliyun.exe 将目录添加到 PATH 环境变量 验证：aliyun version（必须显示 3.3.0 或更高版本） 参数确认 重要：参数确认 - 执行任何命令之前，所有用户可自定义的参数（例如 RegionId、实例名称、AccessKey、端点等）必须与用户确认。不要假设或使用默认值而不经用户明确同意。 参数 必需 描述 默认 --endpoint 是（用于表操作）实例端点 URL - --instance 是（用于表操作）实例名称 - -n（instanceName） 是（用于 describe_instance）实例名称 - -r（regionId） 是（用于实例操作）区域 ID（例如 cn-hangzhou） - -t（tableName） 是（用于表操作）数据表名称 - 注意：AccessKey 凭证通过 aliyun configure 配置，而不是作为命令参数传递。 身份验证 预检查：阿里云凭证必需 安全规则： NEVER 回显或打印 AccessKey 值 NEVER 要求用户直接在明文中输入 AccessKey 仅使用 aliyun configure 配置凭证 如果没有有效凭证： 从阿里云控制台获取 AccessKey 出于安全考虑，使用具有 AliyunOTSReadOnlyAccess 权限的 RAM 用户凭证 使用 Aliyun CLI 配置凭证 配置凭证（Aliyun CLI） # 交互式配置（推荐） aliyun configure # 按照提示： # Aliyun Access Key ID [None]: # Aliyun Access Key Secret [None]: # 默认区域 ID [None]: cn-hangzhou # 默认输出格式 [json]: json # 默认语言 [zh]: en 使用特定配置文件配置 创建命名配置文件 aliyun configure --profile tablestore-user 使用配置文件执行 otsutil 命令 aliyun otsutil --profile tablestore-user list_instance -r cn-hangzhou 支持的身份验证模式 模式 描述 配置命令 AK AccessKey ID/Secret（默认） aliyun configure --mode AK RamRoleArn RAM 角色假设 aliyun configure --mode RamRoleArn EcsRamRole ECS 实例角色 aliyun configure --mode EcsRamRole OIDC OIDC 角色假设 aliyun configure --mode OIDC RAM 策略 Tablestore 只读操作所需的权限： { "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "ots:GetInstance", "ots:ListInstance", "ots:ListTable", "ots:DescribeTable" ], "Resource": "acs:ots:::instance/*" } ] } 或者使用托管策略：AliyunOTSReadOnlyAccess 请参阅 references/ram-policies.md 获取详细权限。 核心工作流 第 1 部分：实例读取操作 任务 1：配置实例（连接到实例） 配置端点以选择要操作的实例。 重要：您必须在执行任何表操作之前配置实例。 命令格式：aliyun otsutil config --endpoint --instance 端点格式： 公共：https://..ots.aliyuncs.com VPC：https://..vpc.tablestore.aliyuncs.com 示例：aliyun otsutil config --endpoint --instance