alibabacloud-lindorm-agent-skill について
Alibaba Cloud Lindorm の開発ガイド、運用管理、リファレンスを扱うスキルです。SQL、検索、ベクトル・グラフエンジン、インスタンス管理などの要件に応じて関連資料を案内します。
主な機能
- 01接続、SQL、テーブル設計のガイド
- 02検索、ベクトル、グラフ、AI エンジンのガイド
- 03インスタンスのライフサイクルと監視のガイド
- 04障害調査、バックアップ、移行の資料
- 05Aliyun CLI と Lindorm CLI のリファレンス
活用シーン
- 01Lindorm の接続や SQL の手順を探す
- 02ベクトル・グラフ検索の開発を進める
- 03インスタンスや性能の問題を調査する
- 04データベース運用 CLI コマンドを確認する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/alibabacloud-lindorm-agent-skillを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/01-dev/ai-guide.mdconnection-guide.mdgraph-guide.mdknowledge-search-scene.mdmultimodal-search-scene.mdquick-start-guide.mdsearch-guide.mdsql-client-guide.mdsql-operations.mdsql-usage-notes.mdtable-design.mdvector-guide.mdreferences/02-ops/backup-restore.mdconnection-troubleshoot.mddata-migration.mderror-troubleshoot.mdinstance-lifecycle.mdinstance-management.mdmonitoring-guide.mdnetwork-access-control.mdslow-query-analysis.mdstorage-analysis.mduser-permission.mdreferences/03-ref/acceptance-criteria.mdcli-installation-guide.mdhbase-shell-guide.mdlindorm-cli-guide.mdram-policies.mdrelated-commands.mdverification-method.md詳細
Lindorm Agent Skill
Alibaba Cloud Lindorm クラウドネイティブのマルチモデルデータベース向け Skill です。運用管理、開発ガイダンス、リファレンス資料の 3 つの分野をカバーします。開発ガイダンスには、従来の SQL／検索の利用に加え、ベクトル検索、Lindorm AI エンジンの呼び出し、マルチモーダル画像・テキスト検索、プライベートナレッジベース検索が含まれます。
コア機能マトリックス
| カテゴリ | サブシナリオ | リファレンスドキュメント |
|---|---|---|
| 01-開発ガイダンス | 接続設定、クイックスタート、SQL ガイド、テーブル設計、検索エンジンの利用、ベクトル検索、グラフエンジンの利用、AI エンジンの呼び出し、マルチモーダル検索、ナレッジ検索 | references/01-dev/ |
| 02-運用管理 | インスタンス管理、インスタンスのライフサイクル（作成／スケール／解放／支払いタイプ）、モニタリング、エラーのトラブルシューティング、ストレージ分析、接続診断、ネットワークアクセス制御、バックアップと復元、移行、権限、スロークエリ | references/02-ops/ |
| 03-リファレンス | Aliyun CLI コマンドリファレンス、Lindorm CLI（SQL クライアント）ガイド、HBase Shell ガイド、RAM 権限、受け入れ基準 | references/03-ref/ |
判断ツリー
User Request
├── Connection / DDL / SQL / Code examples → 01-dev
│ ├── Connection address / code → references/01-dev/connection-guide.md
│ ├── DDL / write / query examples → references/01-dev/quick-start-guide.md
│ ├── SQL connection & SQL-based application development → references/01-dev/sql-client-guide.md
│ ├── SQL syntax reference → references/01-dev/sql-operations.md
│ ├── MySQL compatibility → references/01-dev/sql-usage-notes.md
│ ├── Table design guide → references/01-dev/table-design.md
│ ├── Search engine standalone usage → references/01-dev/search-guide.md
│ ├── Vector engine usage through Search / Wide Table → references/01-dev/vector-guide.md
│ ├── Graph engine usage (Gremlin / Schema / query) → references/01-dev/graph-guide.md
│ ├── Lindorm AI engine model calls → references/01-dev/ai-guide.md
│ ├── Multimodal image-text search scene → references/01-dev/multimodal-search-scene.md
│ └── Knowledge base search / private QA scene → references/01-dev/knowledge-search-scene.md
│
├── Instance / Monitoring / Errors / Performance / Storage / Connection / Scaling / Backup / Migration / Permissions / Slow query → 02-ops
│ ├── Instance query (list / details / engines / storage) → references/02-ops/instance-management.md
│ ├── Instance write ops (create / scale / release / pay-type) → references/02-ops/instance-lifecycle.md
│ ├── IP whitelist / ECS security group → references/02-ops/network-access-control.md
│ ├── Monitoring / Alerts → references/02-ops/monitoring-guide.md
│ ├── Error codes → references/02-ops/error-troubleshoot.md
│ ├── Storage analysis → references/02-ops/storage-analysis.md
│ ├── Connection diagnostics → references/02-ops/connection-troubleshoot.md
│ ├── Scale up/down → references/02-ops/instance-lifecycle.md
│ ├── Backup & restore → references/02-ops/backup-restore.md
│ ├── Data migration → references/02-ops/data-migration.md
│ ├── Account & permissions → references/02-ops/user-permission.md
│ └── Slow query analysis → references/02-ops/slow-query-analysis.md
│
└── Command list / Permission reference / CLI tools / SQL execution → 03-ref
├── Aliyun CLI command list + region rule + return structures (`aliyun lindorm ...`) → references/03-ref/related-commands.md
├── Lindorm CLI — SQL client, executes SQL (`lindorm-cli`) → references/03-ref/lindorm-cli-guide.md
├── HBase Shell (alihbase) → references/03-ref/hbase-shell-guide.md
├── RAM permission list → references/03-ref/ram-policies.md
├── Aliyun CLI setup → references/03-ref/cli-installation-guide.md
├── Acceptance criteria → references/03-ref/acceptance-criteria.md
└── Verification methods → references/03-ref/verification-method.md
クイック対応表
| ユーザーの発言 | シナリオ | 参照ドキュメント |
|---|---|---|
| "接続方法／接続アドレス" | 接続設定 | references/01-dev/connection-guide.md |
| "テーブルの作成／データの挿入／クエリの例" | クイックスタート | references/01-dev/quick-start-guide.md |
| "テーブルの作成方法" | テーブル設計 | references/01-dev/table-design.md |
| "SQL による DBA／運用デバッグ" | CLI 経由の SQL 運用 → SQL 構文 | references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md |
| "SQL アプリの開発／コードでの接続" | SQL クライアント開発 → SQL 構文 | references/01-dev/sql-client-guide.md → references/01-dev/sql-operations.md |
| "SQL 構文" | SQL リファレンス | references/01-dev/sql-operations.md |
| "SQL の使い方" | SQL ガイド | references/01-dev/sql-client-guide.md |
| "MySQL 互換性" | SQL に関する注意事項 | references/01-dev/sql-usage-notes.md |
| "検索エンジンの使い方／ES API／30070" | 検索エンジンの単独利用 | references/01-dev/search-guide.md |
| "ベクトルエンジン／KNN／RRF／IVFPQ／IVFBQ" | 検索または Wide Table によるベクトル検索 | references/01-dev/vector-guide.md |
| "AI エンジン／埋め込み／VL／リランク／9002" | Lindorm AI エンジンのモデル呼び出し | references/01-dev/ai-guide.md |
| "マルチモーダル検索／画像とテキストの検索／画像から画像／テキストから画像" | マルチモーダルな画像・テキスト検索のシナリオ | references/01-dev/multimodal-search-scene.md |
| "ナレッジベース検索／プライベート QA／ドキュメントのチャンク分割" | ナレッジベース検索と QA のシナリオ | references/01-dev/knowledge-search-scene.md |
| "グラフエンジン／Gremlin／グラフクエリ／グラフスキーマ／hasVector" | Gremlin によるグラフエンジンの利用 | references/01-dev/graph-guide.md |
| "インスタンスの一覧／既存のインスタンス" | インスタンスの照会 | references/02-ops/instance-management.md |
| "インスタンスの作成／Lindorm のプロビジョニング" | インスタンスの作成 | references/02-ops/instance-lifecycle.md |
| "スケーリング／サイズ変更／ノードの追加／エンジンの有効化" | インスタンスのスケーリング | references/02-ops/instance-lifecycle.md |
| "インスタンスの解放／削除／解約" | インスタンスの解放 | references/02-ops/instance-lifecycle.md |
| "課金方式の切り替え／サブスクリプションへの変更" | 支払い方式の変更 | references/02-ops/instance-lifecycle.md |
| "ホワイトリスト／IP の追加／セキュリティグループ" | ネットワークアクセス制御 | references/02-ops/network-access-control.md |
| "CPU／メモリ／QPS／レイテンシ" | モニタリング情報の照会 | references/02-ops/monitoring-guide.md |
| "アラートの設定／アラート通知" | モニタリングアラート | references/02-ops/monitoring-guide.md |
| "エラーが発生した／エラーコード" | エラーのトラブルシューティング | references/02-ops/error-troubleshoot.md |
| "スロークエリ／クエリが遅い" | スロークエリ分析 | references/02-ops/slow-query-analysis.md |
| "パフォーマンスが低い／RT が高い" | モニタリング情報の照会 | references/02-ops/monitoring-guide.md |
| "接続できない／接続タイムアウト" | 接続診断 | references/02-ops/connection-troubleshoot.md |
| "ストレージ使用量" | ストレージ分析 | references/02-ops/storage-analysis.md |
| "ホット／コールドデータ／階層型ストレージ" | ストレージ分析 | references/02-ops/storage-analysis.md |
| "スケールアップ／ノードの追加" | スケーリング | references/02-ops/instance-lifecycle.md |
| "データのバックアップ／復元" | バックアップと復元 | references/02-ops/backup-restore.md |
| "データ移行／同期" | データ移行 | references/02-ops/data-migration.md |
| "アカウントの作成／権限" | 権限管理 | references/02-ops/user-permission.md |
| "lindorm-cli／lindormcli" | Lindorm CLI（SQL クライアント） | references/03-ref/lindorm-cli-guide.md |
| "aliyun lindorm／管理 CLI／インスタンスライフサイクル CLI" | Aliyun CLI コマンドリファレンス | references/03-ref/related-commands.md |
| "SQL の実行／クエリの実行" | CLI 経由の SQL 実行 | references/03-ref/lindorm-cli-guide.md → references/01-dev/sql-operations.md |
| "SHOW TABLES／DESCRIBE／テーブルスキーマの表示／テーブル一覧" | CLI によるスキーマの確認 | references/03-ref/lindorm-cli-guide.md |
| "データのプレビュー／データの確認／データのクエリ" | CLI によるデータのプレビュー | references/03-ref/lindorm-cli-guide.md |
| "接続のテスト／接続の確認" | CLI による接続確認 | references/03-ref/lindorm-cli-guide.md |
| "HBase Shell／hbase shell " | HBase Shell | references/03-ref/hbase-shell-guide.md |
Aliyun CLI
前提条件
CLI の呼び出しが必要な場合、エージェントは次の事項を確認する必要があります。
- CLI がインストール済みであること：
aliyun versionが 3.4.1 以上であること —aliyun lindormサブコマンドは 3.4.1 以降でのみ利用できます。古い CLI では、aliyun lindorm ...の呼び出しはすべて不明なコマンドとして失敗するため、コマンドに問題があると判断する前にバージョンを確認してください。CLI がインストールされていないか、古すぎる場合は、references/03-ref/cli-installation-guide.mdを参照してください。lindormプラグインは、以下の AI モードの手順（aliyun configure set --auto-plugin-install trueとaliyun plugin update）でインストールされます。aliyun lindorm --versionで確認してください。 - 認証情報が設定済みであること：
セキュリティルール：
- AK/SK の値を読み取ったり、エコーしたり、出力したりすることは絶対にしないでください
- 会話やコマンドラインで AK/SK を直接入力するよう、ユーザーに絶対に求めないでください
- 認証情報の状態の確認には、
aliyun configure listのみを使用してください
有効なプロファイルが存在しない場合は、停止してください。このセッションの外部で認証情報を設定してください。
- 権限が付与されていること：最低限、
AliyunLindormReadOnlyAccessとAliyunCloudMonitorReadOnlyAccessが必要です[必須] 権限エラーへの対応： 実行中のいずれかの時点で、権限エラーが原因でコマンドまたは API 呼び出しが失敗した場合は、次の手順に従ってください。
- この SKILL に必要な権限の完全な一覧を確認するため、
references/03-ref/ram-policies.mdを読みます ram-permission-diagnoseスキルが利用可能な場合は、それを使用して権限を申請する手順をユーザーに案内します。利用できない場合は、必要な RAM ポリシー／アクションの一覧、エラーコード、およびユーザーが RAM コンソール を通じて管理者に権限を申請するための手順を、順を追って直接提示します- 必要な権限が付与されたことをユーザーが確認するまで、一時停止して待ちます
- この SKILL に必要な権限の完全な一覧を確認するため、
可観測性（すべての aliyun コマンドで必ず従うこと）
このスキルを読み込んだら、セッション全体で一度だけ、新しいランダムなセッション ID（32 文字の小文字の 16 進文字列）を生成し、以下の
{session-id}として使用してください。セッション ID はセッションごとに新しく生成する必要があります。以下の例の値や、以前のセッションのセッション ID を再利用しないでください。references/manifest.jsonのversionフィールドからスキルのバージョンを読み取り、以下の{skill-version}として使用してください。ルール：クラウド API を呼び出す
aliyunCLI コマンドには、すべて--user-agentフラグを含める必要があります。 ローカルユーティリティコマンド（例：configure、plugin、version）はこのフラグに対応していないため、対象外です。--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/{session-id} skill-version/{skill-version}"例（session-id が
a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6、skill-version が0.0.3の場合）：aliyun lindorm v1 instance describe ld-xxx --lindorm-region cn-shanghai \ --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-lindorm-agent-skill/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 skill-version/0.0.3"
aliyunの API コマンドを呼び出す際は、--user-agentを省略したり、書式を変更したり、追加し忘れたりしないでください。
パラメーターの確認
コマンドを実行する前に、ユーザーが設定できるすべてのパラメーター（リージョン、インスタンス ID、期間など）を必ずユーザーに確認してください。
バージョンの判別
インスタンスを操作する場合、V1 と V2 ではサブコマンドが異なるため、エージェントはまずインスタンスのアーキテクチャを判別する必要があります。推測せずに 1 回の呼び出しでアーキテクチャを判別できるよう、aliyun lindorm instance list を優先してください。このコマンドはリージョン内のすべてのインスタンスを返し、arch（v1 / v2）と service_type の両方の列が含まれています。
aliyun lindorm instance list --lindorm-region cn-shanghai --output json
ID がわかっている単一のインスタンスの場合、aliyun lindorm v1 instance describe <id> も両方のアーキテクチャについて service_type を返します。v1 のコマンドパスですが、基盤となる GetLindormInstance アクションは共通です。
service_type とアーキテクチャの対応は次のとおりです。
| service_type | バージョン | デプロイメント |
|---|---|---|
lindorm | V1 | シングル AZ |
lindorm_multizone | V1 | マルチ AZ（HA） |
lindorm_multizone_basic | V1 | マルチ AZ（ベーシック） |
lindorm_v2 | V2 | シングル AZ |
lindorm_v2_multizone | V2 | マルチ AZ（ベーシック） |
lindorm_v2_multizone_ha | V2 | マルチ AZ（HA） |
一般ポリシー
リージョンポリシー
| シナリオ | コマンド | リージョンが必要 |
|---|---|---|
| 対応リージョンの一覧表示 | aliyun lindorm regions list | ❌ リージョンに依存しません。何も設定されていない場合はデフォルトのエンドポイントにフォールバックします |
| 全リージョンの概要を照会 | aliyun lindorm summary | ❌ リージョンに依存しません。すべてのリージョンの V1 + V2 を対象とします |
| インスタンス一覧を照会 | aliyun lindorm instance list | ✅ --lindorm-region。デフォルトは cn-shanghai です |
| インスタンスの詳細／エンジン／ストレージ／ホワイトリストを照会 | aliyun lindorm v1|v2 instance ... | ✅ --lindorm-region。エンドポイントはインスタンス ID ではなく、リージョンから解決されます |
| クラウドモニタリングのクエリ | cms commands | ❌ 不要です。instanceId を使用してリージョンが自動解決されます |
⚠️ [必須]
aliyun lindormの配下では、リージョンには--lindorm-regionを渡し、--regionは絶対に使用しないでください。--regionは親のaliyunCLI のグローバルフラグであり、プラグインに届く前に消費されます。コマンドは成功しますが、指定したリージョンではなくプロファイルのリージョンを照会します。これはエラーではなく、誤った結果を返す落とし穴です。プラグインは stderr に警告を出力するため、エージェントは無視してはいけません。note: using region cn-shenzhen (from profile/environment). '--region' is consumed by the aliyun CLI and never reaches this plugin — use '--lindorm-region <region>' to override.
--profileにも同じことが当てはまり、プラグイン側で対応するフラグは--lindorm-profileです。aliyun lindorm --helpより：--lindorm-region string Same as --region; use this under 'aliyun lindorm', where --region is consumed by the aliyun CLI --lindorm-profile string Same as --profile; use this under 'aliyun lindorm', where --profile is consumed by the aliyun CLI
--lindorm-regionを指定しない場合、リージョンはアクティブなプロファイルから取得されます。必ず--lindorm-regionを明示的に渡し、結果がどのリージョンを示すかをユーザーに伝える前に、出力のregion_idを確認してください。例外：
profile create --region <region>は、そのサブコマンドのコマンド固有のフラグであり、記載どおりに動作します。
ユーザーから、リージョン指定のクエリでエラーなく別のリージョンのデータが返された（
region_idが誤っている）という報告があった場合、このフラグの落とし穴が原因だと診断してください。RAM／権限（Forbidden）の問題として扱ってはいけません。根本原因（--regionは親 CLI によって消費されること）と修正方法（--lindorm-regionを使うこと）を説明してください。
⚠️
summaryは件数を過少に報告します。インベントリとして使用しないでください。 合計値には整合性がある一方で、個々のリージョンの件数が過少だったり、リージョン全体が欠落したりすることが確認されています（例：あるリージョンが 9 インスタンスと報告される一方、instance list --lindorm-regionでは 11 件が返される）。あくまで概要をすばやく確認するために使用してください。正確な件数を確認するには、regions listの後、各リージョンでinstance list --lindorm-region <region>を実行してください。
時刻形式
クラウドモニターの時刻パラメーターに関するタイムゾーンの注意事項：
- ✅
2026-04-14 08:00:00（現地時刻。CST 北京時間として解析されます） - ✅
1773897600000（Unix ミリ秒タイムスタンプ。タイムゾーンの曖昧さがありません） - ✅
2026-04-14T08:00:00Z（ISO 8601 UTC 完全形式。UTCとして解析されます。つまり CST+8 = 16:00 です） - ❌
2026-04-14T08:00Z（ISO 8601 短縮形式。秒がなく、未対応です。parse param time errorが返されます） - ❌ ユーザーが現地時刻を意図している場合は、UTC の Z 形式を絶対に使用しないでください（例：ユーザーが「14:00」と言った場合は、
2026-04-14T14:00:00Zではなく2026-04-14 14:00:00と指定します） - ⚠️ 注意：現地時刻と ISO 8601 の Z 形式では、異なる時間範囲が照会されます。タイムゾーンに関する問題のよくある原因です
コマンドリファレンス
照会（読み取り専用、課金への影響なし）
| コマンド | 説明 | 例 |
|---|---|---|
aliyun lindorm regions list | サポートされているリージョンを一覧表示します（DescribeRegions）。リージョンに依存しません | aliyun lindorm regions list --output json |
aliyun lindorm summary | 全リージョン、全アーキテクチャのインスタンス数を表示します（GetInstanceSummary）。リージョンに依存しません | aliyun lindorm summary --output json |
aliyun lindorm instance list | 対象リージョンのすべてのインスタンスを、V1 と V2 を混在させて一覧表示します（GetLindormInstanceList）。arch / service_type 列でアーキテクチャを識別できます | aliyun lindorm instance list --lindorm-region cn-shanghai --output json |
aliyun lindorm v1 instance describe | V1 の構成、バージョン、ステータスを表示します（GetLindormInstance）。接続アドレスは表示されません | aliyun lindorm v1 instance describe ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v2 instance describe | エンジントポロジーや connect_address_list を含む V2 の詳細を表示します（GetLindormV2InstanceDetails） | aliyun lindorm v2 instance describe ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v1 instance engine-list | エンジンごとの接続アドレスを表示します（GetLindormInstanceEngineList）。V1 の接続アドレスを取得する唯一の方法です | aliyun lindorm v1 instance engine-list ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v2 instance engine-list | 同じエンドポイントの V2 サブツリーです | aliyun lindorm v2 instance engine-list ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v1 instance storage | V1 のストレージ使用量を、ホット／コールド、エンジンごと、ディスクタイプごとに表示します（GetLindormFsUsedDetail） | aliyun lindorm v1 instance storage ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v2 instance storage | ディスクカテゴリー別に V2 のストレージ使用量を表示します（GetLindormV2StorageUsage） | aliyun lindorm v2 instance storage ld-xxx --lindorm-region cn-beijing --output json |
aliyun lindorm v1 instance whitelist get | IP ホワイトリストを取得します（GetInstanceIpWhiteList、V1 / V2 共通） | aliyun lindorm v1 instance whitelist get ld-xxx --lindorm-region cn-beijing |
aliyun lindorm v1 instance security-group get | 関連付けられた ECS セキュリティグループを取得します（GetInstanceSecurityGroups、V1 / V2 共通） | aliyun lindorm v1 instance security-group get ld-xxx --lindorm-region cn-beijing |
aliyun lindorm vpc list | リージョン内の VPC を一覧表示します（DescribeVpcs） | aliyun lindorm vpc list --lindorm-region cn-beijing --output json |
aliyun lindorm vpc vswitch | VSwitch を一覧表示します。VPC / ゾーンで絞り込めます（DescribeVSwitches） | aliyun lindorm vpc vswitch --vpc-id vpc-xxx --zone-id cn-beijing-i --lindorm-region cn-beijing --output json |
変更（課金対象／破壊的な操作 — --yes を指定しない場合、確認を求めます）
| コマンド | 説明 | 例 |
|---|---|---|
aliyun lindorm v2 instance create | V2 インスタンスを作成します（CreateLindormV2Instance）。--dry-run をサポートします | aliyun lindorm v2 instance create --lindorm-region cn-beijing --name demo --zone-id cn-beijing-i --vpc-id vpc-xxx --vswitch-id vsw-xxx --arch-version 1.0 --pay-type POSTPAY --engine TABLE:lindorm.g.2xlarge:2 --cloud-storage-type PerformanceStorage --cloud-storage-size 400 --dry-run |
aliyun lindorm v1 instance create | V1 インスタンスを作成します（CreateLindormInstance） | aliyun lindorm v1 instance create --lindorm-region cn-hangzhou --name demo --zone-id cn-hangzhou-h --vpc-id vpc-xxx --vswitch-id vsw-xxx --lindorm-spec lindorm.g.2xlarge --lindorm-num 2 --instance-storage 480 --pay-type POSTPAY |
aliyun lindorm v2 instance modify | V2 インスタンスをスケールします（UpdateLindormV2Instance）。1 回の呼び出しにつき、クラスの変更は 1 種類です | aliyun lindorm v2 instance modify ld-xxx --lindorm-region cn-beijing --cloud-storage-size 800 --dry-run |
aliyun lindorm v1 instance modify | V1 インスタンスをスケールします（UpgradeLindormInstance）。指定されたフラグから UpgradeType が推定されます | aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --lindorm-num 4 --cluster-storage 1280 --yes |
aliyun lindorm v1 instance modify --tsdb-spec/--tsdb-num | 時系列エンジンを有効化またはスケールします | aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --tsdb-spec lindorm.g.4xlarge --tsdb-num 2 --cluster-storage 2160 --yes |
aliyun lindorm v1 instance modify --search-spec/--search-num | 検索エンジンを有効化またはスケールします | aliyun lindorm v1 instance modify ld-xxx --lindorm-region cn-beijing --search-spec lindorm.g.xlarge --search-num 2 --yes |
aliyun lindorm v1 instance whitelist update | グループの IP ホワイトリストを置き換えます（UpdateInstanceIpWhiteList） | aliyun lindorm v1 instance whitelist update ld-xxx --lindorm-region cn-beijing --group default --ips 10.0.0.0/8,192.168.1.1 |
aliyun lindorm v1 instance security-group update | バインドされている ECS セキュリティグループを置き換えます（UpdateInstanceSecurityGroups） | aliyun lindorm v1 instance security-group update ld-xxx --lindorm-region cn-beijing --groups sg-aaa,sg-bbb |
aliyun lindorm v1 instance switch-pay-type | 課金方法を変更します（ModifyInstancePayType、V1/V2 共通） | aliyun lindorm v1 instance switch-pay-type ld-xxx --lindorm-region cn-beijing --pay-type PREPAY --pricing-cycle Month --duration 1 |
aliyun lindorm v2 instance release | V2 インスタンスをリリースします（ReleaseLindormV2Instance）。POSTPAY のみ | aliyun lindorm v2 instance release ld-xxx --lindorm-region cn-beijing --yes |
aliyun lindorm v1 instance release | V1 インスタンスをリリースします（ReleaseLindormInstance）。POSTPAY のみ | aliyun lindorm v1 instance release ld-xxx --lindorm-region cn-beijing --yes --immediate |
aliyun lindorm instance ...はaliyun lindorm v2 instance ...のエイリアスです。⚠️
aliyun lindormでは、--region/--profileではなく、--lindorm-region/--lindorm-profileを使用してください。後者ではなく前者はaliyunCLI のグローバルフラグであり、CLI 自身が解析してプラグインに転送しないため、何も通知されずに無視されます（終了コードは 0 ですが、誤ったリージョンが使用されます）。 エイリアスはスタンドアロンバイナリでも機能するため、どちらのモードでも同じ表記を使用できます。 プラグイン v0.2.20 以降が必要です。すべてのサブコマンドで使用できるその他のフラグ：
--aliyun-profile/--output table|json|yaml（-o）/--yes/--non-interactive。
whitelist/security-group/switch-pay-type/engine-listはv1 instanceとv2 instanceの両方で同じように使用できます。storageはアーキテクチャ固有です。V2 インスタンスに対してv1 instance storageを実行すると、エラーではなく、空の本文とともに HTTP 200 が返されます。逆の場合は 451 が返されます。
作成／変更で使用する列挙値
| 列挙型 | 値 |
|---|---|
EngineType (--engine) | TABLE ワイドテーブル / TSDB 時系列 / LSEARCH 検索 / LVECTOR ベクトル / LTS ストリーム / LCOLUMN 列指向ストア |
--engine の形式 | <EngineType>:<NodeSpec>:<NodeCount>[:<DiskType>:<DiskSizeGB>]。複数指定可能。ディスク部分はアーキテクチャ 3.0 専用です。1.0 / 2.0 では、インスタンスレベルの --cloud-storage-* を推奨します |
CloudStorageType | StandardStorage 標準 / PerformanceStorage パフォーマンス / CapacityStorage 容量 |
ArchVersion | 1.0 単一ゾーン（--zone-id + --vswitch-id） / 2.0 マルチゾーンのベーシック構成 / 3.0 マルチゾーンの高可用性構成（2.0 と 3.0 はどちらも --primary-* + --standby-* + --coordinator-* が必要） |
PayType | PREPAY サブスクリプション（--duration が必要） / POSTPAY 従量課金 |
PricingCycle | Month（--duration は 1-9） / Year（--duration は 1-3） |
V1 --cluster-storage | 480-1017600 GB、単一 AZ のインスタンスレベルのクラウドディスク。クラウドディスクは拡張のみ可能です |
V1 --core-storage | コアノードごとのディスク。マルチ AZ 専用です |
V1 --cold-storage | 800-1000000 GB |
| V1 のノード数 | --lindorm-num 2-90 / --tsdb-num 2-24 / --search-num 2-60 |
エンジンの種類
| エンジン | V1 コード | V2 コード | 備考 |
|---|---|---|---|
| LindormTable | lindorm | lindorm | HBase 互換で、SQL をサポートします（推奨） |
| LindormTable（列指向） | — | lcolumn | V2 専用です |
| LindormTSDB | tsdb | tsdb | 時系列データストレージ |
| LindormSearch | solr | lsearch | ポート 30070（ES 互換）。solr は旧 API のコード名です。Solr API（ポート 10020）は非推奨で、オフラインです |
| Lindorm Tunnel Service | bds | bds | 旧称は BDS。外部接続はありません |
| Compute Engine | compute | compute | Flink ストリーミングエンジン。外部接続はありません |
| Stream Engine | stream | lstream | ポート 33060（MySQL プロトコル） |
| Message Engine | — | lmessage | Kafka 互換で、トピック管理とメッセージの生成・消費をサポートします |
| Vector Engine | — | lvector | V2 専用です。組み込みのベクトル検索エンジンで、Search 30070 または Wide Table + Search 経由でアクセスします |
| AI Engine | — | lai | V2 専用です。AI 推論エンジン（埋め込み / VL / 再ランキング / チャット）。ポート 9002 |
| LindormDFS | file | file | OSS 互換ストレージ（HDFS プロトコル、ポート 9000） |
ポート早見表
| エンジン | プロトコル | ポート | 備考 |
|---|---|---|---|
| LindormTable | MySQL プロトコル | 33060 | ✅ 推奨。SQL 接続にはこちらを推奨します |
| LindormTable | HBase API | 30020 | HBase ネイティブ API 互換 |
| LindormTable | Avatica プロトコル | 30060 | ⚠️ レガシー専用です。MySQL プロトコルに移行してください |
| LindormTable | Cassandra CQL | 9042 | ⚠️ レガシー専用です。Cassandra プロトコル互換 |
| Stream Engine | MySQL プロトコル | 33060 | MySQL プロトコル経由の Stream SQL |
| LindormTSDB | HTTP SQL | 8242 | HTTP SQL API |
| LindormSearch | ES 互換 | 30070 | Elasticsearch 互換ポート（固定）。Solr API（ポート 10020）は非推奨で、オフラインです |
| Vector Engine | 組み込みサービス | — | V2 専用です。直接のエンドポイントはありません。Search 30070 または Wide Table + Search を使用してください |
| AI Engine | DashScope 互換 HTTP | 9002 | V2 専用です。x-ld-ak / x-ld-sk ヘッダーを使用します |
| LindormDFS | HDFS | 9000 | NameNode ポート |
Cloud Monitor API（aliyun cms）
| コマンド | 説明 | 例 |
|---|---|---|
aliyun cms describe-metric-meta-list | 利用可能な監視メトリクスの一覧を取得します | aliyun cms describe-metric-meta-list --namespace acs_lindorm |
aliyun cms describe-metric-last | 最新の監視データを取得します（ノードごとのデータを返します。Datapoints は JSON 文字列のため、追加の解析が必要です） | aliyun cms describe-metric-last --namespace acs_lindorm --metric-name cpu_idle --dimensions '[{"instanceId":"ld-xxx"}]' |
aliyun cms describe-metric-data | 過去の傾向データを取得します（期間ごとに集計され、ホストのディメンションはありません） | aliyun cms describe-metric-data --namespace acs_lindorm --metric-name cpu_idle --dimensions '[{"instanceId":"ld-xxx"}]' --start-time "2026-04-14 08:00:00" --end-time "2026-04-14 09:00:00" --period 60 |
メトリクスの対応関係
| ユーザーの表現 | V1 メトリクス | V2 メトリクス | 単位 |
|---|---|---|---|
| CPU 使用率 | 100 - cpu_idle | 100 - cpu_idle | % |
| メモリ使用率 | mem_used_percent | 1 - mem_free / mem_total | % |
| QPS | read_ops + write_ops | read_ops + write_ops | ops/s |
| レイテンシ／RT | read_rt / get_rt_avg | read_rt / get_rt_avg | ms |
| P99 レイテンシ | get_rt_p99 / put_rt_p99 | —（データなし） | ms |
| ホットストレージ使用率 | hot_storage_used_percent | v2 instance storage | % |
| ストレージ全体の使用率 | storage_used_percent | v2 instance storage | % |
| ホットストレージのバイト数 | hot_storage_used_bytes | v2 instance storage | bytes |
| コールドストレージ使用率 | cold_storage_used_percent | v2 instance storage | % |
| コールドストレージのバイト数 | cold_storage_used_bytes | v2 instance storage | bytes |
メトリクスの詳細：references/02-ops/monitoring-guide.md
対話ガイドライン
出力形式
監視クエリ：
[Summary] CPU usage 25% (normal)
[Time] <YYYY-MM-DD HH:MM–HH:MM>
[Trend] Stable (variance <10%)
[Details] avg 24.5%, max 32.1%, min 18.3%
エラーのトラブルシューティング：
[Error Code] InvalidParameter.InstanceId
[Meaning] Instance ID is invalid or does not exist
[Possible Causes] 1.xxx 2.xxx 3.xxx
[Resolution Steps] 1.xxx 2.xxx 3.xxx
インスタンス一覧：
[Region] cn-shanghai [Count] 3
| ID | Name | Status | Engines |
|----|------|--------|---------|
| ld-xxx | prod | Running | LindormTable + LindormTSDB |
回答の言語と用語（必須）
- 中国語での質問には中国語で回答してください。 ユーザーが中国語で質問した場合、最終回答も中国語にする必要があります（英語のみの回答は禁止）。また、ユーザーが使う標準的な中国語の用語をそれぞれ少なくとも一度はそのまま使用してください。例：云监控（「CloudMonitor」のみではなく）、全地域（「cross-region」のみではなく）、全量替换（「full replacement」のみではなく）、白名单（「whitelist」／「IP whitelist」のみではなく）、拓扑（「topology」のみではなく）、连接地址（「connection address」／「endpoint」のみではなく）。中国語と英語を併記した説明は問題ありませんが、英語のみの回答や中国語の用語を完全に省いた回答は不正解です。
- API レスポンスのフィールド名は正確に記載してください。 クエリ結果や不一致について説明する場合は、正確なレスポンスフィールド名（例：
region_id、ServiceType、net_type）を示してください。フィールド名を示さずに言い換えると、追跡可能性が失われます。 - コントロールプレーンの OpenAPI 操作はすべて、対応する CLI 形式と併記してください。 回答で Lindorm のコントロールプレーン OpenAPI 操作に言及する場合（利用できない状況に限りません）は、対応する
aliyun lindormCLI コマンド（例：GetLindormInstance/aliyun lindorm v1 instance describe）も併記してください。この併記ルールは、対応する Lindorm コントロールプレーン OpenAPI 操作が存在しない、データプレーンの SQL、HBase Shell、Elasticsearch 互換 HTTP、Gremlin の操作には適用されません。
実行がブロックされた場合 — 常に完全な計画を提示する
クエリを完了できない場合（現在の認証情報ではインスタンスが表示されない、権限が拒否された、リソースが見つからない、監視データが空であるなど）、ブロックされたことを報告するだけで終わらせないでください。最終回答には、以下をすべて漏れなく含める必要があります。
- 完全な判断手順 — すべての分岐について、正確な OpenAPI 操作名とその CLI コマンドをセットで示してください（CLI 形式だけを示すことはできません）。試した分岐だけでなく、すべての分岐を示します。例：ストレージ分析では、まず
GetLindormInstance（aliyun lindorm v1 instance describe）でServiceTypeを確認し、その後GetLindormV2StorageUsage（aliyun lindorm v2 instance storage）またはGetLindormFsUsedDetail（aliyun lindorm v1 instance storage）を実行します。接続診断では、GetLindormInstanceでインスタンスのステータスを確認し、GetLindormInstanceEngineList（aliyun lindorm v1 instance engine-list／v2 instance engine-list）でエンジンのエンドポイントを確認し、GetLindormV2InstanceDetails（aliyun lindorm v2 instance describe。engines[]／node_groups[]／connect_address_list[]を返します）でトポロジーを確認し、net_type（パブリックか VPC か）も確認します。 - ユーザーが求めた項目をすべて含める — インスタンスとそのエンジンの両方を求められた場合は、エンジンも明示的に記載します。ピークの分析を求められた場合は、ピーク分析の結果または方法を明示します（ユーザー自身の表現では「峰值」など）。
- 続行に必要な情報を具体的に示す — インスタンス ID、所有アカウント、リージョン、時間範囲。
- 不足情報が提供されたらユーザーが実行できるコマンドを提示します。
- 具体例を示し、空のプレースホルダーは使わない — 実際の値を取得できない場合（アカウント内のインスタンス数が 0 など）でも、成果物の具体的な形式を示します。実際の列名を含むトポロジーテーブルや、実際のポート番号を含む完全な接続アドレス形式（例：
ld-xxx-proxy-lindorm.lindorm.rds.aliyuncs.com:30020、MySQL プロトコル 33060、TSDB HTTP 8242）を記載します。具体的な形式を示さずに<待查询>／<TBD>とだけ記載した場合は、回答として不十分です。
ブロックされた理由を説明するだけの回答は不適切です。
コード生成の基準
一般原則
- まず Skill のドキュメントを参照する：Lindorm はドメイン固有の知識です。情報はリファレンスドキュメントに基づく必要があり、学習済み知識だけで直接回答することは禁止されています。
- Skill でカバーされていない場合は公式ドキュメントを確認する：リファレンスドキュメントで扱われていないシナリオについては、Alibaba Cloud の公式ドキュメントを参照してください。
生成前チェックリスト
- □ 接続パラメーター名が正しい（MySQL プロトコル：
jdbc:mysql://host:33060、HBase API：hbase.zookeeper.quorum） - □ ポート番号が正しい（LindormTable／Stream Engine の MySQL は 33060、HBase API は 30020、LindormTSDB HTTP は 8242、LindormSearch は 30070）
- □ 公式ドキュメントへのリンクを含める
コメント
Markdown 対応