集成概览

版本说明

阿里云OpenAPI通过版本号管控不同架构的云原生数据仓库 AnalyticDB MySQL 版集群的API，请您根据自己的集群类型选择合适版本的API。

在线调试

云原生数据仓库 AnalyticDB MySQL 版在OpenAPI门户提供API调试等功能。在调用前，您需要了解云原生数据仓库 AnalyticDB MySQL 版提供的版本、接入点说明、集成方式等信息。

调试入口

云原生数据仓库 AnalyticDB MySQL 版分为数仓版、企业版、基础版及湖仓版。每个版本API的调试入口不同，请您根据自己的版本，选择合适的API调试入口。

接入点说明

根据相关资源所在地域，选择对应的接入地址，以获得最低延迟。例如华北3（张家口）云原生数据仓库 AnalyticDB MySQL 版的公网接入地址为adb.cn-zhangjiakou.aliyuncs.com，VPC接入地址为adb-vpc.cn-zhangjiakou.aliyuncs.com。

• 公网接入地址在全球都可访问。

• VPC（Virtual Private Cloud）隔离了虚拟网络，每个VPC对应一个虚拟化网络。VPC地址的优势：

  • 高安全性：VPC接入地址只能在VPC内部访问，提供更高的安全性和隐私性。

  • 更快的响应速度：由于VPC接入地址在VPC内部网络中运行，其响应速度通常比公网接入地址更快，并且可以避免公网延迟和带宽限制等问题。

  • 更低的成本：VPC接入地址可以使用内部网络通信。

数仓版接入点信息，请参见服务接入点；企业版、基础版及湖仓版接入点信息，请参见各API文档中的接入地址信息。

支持的用户身份

当您登录OpenAPI网站后，OpenAPI默认使用您所登录的账号进行在线OpenAPI调试。由于阿里云账号拥有所有API的访问权限，存在较高风险，因此不建议您使用阿里云账号在线调试API。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行API调用。RAM用户需具备操作云原生数据仓库 AnalyticDB MySQL 版的权限。具体操作，请参见授权信息。

阿里云SDK

• 阿里云为您提供了多种编程语言（Java、C#、Go、Python、Node.js、TypeScript、PHP、C++等）的SDK。SDK屏蔽了OpenAPI实现细节，统一身份、认证及签名规则。您只需要集成SDK，通过SDK直接调用OpenAPI。关于更多阿里云SDK的介绍，请参见阿里云SDK。

• 支持通过阿里云SDK调用云原生数据仓库 AnalyticDB MySQL 版的OpenAPI。支持的语言及依赖安装方法，请参见云原生数据仓库AnalyticDB MySQL版SDK。

Terraform

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

• 支持Terraform编排和使用云原生数据仓库 AnalyticDB MySQL 版。

资源编排ROS

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

• 支持资源编排服务ROS编排调用云原生数据仓库 AnalyticDB MySQL 版。更多信息，请参见资源编排。

自定义封装

您可以参考SDK部分的V3签名文档自定义封装请求来访问阿里云OpenAPI。原生HTTP调用需要您自己实现签名算法，并构建自定义请求，发起HTTP调用。有关签名机制的更多详细信息，请参见V3版本请求体&签名机制。