

# RDS for Oracle で DB インスタンスクラスのプロセッサを設定する
<a name="USER_ConfigureProcessor"></a>

Amazon RDS DB インスタンスクラスは、単一のインテル Xeon CPU コアで同時に複数のスレッドを実行できるインテルハイパースレッディングテクノロジーをサポートしています。各スレッドは、DB インスタンスの仮想 CPU (vCPU) として表されます。DB インスタンスには、デフォルトの CPU コア数があります。これは、DB インスタンスタイプによって異なります。例えば、db.m4.xlarge DB インスタンスタイプには 2 つの CPU コアがあり、デフォルトではコアごとに 2 つのスレッドの合計で 4 つの vCPU があります。

**注記**  
各 vCPU は、インテルXeon CPU コアのハイパースレッドです。

**Topics**
+ [RDS for Oracle のプロセッサ設定の概要](#USER_ConfigureProcessor.Overview)
+ [プロセッサ設定をサポートする DB インスタンスクラス](#USER_ConfigureProcessor.CPUOptionsDBInstanceClass)
+ [DB インスタンスクラスの CPU コア数と CPU コアあたりのスレッド数の設定](#USER_ConfigureProcessor.SettingCPUOptions)

## RDS for Oracle のプロセッサ設定の概要
<a name="USER_ConfigureProcessor.Overview"></a>

RDS for Oracle を使用すると、通常、ワークロードに適したメモリと vCPU 数を組み合わせた DB インスタンスクラスを見つけることができます。ただし、特定のワークロードまたはビジネスのニーズに合わせて、RDS for Oracle DB インスタンスを最適化するために、以下のプロセッサ機能を指定することもできます。
+ **CPU コア数** - DB インスタンスの CPU コア数をカスタマイズできます。これによって、大量のメモリを使用するワークロード用に十分な RAM 量がありながら、少ない CPU コアの DB インスタンスのソフトウェアのライセンスコストを最適化することにつながります。
+ **コア別のスレッド** - Intel ハイパースレッディングテクノロジーを無効化するには、CPU コアごとに 1 つのスレッドを指定できます。高性能コンピューティング (HPC) のワークロードのような特定のワークロードでこれを使用できます。

各コアで、CPU コア数とスレッド数を個別に制御できます。1 つのリクエストでどちらか片方または両方を設定できます。設定は DB インスタンスに関連付けられると、変更するまで維持されます。

DB インスタンスのプロセッサ設定は、DB インスタンスのスナップショットに関連付けられます。スナップショットを復元されると、復元された DB インスタンスは、スナップショットが作成されたときに使用されたプロセッサ機能設定を使用します。

デフォルト以外のプロセッサ設定を持つ DB インスタンスの DB インスタンスクラスを変更する場合は、デフォルトのプロセッサ設定を指定するか、変更時にプロセッサ設定を明示的に指定します。この要件により、DB インスタンスを変更する場合に発生する可能性があるサードパーティーのライセンスコストを確認できます。

RDS for Oracle DB インスタンスでプロセッサ機能を指定しても、課金の追加や割引はありません。デフォルトの CPU 設定で起動した DB インスタンスと同じように課金されます。

## プロセッサ設定をサポートする DB インスタンスクラス
<a name="USER_ConfigureProcessor.CPUOptionsDBInstanceClass"></a>

次の条件が満たされている場合にのみ、CPU コア数およびコアあたりのスレッド数を設定できます。
+ RDS for Oracle DB インスタンスを設定しています。さまざまな Oracle データベースエディションによってサポートされる DB インスタンスクラスについては、「[RDS for Oracle DB インスタンスクラス](Oracle.Concepts.InstanceClasses.md)」を参照してください。
+ DB インスタンスで RDS for Oracle の Bring-Your-Own-License (BYOL) ライセンスオプションを使用しています。Oracle ライセンスのオプションの詳細については、「[RDS for Oracle のライセンスオプション](Oracle.Concepts.Licensing.md)」を参照してください。
+ DB インスタンスは、事前定義されたプロセッサ設定を持つ db.r5 または db.r5b インスタンスクラスには属していません。これらのインスタンスクラスの名前は、db.r5.*instance\$1size*.tpc*threads\$1per\$1core*.mem*ratio* または db.r5b.*instance\$1size*.tpc*threads\$1per\$1core*.mem*ratio* という形式です。例えば、db.r5b.xlarge.tpc2.mem4x は、コアあたり 2 スレッド (tpc2)、スタンダードの db.r5b.xlarge インスタンスクラスの 4 倍のメモリで事前設定されています。これらの最適化されたインスタンスクラスのプロセッサ機能を設定することはできません。詳細については、「[サポートされている RDS for Oracle DB インスタンスクラス](Oracle.Concepts.InstanceClasses.md#Oracle.Concepts.InstanceClasses.Supported)」を参照してください。

次の AWS CLI コマンドを使用して、インスタンスクラスのデフォルトの vCPU、コア、コアあたりのスレッド、およびコアの有効数を表示できます。サンプルコマンドの `r7i.48xlarge` をインスタンスクラスの名前に置き換えます。

```
aws ec2 describe-instance-types \
    --instance-types r7i.48xlarge \
    --query '{
        DefaultVCPUs: InstanceTypes[0].VCpuInfo.DefaultVCpus,
        DefaultCores: InstanceTypes[0].VCpuInfo.DefaultCores,
        DefaultThreadsPerCore: InstanceTypes[0].VCpuInfo.DefaultThreadsPerCore,
        ValidCores: InstanceTypes[0].VCpuInfo.ValidCores
    }' \
    --output json
```

次の表では、CPU コア数とコアあたりの CPU スレッド数の設定をサポートする DB インスタンスクラスを確認できます。また、DB インスタンスクラスごとに CPU コア数とコアあたりの CPU スレッド数のデフォルト値と有効値も確認できます。


****  

| DB インスタンスクラス | デフォルト vCPU | デフォルトの CPU コア | コアごとのデフォルトのスレッド | CPU コアの有効数 | コアごとのスレッドの有効数 | 
| --- | --- | --- | --- | --- | --- | 
| db.m6i - メモリ最適化インスタンスクラス | 
|  db.m6i.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.m6i.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.m6i.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.m6i.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.m6i.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.m6i.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.m6i.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.m6i.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.m6i.24xlarge  |  96  |  48  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
|  db.m6i.32xlarge  |  128  |  64  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62、64  |  1、2  | 
| db.m5 – 汎用インスタンスクラス | 
|  db.m5.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.m5.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.m5.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.m5.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.m5.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.m5.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.m5.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.m5.24xlarge  |  96  |  48  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
| db.m5d – 汎用インスタンスクラス | 
|  db.m5d.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.m5d.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.m5d.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.m5d.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.m5d.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.m5d.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.m5d.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.m5d.24xlarge  |  96  |  48  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
| db.m4 – 汎用インスタンスクラス | 
|  db.m4.10xlarge  |  40  |  20  |  2  |  2、4、6、8、10、12、14、16、18、20  |  1、2  | 
|  db.m4.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
| db.r7i – メモリ最適化インスタンスクラス | 
|  db.r7i.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r7i.xlarge  |  4  |  2  |  2  |  1、2  |  1、2  | 
|  db.r7i.2xlarge  |  8  |  4  |  2  |  1、2、3、4  |  1、2  | 
|  db.r7i.4xlarge  |  16  |  8  |  2  |  1、2、3、4、5、6、7、8  |  1、2  | 
|  db.r7i.8xlarge  |  32  |  16  |  2  |  1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16  |  1、2  | 
|  db.r7i.12xlarge  |  48  |  24  |  2  |  1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16、17、18、19、20、21、22、23、24  |  1、2  | 
|  db.r7i.16xlarge  |  64  |  32  |  2  |  1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16、17、18、19、20、21、22、23、24、25、26、27、28、29、30、31、32  |  1、2  | 
|  db.r7i.24xlarge  |  96  |  48  |  2  |  1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16、17、18、19、20、21、22、23、24、25、26、27、28、29、30、31、32、33、34、35、36、37、38、39、40、41、42、43、44、45、46、47、48  |  1、2  | 
|  db.r7i.48xlarge  |  192  |  96  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62、64、66、68、70、72、74、76、78、80、82、84、86、88、90、92、94、96  |  1、2  | 
| db.r6i – メモリ最適化インスタンスクラス | 
|  db.r6i.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r6i.xlarge  |  4  |  2  |  2  |  1、2  |  1、2  | 
|  db.r6i.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.r6i.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.r6i.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.r6i.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.r6i.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.r6i.24xlarge  |  96  |  48  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
|  db.r6i.32xlarge  |  128  |  64  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62、64  |  1、2  | 
| db.r5 – メモリ最適化インスタンスクラス | 
|  db.r5.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r5.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.r5.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.r5.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.r5.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.r5.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.r5.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.r5.24xlarge  |  96  |  48  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
| db.r5 – メモリ最適化インスタンスクラス | 
|  db.r5b.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r5b.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.r5b.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.r5b.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.r5b.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.r5b.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.r5b.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.r5b.24xlarge  |  96  |  48  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
| db.r5d – メモリ最適化インスタンスクラス | 
|  db.r5d.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r5d.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.r5d.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.r5d.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.r5d.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.r5d.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
|  db.r5d.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.r5d.24xlarge  |  96  |  48  |  2  |  4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
| db.r4 – メモリ最適化インスタンスクラス | 
|  db.r4.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r4.xlarge  |  4  |  2  |  2  |  1、2  |  1、2  | 
|  db.r4.2xlarge  |  8  |  4  |  2  |  1、2、3、4  |  1、2  | 
|  db.r4.4xlarge  |  16  |  8  |  2  |  1、2、3、4、5、6、7、8  |  1、2  | 
|  db.r4.8xlarge  |  32  |  16  |  2  |  1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16  |  1、2  | 
|  db.r4.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
| db.r3 – メモリ最適化インスタンスクラス | 
|  db.r3.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.r3.xlarge  |  4  |  2  |  2  |  1、2  |  1、2  | 
|  db.r3.2xlarge  |  8  |  4  |  2  |  1、2、3、4  |  1、2  | 
|  db.r3.4xlarge  |  16  |  8  |  2  |  1、2、3、4、5、6、7、8  |  1、2  | 
|  db.r3.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
| db.x2idn – メモリ最適化インスタンスクラス | 
|  db.x2idn.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.x2idn.24xlarge  |  96  |  48  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
|  db.x2idn.32xlarge  |  128  |  64  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62、64  |  1、2  | 
| db.x2iedn – メモリ最適化インスタンスクラス | 
|  db.x2iedn.xlarge  |  4  |  2  |  2  |  1、2  |  1、2  | 
|  db.x2iedn.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.x2iedn.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.x2iedn.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.x2iedn.16xlarge  |  64  |  32  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32  |  1、2  | 
|  db.x2iedn.24xlarge  |  96  |  48  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48  |  1、2  | 
|  db.x2iedn.32xlarge  |  128  |  64  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24、26、28、30、32、34、36、38、40、42、44、46、48、50、52、54、56、58、60、62、64  |  1、2  | 
| db.x2iezn – メモリ最適化インスタンスクラス | 
|  db.x2iezn.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.x2iezn.4xlarge  |  16  |  8  |  2  |  2、4、6、8  |  1、2  | 
|  db.x2iezn.6xlarge  |  24  |  12  |  2  |  2、4、6、8、10、12  |  1、2  | 
|  db.x2iezn.8xlarge  |  32  |  16  |  2  |  2、4、6、8、10、12、14、16  |  1、2  | 
|  db.x2iezn.12xlarge  |  48  |  24  |  2  |  2、4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 
| db.z1d – メモリ最適化インスタンスクラス | 
|  db.z1d.large  |  2  |  1  |  2  |  1  |  1、2  | 
|  db.z1d.xlarge  |  4  |  2  |  2  |  2  |  1、2  | 
|  db.z1d.2xlarge  |  8  |  4  |  2  |  2、4  |  1、2  | 
|  db.z1d.3xlarge  |  12  |  6  |  2  |  2、4、6  |  1、2  | 
|  db.z1d.6xlarge  |  24  |  12  |  2  |  2、4、6、8、10、12  |  1、2  | 
|  db.z1d.12xlarge  |  48  |  24  |  2  |  4、6、8、10、12、14、16、18、20、22、24  |  1、2  | 

**注記**  
Amazon RDS for Oracle DB インスタンスの設定を処理するには、AWS CloudTrail を使用して、変更のモニタリングと監査を行います。CloudTrail の使用の詳細については、「[AWS CloudTrail での Amazon RDS API コールのモニタリング](logging-using-cloudtrail.md)」を参照してください。

## DB インスタンスクラスの CPU コア数と CPU コアあたりのスレッド数の設定
<a name="USER_ConfigureProcessor.SettingCPUOptions"></a>

次のオペレーションを実行するときに、DB インスタンスクラスの CPU コア数とコアあたりのスレッド数を設定できます。
+ [Amazon RDS DB インスタンスの作成](USER_CreateDBInstance.md)
+ [Amazon RDS DB インスタンスを変更する](Overview.DBInstance.Modifying.md)
+ [DB インスタンスへの復元](USER_RestoreFromSnapshot.md)
+ [Amazon RDS の DB インスタンスを特定の時点に復元する](USER_PIT.md)

**注記**  
DB インスタンスを変更してコアごとの CPU 数とスレッド数を指定する際に、DB インスタンスが短時間停止します。

AWS マネジメントコンソール、AWS CLI、または RDS API を使用して、DB インスタンスクラスの CPU コアごとに CPU コアとスレッドを設定できます。

### コンソール
<a name="USER_ConfigureProcessor.Console"></a>

DB インスタンスを作成、変更、または復元するときに、AWS マネジメントコンソール で DB インスタンスクラスを設定します。[**Instance specifications (インスタンスの仕様)**] セクションに、プロセッサのオプションが表示されます。次のイメージにプロセッサ機能オプションを示します。

![\[プロセッサオプションの設定\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/vcpu-config.png)


[**Processor features (プロセッサ機能)**] の下で、次のオプションを、使用している DB インスタンスクラスに適切な値に設定します。
+ **Core count (コア数)- ** CPU コアの数を設定するにはこのオプションを使用します。値は、その DB インスタンスクラスの CPU コアの最大数以下である必要があります。
+ **Threads per core (コアあたりのスレッド)** - コアごとに複数のスレッドを有効にするには **2** を指定します。コアごとの複数スレッドを無効にするには **1** を指定します。

DB インスタンスを変更、または復元する際に、CPU コアごとの CPU コアとスレッドも、インスタンスクラスのデフォルト値に設定できます。

コンソールで DB インスタンスの詳細を表示すると、DB インスタンスクラスのプロセッサ情報を [**設定**] タブで確認できます。次のイメージは 1 つの CPU コアと複数のスレッドが有効になっている DB インスタンスクラスを示します。

![\[プロセッサオプションの表示\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/vcpu-view.png)


Oracle DB インスタンスの場合、Bring-Your-Own-License (BYOL) DB インスタンスの場合のみプロセッサ情報が表示されます。

### AWS CLI
<a name="USER_ConfigureProcessor.CLI"></a>

次の AWS CLI コマンドのいずれかを実行する際に DB インスタンスのプロセッサ機能を設定できます。
+ [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)
+ [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)
+ [DBスナップショットからDBインスタンスを復元する](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html)
+ [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html)
+ [restore-db-instance-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html)

AWS CLI を使用して DB インスタンスで DB インスタンスクラスのプロセッサを設定するには、コマンドに `--processor-features` オプションを含めます。`coreCount` 機能名で CPU コアの数を指定し、`threadsPerCore` 機能名で複数のスレッドを有効にするかどうかを指定します。

オプションの構文は次のとおりです。

```
--processor-features "Name=coreCount,Value=<value>" "Name=threadsPerCore,Value=<value>"
```

プロセッサの設定の例を以下に示します。

**Topics**
+ [DB インスタンスの CPU コア数の設定](#USER_ConfigureProcessor.CLI.Example1)
+ [DB インスタンスの CPU コアの数を設定し、複数のスレッドを無効にする](#USER_ConfigureProcessor.CLI.Example2)
+ [DB インスタンスクラスの有効なプロセッサ値を確認する](#USER_ConfigureProcessor.CLI.Example3)
+ [DB インスタンスのデフォルトのプロセッサ設定に戻す](#USER_ConfigureProcessor.CLI.Example4)
+ [DB インスタンスのデフォルトの CPU コア数に戻す](#USER_ConfigureProcessor.CLI.Example5)
+ [DB インスタンスのデフォルトのコアあたりのスレッド数に戻す](#USER_ConfigureProcessor.CLI.Example6)

#### DB インスタンスの CPU コア数の設定
<a name="USER_ConfigureProcessor.CLI.Example1"></a>

**Example**  
次の例では、CPU コアの数を 4 に設定して `mydbinstance` を変更します。`--apply-immediately` を使用すると変更はすぐに適用されます。変更を次の予定されるメンテナンスウィンドウ中に適用するには、`--apply-immediately` オプションを省略します。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --processor-features "Name=coreCount,Value=4" \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --processor-features "Name=coreCount,Value=4" ^
    --apply-immediately
```

#### DB インスタンスの CPU コアの数を設定し、複数のスレッドを無効にする
<a name="USER_ConfigureProcessor.CLI.Example2"></a>

**Example**  
次の例では、`mydbinstance` を変更して CPU コアの数を `4` に設定し、コアごとの複数のスレッドを無効にします。`--apply-immediately` を使用すると変更はすぐに適用されます。変更を次の予定されるメンテナンスウィンドウ中に適用するには、`--apply-immediately` オプションを省略します。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --processor-features "Name=coreCount,Value=4" "Name=threadsPerCore,Value=1" \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --processor-features "Name=coreCount,Value=4" "Name=threadsPerCore,Value=1" ^
    --apply-immediately
```

#### DB インスタンスクラスの有効なプロセッサ値を確認する
<a name="USER_ConfigureProcessor.CLI.Example3"></a>

**Example**  
特定の DB インスタンスクラスの有効なプロセッサ値を確認するには、[describe-orderable-db-instance-options](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-orderable-db-instance-options.html) コマンドを実行し、`--db-instance-class` オプションでインスタンスクラスを指定します。例えば、次のコマンドの出力は db.r3.large インスタンスクラスのプロセッサオプションを示します。  

```
aws rds describe-orderable-db-instance-options --engine oracle-ee --db-instance-class db.r3.large
```
以下はコマンドの JSON 形式の出力サンプルです。  

```
    {
                "SupportsIops": true,
                "MaxIopsPerGib": 50.0,
                "LicenseModel": "bring-your-own-license",
                "DBInstanceClass": "db.r3.large",
                "SupportsIAMDatabaseAuthentication": false,
                "MinStorageSize": 100,
                "AvailabilityZones": [
                    {
                        "Name": "us-west-2a"
                    },
                    {
                        "Name": "us-west-2b"
                    },
                    {
                        "Name": "us-west-2c"
                    }
                ],
                "EngineVersion": "12.1.0.2.v2",
                "MaxStorageSize": 32768,
                "MinIopsPerGib": 1.0,
                "MaxIopsPerDbInstance": 40000,
                "ReadReplicaCapable": false,
                "AvailableProcessorFeatures": [
                    {
                        "Name": "coreCount",
                        "DefaultValue": "1",
                        "AllowedValues": "1"
                    },
                    {
                        "Name": "threadsPerCore",
                        "DefaultValue": "2",
                        "AllowedValues": "1,2"
                    }
                ],
                "SupportsEnhancedMonitoring": true,
                "SupportsPerformanceInsights": false,
                "MinIopsPerDbInstance": 1000,
                "StorageType": "io1",
                "Vpc": false,
                "SupportsStorageEncryption": true,
                "Engine": "oracle-ee",
                "MultiAZCapable": true
    }
```
さらに、次のコマンドを実行して DB インスタンスのクラスのプロセッサ情報を取得できます。  
+ [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) - 指定された DB インスタンスのプロセッサ情報を示します。
+ [describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html) - 指定された DB スナップショットのプロセッサ情報を示します。
+ [describe-valid-db-instance-modifications](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-valid-db-instance-modifications.html) - 指定された DB インスタンスのプロセッサに対する有効な変更を示します。
上記のコマンドの出力では、次の条件が満たされている場合にのみ、プロセッサ機能の値は null ではありません。  
+ RDS for Oracle DB インスタンスを使用しています。
+ RDS for Oracle DB インスタンスは、プロセッサ値の変更をサポートしています。
+ 現在の CPU コアとスレッドの設定は、デフォルト以外の値に設定されます。
上記の条件が満たされない場合、[describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) を使用してインスタンスタイプを取得できます。EC2 オペレーション [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) を実行することで、このインスタンスタイプのプロセッサ情報を取得できます。

#### DB インスタンスのデフォルトのプロセッサ設定に戻す
<a name="USER_ConfigureProcessor.CLI.Example4"></a>

**Example**  
次の例では、`mydbinstance` を変更して DB インスタンスクラスをデフォルトのプロセッサ値に戻します。`--apply-immediately` を使用すると変更はすぐに適用されます。変更を次の予定されるメンテナンスウィンドウ中に適用するには、`--apply-immediately` オプションを省略します。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \    
    --use-default-processor-features \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --use-default-processor-features ^
    --apply-immediately
```

#### DB インスタンスのデフォルトの CPU コア数に戻す
<a name="USER_ConfigureProcessor.CLI.Example5"></a>

**Example**  
次の例では、`mydbinstance` を変更して DB インスタンスクラスをデフォルトの CPU コア数に戻します。コアごとスレッドの設定は変更されません。`--apply-immediately` を使用すると変更はすぐに適用されます。変更を次の予定されるメンテナンスウィンドウ中に適用するには、`--apply-immediately` オプションを省略します。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --processor-features "Name=coreCount,Value=DEFAULT" \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --processor-features "Name=coreCount,Value=DEFAULT" ^
    --apply-immediately
```

#### DB インスタンスのデフォルトのコアあたりのスレッド数に戻す
<a name="USER_ConfigureProcessor.CLI.Example6"></a>

**Example**  
次の例では、`mydbinstance` を変更して DB インスタンスクラスをデフォルトのコアあたりのスレッド数に戻します。CPU コア数の設定は変更されません。`--apply-immediately` を使用すると変更はすぐに適用されます。変更を次の予定されるメンテナンスウィンドウ中に適用するには、`--apply-immediately` オプションを省略します。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --processor-features "Name=threadsPerCore,Value=DEFAULT" \
    --apply-immediately
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --processor-features "Name=threadsPerCore,Value=DEFAULT" ^
    --apply-immediately
```

### RDS API
<a name="USER_ConfigureProcessor.API"></a>

次の Amazon RDS API オペレーションのいずれかを呼び出す際に DB インスタンスのプロセッサ機能を設定できます。
+ [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html)
+ [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html)
+ [RestoreDBInstanceFromDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html)
+ [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html)
+ [RestoreDBInstanceToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html)

Amazon RDS API を使用して DB インスタンスで DB インスタンスクラスのプロセッサ機能を設定するには、コマンドに `ProcessFeatures` パラメータを含めます。

パラメータの構文は次のとおりです。

```
ProcessFeatures "Name=coreCount,Value=<value>" "Name=threadsPerCore,Value=<value>"
```

`coreCount` 機能名で CPU コアの数を指定し、`threadsPerCore` 機能名で複数のスレッドを有効にするかどうかを指定します。

特定の DB インスタンスクラスの有効なプロセッサ値を確認するには、[DescribeOrderableDBInstanceOptions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeOrderableDBInstanceOptions.html) アクションを実行し、`DBInstanceClass` パラメータでインスタンスクラスを指定します。以下のオペレーションを使用することもできます。
+ [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) - 指定された DB インスタンスのプロセッサ情報を示します。
+ [DescribeDBSnapshots](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) - 指定された DB スナップショットのプロセッサ情報を示します。
+ [DescribeValidDBInstanceModifications](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeValidDBInstanceModifications.html) - 指定された DB インスタンスのプロセッサに対する有効な変更を示します。

上記のオペレーションの出力では、次の条件が満たされている場合にのみ、プロセッサ機能の値は null ではありません。
+ RDS for Oracle DB インスタンスを使用しています。
+ RDS for Oracle DB インスタンスは、プロセッサ値の変更をサポートしています。
+ 現在の CPU コアとスレッドの設定は、デフォルト以外の値に設定されます。

上記の条件が満たされない場合、[DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) を使用してインスタンスタイプを取得できます。EC2 オペレーション [DescribeInstanceTypes](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTypes.html) を実行することで、このインスタンスタイプのプロセッサ情報を取得できます。