すべてのプロダクト
Search
ドキュメントセンター

AnalyticDB:統合の概要

最終更新日:Nov 09, 2025

このトピックでは、AnalyticDB for MySQL API の基本情報と使用上の注意について説明します。

OpenAPI Explorer の概要

Alibaba Cloud は、さまざまな Alibaba Cloud サービスの API 操作を理解し、効率的に使用できるように OpenAPI Explorer を提供しています。OpenAPI Explorer は、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK のダウンロード、サンプルコード、エラー診断、呼び出し統計など、API 操作に関連する複数の機能を統合しています。OpenAPI Explorer では、Alibaba Cloud サービスの API 操作を呼び出し、API リクエストと応答を表示できます。さらに、OpenAPI Explorer は対応する SDK サンプルコードを自動的に生成し、Alibaba Cloud サービスの利用を容易にします。詳細については、「API とは」をご参照ください。

API バージョン

Alibaba Cloud API は、バージョン番号を使用して、さまざまなアーキテクチャを使用する AnalyticDB for MySQL クラスターの API 操作を管理します。AnalyticDB for MySQL クラスターのエディションに基づいて API バージョンを選択してください。

API バージョン

説明

2019-03-15

AnalyticDB for MySQL Data Warehouse Edition クラスターに対して、このバージョンの API 操作を呼び出すことができます。

2021-12-01

AnalyticDB for MySQL Enterprise Edition、Basic Edition、および Data Lakehouse Edition クラスターに対して、このバージョンの API 操作を呼び出すことができます。

オンラインデバッグ

AnalyticDB for MySQL は、OpenAPI Explorer のオンラインデバッグなどの機能をサポートしています。API 操作を呼び出す前に、API バージョン、エンドポイント、統合メソッドなど、AnalyticDB for MySQL に関する情報をよく理解していることを確認してください。

image

デバッグページ

AnalyticDB for MySQL は、Data Warehouse EditionEnterprise Edition、Basic Edition、および Data Lakehouse Edition で利用できます。AnalyticDB for MySQL クラスターのエディションに基づいてデバッグページを選択してください。

API バージョン

説明

Data Warehouse Edition

Data Warehouse Edition の API デバッグページ

Enterprise Edition、Basic Edition、および Data Lakehouse Edition

Data Lakehouse Edition の API デバッグページ

エンドポイント

レイテンシーを削減するために、リソースが存在するリージョンに基づいてエンドポイントを選択します。たとえば、AnalyticDB for MySQL クラスターが中国 (張家口) リージョンにある場合、クラスターのパブリックエンドポイントは adb.cn-zhangjiakou.aliyuncs.com で、クラスターの Virtual Private Cloud (VPC) エンドポイントは adb-vpc.cn-zhangjiakou.aliyuncs.com です。

  • パブリックエンドポイントはグローバルにアクセスできます。

  • 各 VPC は仮想化されたネットワークです。VPC エンドポイントには次の利点があります。

    • 高いセキュリティ: VPC エンドポイントは VPC 内からのみアクセスできるため、より高いセキュリティとプライバシーが提供されます。

    • 高速な応答: VPC エンドポイントは VPC を介してデータ転送を可能にするため、パブリックエンドポイントよりも高速な応答を提供します。さらに、ネットワーク遅延や帯域幅制限などの問題を回避できます。

    • 低コスト: VPC エンドポイントは内部ネットワーク経由でアクセスされます。

Data Warehouse Edition のエンドポイントの詳細については、「エンドポイント」をご参照ください。Enterprise Edition、Basic Edition、および Data Lakehouse Edition のエンドポイントの詳細については、特定の API 操作のトピックをご参照ください。

サポートされているユーザー ID

Alibaba Cloud アカウントを使用して OpenAPI Explorer にログインすると、システムはオンラインデバッグにそのアカウントを自動的に使用します。Alibaba Cloud アカウントには、すべての API 操作を呼び出す権限があります。Alibaba Cloud アカウントを使用したオンラインデバッグは、リスクの高い操作です。API 操作の呼び出しや日常の O&M の実行には、Resource Access Management (RAM) ユーザーを使用することを推奨します。RAM ユーザーを使用して API 操作を呼び出す前に、ビジネス要件に基づいて AnalyticDB for MySQL に対する必要な権限を RAM ユーザーに付与してください。詳細については、「RAM での権限付与」をご参照ください。

ID

サポート

Alibaba Cloud アカウント

はい

RAM ユーザー (推奨)

はい

RAM ロール (推奨)

はい

統合メソッド

次のいずれかのメソッドを使用して、AnalyticDB for MySQL API を呼び出すことができます: Alibaba Cloud SDK、Alibaba Cloud CLI、Terraform、Resource Orchestration Service (ROS)、およびカスタムカプセル化。

説明

Alibaba Cloud SDK はアプリケーションに簡単に統合できます。API 操作の呼び出しには Alibaba Cloud SDK を使用することを推奨します。

統合メソッド

サポート

Alibaba Cloud SDK (推奨)

はい

Alibaba Cloud CLI

はい

ROS

はい

Terraform

はい

カスタムカプセル化

はい

Alibaba Cloud SDK

  • Alibaba Cloud は、Java、C#、Go、Python、TypeScript、Node.js、PHP、C++ など、複数のプログラミング言語で SDK を提供しています。Alibaba Cloud SDK を使用すると、ID、認証情報、署名ルールなど、API 操作の実装詳細を考慮する必要がなくなります。Alibaba Cloud SDK をアプリケーションに統合して、API 操作を直接呼び出すことができます。詳細については、「Alibaba Cloud SDK」をご参照ください。

  • Alibaba Cloud SDK を使用して AnalyticDB for MySQL API を呼び出すことができます。サポートされているプログラミング言語とダウンロードリンクの詳細については、AnalyticDB for MySQL SDK をご参照ください。

Alibaba Cloud CLI

  • Alibaba Cloud CLI を使用すると、aliyun コマンドを実行して Alibaba Cloud サービスと対話し、クラウドサービスリソースを管理できます。詳細については、「Alibaba Cloud CLI とは」をご参照ください。

  • Alibaba Cloud CLI を使用して AnalyticDB for MySQL API を呼び出すことができます。詳細については、「Alibaba Cloud CLI」をご参照ください。

Terraform

  • Terraform は、クラウドインフラストラクチャとリソースを安全かつ効率的にプレビュー、設定、管理するために使用できるオープンソースツールです。Terraform は ROS と同じ方法で動作します。Terraform は、テンプレートを解釈して API 操作を呼び出します。詳細については、「Terraform とは」をご参照ください。

  • Terraform を使用して AnalyticDB for MySQL API を呼び出すことができます。

ROS

  • ROS は、クラウドコンピューティングリソースを簡素化された方法で管理するのに役立つ Alibaba Cloud サービスです。スタックテンプレートをコンパイルして、Elastic Compute Service (ECS) や ApsaraDB RDS インスタンスなどのクラウドコンピューティングリソース、およびテンプレート内のリソース間の依存関係を記述できます。ROS エンジンは、テンプレートに基づいてスタック内のすべてのリソースを自動的に作成および設定し、自動デプロイと O&M を実装します。詳細については、「ROS とは」をご参照ください。

  • ROS を使用して AnalyticDB for MySQL API を呼び出すことができます。詳細については、ROS をご参照ください。

カスタムカプセル化

ビジネス要件に基づいてリクエストをカプセル化し、Alibaba Cloud API を呼び出すことができます。ネイティブ HTTP 呼び出しを行うには、カスタムリクエストを構築し、リクエストに署名する必要があります。署名メソッドの詳細については、「v3 リクエストボディと署名メカニズム」をご参照ください。

使用上の注意

API 操作を呼び出した後にエラーが発生した場合は、返されたエラーコードに基づいて、リクエストパラメーターとパラメーターの値が有効かどうかを確認する必要があります。詳細については、サービスエラーコード をご参照ください。

また、Alibaba Cloud OpenAPI 診断プラットフォームを使用して、返されたリクエスト ID または SDK エラー情報に基づいてセルフサービス診断を実行することもできます。