コンソールに加えて、Tablestore は、オンライン OpenAPI デバッグ、ソフトウェア開発キット (SDK)、コマンドラインインターフェイス (CLI) などの統合方法を提供します。要件に応じて、適切な方法を選択して Tablestore を開発および使用できます。
統合方法
Tablestore の機能は、インスタンス管理とデータ管理に分かれています。
インスタンス管理
このカテゴリには、インスタンスの作成、タグとリソースグループの使用、インスタンスのアクセス制御ポリシーの設定など、インスタンスに関連する操作と機能が含まれます。
データ管理
このカテゴリには、データテーブルの作成、SQL クエリの実行、ビッグデータシステムへの接続など、テーブルとデータに関連する操作と機能が含まれます。
次の表に、各統合方法がサポートする Tablestore の機能を示します。
統合方法 | サポート | ||
インスタンス管理 | データ管理 | ||
Tablestore SDK | 非対応 | 対応 (推奨) | |
Alibaba Cloud SDK | 対応 (推奨) | 非対応 | |
部分的にサポート | 部分的にサポート | ||
部分的にサポート | 部分的にサポート | ||
部分的にサポート | 部分的にサポート | ||
SDK
Tablestore SDK と Alibaba Cloud SDK を使用して、Tablestore の機能にアクセスできます。
Tablestore SDK
Tablestore は、Java、Go、Python、Node.js、.NET、PHP など、いくつかの一般的なプログラミング言語用の SDK を提供しています。Tablestore SDK を使用して、テーブルとデータに対する操作を実行できます。次の表に、各 SDK がサポートする機能を示します。
説明「」は、その機能がサポートされていることを示します。「」は、その機能がサポートされていないことを示します。
機能
Java
Go
Python
Node.js
.NET
PHP
テーブル操作
グローバルテーブル操作
データ操作：基本機能
データ操作：ローカルトランザクション
検索インデックス：基本機能
検索インデックス：ベクトル検索
検索インデックス：統計集計
グローバルセカンダリインデックス
ローカルセカンダリインデックス
Tunnel Service
SQL クエリ
データレイクへの配信
時系列モデル
メッセージモデル
Alibaba Cloud SDK
Alibaba Cloud SDK は、クラウドサービスの API 操作を呼び出すために使用される依存関係パッケージです。Alibaba Cloud SDK を使用して、インスタンスの操作と管理を実行できます。
OpenAPI ポータルでオンラインデバッグすることもできます。詳細については、「付録1：OpenAPI の概要」をご参照ください。
CLI
Tablestore CLI は、シンプルで便利な管理コマンドを提供し、Windows、Linux、macOS で実行されます。Tablestore CLI を使用して、Tablestore サービスのアクティベーションやインスタンスの作成などの操作を実行できます。
Terraform
Terraform は、IT リソースをコードとして管理するために使用できる、自動化されたリソースオーケストレーション用のオープンソースツールです。Terraform CLI は、設定ファイルを Alibaba Cloud またはその他のサポートされているクラウドにデプロイし、そのバージョンを管理する簡単な方法を提供します。
Tablestore の機能のうち、Terraform でオーケストレーションして使用できるものの一覧については、「Terraform リソース」をご参照ください。
Tablestore と Terraform を統合する方法については、「Terraform を使用した Tablestore インスタンスの作成」をご参照ください。
Resource Orchestration Service (ROS)
Resource Orchestration Service (ROS) は、クラウドリソース管理を簡素化する Alibaba Cloud サービスです。テンプレートを記述して、ECS インスタンスや RDS データベースインスタンスなどの必要な Alibaba Cloud リソースと、それらの間の依存関係を定義できます。ROS オーケストレーションエンジンは、テンプレートに基づいてすべてのリソースを自動的に作成および設定し、自動デプロイと運用保守 (O&M) を可能にします。
リソースオーケストレーションをサポートする Tablestore の機能の一覧については、「リソースオーケストレーションリスト」をご参照ください。
Tablestore と ROS を統合する方法については、「ROS 統合の例」をご参照ください。
カスタム API 呼び出しのカプセル化
上記の方法のいずれもビジネス要件を満たさない場合は、リクエストをカプセル化して OpenAPI を呼び出すことができます。この方法は推奨されません。詳細については、「API の概要」および「リクエストボディと署名メカニズム V3」をご参照ください。
よくある質問
Tablestore の詳細については、「Tablestore とは」をご参照ください。
Tablestore は、大量の構造化データを扱うためのサーバーレステーブルストレージサービスです。また、モノのインターネット (IoT) シナリオ向けに深く最適化されたワンストップの IoTstore ソリューションも提供します。製品がサポートする機能の詳細については、「機能」をご参照ください。
付録
付録1：OpenAPI の概要
Alibaba Cloud は、開発者がクラウド製品の OpenAPI を迅速かつ効率的に学習して使用できるように、OpenAPI Web サイトを提供しています。この Web サイトには、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK の取得、コードサンプル、エラー診断、呼び出し統計などの機能が統合されています。OpenAPI ポータルでは、さまざまな Alibaba Cloud 製品の OpenAPI を呼び出し、リクエストとレスポンスを表示できます。ポータルはまた、SDK 呼び出しの例を自動的に生成し、Alibaba Cloud 製品をすぐに使い始めるのに役立ちます。
バージョン
Alibaba Cloud OpenAPI は、バージョン番号を使用して、主要な製品バージョンの API リストを管理します。たとえば、Tablestore は現在、バージョン 2020-12-09 の API リストをサポートしています。文字列 2020-12-09 は API バージョンを表し、日付ではありません。このリストには、最新の公開 API データが表示され、2020-12-09 より前のデータに限定されません。
バージョン | 説明 |
2020-12-09 | 推奨 |
オンラインデバッグ
Tablestore は、OpenAPI ポータルでの API デバッグなどの機能を提供します。呼び出しを行う前に、バージョン、エンドポイント、API スタイル、呼び出しメソッドなど、Tablestore が提供する情報を理解する必要があります。
デバッグのエントリポイント
API デバッグのエントリポイントは次のとおりです： https://next.api.alibabacloud.com/api/Tablestore/2020-12-09
エンドポイント
リソースが存在するリージョンに基づいてエンドポイントを選択し、最小のレイテンシーを得ることができます。
Tablestore サービスのエンドポイントのリストについては、「エンドポイント」をご参照ください。
ユーザー ID
Alibaba Cloud アカウントで OpenAPI ポータルにログインすると、ポータルはデフォルトで Alibaba Cloud アカウントを使用して OpenAPI 呼び出しをデバッグします。Alibaba Cloud アカウントはすべての API へのアクセス権限を持っているため、高いセキュリティリスクをもたらします。API アクセスや日常の運用保守 (O&M) には、RAM ユーザーを作成して使用することを強く推奨します。API を呼び出す前に、RAM ユーザーに必要な権限を付与する必要があります。詳細については、「RAM を使用したアクセス制御」をご参照ください。
ユーザー ID | サポート |
対応 | |
RAM ユーザー (推奨) | 対応 |
RAM ロール (推奨) | 対応 |
注意事項
サービス API の呼び出し後にエラーが返された場合は、返されたエラーコードに基づいて、リクエストパラメーターとその値が正しいかどうかを確認できます。
呼び出しから RequestID または SDK エラーメッセージを記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用してセルフサービス診断を行うこともできます。