利用制限
TDSQL-C for MySQLはクラスタの安定した運用とセキュリティを確保するため、一部の使用上の制約があります。本ドキュメントではTDSQL-C for MySQLの関連する使用制限についてご紹介します。
エンジン制限
TDSQL-C for MySQLはInnoDBエンジンとLibraDBエンジンのみサポートされます。
命名の制限
制限項目 | 制限の説明 |
クラスタ名 | 長さは60文字未満です。 入力が 中国語/英語/数字/"-"/"_"/"."に対応しています。 |
読み書き/読み取り専用インスタンス名 | 長さは60文字未満です。 入力が 中国語/英語/数字/"-"/"_"/"."に対応しています。 |
アカウント名 | 長さは1 - 16文字です。 アルファベット、数字、特殊文字で構成され、アルファベットで始まり、アルファベットまたは数字で終わる必要があります。 スペシャルキャラクターは "_"です。既存のアカウント名と重複することはできません。 |
データベース名 | 長さは最大64文字です。 小文字、数字、ハイフン (-)、アンダースコア(_)で構成されています。アルファベットで始まり、アルファベットあるいは数字で終わる必要があります。 既存のデータベース名と重複することはできず、また作成後のデータベース名の変更はサポートされていません。 |
クォータ制限
クォータ | 制限 |
読み取り専用インスタンス | インスタンス形態がプリセットリソースであるクラスタでは、読み取り専用インスタンスの合計作成数は0～15個です。これにはTXRocksエンジンとLibraDBエンジンが含まれます。ただし、最大6個の読み取り専用インスタンスをLibraDBエンジンにすることができます。 インスタンス形態がプリセットリソースであるクラスタでは、読み取り専用インスタンスの総数 = プリセットリソース読み取り専用インスタンス数 + Serverless読み取り専用インスタンス数 + LibraDB読み取り専用分析エンジン数となります。 インスタンス形態がServerlessであるクラスタでは、読み取り専用インスタンスの数は0～15個の範囲です。0個の読み取り専用インスタンスの場合、このServerlessクラスタのアーキテクチャはシングルノード版となり、0個でない場合、このServerlessクラスタのアーキテクチャはクラスタ版となります。 |
Tag | タグキーは一意である必要があり、最大20個まで設定できます。 |
バックアップストレージの無料クォータ | TDSQL-C for MySQLのバックアップストレージは当面追加料金が発生しません。その後、クラスタ購入時のストレージ容量に基づいてバックアップストレージの無料クォータが設定され、無料クォータを超えた分については追加料金が発生します。 |
バックアップ保持期間 | デフォルトは7日、最大で1830日までサポートしています。 |
ログ保持期間 | デフォルトは7日、最大で1830日までサポートしています。 |
プロジェクト | プロジェクトはクラスタを単位として帰属され、同一クラスタ内の複数のインスタンスは同じプロジェクトに属します。 |
操作制限
制限項目 | 制限の説明 |
カーネルバージョンのアップグレード | バージョンアップ完了時にはクラスタ切り替え（秒単位のデータベース接続切断）が発生します。プログラムに自動再接続機能を実装することを推奨し、またインスタンスのメンテナンス時間内に切り替えを実施することを推奨します。 単一インスタンスのテーブル数が100万を超えると、アップグレード失敗の原因となる可能性があり、またデータベース監視にも影響を及ぼす場合があります。テーブル数を適切に管理し、単一インスタンスあたりのテーブル数が100万を超えないように制御してください。 カーネルのマイナーバージョンアップグレード後はダウングレードできません。 |
障害切り替え | マスターノードに障害が発生した場合、TDSQL-C for MySQLはスタンバイノードに切り替えます。切り替え過程で30秒以内の接続瞬断が発生します。お客様のビジネスに自動再接続メカニズムを確保し、切り替えによるサービスの利用不可を回避してください。 |
ネットワーク切り替え | ネットワーク変更により、クラスタ内のすべてのプライベートネットワークIPが変更されます。システムは自動的に新しいIPアドレスを割り当てますので、クライアント側プログラムを速やかに修正してください。 古いIPアドレスはデフォルトで24時間後に無効になります。無効時間はネットワーク切り替え操作時に設定可能です。0に設定した場合、ネットワーク変更後ただちに古いIPアドレスが回収されます。 ネットワークを切り替える際には、クラスタが配置されているリージョンおよびアベイラビリティーゾーン内のVPCネットワークとサブネットのみ選択できます。 |
ストレージスペース | 従量課金およびServerlessクラスタの各コンピューティングインスタンス仕様のストレージスペースには上限があります。詳細はそれぞれ製品仕様およびServerlessコンピューティング能力設定を参照してください。 年/月単位サブスクリプション課金モードでは、購入したストレージスペースを基準とします。 異なるコンピューティングインスタンス仕様には対応する最大ストレージ上限があります。より大きなストレージが必要な場合は、コンピューティングインスタンス仕様をアップグレードしてください。 |
データ復元 | 重要データをバックアップしてからデータ復元を行うことをお勧めします。データ損失を防ぐためです。データ復元には、ロールバックまたはクラスタのクローン作成をご利用ください。 |
構成変更 | TDSQL-C for MySQLはその場での迅速なスケールアップ/ダウンをサポートしますが、特殊な状況では接続に秒単位の瞬断が発生する可能性があります。業務にリトライ機構が備わっていることをご確認いただき、この操作は業務の低ピーク時に実施されることをお勧めします。 |
キーワードと予約語の制限
キーワードとは、SQL文において意味を持つ単語を指します。予約語とは、特定のキーワード（SELECT、DELETE、BIGINTなど）がデータベースの対応バージョンで予約されているものです。これらの予約キーワードは、テーブル名や列名などの識別子として使用する際に特別な処理（引用符で囲むなど）が必要です。そうでない場合エラーが発生します。非予約キーワードは特別な処理なしで識別子として使用できます。
公式サイトに記載されているキーワードと予約語に加えて、TDSQL-C for MySQLでは以下の予約キーワードが追加されています：
CLUSTER
THREADPOOL_SYM
ack
説明：
ackはTDSQL-C for MySQLでは予約キーワードであり、バッククォートを付けて記述する必要があります。例：`ack`。
接続数制限
TDSQL-C for MySQLの最大接続数はシステム変数max_connectionsで設定され、インスタンスの接続数がmax_connectionsを超えると、新しい接続は確立できなくなります。
クラウドデータベースのデフォルト接続数は、TDSQL-C for MySQLコンソールでクラスタIDをクリックし、クラスタ管理ページ > パラメータ設定ページで確認できます。ユーザーは必要に応じてmax_connectionsの値を調整できます。ただし、接続数が多いほどシステムリソースの消費も増加します。接続数がシステムの負荷耐容量を超えた場合、サービス品質に影響が生じます。
max_connectionsの詳細についてはMySQL公式ドキュメントをご参照ください。
クラウドデータベースに接続するクライアントの制限
CVMシステム標準搭載のMySQLクライアントおよびライブラリを使用して、クラウドデータベースインスタンスに接続することをお勧めします。
スロークエリに関する説明
Linux CVMをご利用の開発者様は、クラウドデータベースエクスポートツールでスロークエリログを取得できます。詳細はバックアップファイルのダウンロードおよびスローログ明細のダウンロードをご参照ください。
Windows CVMをご利用の開発者様は、現時点ではスロークエリログを直接取得できません。必要に応じてチケットを提出の上、弊社までお問い合わせいただければスロークエリログファイルを提供いたします。
クラウドデータベースのbinlog保存期間に関する説明
TDSQL-C for MySQLのbinlogログファイルは7日～1830日間保持可能で、デフォルトは7日です（クラスタIDをクリックしバックアップ管理 > ログバックアップ設定で保持期間を設定できます）。
binlogの保持期間が長すぎるか増加が速すぎると、バックアップ領域が拡大します。バックアップ領域がシステム提供領域を超えた場合、追加のバックアップ領域費用が発生します。
文字セットについて
説明：
公式MySQLバージョン8.0.29から、従来のUTF8エンコーディング形式はUTF8MB4に変更されました。
データベースバージョンMySQL 5.7のデフォルト文字セットエンコーディング形式はUTF8です。
データベースバージョンMySQL 8.0のデフォルト文字セットエンコーディング形式は以下の2つのケースに分かれます：
ケース1：公式MySQLバージョン8.0.29未満のインスタンスのデフォルト文字セットエンコーディング形式はUTF8です。
ケース2：公式MySQLバージョン8.0.29以降のインスタンスのデフォルト文字セットエンコーディング形式はUTF8MB4です。詳細な変更説明についてはMySQL公式ドキュメントをご参照ください。
クラウドデータベースはデフォルトの文字セットエンコーディング設定をサポートしていますが、テーブル作成時にエンコーディングを明示的に指定し、接続確立時には接続エンコーディングを指定することをお勧めします。これにより、アプリケーションの移植性が向上します。
文字セットに関する関連リソースについてはMySQL公式ドキュメントをご参照ください。
SQL言語またはTDSQL-C for MySQLコンソールで文字セットを変更できます。
SQL言語による文字セットの変更
1. SQL言語で以下のステートメントを実行すると、クラウドデータベースインスタンスのデフォルト文字セットエンコーディングを変更できます：
SET @@global.character_set_client = utf8;SET @@global.character_set_results = utf8;SET @@global.character_set_connection = utf8;SET @@global.character_set_server = utf8;
ステートメント実行後、@@global.character_set_server などは約10分後にローカルファイルに自動的に同期され永続化されます（その他3つの変数はローカルファイルに同期されません）。移行や再起動時には設定後の値が保持されます。
2. 以下のステートメントを実行することで、現在の接続の文字セットエンコーディングを変更できます：
SET @@session.character_set_client = utf8;SET @@session.character_set_results = utf8;SET @@session.character_set_connection = utf8;
または
SET names utf8;
3. PHPプログラムの場合、以下の関数で現在の接続の文字セットエンコーディングを設定できます：
bool mysqli::set_charset(string charset);
または
bool mysqli_set_charset(mysqli link, string charset);
4. Javaプログラムの場合、以下の方法で現在の接続の文字セットエンコーディングを設定できます：
jdbc:mysql://localhost:3306/dbname?useUnicode=true&characterEncoding=UTF-8
TDSQL-C for MySQLコンソールで文字セットを変更する
1. TDSQL-C for MySQLコンソールにログインし、左側のクラスタリストでターゲットクラスタをクリックすると、クラスタ管理ページに入ります。
2. クラスタの詳細でターゲットインスタンスを見つけ、インスタンスIDの後の詳細をクリックし、インスタンス詳細ページに入ります。そして文字セットの後にある編集アイコンをクリックして変更します。
操作制限
1. TDSQL-C for MySQLクラスタのデフォルトで既存のアカウントの情報と権限を変更しないでください。この操作は一部のクラスタサービスを無効にする可能性があります。
2. データベースとテーブルを作成する際には、InnoDBエンジンを統一して使用することをお勧めします。この選択により、インスタンスの高アクセス対応能力が向上します。
データベースアカウントパーミッション
TDSQL-C for MySQLはユーザーにインスタンスのsuper user権限を提供していません。ユーザーが変更可能なパラメータは実際のコンソールに準じます。TDSQL-C for MySQLコンソールでターゲットクラスタを見つけ、クラスタIDをクリックし、クラスタ管理ページ > パラメータ設定ページに入り、変更可能なパラメータ範囲を確認できます。
ネットワーク選択
VPCの使用をお勧めします。VPC内では、ユーザーが自由にセグメント分割、IPアドレス、ルーティングポリシーを定義できます。基本ネットワークと比較して、VPCはネットワークのカスタム設定が必要なシナリオにより適しています。プライベートネットワークと基本ネットワークの比較については、ネットワーク管理を参照してください。
フィードバック