構成の管理

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

カスタム構成の編集

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

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

コンソールの使用

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

ナビゲーション・メニューを開き、「データベース」を選択します。HeatWave MySQLで、「構成」をクリックします。
編集するカスタム構成を探し、次のいずれかを実行します:
- 「アクション」メニューをクリックし、「編集」を選択して、「構成の編集」ダイアログ・ボックスを開きます。
- 構成の名前をクリックして構成の詳細ページを開き、「編集」をクリックします。
「構成の編集」ダイアログ・ボックスで、構成の名前と説明を編集します。
(オプション)「拡張オプションの表示」を選択して、「タグ」セクションを展開します。既存のタグの編集、タグの追加、不要なタグの削除を行うことができます。
「変更の保存」をクリックします。

関連トピック

構成のコピー

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

新しいカスタム構成は、コピーされた構成からシェイプを継承します。高可用性DBシステムをサポートするカスタム構成を作成する場合は、高可用性をサポートする既存の構成からコピーする必要があります。For example, if you want to create a custom configuration for the MySQL.8 shape that supports high availability, you can copy from the MySQL.8.HA configuration.

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

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

コンソールの使用

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

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

ノート

コンソールでは、構成から読み取る大きい整数の値が16桁に丸められます。たとえば、9223372036854775807は9223372036854776000に丸められます。最大値を超える既存の変数の端数処理値を修正する必要があります。
「システム変数(読取り専用)」セクションには、編集できないシステム変数が表示されます。システム変数を参照してください。
(オプション)「拡張オプションの表示」を選択して、「タグ」セクションを展開します。タグを追加するには、「タグ・ネームスペース」を選択し、「タグ・キー」とその「タグ値」を入力します。別のタグを追加する場合は、「タグの追加」を選択して別の行を作成します。
(オプション)リソース定義を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> 
     --variables <JSONObject>
```
- compartment-id: 新しい構成の作成に使用されるコンパートメントのOCIDを指定します。
- parent-configuration-id: コピー元の構成のOCIDを指定します。
- description: (オプション)構成の簡単な説明を指定します。
- display-name: (オプション)構成の表示名を指定します。表示名を定義しない場合は、OracleによってmysqlconfigurationYYYYMMDDHHMMSSという形式の名前が生成されます。
- shape-name: シェイプの名前を指定します。たとえば、MySQL.4です。
  ノート
  
  シェイプは、親構成のシェイプと同じである必要があります。
- variables: (オプション) JSONオブジェクトのキー値ペアとして、変数とその対応する値を指定します。次に例を示します:
```
{ "autocommit": true, "connectTimeout": 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",
    "variables": {
      "autocommit": true,
      "big-tables": null,
      "binlog-expire-logs-seconds": 3600,
      "binlog-row-metadata": null,
      "binlog-row-value-options": "PARTIAL_JSON",
      "binlog-transaction-compression": null,
      "completion-type": null,
      "connect-timeout": 20,
      "connection-memory-chunk-size": null,
      "connection-memory-limit": null,
      "cte-max-recursion-depth": null,
      "default-authentication-plugin": null,
      "foreign-key-checks": null,
      "generated-random-password-length": null,
      "global-connection-memory-limit": null,
      "global-connection-memory-tracking": null,
      "group-replication-consistency": "BEFORE_ON_PRIMARY_FAILOVER",
      "information-schema-stats-expiry": null,
      "innodb-buffer-pool-dump-pct": null,
      "innodb-buffer-pool-instances": 4,
      "innodb-buffer-pool-size": 9126805504,
      "innodb-ddl-buffer-size": null,
      "innodb-ddl-threads": null,
      "innodb-ft-enable-stopword": null,
      "innodb-ft-max-token-size": null,
      "innodb-ft-min-token-size": null,
      "innodb-ft-num-word-optimize": null,
      "innodb-ft-result-cache-limit": 33554432,
      "innodb-ft-server-stopword-table": null,
      "innodb-lock-wait-timeout": null,
      "innodb-log-writer-threads": null,
      "innodb-max-purge-lag": null,
      "innodb-max-purge-lag-delay": 300000,
      "innodb-stats-persistent-sample-pages": null,
      "innodb-stats-transient-sample-pages": null,
      "interactive-timeout": null,
      "local-infile": true,
      "mandatory-roles": "public",
      "max-allowed-packet": null,
      "max-binlog-cache-size": 4294967296,
      "max-connect-errors": null,
      "max-connections": 1000,
      "max-execution-time": null,
      "max-heap-table-size": null,
      "max-prepared-stmt-count": null,
      "mysql-firewall-mode": null,
      "mysql-zstd-default-compression-level": null,
      "mysqlx-connect-timeout": null,
      "mysqlx-deflate-default-compression-level": null,
      "mysqlx-deflate-max-client-compression-level": null,
      "mysqlx-document-id-unique-prefix": null,
      "mysqlx-enable-hello-notice": null,
      "mysqlx-idle-worker-thread-timeout": null,
      "mysqlx-interactive-timeout": null,
      "mysqlx-lz4-default-compression-level": null,
      "mysqlx-lz4-max-client-compression-level": null,
      "mysqlx-max-allowed-packet": null,
      "mysqlx-min-worker-threads": null,
      "mysqlx-read-timeout": null,
      "mysqlx-wait-timeout": null,
      "mysqlx-write-timeout": null,
      "mysqlx-zstd-default-compression-level": null,
      "mysqlx-zstd-max-client-compression-level": null,
      "net-read-timeout": null,
      "net-write-timeout": null,
      "parser-max-mem-size": null,
      "query-alloc-block-size": null,
      "query-prealloc-size": null,
      "regexp-time-limit": null,
      "sort-buffer-size": null,
      "sql-mode": null,
      "sql-require-primary-key": true,
      "sql-warnings": null,
      "thread-pool-dedicated-listeners": null,
      "thread-pool-max-transactions-limit": null,
      "time-zone": "UTC",
      "tmp-table-size": null,
      "transaction-isolation": null,
      "wait-timeout": null
    }
  },
  "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)。
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つの構成を比較します。

ナビゲーション・メニューを開き、「データベース」を選択します。HeatWave MySQLで、「構成」をクリックします。
比較する2つの構成のチェック・ボックスを選択し、ページの上部にある「アクション」ボタンをクリックしてから、「比較」をクリックします。
「構成の比較」パネルで、次のいずれかのオプション・ボタンをクリックします:
- 構成の違いを表示: シェイプ、初期化変数およびユーザー変数の違いが表示されます。
- すべての構成情報の表示: 2つの構成のシェイプ、初期化変数およびユーザー変数に関連するすべての情報が表示されます。
「閉じる」をクリックします。

関連トピック

構成詳細の表示

Oracle Cloud Infrastructureドキュメント