集成概览

表格存储(Tablestore)不仅提供可视化操作控制台,还提供OpenAPI在线调试、SDK、命令行工具客户端工具、Terraform和资源编排ROS等调用方式。为提升您使用Tablestore的开发效率,建议您按需选择合适的操作和集成方式。

集成方式

背景信息

表格存储(Tablestore)的功能可以分为管控链路和数据链路两个部分。

  • 管控链路

    通常是对实例进行管理和控制的相关业务。例如创建实例、配置资源标签、配置实例访问控制策略、获取地域列表等。

  • 数据链路

    主要是数据存储、检索和处理。例如创建数据表、SQL查询、大数据对接等。

集成概览

您可以根据业务的实际需要选择合适的调用方式,具体信息请参见下表。

调用方式

支持情况

管控链路

数据链路

SDK

阿里云SDK

支持(推荐)

不支持

Tablestore SDK

不支持

支持(推荐)

CLI

Tablestore CLI

部分支持

部分支持

阿里云CLI

不支持

不支持

客户端工具

不支持

部分支持

Terraform

部分支持

部分支持

资源编排ROS

部分支持

部分支持

SDK

SDK统一封装了签名逻辑、超时机制、重试机制,并根据文档返回结构化Response对象,易于开发,功能更完整。

阿里云SDK

  • 阿里云为开发者提供了多种编程语言(Java、C#、Go、Python、Node.js/TypeScript、PHP、C++等)的SDK。开发者只需集成SDK,通过SDK暴露的方法直接调用OpenAPI。更多关于阿里云SDK的介绍,请参见阿里云SDK

  • 表格存储的OpenAPI信息,请参见附录1:OpenAPI介绍

说明

如果已有的方案无法满足业务需要,您也可自行封装请求调用OpenAPI(不推荐)。更多信息,请参见API概览V3版本请求体&签名机制

Tablestore SDK

Tablestore为开发者提供了多种编程语言(Java、Go、Python、Node.js、.NET、PHP等)的SDK。更多关于Tablestore SDK的介绍,请参见Tablestore SDK

CLI

CLI(Command Line Interface)是一种通过文本命令与计算机进行交互的用户界面。用户可以通过CLI直接输入指令来执行特定操作,而无需依赖图形用户界面(GUI)。

Tablestore CLI

Tablestore CLI提供简洁、方便的管理命令,支持Windows、LinuxMac平台。更多关于Tablestore CLI的信息,请参见通过命令行工具使用宽表模型通过命令行工具CLI使用时序模型

阿里云CLI

  • 阿里云 CLI可以帮助您在使用命令行终端时,通过aliyun命令与阿里云服务进行交互,管理云服务资源。有关阿里云CLI的更多详细信息,请参见什么是阿里云CLI

  • 暂不支持使用阿里云CLI调用表格存储(Tablestore)

客户端工具

表格存储(Tablestore)客户端工具提供图形化的操作界面,支持数据表操作和数据操作。更多信息,请参见客户端工具

Terraform

  • Terraform是一种开源工具,用于安全高效地预览,配置和管理云基础架构和资源。它与阿里云的资源编排服务的运行机制类似,通过将模板转化为内部数据后完成OpenAPI调用。更多信息,请参见什么是Terraform

  • 支持通过Terraform编排和使用表格存储(Tablestore)

    • 支持部分的普通资源和数据资源(例如实例、数据表、多元索引、二级索引和数据通道等),更多信息请参见Terraform资源列表

    • 快速使用Terraform编排表格存储(Tablestore),请参见Terraform集成示例

资源编排ROS

  • 资源编排服务ROS(Resource Orchestration Service)是阿里云提供的一项简化云计算资源管理的服务。开发者和管理员可以编写模板,在模板中定义所需的阿里云资源(例如ECS实例、RDS数据库实例)、资源间的依赖关系等。ROS的编排引擎将根据模板自动完成所有资源的创建和配置,实现自动化部署及运维。更多详情,请参见什么是资源编排服务

  • 支持通过资源编排服务ROS调用表格存储(Tablestore)

    • 支持部分的资源和数据资源清单(例如实例、数据表、多元索引、二级索引和数据通道等),更多信息请参见资源编排列表

    • 快速使用资源编排ROS编排表格存储,请参见资源编排ROS集成示例

注意事项

  • 如果调用服务API后返回错误,您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。

  • 您也可以记录下调用返回的RequestIDSDK报错信息,通过阿里云OpenAPI诊断平台进行自助诊断。

常见问题

  • 如果您想了解表格存储(Tablestore)产品,请参见什么是表格存储

  • 表格存储(Tablestore)面向海量结构化数据提供Serverless表存储服务,同时针对物联网场景深度优化提供一站式的IoTstore解决方案。了解更多产品支持的特性,请参见表格存储支持的功能特性清单

附录资料

附录1:OpenAPI介绍

为了能够让开发者快速高效地学习和使用云产品OpenAPI,阿里云为用户提供OpenAPI网站。它是一款集OpenAPI智能搜索、文档、在线调试、SDK获取、CodeSample、调用出错诊断、调用统计为一体的产品。您可以在OpenAPI门户中调用阿里云各云产品开放的OpenAPI,查看OpenAPI请求和返回结果。此外,OpenAPI门户会自动生成相应的SDK调用示例,帮助您快速使用阿里云产品。更多信息,请参见什么是OpenAPI

版本说明

阿里云OpenAPI通过版本号管控各时期云产品大版本的API列表,例如表格存储目前支持2020-12-09版本的API列表,2020-12-09代表的是API版本号而非时间概念,所展示的都是最新的API公开数据,并非自2020-12-09之后就未更新。

版本号

说明

2020-12-09

推荐使用

在线调试

表格存储在OpenAPI门户提供API调试等功能。在调用前,您需要了解表格存储提供的版本、接入点、接口风格、调用方式等信息。

image

调试入口

调试API入口为:https://next.api.aliyun.com/api/Tablestore/2020-12-09

接入点说明

根据相关资源所在地域,选择对应的服务接入点地址,以获得最低延迟。

全局接入域名dyvmsapi.aliyuncs.com。更多信息,请参见服务接入点

用户身份

您阿里云账号登录OpenAPI网站后,OpenAPI默认使用您的阿里云账号进行在线OpenAPI调试。阿里云账号拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行接口调用。RAM用户需具备操作权限,详情请参见使用RAM进行访问控制

用户身份

支持情况

阿里云账号

支持

RAM用户(推荐)

支持

RAM角色(推荐)

支持

更多信息