SERVICE_NAME

説明

ALTER SYSTEM {CREATE | DELETE | START | STOP} SERVICE ... ステートメントは、SERVICE_NAME（サービス名）のメンテナンスを行い、SERVICE_NAME の作成、削除、起動、停止などの操作を制御します。

制限事項と注意点

• META/SYS テナントは SERVICE_NAME 機能をサポートしていません。
• OceanBaseクラウドプラットフォーム（OceanBase Cloud Platform、OCP）は、管理するクラスタ内で一つの SERVICE_NAME に対してプライマリテナントが一つしか存在しないことを保証します。ユーザーがコマンドラインで 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'];

パラメータの説明

例

テナント 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モード)を参照してください。