構成の管理

カスタム構成の編集、構成のコピー、DBシステムの構成の更新、または2つの構成の比較を行うことができます。

カスタム構成の編集

カスタム構成の名前、説明およびタグを編集できます。デフォルト構成を編集できません。

コンソール、コマンドライン・インタフェースまたはREST APIを使用して、カスタム構成を編集します。

コンソールの使用
CLIの使用
REST APIを使用して、UpdateConfiguration操作を実行します。

コンソールの使用

コンソールを使用して、カスタム構成を編集します。

「構成」リスト・ページで、操作する構成を選択します。リスト・ページまたは構成の検索に関するヘルプが必要な場合は、「構成のリスト- コンソールの使用」を参照してください。

詳細ページが開き、構成に関する情報が表示されます。
「詳細」タブを選択します。
「名前」または「説明」フィールドで「編集」を選択します。
「構成の編集」ダイアログ・ボックスで、構成の名前と説明を編集します。
「変更の保存」を選択します。

関連トピック

CLIの使用

コマンドライン・インタフェースを使用して、カスタム構成を編集します。

このタスクでは次が必要です:

コンパートメントまたはテナンシでの構成の編集を許可するポリシー。
適切に構成されたCLIインストールと必要なSSHキー。コマンドライン・インタフェースを参照してください。

CLIを使用して構成を編集します。

コマンド・プロンプトを開き、次のコマンドを実行します:
```
oci mysql configuration update 
     --configuration-id <ConfigurationOCID>
     --display-name <DisplayName>
     --description <Description>
```
- configuration-id: 編集するカスタム構成のOCIDを指定します。
- display-name: (オプション)カスタム構成の新しい表示名を指定します。表示名を定義しない場合は、既存の名前が保持されます。
- description: (オプション)カスタム構成の新しい説明を指定します。摘要を定義しない場合は、既存の摘要が保持されます。

構成のコピー

既存のカスタム構成またはデフォルト構成をコピーして、新しいカスタム構成を作成できます。

新しいカスタム構成は、コピーされた構成からシェイプを継承します。高可用性DBシステムをサポートするカスタム構成を作成する場合は、高可用性をサポートする既存の構成からコピーする必要があります。たとえば、高可用性をサポートするMySQL.8シェイプのカスタム構成を作成する場合は、MySQL.8からコピーできます。HA構成。

構成をコピーするには、コンソールまたはコマンドライン・インタフェースを使用します。

コンソールの使用
CLIの使用
REST APIを使用して、parentConfigurationId属性を指定してCreateConfiguration操作を実行します。

コンソールの使用

コンソールを使用して構成をコピーします。

「構成」リスト・ページで、操作する構成を選択します。リスト・ページまたは構成の検索に関するヘルプが必要な場合は、「構成のリスト- コンソールの使用」を参照してください。

詳細ページが開き、構成に関する情報が表示されます。
ページの上部にある「構成のコピー」を選択します。
「構成の基本情報の指定」セクションで、次の情報を入力します:
- 名前: 構成のわかりやすい表示名を指定します。この名前は一意である必要はありません。構成を識別するために一意のOracle Cloud Identifier (OCID)が生成されます。
- 説明: (オプション)構成の説明を指定します。
「配置およびハードウェアの構成」セクションで、次の情報を入力します:
- コンパートメントの選択: 別のコンパートメントに構成を作成する場合は、必要なコンパートメントを選択します。
- シェイプの選択: コピー構成ではシェイプを変更できません。
「初期化変数」セクションで、「表およびスキーマ名で大/小文字を無視」を選択して、表およびスキーマ名で大/小文字の区別を無効にできます。初期化変数を参照してください。
「ユーザー変数(読取り/書込み)」セクションで、編集する変数を「変数名」ドロップダウン・リストで選択し、「変数値」を入力または選択します。構成から変数を削除するには、行の最後にあるクロス(X)を選択します。別の変数を構成に追加するには、+Another変数を選択します。

ノート

optimizer_switchなどのフラグのセットを含む変数は、「ユーザー・フラグ・セット変数(読取り/書込み)」セクションで構成されます。
すべての構成には、デフォルトのユーザー変数のセットがあります。変数を選択しない場合は、Oracleによってこれらのデフォルト変数が構成に追加されます。ユーザー変数を参照してください。

ノート

コンソールでは、構成から読み取る大きい整数の値が16桁に丸められます。たとえば、9223372036854775807は9223372036854776000に丸められます。最大値を超える既存の変数の端数処理値を修正する必要があります。
ユーザー・フラグ・セット変数(読取り/書込み)セクションは、フラグのセットを含む変数を構成するために使用されます。構成する変数を展開し、次の1つ以上を実行して、変数のフラグを構成します。
- 必要に応じて、ソース構成からコピーしたフラグ値を編集します。
- 「デフォルト値」を選択して、フラグのリストにデフォルト値を移入します。その後、必要に応じてフラグ値を変更できます。
  ノート
  
  すべてのフラグ値がデフォルトにリセットされ、既存の設定が失われます。
- 「フラグの追加」を選択して、フラグ名と値の新しい行を追加します。フラグ名を選択し、フラグの値を選択します。変数に追加する新しいフラグごとに繰り返します。
- 行の末尾にある「X」を選択して、変数からフラグを削除します。
「システム変数(読取り専用)」セクションには、編集できないシステム変数が表示されます。システム変数を参照してください。
(オプション)「拡張オプションの表示」を選択して、「タグ」セクションを展開します。タグを追加するには、「タグ・ネームスペース」を選択し、「タグ・キー」とその「タグ値」を入力します。別のタグを追加する場合は、「タグの追加」を選択して別の行を作成します。
(オプション)リソース定義をTerraform構成として保存するには、「スタックとして保存」を選択します。リソース作成ページからのスタックの作成を参照してください。
構成をコピーするには、「作成」を選択します。

ノート

構成を作成した後で、構成に定義された変数を編集することはできません。変数を編集するには、必要な変数を使用して新しい構成を作成するか、既存の構成をコピーして変数を編集してから、新しい構成を使用するようにDBシステムを編集します。DB Systemの構成の更新を参照してください。

関連トピック

カスタム構成の作成

CLIの使用

コマンド行インタフェースを使用して、構成をコピーします。

このタスクでは次が必要です:

コンパートメントのOracle Cloud Identifier (OCID)。
コピー元の既存構成のOCID。
コンパートメントまたはテナンシでの構成の作成を許可するポリシー。
カスタム構成からコピーする場合、カスタム構成の読取りを許可するポリシー。
適切に構成されたCLIインストールと必要なSSHキー。コマンドライン・インタフェースを参照してください。

CLIを使用して、構成をコピーして新しいカスタム構成を作成します:

コマンド・プロンプトを開き、次のコマンドを実行します:
```
oci mysql configuration create 
     --compartment-id <CompartmentOCID>
     --parent-configuration-id <ConfigurationOCID>
     --description <Description>
     --display-name <DisplayName> 
     --shape-name <ShapeName> 
     --options <JSONObject>
```
- compartment-id: 新しい構成の作成に使用されるコンパートメントのOCIDを指定します。
- parent-configuration-id: コピー元の構成のOCIDを指定します。
- description: (オプション)構成の簡単な説明を指定します。
- display-name: (オプション)構成の表示名を指定します。表示名を定義しない場合は、OracleによってmysqlconfigurationYYYYMMDDHHMMSSという形式の名前が生成されます。
- shape-name: シェイプの名前を指定します。たとえば、MySQL.4です。
  ノート
  
  シェイプは、親構成のシェイプと同じである必要があります。
- options: (オプション) JSONオブジェクトのキー値ペアとして変数および対応する値を指定します。たとえば:
```
[{"name": "autocommit", "value": "ON"}, {"name":"connect_timeout", "value": "20"}]
```

コマンドの検証と正常に実行されると、次のようなレスポンスが返されます。これにより、リクエストが要約されて構成が作成されます:

{
  "data": {
    "compartment-id": "ocid1.compartment.oc1..longAlphanumericString",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "userName",
        "CreatedOn": "2024-07-11T00:51:53.856Z"
      }
    },
    "description": "This is a user defined descrption",
    "display-name": "ConfigName",
    "freeform-tags": {},
    "id": "ocid1.mysqlconfiguration.oc1.longAlphanumericString",
    "init-variables": {
      "lower-case-table-names": "CASE_SENSITIVE"
    },
    "lifecycle-state": "ACTIVE",
    "parent-configuration-id": "ocid1.mysqlconfiguration.oc1.longAlphanumericString",
    "shape-name": "MySQL.2",
    "time-created": "2024-07-11T00:51:53.866000+00:00",
    "time-updated": "2024-07-11T00:51:53.866000+00:00",
    "type": "CUSTOM",
    "options" : [ {
        "name" : "audit_log_max_size",
        "value" : "5368709120"
      }, {
        "name" : "audit_log_rotate_on_size",
        "value" : "5242880"
      }, {
        "name" : "audit_log_strategy",
        "value" : "ASYNCHRONOUS"
      }, {
        "name" : "autocommit",
        "value" : "ON"
      }, {
        "name" : "binlog_expire_logs_seconds",
        "value" : "3600"
      }, {
        "name" : "binlog_row_value_options",
        "value" : "PARTIAL_JSON"
      }, {
        "name" : "binlog_transaction_dependency_history_size",
        "value" : "1000000"
      }, {
        "name" : "connect_timeout",
        "value" : "20"
      }, {
        "name" : "group_replication_consistency",
        "value" : "BEFORE_ON_PRIMARY_FAILOVER"
      }, {
        "name" : "innodb_adaptive_hash_index",
        "value" : "OFF"
      }, {
        "name" : "innodb_buffer_pool_instances",
        "value" : "4"
      }, {
        "name" : "innodb_buffer_pool_size",
        "value" : "2147483648"
      }, {
        "name" : "innodb_change_buffering",
        "value" : "NONE"
      }, {
        "name" : "innodb_doublewrite_files",
        "value" : "2"
      }, {
        "name" : "innodb_doublewrite_pages",
        "value" : "128"
      }, {
        "name" : "innodb_extend_and_initialize",
        "value" : "OFF"
      }, {
        "name" : "innodb_ft_result_cache_limit",
        "value" : "33554432"
      }, {
        "name" : "innodb_log_buffer_size",
        "value" : "67108864"
      }, {
        "name" : "innodb_max_purge_lag_delay",
        "value" : "300000"
      }, {
        "name" : "innodb_numa_interleave",
        "value" : "ON"
      }, {
        "name" : "innodb_page_cleaners",
        "value" : "4"
      }, {
        "name" : "innodb_read_io_threads",
        "value" : "1"
      }, {
        "name" : "innodb_redo_log_capacity",
        "value" : "2147483648"
      }, {
        "name" : "local_infile",
        "value" : "ON"
      }, {
        "name" : "lock_wait_timeout",
        "value" : "86400"
      }, {
        "name" : "lower_case_table_names",
        "value" : "CASE_SENSITIVE"
      }, {
        "name" : "mandatory_roles",
        "value" : "public"
      }, {
        "name" : "max_binlog_cache_size",
        "value" : "4294967296"
      }, {
        "name" : "max_connect_errors",
        "value" : "18446744073709551615"
      }, {
        "name" : "max_connections",
        "value" : "500"
      }, {
        "name" : "performance_schema_max_statement_stack",
        "value" : "1"
      }, {
        "name" : "relay_log_space_limit",
        "value" : "8589934592"
      }, {
        "name" : "replica_parallel_workers",
        "value" : "12"
      }, {
        "name" : "table_open_cache_instances",
        "value" : "16"
      }, {
        "name" : "temptable_max_ram",
        "value" : "1073741824"
      }, {
        "name" : "thread_pool_size",
        "value" : "8"
      }, {
        "name" : "time_zone",
        "value" : "UTC"
      } ]
  },
  "etag": "longAlphanumericString"
}

DB Systemの構成の更新

DBシステムの構成を既存の構成または新しく作成した構成に更新して、DBシステムの変数設定を変更できます。

変更されたすべての変数が動的である場合、DBシステムは再起動を必要とせず、停止時間は発生しません。

1つ以上の非動的変数を変更する場合は、DBシステムを再起動する必要があります。

スタンドアロンDBシステムでは、再起動中に停止時間が発生します。
高可用性DBシステムでは、ローリング再起動を実行する際に、短いダウンタイムと現在のプライマリ配置の変更が発生します。ローリング再起動によって停止時間が短縮され、高可用性DBシステムの現在のプライマリ配置が変更されます。
DBシステムにアクティブなHeatWaveクラスタがアタッチされている場合、HeatWaveクラスタのデータは自動的にリロードされます。

コマンドライン・インタフェースのコンソールを使用して、DBシステムの構成を更新します:

コンソールの使用
CLIの使用
REST APIを使用して、configurationId属性を指定してUpdateDbSystem操作を実行します。

コンソールの使用

コンソールを使用して、DBシステムの構成を更新します。

次の手順を実行して、DBシステムの構成を更新します:

(オプション)新しい構成を作成します。カスタム構成の作成を参照してください。
DBシステムを編集して構成を更新します。DB Systemの編集を参照してください。
ノート

DBシステムに接続されたアクティブなチャネルがある場合は、構成を更新できません。チャネルを停止して構成を更新します。

関連トピック

カスタム構成の作成

CLIの使用

コマンドライン・インタフェースを使用して、DBシステムの構成を更新します。

このタスクでは次が必要です:

DBシステムのOracle Cloud Identifier (OCID)。
MySQL HeatWave構成OCID。
適切に構成されたCLIインストールと必要なSSHキー。コマンドライン・インタフェースを参照してください。

(オプション)新しい構成を作成します。カスタム構成の作成を参照してください。
コマンド・プロンプトを開き、次のコマンドを実行します:
```
oci mysql db-system update 
     --db-system-id <DBSystemOCID>
     --configuration-id <ConfigurationOCID>
```
- db-system-id: 更新するDBシステムのOCIDを指定します。
- configuration-id: 既存の構成を置き換える構成のOCIDを指定します。

構成の比較

2つの構成のシェイプ、初期化変数およびユーザー変数を比較します。

ノート

これはコンソールのみの機能で、同等のCLIまたはREST APIコマンドはありません。両方の構成の詳細を表示し、出力を比較できます。

コンソールの使用

コンソールを使用して、2つの構成を比較します。

「構成」リスト・ページで、比較する2つの構成を選択します。リスト・ページまたは構成の検索に関するヘルプが必要な場合は、「構成のリスト- コンソールの使用」を参照してください。
構成リストの上部にある「アクション」メニューから、「比較」を選択します。
「構成の比較」パネルでは、次のいずれかのオプション・ボタンを選択します:
- 構成の違いを表示: シェイプ、初期化変数およびユーザー変数の違いが表示されます。
- すべての構成情報の表示: 2つの構成のシェイプ、初期化変数およびユーザー変数に関連するすべての情報が表示されます。
「閉じる」を選択します。

関連トピック

構成詳細の表示

構成の削除

どのDBシステムでも現在使用されていないカスタム構成を削除できます。

コンソール、コマンドライン・インタフェースまたはREST APIを使用して、構成を削除します。

コンソールの使用
CLIの使用
REST APIを使用して、DeleteConfiguration操作を実行します。

コンソールの使用

コンソールを使用して、カスタム構成を削除します。

このタスクでは次が必要です:

削除するカスタム構成は、どのDBシステムでも使用されていません。
コンパートメントまたはテナンシでの構成の削除を許可するポリシー。

コンソールを使用してカスタム構成を削除するには、次を実行します:

「構成」リスト・ページで、操作する構成を検索します。リスト・ページまたは構成の検索に関するヘルプが必要な場合は、「構成のリスト- コンソールの使用」を参照してください。
構成の「アクション」メニューから、「削除」を選択します。
プロンプトが表示されたら、削除を確認します。

CLIの使用

コマンドライン・インタフェースを使用して構成を削除します。

このタスクでは次が必要です:

どのDBシステムでも使用されていないMySQL HeatWave構成のOCID。
コンパートメントまたはテナンシでの構成の削除を許可するポリシー。
適切に構成されたCLIインストールと必要なSSHキー。コマンドライン・インタフェースを参照してください。

CLIを使用して構成を削除します。

コマンド・プロンプトを開き、次のコマンドを実行します:
```
oci mysql configuration delete 
     --configuration-id <ConfigurationOCID>
```
- configuration-id: 削除する構成のOCIDを指定します。

Oracle Cloud Infrastructureドキュメント

構成の管理

カスタム構成の編集

コンソールの使用

CLIの使用

構成のコピー

コンソールの使用

CLIの使用

DB Systemの構成の更新

コンソールの使用

CLIの使用

構成の比較

コンソールの使用

構成の削除

コンソールの使用

CLIの使用