DBシステムの作成

コンソール、コマンドライン・インタフェースまたはREST APIを使用して、MySQL HeatWave DBシステムを作成します。

コンソールの使用

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

  1. 「DBシステム」リスト・ページで、「DBシステムの作成」を選択します。リスト・ページの検索に関するヘルプが必要な場合は、DBシステムのリスト- コンソールの使用を参照してください。
  2. 次の項目から選択します。
    • 本番: 本番環境に適した次のデフォルト値を使用して、高可用性DBシステムを設定します。
    • 開発またはテスト: スタンドアロンDBシステムを開発またはテスト環境に適した次のデフォルト値に設定します。
    テンプレートのデフォルトについては、DB Systemテンプレートの作成を参照してください。
  3. DBシステム情報の指定:
    • コンパートメントに作成: 現在のコンパートメント以外のコンパートメントでDBシステムを起動する場合は、リストからコンパートメントを選択します。
    • 名前: DBシステムの表示名を指定します。名前は一意である必要はありません。Oracle Cloud Identifier (OCID)によってDBシステムが一意に識別されます。
    • 説明: (オプション) DB Systemとその目的についての説明を指定します。
  4. 管理者資格証明を作成します:
    • ユーザー名: 管理者の名前を指定します。予約済ユーザー名を参照してください。管理者には、rootユーザーとは異なる特定の権限セットがあります。デフォルトのMySQL権限を参照してください。
    • パスワード: 管理者パスワードを指定します。
    • パスワードの確認: 管理者のパスワードを確認してください。
  5. DBシステムのタイプを選択します。
    • スタンドアロン: 単一インスタンスのDBシステムに対して選択します。
    • 高可用性: 1つのプライマリ・インスタンスと2つのセカンダリ・データベースを含む3インスタンスのDBシステムに対して選択します。リージョナル・サブネットを選択すると、インスタンスは可用性ドメイン全体に分散されます。リージョナル・サブネットを選択しない場合、またはリージョンが単一の可用性ドメインで構成されている場合、インスタンスはフォルト・ドメイン全体に分散されます。高可用性を参照してください。
  6. ネットワークを構成:
    • 仮想クラウド・ネットワーク: DBシステムを作成するVCNを選択します。
    • サブネット: VCNのプライベート・サブネットを選択します。
    • 拡張オプションの表示: (オプション)ネットワーク・セキュリティ・グループを構成する場合に選択します。
      • コンパートメント: ネットワーク・セキュリティ・グループが構成されているコンパートメントを選択します。
      • ネットワーク・セキュリティ・グループ: 使用するネットワーク・セキュリティ・グループを選択してください。
        ノート

        必要なポリシーについては、必須ポリシー: ネットワーク・セキュリティ・グループを参照してください。
      • 複数のネットワーク・セキュリティ・グループを追加するには、「別のネットワーク・セキュリティ・グループ」ボタンを選択して別の行を追加します。
        ノート

        最大5つのネットワーク・セキュリティ・グループを追加できます。
  7. 配置の構成:
    • 可用性ドメイン: スタンドアロンDBシステムの場合、DBシステムが存在する可用性ドメインを指定してください。高可用性DBシステムの場合、可用性ドメインの選択はインスタンスの配置に影響します。高可用性を参照してください。
    • フォルト・ドメインの選択: フォルト・ドメインを選択できるようにするには、このオプションを選択します。フォルト・ドメインを選択しない場合は、Oracleによって選択されます。フォルト・ドメインを参照してください。
  8. ハードウェアの構成:
    • HeatWaveクラスタの有効化: デフォルトでは有効です。HeatWaveクラスタを使用しないDBシステムを作成する場合は選択解除します。
      ノート

      DBシステムにHeatWaveクラスタがサポートされているシェイプがある場合でも、後でHeatWaveクラスタをDBシステムに追加できます。
    • シェイプの詳細: デフォルトのシェイプを変更する場合は、「シェイプの変更」を選択します。「すべての形状の参照」パネルでは、次を実行します:
      1. コンピュート・モデルを選択します。
        • ECPU: CPUコア、メモリー、その他のリソースを抽象化した、ECPUに依存しないアーキテクチャに基づいています。
        • OCPU: ハイパースレッドが有効になっているプロセッサの物理コアに基づく。マシン・タイプを選択してシェイプをフィルタします。
          • すべての型: 使用可能なすべてのシェイプが表示されます。
          • 仮想マシン: 仮想マシンベースのシェイプのみが表示されます。
          • ベア・メタル: ベア・メタルベースのシェイプのみが表示されます。
          ノート

          すべてのOCPUシェイプは非推奨であり、2024年9月5日以降に作成された新規ユーザーは使用できません。既存のユーザーは2026年3月13日まで引き続き使用できます。
      2. シェイプを選択するには、チェック・ボックスを選択します。サポートされるシェイプを参照してください。
      3. 「シェイプの選択」を選択します。
    • HeatWaveクラスタ構成: このオプションは、「HeatWaveクラスタの有効化」が選択されている場合に表示されます。デフォルト構成を変更する場合は、「HeatWaveクラスタの構成」を選択し、「HeatWaveクラスタの構成」パネルで次を実行します:
      1. シェイプの詳細: HeatWaveノードのシェイプ。シェイプを変更する場合は、「シェイプの変更」を選択して、HeatWaveノードのシェイプを選択します。サポートされるシェイプを参照してください。
      2. ノード: 作成するHeatWaveノードの数を指定します。最小は1ノード、最大は次によって異なります。
        • HeatWave.Freeシェイプ: 1ノード
        • HeatWave.32GBシェイプ: 16ノード
        • HeatWave.512GBまたはMySQL.HeatWave.VM.Standardシェイプ: 64ノード
        • Lakehouseが有効なHeatWave.512GBまたはMySQL.HeatWave.VM.Standardシェイプ: 512ノード
      3. MySQL HeatWave Lakehouse: オブジェクト・ストレージに存在するデータに対するクエリ処理を有効にします。MySQL 8.4.0-u3より前のMySQL HeatWave Lakehouseは、MySQL.HeatWave.VM.StandardおよびHeatWave.512GBシェイプでのみサポートされています。MySQL HeatWave Lakehouseを参照してください。
        ノート

        MySQL 8.3.0-u2より前では、MySQL HeatWave Lakehouseを有効にするために、ポイントインタイムリカバリ、高可用性、読み取りレプリカ、およびアウトバウンドレプリケーションを無効にする必要があります。
      4. 「Save changes」を選択します。
    • ストレージ・サイズ: DBシステムのストレージ・サイズを構成します。データ・ストレージ・サイズは、選択したシェイプとは無関係です。
      • 初期データ・ストレージ・サイズ(GB): DBシステムに割り当てる初期データ・ストレージ・サイズ(GB)を指定します。値は50より大きく131072より小さい値にする必要があります。

        初期ストレージ値は、ストレージ・サイズを後で増やす機能および増加したストレージのパフォーマンスに影響を与えます。DB Systemストレージを参照してください。また、データをインポートする場合は、必ず十分なデータ・ストレージを指定してください。

      • 自動ストレージ拡張: DBシステム内の任意のインスタンスの領域使用量がデータベース・インスタンス・ヘルス・モニターの読取り専用の制限に近づくと、自動のデータ・ストレージ拡張が有効となります。
        ノート

        自動ストレージ拡張は、高可用性が有効な場合、デフォルトで有効になっており、無効にできません。
      • 最大データ・ストレージ・サイズ(GB): ストレージ・サイズを拡張できる最大データ・ストレージ・サイズ(GB)を指定します。値は初期データ・ストレージ・サイズより大きくする必要があります。
        ノート

        ストレージ・サイズが拡張されると、それに応じてストレージ使用量に対する請求が増加します。最大ストレージ・サイズを使用して、コストの超過を防ぎます。
  9. バックアップ・プランの構成: 自動バックアップを有効にする場合は、このオプションを選択します。自動バックアップを選択しない場合は、手動でバックアップを管理します。自動バックアップを有効にすることをお薦めします。
    バックアップ・プラン:
    • Backup retention period: (Optional) Specify how many days you want to retain the backup. デフォルトでは、DBシステムはバックアップを7日間保持します。
    • Point-in-Timeリカバリの有効化: 特定の時点のDBシステムを新しいDBシステムにリストアできるようにするオプションを選択します。
    • バックアップ・ウィンドウで選択: バックアップ・ウィンドウの開始時間を選択できるようにするオプションを選択します。このオプションを有効にしない場合、デフォルトのウィンドウ開始時間がリージョンに基づいて選択されます。
      • ウィンドウ開始時間: DBシステムのバックアップを開始する時刻を(UTCタイム・ゾーンで)指定する。バックアップは、ウィンドウの開始時間からの30分以内に開始されます。
        ノート

        バックアップ・ウィンドウの開始時間の設定がメンテナンス・ウィンドウの開始時間に近づきすぎないようにしてください。メンテナンスやアップグレードなどの競合する操作が現在実行中の場合、自動バックアップを開始できません。競合する操作が完了するまで待機する必要があります。競合する操作がバックアップウィンドウの開始時間から2時間以内に完了しない場合、自動バックアップはスキップされ、翌日の次のバックアップウィンドウで再試行されます。
      • リージョンごとのバックアップ・ウィンド・ウィンドウの表示: このオプションを選択すると、リージョンのデフォルトのウィンドウ開始時間が表示されます。
    • ソフト削除: このオプションを選択すると、永続的に削除する前に、DELETE_SCHEDULED状態の保持ポリシーのために、さらに7日間、削除するバックアップが保持されます。これはデフォルトで有効になっています。
    リージョン間コピー: リージョン間コピーをスケジュールするオプションを選択します。有効にすると、各自動バックアップが選択された宛先リージョンにコピーされます。
    • 宛先リージョン: バックアップのコピー先となる宛先リージョンを選択します。
    • バックアップ保持期間: (オプション)バックアップを宛先リージョンに保持する日数を指定します。定義されていない場合、デフォルト値はソース・バックアップの保存期間と同じです。
    ノート

    クロスリージョン・コピーを有効にするには、MYSQL_BACKUP_COPY権限が必要です。MYSQL_BACKUP_COPY権限は、mysql-family集約リソース・タイプには含まれません。テナンシは、宛先リージョンにもサブスクライブする必要があります。
  10. MySQL Studio: MySQL Studioを有効にし、(オプションで) MySQL Studioエンドポイントに割り当てるポート番号を指定します。サポートされるポート番号は443で、すべてのポート番号は1024から65535です。ポート番号が指定されていない場合、ポート番号8443はデフォルトでMySQL Studioエンドポイントに割り当てられます。指定したポート番号は、データベース・ポート、データベースXプロトコル・ポートまたはMRSポート(MRSが有効な場合)と同じにできません。MySQL Studioの詳細は、MySQL Studio Documentationを参照してください。
    ノート

    MySQL Studioは、スタンドアロンDBシステムでのみ有効にできます。高可用性DBシステムでは有効にできません。
  11. 業務上の通知およびお知らせの連絡先の提供: (オプション)業務上の通知およびお知らせ、およびスケジュールされたメンテナンス通知および計画外のメンテナンス通知を受信する1つ以上の連絡先電子メールを入力します。連絡先をさらに追加するには、「連絡先の追加」を選択します。最大10人の担当者を追加できます。重複および無効なEメール・アドレスは許可されません。
    ノート

    Oracleでは、管理者がDBシステムに関連する通知を受信できるように、連絡先電子メールを設定することをお薦めします。
  12. 詳細オプションの表示: クリックすると、DBシステムをさらに構成できるタブのグループが開きます。拡張オプションを参照してください。
  13. (オプション)リソース構成をスタックとして保存するには、「スタックとして保存」を選択します。スタックを使用して、リソース・マネージャ・サービスを介して、リソースをインストール、構成および管理します。スタックの管理を参照してください。
  14. DBシステムを作成するには、「作成」を選択します。
DBシステムが作成されます。
ノート

DBシステムの作成時にOutOfHostCapacity作業リクエスト・エラーが発生した場合は、OutOfHostCapacityエラーの解決を参照してください。

DB Systemテンプレートの作成

DBシステム・テンプレートの作成には、様々な環境に適した推奨デフォルト値のセットが用意されています。

表6-1異なるテンプレートのデフォルト値

生産 開発またはテスト Always Free
高可用性 有効 無効 使用不可
シェイプ 64 GBのメモリー・サイズのシェイプ 8 GBのメモリー・サイズのシェイプ 8 GBのメモリー・サイズのシェイプ
ストレージ・サイズ 1024 GB 50 GB 50 GB
自動バックアップ 有効 有効 有効
ポイントインタイム・リカバリ 有効 有効 使用不可
削除保護 有効 無効 有効
自動バックアップ保持 有効 無効 有効
最終バックアップ 最終バックアップが必要 最終バックアップをスキップ 最終バックアップをスキップ

JSONペイロードでのCLIの使用

コマンドライン・インタフェースを使用して、JSONペイロードを使用してDBシステムを作成し、オブジェクト・ストレージ・バケットからデータをインポートします。

このタスクでは次が必要です:
  1. コマンドライン・インタフェースを開き、JSONペイロードを使用して次のコマンドを実行してDBシステムを作成します:
    oci mysql db-system create --from-json file://<File.json>

    <File.json>ファイルには次のものが含まれています:

    {
      "adminUsername": "<AdminUsername>",
      "adminPassword": "<AdminPassword>",
      "compartmentId": "<CompartmentOCID>", 
      "configurationId": "<ConfigurationOCID>", 
      "shapeName": "<ShapeName>", 
      "dataStorageSizeInGbs": "<StorageSize>", 
      "description": "<Description>", 
      "displayName": "<DBSystemName>", 
      "hostnameLabel": "<HostName>",
      "availabilityDomain": "<Region>",
      "subnetId": "<SubnetOCID>",
      "isIpv6Enabled": <Boolean>,
      "ipv6AddressIpv6SubnetCidrPairDetails": {
        "ipv6SubnetCidr": "<IPv6SubnetPrefix>",
        "ipv6Address": "<IPv6Address>"
      },
      "backupPolicy": {
        "isEnabled": <Boolean>,
        "retentionInDays": <NumberOfDays>,
        "windowStartTime": "<Time>", 
        "softDelete": "<EnabledOrDisabled>",
        "pitrPolicy": {
          "isEnabled": <Boolean> 
        }, 
        "copyPolicies": [
          {
            "copyToRegion": "<Region>",
            "backupCopyRetentionInDays": <NumberOfDays>
          }
        ]
      },
      "deletionPolicy": { 
        "automaticBackupRetention": "<RetainOrDelete>",
        "finalBackup": "<SkipOrRequire>",
        "isDeleteProtected": <Boolean> 
      },
      "source": {
          "sourceType": "IMPORTURL",
          "sourceUrl": "https://objectstorage.<region>.com/p/<Secret>/n/<Namespace>/b/<BucketName>/o/"
        }
    }
    • adminUsername: DBシステムのルート・ユーザーのユーザー名を指定します。一部のユーザー名は予約されており、DBシステムの定義では使用できません。予約済ユーザー名を参照してください。
    • adminPassword: DBシステムのルート・ユーザーのパスワードを指定します。
    • compartmentId: DBシステムを作成するコンパートメントのOCIDを指定します。
    • availabilityDomain: DBシステムを作成する可用性ドメインの名前を指定します。
    • configurationID: (オプション) DBシステムに適用する構成のOCIDを指定します。構成IDを定義しない場合、DBシステムでは、選択したシェイプに関連付けられているデフォルト構成が使用されます。カスタム構成を定義する場合は、リクエストで定義したシェイプと同じシェイプを使用する必要があります。
    • shapeName: シェイプの名前を指定します。たとえば、MySQL.8です。
    • subnetId: DBシステムがアタッチされているVCNサブネットのOCIDを指定します。
    • isIpv6Enabled: (オプション) trueに設定すると、IPv6アドレスがDBシステムに割り当てられます。サブネットはIPv6をサポートしている必要があります。
    • ipv6AddressIpv6SubnetCidrPairDetails: (オプション) DBシステムに使用するIPv6サブネット接頭辞またはIPv6アドレスを指定します。IPv6アドレスを指定しない場合、Oracleはサブネットから使用可能なIPv6アドレスを自動的に割り当てます。
    • dataStorageSizeInGbs: DBシステムのデータ・ストレージの容量(GB)を指定します。値は50より大きく131,072より小さくする必要があり、インポートされたデータを格納するのに十分な記憶域を定義してください。データ・ストレージ・サイズは、選択したシェイプとは無関係です。
    • hostnameLabel: (オプション) DBシステムのホスト名を指定します。このオプションは、選択したVCNでUSE DNS HOSTNAMES IN THIS VCNオプションを有効にした場合にのみ使用できます。ホスト名は英字で始め、英数字とハイフン(-)のみを含める必要があります。30文字を超えることはできません。ホスト名はサブネット内で一意である必要があります。一意でない場合、DBシステムのプロビジョニングが失敗します。ホスト名を指定すると、OracleによってそれがVCNおよびサブネット・ドメインに割り当てられ、インスタンスの起動中に次の形式で自動的に作成されます:
      <hostnameLabel>.<subnet DNS label>.<VCN DNS label>.oraclevcn.com
      たとえば、VCN myvcnのサブネットmyprivatesubnetで、hostnameLabelmyhostの値を指定すると、DBシステムの完全修飾ドメイン名は次のように設定されます:
      myhost.myprivatesubnet.myvcn.oraclevcn.com
    • description: (オプション) DBシステムの簡単な説明を指定します。
    • displayName: (オプション) DBシステムの表示名を指定します。表示名を定義しない場合は、OracleによってmysqldbsystemYYYYMMDDHHMMSSという形式の名前が生成されます。
    • backupPolicy: (オプション)バックアップ・ポリシー・パラメータのコンテナを指定します。次のパラメータによって、DBシステムの自動バックアップのスケジュールが定義されます:
      • isEnabled: バックアップを有効にするには、これをtrueに設定します。
      • retentionInDays: 自動バックアップを保持する日数を指定します。デフォルトでは、データは7日間保持されます。
      • windowStartTime: 毎日の自動バックアップに対する30分間のウィンドウの開始時刻を指定します。HH:MMという形式のUTCタイムゾーンが使用されます。オフセットを定義することもできます。たとえば、00:00-08:00とすると、午前0時(UTC)から8時間後の時刻が設定されます。
      • softDelete: デフォルトで有効になります。ソフト削除を無効にするには、DISABLEに設定します。
      • pitrPolicy: isEnabledtrueに設定して、特定のポイントインタイムでDBシステムから新しいDBシステムにデータをリストアするポイントインタイム・リカバリを有効にします。
      • copyPolicies: copyToRegionを宛先リージョンに設定して、自動バックアップのリージョン間コピーを有効にします。オプションで、backupCopyRetentionInDaysを、宛先リージョンで自動バックアップを保持する日数に設定します。設定されていない場合、保存はデフォルトでソース・バックアップと同じになります。
        ノート

        指定できるコピー・ポリシーは1つのみです。
    • deletionPolicy: (オプション)削除ポリシー・パラメータのコンテナを指定します:
      • automaticBackupRetention: DELETEに設定すると、DBシステムの削除時にDBシステムに対して作成された自動バックアップが削除されます。デフォルトはRETAINで、DBシステムの削除時にDBシステムに対して作成されたすべての自動バックアップが保持されます。
      • finalBackup: DBシステムの削除時にDBシステムのバックアップを取得するには、REQUIRE_FINAL_BACKUPに設定します。デフォルトはSKIP_FINAL_BACKUPで、DBシステムの削除時にDBシステムをバックアップしません。
      • isDeleteProtected: DBシステムが削除されないようにするには、trueに設定します。デフォルトはfalseで、DBシステムを削除できます。
    • source: (オプション)インポート・パラメータのコンテナを指定します。次のパラメータによって、データ・インポートのタイプとソースURLが指定されます:
      • sourceType: IMPORTURL: インポート・タイプをPAR URLとして指定します。
      • sourceUrl: バケットまたはバケット接頭辞の事前認証済リクエスト(PAR) URLを指定します。
    • mysqlVersion: (オプション) DBシステムで使用するMySQLのバージョンを指定します。これを指定しない場合は、最新のLTSバージョンが使用されます。DB SystemのアップグレードおよびMySQL Serverのバージョンを参照してください。

JSONペイロードを使用しないCLIの使用

コマンドライン・インタフェースを使用して、JSONペイロードを使用せずにDBシステムを作成し、オブジェクト・ストレージ・バケットからデータをインポートします。

このタスクでは次が必要です:
  1. コマンドライン・インタフェースを開き、JSONペイロードを使用せずに次のコマンドを実行してDBシステムを作成します:
     oci mysql db-system create 
     -c <CompartmentOCID> 
     --configuration-id <ConfigurationOCID>   
     --shape-name <ShapeName> 
     --availability-domain <Region>
     --subnet-id <SubnetOCID> 
     --is-ipv6-enabled <Boolean>
     --ipv6-address-subnet-cidr-pair '{"ipv6SubnetCidr":"<IPv6SubnetPrefix>","ipv6Address":"<IPv6Address>"}'                       
     --admin-username <AdminUsername> 
     --admin-password <AdminPassword> 
     --data-storage-size-in-gbs <StorageSize> 
     --display-name <DBSystemName> 
     --description <Description>
     --hostname-label <HostName> 
     --backup-policy '{ "isEnabled": <Boolean>, "retentionInDays": <NumberOfDays>, "windowStartTime": "<Time>", 
                        "softDelete": "<EnabledOrDisabled>", "pitrPolicy": {"isEnabled": <Boolean>}, 
                        "copyPolicies": [ {"copyToRegion": "<Region>", "backupCopyRetentionInDays": <NumberOfDays>} ] }'
     --deletion-policy '{ "automaticBackupRetention": "<RetainOrDelete>",
                          "finalBackup": "<SkipOrRequire>",
                          "isDeleteProtected": <Boolean>}'
     --source '{"sourceType": "IMPORTURL", "sourceURL":"https://objectstorage.<region>.com/p/<Secret>/n/<Namespace>/b/<BucketName>/o/"}'
    • c: DBシステムを作成するコンパートメントのOCIDを指定します。
    • configuration-id: (オプション) DBシステムに適用する構成のOCIDを指定します。構成IDを定義しない場合、DBシステムでは、選択したシェイプに関連付けられているデフォルト構成が使用されます。カスタム構成を定義する場合は、リクエストで定義したシェイプと同じシェイプを使用する必要があります。
    • shape-name: シェイプの名前を指定します。たとえば、MySQL.8です。
    • availability-domain: DBシステムを作成する可用性ドメインの名前を指定します。
    • subnet-id: DBシステムがアタッチされているVCNサブネットのOCIDを指定します。
    • is-ipv6-enabled: (オプション) trueに設定すると、IPv6アドレスがDBシステムに割り当てられます。サブネットはIPv6をサポートしている必要があります。
    • ipv6-address-subnet-cidr-pair: (オプション) DBシステムに使用するIPv6サブネット接頭辞またはIPv6アドレスを指定します。IPv6アドレスを指定しない場合、Oracleはサブネットから使用可能なIPv6アドレスを自動的に割り当てます。
    • admin-username: DBシステムのルート・ユーザーのユーザー名を指定します。一部のユーザー名は予約されており、DBシステムの定義では使用できません。予約済ユーザー名を参照してください。
    • admin-password: DBシステムのルート・ユーザーのパスワードを指定します。
    • data-storage-size-in-gbs: DBシステムのデータ・ストレージの容量(GB)を指定します。値は50より大きく131,072より小さくする必要があり、インポートされたデータを格納するのに十分な記憶域を定義してください。データ・ストレージ・サイズは、選択したシェイプとは無関係です。
    • display-name: (オプション) DBシステムの表示名を指定します。表示名を定義しない場合は、OracleによってmysqldbsystemYYYYMMDDHHMMSSという形式の名前が生成されます。
    • description: (オプション) DBシステムの簡単な説明を指定します。
    • hostname-label: (オプション) DBシステムのホスト名を指定します。このオプションは、選択したVCNでUSE DNS HOSTNAMES IN THIS VCNオプションを有効にした場合にのみ使用できます。ホスト名は英字で始め、英数字とハイフン(-)のみを含める必要があります。30文字を超えることはできません。ホスト名はサブネット内で一意である必要があります。一意でない場合、DBシステムのプロビジョニングが失敗します。ホスト名を指定すると、OracleによってそれがVCNおよびサブネット・ドメインに割り当てられ、インスタンスの起動中に次の形式で自動的に作成されます:
      <hostnameLabel>.<subnet DNS label>.<VCN DNS label>.oraclevcn.com
      たとえば、VCN myvcnのサブネットmyprivatesubnetで、hostnameLabelmyhostの値を指定すると、DBシステムの完全修飾ドメイン名は次のように設定されます:
      myhost.myprivatesubnet.myvcn.oraclevcn.com
    • backup-policy: (オプション)バックアップ・ポリシー・パラメータのコンテナを指定します。次のパラメータによって、DBシステムの自動バックアップのスケジュールが定義されます:
      • isEnabled: バックアップを有効にするには、これをtrueに設定します。
      • retentionInDays: 自動バックアップを保持する日数を指定します。デフォルトでは、データは7日間保持されます。
      • windowStartTime: 毎日の自動バックアップに対する30分間のウィンドウの開始時刻を指定します。HH:MMという形式のUTCタイムゾーンが使用されます。オフセットを定義することもできます。たとえば、00:00-08:00とすると、午前0時(UTC)から8時間後の時刻が設定されます。
      • softDelete: デフォルトで有効になります。ソフト削除を無効にするには、DISABLEに設定します。
      • pitrPolicy: isEnabledtrueに設定して、特定のポイントインタイムでDBシステムから新しいDBシステムにデータをリストアするポイントインタイム・リカバリを有効にします。
      • copyPolicies: copyToRegionを宛先リージョンに設定して、自動バックアップのリージョン間コピーを有効にします。オプションで、backupCopyRetentionInDaysを、宛先リージョンで自動バックアップを保持する日数に設定します。設定されていない場合、保存はデフォルトでソース・バックアップと同じになります。
        ノート

        指定できるコピー・ポリシーは1つのみです。
    • deletion-policy: (オプション)削除ポリシー・パラメータのコンテナを指定します:
      • automaticBackupRetention: DELETEに設定すると、DBシステムの削除時にDBシステムに対して作成された自動バックアップが削除されます。デフォルトはRETAINで、DBシステムの削除時にDBシステムに対して作成されたすべての自動バックアップが保持されます。
      • finalBackup: DBシステムの削除時にDBシステムのバックアップを取得するには、REQUIRE_FINAL_BACKUPに設定します。デフォルトはSKIP_FINAL_BACKUPで、DBシステムの削除時にDBシステムをバックアップしません。
      • isDeleteProtected: DBシステムが削除されないようにするには、trueに設定します。デフォルトはfalseで、DBシステムを削除できます。
    • source: (オプション)インポート・パラメータのコンテナを指定します。次のパラメータによって、データ・インポートのタイプとソースURLが指定されます:
      • sourceType: IMPORTURL: インポート・タイプをPAR URLとして指定します。
      • sourceUrl: バケットまたはバケット接頭辞の事前認証済リクエスト(PAR) URLを指定します。
    • mysqlVersion: (オプション) DBシステムで使用するMySQLのバージョンを指定します。これを指定しない場合は、最新のLTSバージョンが使用されます。DB SystemのアップグレードおよびMySQL Serverのバージョンを参照してください。

このコマンドにより、DBシステムがバックアップとともに作成され、事前認証済リクエスト(PAR) URLを使用してオブジェクト・ストレージからデータがインポートされます。次のようなレスポンスが返され、リクエストが要約されてDBシステムが作成されます:

{
  "data": {
    "access-mode": "UNRESTRICTED",
    "availability-domain": "nnnn:<region>-AD-1",
    "backup-policy": {
      "copy-policies" : [
         {
            "backup-copy-retention-in-days" : 7,
            "copy-to-region" : "<region>"             
         }
      ],
      "is-enabled": true,
      "pitr-policy": {    
         "is-enabled": true
      },
      "retention-in-days": 7,
      "softDelete": "ENABLED",
      "window-start-time": "00:10",
    },
    "channels": [],
    "compartment-id": "ocid1.compartment.oc1...<alphaNumericString>",
    "configuration-id": "ocid1.mysqlconfiguration.oc1...<alphaNumericString>",
    "crash-recovery": "ENABLED",
    "current-placement": {
      "availability-domain": null,
      "fault-domain": null
    },
    "customer-contacts": null,
    "data-storage": {
      "allocated-storage-size-in-gbs": 50,
      "data-storage-size-in-gbs": 50,
      "data-storage-size-limit-in-gbs": 32768,
      "is-auto-expand-storage-enabled": false,
      "max-storage-size-in-gbs": null
    },
    "data-storage-size-in-gbs": 50,
    "database-management": "DISABLED",
    "database-mode": "READ_WRITE",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "<userEmail>",
        "CreatedOn": "2021-06-04T10:02:32.140Z"
      }
    },
    "deletion-policy": {
      "automatic-backup-retention": "DELETE",
      "final-backup": "SKIP_FINAL_BACKUP",
      "is-delete-protected": false
    },
    "description": "This is my DBSystem",
    "display-name": "MyDBSystem",
    "endpoints": [],
    "fault-domain": null,
    "freeform-tags": {},
    "heat-wave-cluster": null,
    "hostname-label": null,
    "id": "ocid1.mysqldbsystem.oc1.iad.<alphaNumericString>",
    "ip-address": null,
    "is-heat-wave-cluster-attached": false,
    "is-highly-available": false,
    "lifecycle-details": null,
    "lifecycle-state": "CREATING",
    "maintenance": {
      "window-start-time": "TUESDAY 06:46"
    },
    "mysql-version": null,   
    "point-in-time-recovery-details": null
    "port": null,
    "port-x": null,
    "read-endpoint": {
      "exclude-ips": [],
      "is-enabled": false,
      "read-endpoint-hostname-label": null,
      "read-endpoint-ip-address": null
    },
    "secure-connections": {
      "certificate-generation-type": "SYSTEM",
      "certificate-id": null
    },
    "shape-name": "MySQL.2",
    "source": {
      "source-type": "IMPORTURL",
      "sourceURL":"PARURL"
    },
    "subnet-id": "ocid1.subnet.oc1.iad.<alphaNumericString>",
    "time-created": "2025-04-04T10:02:37.186000+00:00",
    "time-updated": "2025-04-04T10:02:37.186000+00:00"
  },
  "etag": "<alphaNumericString>",
  "opc-work-request-id": "ocid1.mysqlworkrequest.oc1.iad.<alphaNumericString>"
}