説明
ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE ... 文は、SERVICE_NAME（サービス名）を管理し、SERVICE_NAME の作成、削除、起動、停止などの操作を制御するために使用されます。
説明
OCPを使用してサービス名の管理やプライマリ/スタンバイの切り替え操作を行う場合は、プライマリ/スタンバイテナントの日常的な切り替えを参照してください。
使用上の制限と注意事項
META/SYSテナントはSERVICE_NAME機能をサポートしていません。- OceanBaseクラウドプラットフォーム（OceanBase Cloud Platform、OCP）は、管理対象のクラスタ範囲内で、一つの
SERVICE_NAMEに対してプライマリテナントが一つしか存在できないことを保証します。ユーザーがCLIを使用してSERVICE_NAMEを設定する場合は、その点をご自身で確認および保証してください。 FAILOVER操作は、テナント内のすべてのSERVICE_NAMEを自動的に削除します。- 一つのテナントには最大一つの
SERVICE_NAMEが存在できます。 SERVICE_NAMEで確立された接続では、SERVICE_NAMEおよびテナントのプライマリ/スタンバイロール変換に関連する運用コマンドの実行は許可されません。これらのコマンドを実行すると、OB_OP_NOT_ALLOWエラーが発生します。
権限要件
この文を実行するユーザーは ALTER SYSTEM 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードの権限分類およびOracleモードの権限分類を参照してください。
構文
ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE service_name [tenant = 'tenant_name'];
パラメータの説明
パラメータ |
説明 |
|---|---|
| CREATE | サービスを作成します。サービス作成後、自動的に起動します。 |
| DELETE | サービスを削除します。サービスを削除する前に、サービスを停止しておく必要があります。 |
| START | サービスを起動します。サービス起動後、この SERVICE_NAME でセッションを確立したり、リクエストを許可したりできます。 |
| STOP | サービスを停止します。サービス停止後、この SERVICE_NAME で起動したセッションは存在せず、新しいセッションも確立できません。 |
| service_name | サービス名を指定します。 |
| tenant_name | オプションです。操作対象のテナントを指定します。操作対象のテナントを明示的に指定しない場合、デフォルトのテナント名は現在のテナントになります。
注意システムテナントは |
例
テナント mysql001 にサービス service_mysql001 を作成します。
ALTER SYSTEM CREATE SERVICE service_mysql001 TENANT = 'mysql001';
関連ドキュメント
テナントの
SERVICE_NAMEおよびそのステータス情報をビューで照会するには、DBA_OB_SERVICESまたはoceanbase.CDB_OB_SERVICESを参照してください。ビューを使用して
MODULEをSERVICE_NAMEと指定し、SERVICE_NAMEに関連する運用コマンドの実行状況を照会するには、DBA_OB_TENANT_EVENT_HISTORYまたはoceanbase.CDB_OB_TENANT_EVENT_HISTORYを参照してください。SERVICE_NAME運用コマンドの紹介情報については、サービスの作成を参照してください。SERVICE_NAMEを使用してテナントに接続する方法の紹介については、OBClientを使用したOceanBaseテナントへの接続（MySQLモード）またはOBClientを使用したOceanBaseテナントへの接続（Oracleモード）を参照してください。