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

AnalyticDB:概要

最終更新日:Sep 23, 2024

このトピックでは、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のこのバージョンのAPI操作を呼び出すことができます Data Lakehouse Editionクラスター。

オンラインデバッグ

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

image

ページのデバッグ

AnalyticDB for MySQLは、データウェアハウスエディションと データウェアハウス] で利用できます。 データレイクハウス版。 AnalyticDB for MySQLクラスターのエディションに基づいてデバッグページを選択します。

APIバージョン

説明

データデータ ウェアハウス版

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

データレイクハウス版

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エンドポイントはパブリックエンドポイントよりも高速に応答します。 さらに、ネットワークの待ち時間や帯域幅の制限などの問題を防ぐことができます。

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

Data Warehouse 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は、アプリケーションに簡単に統合できます。 Alibaba Cloud SDKを使用してAPI操作を呼び出すことを推奨します。

統合方法

対応

Alibaba Cloud SDK (推奨)

継続する

Alibaba Cloud CLI

継続する

ROS

継続する

テラフォーム

継続する

カスタムカプセル化

継続する

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サービスです。 スタックテンプレートをコンパイルして、ECS (Elastic Compute Service) やApsaraDB RDSインスタンスなどのクラウドコンピューティングリソース、およびテンプレート内のリソース間の依存関係を記述できます。 ROSエンジンは、テンプレートに基づいてスタック内のすべてのリソースを自動的に作成および構成して、自動デプロイとO&Mを実装します。詳細については、「」をご参照ください。ROSとは何ですか?

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

カスタムカプセル化

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

使用上の注意

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

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