tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

インスタンスとKeyの命名規則

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-20 18:20:58
AI翻訳

概要

インスタンス数が数十から数百に増加し、Keyの総量が千万級に達した場合、統一された命名体系が欠如していると、問題調査の効率低下、権限管理の誤り、リソース帰属の不明確さを引き起こします。本文では、インスタンス命名とKey命名の2つの次元から標準化された命名規則を定義し、チームメンバーが名前を通じてリソースが属する環境、業務、地域を直接識別できるようにします。

一、インスタンス命名規則

標準化されたインスタンス名は、コンソール一覧、監視パネル、アラート通知でインスタンスの帰属情報を直接伝えることができ、運用保守担当者が対象インスタンスを迅速に特定し、誤操作のリスクを低減するのに役立ちます。環境、組織、業務、場所の4つの次元に従い、ハイフン-で連結する方式でインスタンスに名前を付けることを推奨します:
{環境}-{支社}-{プロジェクトグループ番号}-{業務名}-{地域}-{専用エリア}-{番号}
各フィールドの意味は以下の通りです:
フィールド
説明
例
環境
本番環境と開発環境を区別し、誤操作による本番サービスへの影響を回避します。
prd(本番)、dev(開発)
分公司
所属分公司名の略称であり、費用帰属と権限区分を容易にします。
cx(財険)
プロジェクトグループ番号
プロジェクトグループの一意の識別子であり、チーム単位でのリソース使用量の集計を容易にします。
p001
ビジネス名称
本インスタンスが対応する具体的な業務であり、意味を持つ英語略称を使用します。
ordercache(注文キャッシュ)
リージョン
インスタンスをデプロイするリージョンの略称であり、Tencent Cloudのリージョンコードと一致させます。
gz(広州)、sh(上海)
専用区画
インスタンスが属する専用区の略称
gzcx01
番号
同一業務におけるインスタンスの番号であり、複数インスタンスのデプロイを区別するために使用します。
1、2
正しい例
例
説明
prd-cx-p001-ordercache-gz-gzcx01-1
本番環境、財険P001プロジェクトグループの注文キャッシュインスタンスは、広州財険01区にデプロイされています。
dev-cx-p001-ordercache-gz-gzcx01-1
前の項目に対応する開発環境インスタンス
prd-cx-p002-policysync-sh-shcx01-1
本番環境、財険P002プロジェクトグループの保険契約同期インスタンスは、上海財険01区にデプロイされています。
悪い例
例
問題
redis-01
環境、業務などの重要な情報が不足しており、帰属を判断できません。
本番-財険-注文
中国語で命名すると、コンソールやスクリプトでエンコード問題が発生しやすくなります。
prd_cx_p001
アンダースコアで区切られており、規約のハイフン形式と一致していません。

二、Keyの命名規則

Keyの命名には、業務名をプレフィックスとし、コロンで階層化する構造を採用することを推奨します。この方式により、異なる業務間のKey衝突を防ぐとともに、Keyに自己記述能力を持たせることができます。名前からその所属する業務システムとデータソースを判断できます。以下の形式で命名することを推奨します:
業務名:データベース名:データベーステーブル名:データID
各フィールドの意味は以下の通りです:
フィールド
説明
例
ビジネス名
ビジネスシステムの略称であり、グローバルで一意な名前空間プレフィックスとして使用されます。
cx(財険)
データベース名
データソースのデータベース名であり、トレーサビリティを容易にします。
orderdb(注文データベース)、userdb(ユーザーデータベース)
データベーステーブル名
データに対応するテーブル名であり、具体的なデータエンティティを特定します。
order(注文テーブル)、user(ユーザーテーブル)
データID
データテーブル内の主キーまたは一意の識別子であり、単一レコードを正確に特定します。
202401150001、100238
正しい例:
例
説明
cx:orderdb:order:202401150001
財険注文データベース内の注文レコードであり、注文番号は202401150001です。
cx:userdb:user:100238
財険ユーザーデータベース内のユーザーレコードであり、ユーザーIDは100238です。
悪い例:
例
問題
000110011
プレフィックスや階層化がないため、業務の帰属やデータソースを判断できません。
cx_cxdb_user_000110011
アンダースコアで階層を区切っており、コロンによる階層化の仕様と一致していません。
cx:cxdb:cxdb_user_info:000110011
テーブル名にデータベース名「cxdb」が重複して含まれており、冗長であり、Keyの長さが増加します。
説明:
Key名は128バイト以内に制御することを推奨します。長すぎるKeyは余分なメモリを占有し、高同時実行シーンでは比較およびハッシュ計算のオーバーヘッドを増加させます。
Keyの命名文字セット、型サフィックス、大Key回避などの詳細な設計基準については、KeyとValueの設計原則を参照してください。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック