Oracle Cloud Infrastructureドキュメント

Oracle Database CLIリファレンス

データベースCLI (dbcli)は、ベアメタルおよび仮想マシンのDBシステムで使用できるコマンドライン・インタフェースです。 DBシステムに接続したら、データベースCLIを使用して、Oracleデータベース・ホームおよびデータベースの作成などのタスクを実行できます。

ノート

データベースCLIはExadata DBシステムでは使用できません。

使用上の注意

  • データベースのCLIコマンドは、rootユーザーとして実行する必要があります。

  • dbcli/opt/oracle/dcs/bin/ディレクトリにあります。

    このディレクトリは、ルート・ユーザー環境のパスに含まれています。

  • Oracle Databaseは、dbcliコマンド出力のログを、/opt/oracle/dcs/log/ディレクトリのdcscli.logおよびdcs-agent.logファイルに保持します。

  • データベースのCLIコマンドとほとんどのパラメータは、大文字と小文字が区別され、次のように入力する必要があります。 いくつかのパラメータは、パラメータの説明に示されているように、大/小文字の区別がなく、大文字または小文字で入力できます。

警告

データベースCLIコマンドを使用する場合は、機密情報を含むパラメータ値の指定は避けることをお薦めします。

構文

データベースのCLIコマンドでは、次の構文を使用します:

dbcli command [parameters]

説明:

  • commandは、create-databaseなどの動詞-オブジェクトの組み合わせです。
  • parametersには、コマンドの追加オプションが含まれています。 ほとんどのパラメータ名の前には、2つのダッシュが付いています(例:--help)。 省略されたパラメータ名の前には、たとえば-hのように1つのダッシュが付いています。
  • ユーザー指定のパラメータ値は、山カッコで囲まれた赤いテキストで表示されます(例:<db_home_id>)。 これらの値を指定する場合は、山カッコを省略してください。
  • helpパラメータはすべてのコマンドで使用できます。

このトピックの残りの部分では、コマンドの構文とその他の詳細について説明します。

CLIアップデート・コマンド

場合によっては、新しいコマンドがデータベースCLIに追加され、他のコマンドが新しい機能をサポートするように更新されることがあります。 次のコマンドを使用して、データベースCLIを更新できます:

cliadm update-dbcli

cliadm update-dbcliコマンドを使用して、最新の新規および更新されたコマンドでデータベースCLIを更新します。

ノート

cliadm update-dbcliコマンドは、2ノードのRAC DBシステムでは使用できません。

構文

cliadm update-dbcli [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。

次のコマンドは、dbcliを更新します:

[root@dbsys ~]# cliadm update-dbcli
{
  "jobId" : "dc9ce73d-ed71-4473-99cd-9663b9d79bfd",
  "status" : "Created",
  "message" : "Dcs cli will be updated",
  "reports" : [ ],
  "createTimestamp" : "January 18, 2017 10:19:34 AM PST",
  "resourceList" : [ ],
  "description" : "dbcli patching",
  "updatedTime" : "January 18, 2017 10:19:34 AM PST"
}

エージェント・コマンド

エージェントを管理するには、次のコマンドを使用できます:

dbcli ping-agent

エージェントの到達可能性をテストするには、dbcli ping-agentコマンドを使用します。

構文

dbcli ping-agent [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。

dbcli list-agentConfigParameters

dbcli list-agentConfigParametersコマンドを使用して、エージェント構成パラメータをリストします。

構文

dbcli list-agentConfigParameters [-n] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-n -name (オプション)パラメータ名。

dbcli update-agentConfigParameters

dbcli update-agentConfigParametersコマンドを使用して、エージェント構成パラメータを更新します。

構文

dbcli update-agentConfigParameters -n <parameter> [-v <value>] [-a] [-c] [-d] [-u] [-r] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-a --append (オプション)指定した値を指定したパラメータに貼り付けます。 パラメータの名前と値が複数ある例: -n p1 -v v1 -n p2 -v v2 -a
-c --comment (オプション)パラメータに対するコメントを追加します。 デフォルト: [ ]
-d --description (オプション)パラメータの説明を追加します。 デフォルト: [ ]
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-n --name パラメータ名 パラメータの名前と値が複数ある例: -n p1 -v v1 -n p2 -v v2デフォルト:[ ]
-r --reset (オプション)パラメータをデフォルト値にリセットします。 複数のパラメータのリセット例: -n p1 -n p2 -rデフォルト:false
-u --update (オプション)指定したパラメータ値を指示どおりに置き換えます。 パラメータの名前と値が複数ある例: -n p1 -v v1 -n p2 -v v2 -uデフォルト:false
-v --value (オプション)パラメータ値。 パラメータの名前と値が複数ある例: -n p1 -v v1 -n p2 -v v2デフォルト:[ ]

Autologcleanpolicyコマンド

次のコマンドは、ログの自動クリーンアップ(パージ)のポリシーを管理するために使用できます。

dbcli create-autoLogCleanPolicy

ログの自動クリーンアップ(パージ)のポリシーを作成するには、dbcli create-autoLogCleanPolicyコマンドを使用します。

構文

dbcli create-autoLogCleanPolicy [-c {gi|database|dcs}] [-f <number>] [-o <number>] [-u {Day|Hour|Minute}] [-uMB <number>] [-uPer <number>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --components (オプション)パージするコンポーネント。 使用可能な値は、gi、databaseおよびdcsです。 複数の値は、カンマで区切ってください。 例: gi,dcs
-f --freeSpaceBelowPercentage (オプション)空きディスク領域が合計パーティション・サイズの指定したパーセンテージ未満になると、ログをパージします。 有効範囲: 20-50. デフォルト: 20
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-o --olderthan (オプション)時間間隔の数量部分。 デフォルト: 30 指定した時間間隔(-oおよび-u)より古いログをクリーンアップします。
-u --olderThanUnit (オプション)時間間隔の単位部分。 使用可能な値: 日、時または分。 デフォルト: Day. 指定した時間間隔(-oおよび-u)より古いログをクリーンアップします。
-uMB --usageOverMB (オプション)ログの使用量がMegaBytes (MB)の指定数を超えると、ログをパージします。 有効範囲: 合計パーティション・サイズの10から50%。
-uPer --usageOverPercentage (オプション)ログの使用量が合計パーティション・サイズの指定したパーセンテージを超えると、ログをパージします。 有効範囲: 10-50.

dbcli list-autoLogCleanPolicy

dbcli list-autoLogCleanPolicyコマンドを使用して、ログの自動クリーンアップのポリシーをリストします。

構文

dbcli list-autoLogCleanPolicy [-c {gi|database|dcs}] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --components (Optional) Components 使用可能な値は、gi、databaseおよびdcsです。 複数の値は、カンマで区切ってください。 例: gi,dcs
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。

バックアップ・コマンド

次のコマンドを使用して、データベースをバックアップできます:

ノート

dbcliを使用するかわりに、コンソールまたはAPIを使用して、ベアメタルまたは仮想マシンDBシステム・データベースのオブジェクト・ストレージへのバックアップを管理できます。 ただし、dbcliを使用して管理バックアップを使用するように切り替えると、新しいバックアップ構成が作成されてデータベースに関連付けられるため、dbcliを使用して作成したバックアップには、マネージドのバックアップ・インタフェースからアクセスできなくなります。 管理対象バックアップの詳細は、「Oracle Cloud Infrastructure Object Storageへのデータベースのバックアップ」を参照してください。

dbcli create-backupコマンドを使用してデータベースをバックアップする前に、以下を行う必要があります:

  1. dbcli create-backupconfigコマンドを使用してバックアップ構成を作成します。
  2. dbcli update-databaseコマンドを使用して、バックアップ構成をデータベースに関連付けます。

データベースがバックアップ構成に関連付けられたら、cronジョブのdbcli create-backupコマンドを使用して、バックアップを自動的に実行できます。 CronMakerなどのcronユーティリティを使用すると、式の作成に役立ちます。 詳細は、http://www.cronmaker.comを参照してください。

dbcli create-backup

dbcli create-backupコマンドを使用して、データベースのバックアップを作成します。

構文

dbcli create-backup -in <db_name> -i <db_id> [-bt {Regular-L0|Regular-L1|Longterm|ArchiveLog}] [-c {Database|TdeWallet}] [-k <n>] [-t <tag>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-bt --backupType

(オプション)バックアップ・タイプ。 使用可能な値は、Regular-L0、Regular-L1、LongtermおよびArchiveLogです。 Regular-L0および通常のL1は、増分L0およびL1バックアップに対応します。 Longtermはフル・バックアップに対応します。 ArchiveLogは、アーカイブredoログのバックアップに対応しています。 デフォルト値はRegular-L1です。 値では大文字と小文字は区別されません。 省略した場合は、デフォルト値が使用されます。

-c --component

(オプション) コンポーネント。 使用可能な値は、データベースおよびTdeWalletです。 デフォルト値はデータベースです。 TdeWalletの値によってTDEウォレットがバックアップされます。 値では大文字と小文字は区別されません。 省略した場合は、デフォルト値が使用されます。

ノート

TDEウォレットは、次の状況で自動的にバックアップされます:

  • データベースは、「オブジェクト・ストレージ」バックアップ構成を使用して作成されます。
  • 「オブジェクト・ストレージ」バックアップ構成を持つデータベースが更新されます。
  • 「オブジェクト・ストレージ」のバックアップ構成が更新されます。
  • Longterm型のバックアップが作成されます。
  • データベースのTDEキーがローテーションされます。
  • データベースがバックアップされ、TDEウォレット・バックアップはまだ存在しません。
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --dbid バックアップするデータベースのID。 dbcli list-databasesコマンドを使用してデータベースIDを取得します。
-in --dbName バックアップするデータベースの名前。 dbcli list-databasesコマンドを使用して、データベース名を取得します。
-j --json (オプション)JSON出力を表示します。
-k --keepDays

(オプション)バックアップまたはコピーが保持されるまでの時間を指定します。 バックアップの保存方針の設定に関係なく、この期限を過ぎるとバックアップは不要とされます。 Longtermバックアップ・タイプの場合のみ。

-t --tag

(Longtermバックアップ・タイプに必須)バックアップ・セットにユーザー指定のタグ名を指定して、このタグをコマンドで生成される出力ファイルに適用します。 この値では、大文字と小文字は区別されません。 有効な文字数: 1から30. 使用する文字は、ターゲット・ファイル・システムのファイル名に使用できる有効な文字に限定されています。 たとえば、ASMでは、内部的に使用されるファイル名でのハイフン(-)文字の使用はサポートされていないため、ウィーク増分はASMディスク・グループ内のバックアップの有効なタグ名ではありません。 TAGパラメータには、環境変数を含めることはできません。

次のコマンドは、データベースIDを使用して、指定したデータベースのバックアップを作成します。

[root@dbsys ~]# dbcli create-backup -i 573cadb2-0cc2-4c1c-9c31-595ab8963d5b

次のコマンドは、データベース名("mydb")を使用して、指定したデータベースのバックアップを作成します。

[root@dbsys ~]# dbcli create-backup -in mydb

dbcli getstatus-backup

dbcli getstatus-backupコマンドを使用して、バックアップのステータスを表示します。

構文

dbcli getstatus-backup -t <backup_type> [i <id>] [-in <name>] [-l] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --dbId (オプション)データベース・リソースID。
-in --dbName (オプション)データベース・リソース名。
-j --json (オプション)JSON出力を表示します。
-l --isLatestBackupReport (オプション)最新のバックアップ・レポート。 デフォルト: true。
-t --backupType バックアップのタイプ。

dbcli schedule-backup

dbcli schedule-backupコマンドは、データベースのバックアップをスケジュールする場合に使用します。

構文

dbcli schedule-backup -t <backup_type> -f <number> [i <id>] [-in <name>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-f --frequency 頻度(分)。
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --dbId (オプション)データベース・リソースID。
-in --dbName (オプション)データベース・リソース名。
-j --json (オプション)JSON出力を表示します。
-t --backupType バックアップのタイプ。

Backupconfigコマンド

バックアップ構成によって、データベース・バックアップのバックアップ先とリカバリ・ウィンドウが決定されます。 dbcli update-databaseコマンドを使用してバックアップ構成を作成し、それをデータベースに関連付けることができます。

警告

これらのコマンドを使用して変更を加えた場合、コンソールを使用して構成されたバックアップは使用できなくなる可能性があります。
コンソールを使用して構成されたバックアップの場合は、これらのコマンドをサポート・ガイドとしてのみ使用してください。

ノート

dbcliを使用するかわりに、コンソールまたはAPIを使用して、ベアメタルまたは仮想マシンDBシステム・データベースのオブジェクト・ストレージへのバックアップを管理できます。 管理対象バックアップの詳細は、「Oracle Cloud Infrastructure Object Storageへのデータベースのバックアップ」を参照してください。

データベースがバックアップ構成に関連付けられたら、cronジョブのdbcli create-backupコマンドを使用して、バックアップを自動的に実行できます。 CronMakerなどのcronユーティリティを使用すると、式の作成に役立ちます。 詳細は、http://www.cronmaker.comを参照してください。

バックアップ構成を管理するには、次のコマンドを使用できます:

dbcli create-backupconfig

dbcli create-backupconfigコマンドを使用して、バックアップ先とリカバリ・ウィンドウを定義するバックアップ構成を作成します。

構文

dbcli create-backupconfig -d {DISK|OBJECTSTORE|NONE} -c <bucket>  -o <object_store_swift_id> -on <object_store_swift_name> -w <n> -n <name> [-cr|-no-cr] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --container

Oracle Cloud Infrastructure Object Storageサービス内の既存のバケットの名前。 コンソール APIまたはオブジェクト・ストレージ APIを使用してバケットを作成できます。 詳細は、「バケットの管理」を参照してください。

また、--backupdestination objectstore--objectstoreswiftIdパラメータも指定する必要があります。

-cr

-no-cr

--crosscheck

--no-crosscheck

(オプション)クロスチェック操作を有効にするかどうかを示します。 この操作により、ディスクまたはメディア管理カタログ上のファイルがRMANリポジトリのデータに対応するかどうかが決定されます。 省略すると、デフォルト設定が使用されます(デフォルトではクロスチェックが有効化されています)。

-d --backupdestination

バックアップ先は次のいずれかです(これらの値は大文字と小文字が区別されません):

DISK - ローカル高速リカバリ領域。

OBJECTSTORE - Oracle Cloud Infrastructure Object Storageサービス。 また、--containerおよび--objectstoreswiftIdパラメータも指定する必要があります。

NONE - バックアップを無効にします。

-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-n --name バックアップ構成の名前。
-o --objectstoreswiftId

Oracle Cloud Infrastructure Object Storageサービスのエンドポイントと資格証明を含むオブジェクト・ストアのID。 オブジェクト・ストアIDを取得するには、dbcli list-objectstoreswiftsコマンドを使用します。 オブジェクト・ストアを作成するには、dbcli create-objectstoreswiftコマンドを使用します。

また、--backupdestination objectstore--containerパラメータも指定する必要があります。

-on --objectstoreswiftName

Oracle Cloud Infrastructure Object Storageサービスのエンドポイントおよび資格証明を含むオブジェクト・ストアの名前。 dbcli list-objectstoreswiftsコマンドを使用して、オブジェクト・ストア名を取得します。 オブジェクト・ストアを作成するには、dbcli create-objectstoreswiftコマンドを使用します。

また、--backupdestination objectstore--containerパラメータも指定する必要があります。

-w --recoverywindow

バックアップおよびアーカイブREDOログが維持される日数。 現在時刻を終点とし、指定された日数を遡る期間です。

DISKバックアップ先の場合は、1〜14日を指定します。

OBJECTSTOREバックアップ先には、1〜30日を指定します。

次のコマンドは、dbbkcfg1という名前のバックアップ構成を作成します:

[root@dbsys ~]# dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1
{
  "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
  "status" : "Success",
  "message" : null,
  "reports" : [ {
    "taskId" : "TaskParallel_919",
    "taskName" : "persisting backup config metadata",
    "taskResult" : "Success",
    "startTime" : "November 18, 2016 20:21:25 PM UTC",
    "endTime" : "November 18, 2016 20:21:25 PM UTC",
    "status" : "Success",
    "taskDescription" : null,
    "parentTaskId" : "TaskSequential_915",
    "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
    "tags" : [ ],
    "reportLevel" : "Info",
    "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
  } ],
  "createTimestamp" : "November 18, 2016 20:21:25 PM UTC",
  "description" : "create backup config:dbbkcfg1",
  "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
}

dbcli list-backupconfigs

dbcli list-backupconfigsコマンドを使用して、DBシステムのすべてのバックアップ構成をリストします。

構文

dbcli list-backupconfigs [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。

次のコマンドは、バックアップ構成をリストします:

[root@dbsys ~]# dbcli list-backupconfigs


ID                                       Name                 RecoveryWindow     BackupDestination CreateTime
---------------------------------------- -------------------- ------------------ ----------------- -----------------------------
ccdd56fe-a40b-4e82-b38d-5f76c265282d     dbbkcfg1             7                  Disk              July 10, 2016 12:24:08 PM UTC
 

dbcli describe-backupconfig

特定のバックアップ構成の詳細を表示するには、dbcli describe-backupconfigコマンドを使用します。

構文

dbcli describe-backupconfig -i <id> -in <name> [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --backupconfigid バックアップ構成ID。 IDを取得するには、dbcli list-backupconfigsコマンドを使用します。
-in --backupconfigname バックアップ構成名。 dbcli list-backupconfigsコマンドを使用して名前を取得します。
-j --json (オプション)JSON出力を表示します。

次のコマンドは、バックアップ構成の詳細を表示します:

[root@dbsys ~]# dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d

Backup Config details
----------------------------------------------------------------
                     ID: ccdd56fe-a40b-4e82-b38d-5f76c265282d
                   Name: dbbkcfg1
         RecoveryWindow: 7
      BackupDestination: Disk
            CreatedTime: July 10, 2016 12:24:08 PM UTC
            UpdatedTime: July 10, 2016 12:24:08 PM UTC

dbcli update-backupconfig

既存のバックアップ構成を更新するには、dbcli update-backupconfigコマンドを使用します。

構文

dbcli update-backupconfig -i <id> -in <name> -w <n> -c <bucket> -o <object_store_swift_id> -on <object_store_swift_name> [-cr|-no-cr] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --container

Oracle Cloud Infrastructure Object Storageサービス内の既存のバケットの名前。 コンソール APIまたはオブジェクト・ストレージ APIを使用してバケットを作成できます。 詳細は、「バケットの管理」を参照してください。

また、--backupdestination objectstore--objectstoreswiftIdパラメータも指定する必要があります。

-cr

-no-cr

--crosscheck

--no-crosscheck

(オプション)クロスチェック操作を有効にするかどうかを示します。 この操作により、メディア管理カタログのディスク上のファイルがRMANリポジトリのデータに対応するかどうかが決定されます。 省略すると、デフォルト設定が使用されます(デフォルトではクロスチェックが有効化されています)。

-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --backupconfigid 更新するバックアップ構成のID。 IDを取得するには、dbcli list-backupconfigsコマンドを使用します。
-in --backupconfigname 更新するバックアップ構成の名前。 dbcli list-backupconfigsコマンドを使用して名前を取得します。
-j --json (オプション)JSON出力を表示します。
-o --objectstoreswiftId

Oracle Cloud Infrastructure Object Storageサービスのエンドポイントと資格証明を含むオブジェクト・ストアのID。 オブジェクト・ストアIDを取得するには、dbcli list-objectstoreswiftsコマンドを使用します。 オブジェクト・ストアを作成するには、dbcli create-objectstoreswiftコマンドを使用します。

また、--backupdestination objectstore--containerパラメータも指定する必要があります。

-on --objectstoreswiftname

Oracle Cloud Infrastructure Object Storageサービスのエンドポイントおよび資格証明を含むオブジェクト・ストアの名前。 dbcli list-objectstoreswiftsコマンドを使用して、オブジェクト・ストア名を取得します。 オブジェクト・ストアを作成するには、dbcli create-objectstoreswiftコマンドを使用します。

また、--backupdestination objectstore--containerパラメータも指定する必要があります。

-w --recoverywindow

新しいディスク・リカバリ・ウィンドウ。

DISKバックアップ先の場合は、1〜14日を指定します。

OBJECTSTOREバックアップ先には、1〜30日を指定します。

次のコマンドは、バックアップ構成のリカバリ・ウィンドウを更新します:

[root@dbsys ~]# dbcli update-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d -w 5
{
  "jobId" : "0e849291-e1e1-4c7a-8dd2-62b522b9b807",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1468153731699,
  "description" : "update backup config: dbbkcfg1",
  "updatedTime" : 1468153731700
}

dbcli delete-backupconfig

バックアップ構成を削除するには、dbcli delete-backupconfigコマンドを使用します。

構文

dbcli delete-backupconfig -i <id> -in <name> [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --id 削除するバックアップ構成ID。 IDを取得するには、dbcli list-backupconfigsコマンドを使用します。
-in --backupconfigname 削除するバックアップ構成の名前。 dbcli list-backupconfigsコマンドを使用して名前を取得します。
-j --json (オプション)JSON出力を表示します。

次のコマンドは、指定されたバックアップ構成を削除します:

[root@dbsys ~]# dbcli delete-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d

Bmccredentialコマンド

次のコマンドは、Oracle Cloud Infrastructure Object StorageサービスからDBシステム・パッチをダウンロードするために必要な、資格証明の構成を管理するために使用できます。 詳細は、「DBシステムへのパッチ適用」を参照してください。

ノート

bmccredentialコマンドは、2ノードのRAC DBシステムでは使用できません。

dbcli create-bmccredential

dbcli create-bmccredentialコマンドを使用して、資格証明の構成を作成します。

前提条件

資格証明の構成を作成する前に、次のアイテムが必要です:

その後、公開キーをコンソールにアップロードする必要があります。 「公開キーをアップロードする方法」を参照してください。

構文

dbcli create-bmccredential -c [backup|patching|other] -t <tenant_ocid> -u <user_ocid>  -f <fingerprint> -k <private_key_path> -p|-hp <passphrase> [-n <credentials_name>] [-e <object_store_url>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --credentialsType

作成するオブジェクト・ストレージ資格証明の構成のタイプ(これらの値は大文字と小文字が区別されません):

BACKUP - 将来の使用のために予約されています。

PATCHING - サービスからパッチをダウンロードします。

OTHER - 将来の使用のために予約されています。

-e --objectStoreUrl

(オプション)オブジェクト・ストレージ・エンドポイントURL。

--credentialsType PATCHINGが指定されている場合は、このパラメータを省略します。 次のURLが想定されています:

https://objectstorage.<region_name>.oraclecloud.com

リージョン名文字列については、「リージョンと可用性ドメイン」を参照してください。

-f --fingerPrint

公開キーのフィンガープリント。 コンソールでフィンガープリントを見つけるには、右上隅にあるユーザー名をクリックし、「ユーザー設定」をクリックします。 フィンガープリントは次のようになります:

-f 61:9e:52:26:4b:dd:46:dc:8c:a8:05:6b:9f:0a:30:d2
-k --privateKey

PEM形式の秘密キー・ファイルへのパス、例:

-k /root/.ssh/privkey
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-n --name (オプション)新しい資格証明構成の名前。 名前は構成をトラッキングするのに便利です。

-p

-hp

--passPhrase

キー・ペアの作成時に指定した場合は、公開キー/秘密キー・ペアのパスフレーズ。

-p (パスフレーズなし)を指定してプロンプトを表示します。

-hp <passphrase>を指定して、コマンドにパスフレーズを入力します。

-t --tenantOcid

テナンシOCID。 「テナンシOCIDを見つける場所」も参照してください。 テナンシOCIDは次のようになります:

ocid1.tenancy.oc1..<unique_ID>
-u --userOcid

Oracle Cloud Infrastructureユーザー・アカウントのユーザー名OCID。 コンソールにOCIDがあるかどうか: プロファイルメニュー(ユーザー・メニュー・アイコン)を開き、ユーザー設定をクリックします。 ユーザー名OCIDは次のようになります:

ocid1.user.oc1..<unique_ID>

次のコマンドは、資格証明の構成を作成します:

[root@dbsys ~]# dbcli create-bmccredential -c patching -hp mypass -t ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdsq -u ocid1.user.oc1..aaaaaaaalhdxviuxqi7xevqsksccl6edokgldvuf6raskcioq4x2z7watsfa -f 60:9e:56:26:4b:dd:46:dc:8c:a8:05:6d:9f:0a:30:d2 -k /root/.ssh/privkey

{
  "jobId" : "f8c80510-b717-4ee2-a47e-cd380480b28b",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "December 26, 2016 22:46:38 PM PST",
  "resourceList" : [ ],
  "description" : "BMC Credentials Creation",
  "updatedTime" : "December 26, 2016 22:46:38 PM PST"
}

dbcli list-bmccredentials

dbcli list-bmccredentialsコマンドを使用して、DBシステムの資格証明の構成をリストします。

構文

dbcli list-bmccredentials [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。

次のコマンドは、DBシステムの資格証明の構成をリストします:

[root@dbsys ~]# dbcli list-bmccredentials
    ID                                       Name           Type          End Point                                                    Status
    ---------------------------------------- -------------  ----------    ----------------------------------------------------------- ----------
    f19d7c8b-d0d5-4jhf-852b-eb2a81cb7ce5     patch1         Patching      https://objectstorage.us-phoenix-1.oraclecloud.com           Configured
    f1a8741c-b0c4-4jhf-239b-ab2a81jhfde4     patch2         Patching      https://objectstorage.us-phoenix-1.oraclecloud.com           Configured

dbcli describe-bmccredential

dbcli describe-bmccredentialコマンドを使用して、資格証明の構成に関する詳細を表示します。

構文

dbcli describe-bmccredential -i <credentials_id> [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --id

資格証明構成のID。 IDを取得するには、dbcli list-bmccredentialsコマンドを使用します。

-j --json (オプション)JSON出力を表示します。

次のコマンドは、指定された資格証明構成の詳細を表示します:

[root@dbsys ~]# dbcli describe-bmccredential -i 09f9988e-eed5-4dde-8814-890828d1c763

BMC Credentials details
----------------------------------------------------------------
                     ID: 09f9988e-eed5-4dde-8814-890678d1c763
                   Name: patch23
            Tenant OCID: ocid1.tenancy.oc1..aaaaaaaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdsq
              User OCID: ocid1.user.oc1..aaaaaaaalhjhfiuxqi7xevqsksccl6edokgldvuf6raskcioq4x2z7watjhf
       Credentials Type: Patching
        objectStore URL: https://objectstorage.us-phoenix-1.oraclecloud.com
                 Status: Configured
                Created: January 9, 2017 1:19:11 AM PST
            UpdatedTime: January 9, 2017 1:41:46 AM PST
    

dbcli delete-bmccredential

dbcli delete-bmccredentialコマンドを使用して、資格証明構成を削除します。

構文

dbcli delete-bmccredential -i <credentials_id> [-h] [-j]

パラメータ

パラメータ 完全名 説明
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-i --id

資格証明構成のID。 IDを取得するには、dbcli list-bmccredentialsコマンドを使用します。

-j --json (オプション)JSON出力を表示します。

次のコマンドは、指定された資格証明の構成を削除します:

[root@dbsys ~]# dbcli delete-bmccredential -i f19d7c8b-d0d5-4jhf-852b-eb2a81cb7ce5        

dbcli update-bmccredential

dbcli update-bmccredentialコマンドを使用して、資格証明の構成を更新します。

構文

dbcli update-bmccredential -i <credentials_id> -n <credentials_name> -c [backup|patching|other] -p|-hp <passphrase> -f <fingerprint> -k <private_key_path> [-h] [-j]

パラメータ

パラメータ 完全名 説明
-c --credentialsType

オブジェクト・ストレージ資格証明の構成のタイプ(これらの値は大文字と小文字が区別されません):

BACKUP - 将来の使用のために予約されています。

PATCHING - サービスからパッチをダウンロードします。

OTHER - 将来の使用のために予約されています。

-i --id

資格証明構成のID。 IDを取得するには、dbcli list-bmccredentialsコマンドを使用します。

-f --fingerPrint

公開キーのフィンガープリント。例:

-f 61:9e:52:26:4b:dd:46:dc:8c:a8:05:6b:9f:0a:30:d2
-k --privateKey

PEM形式の秘密キー・ファイルへのパス、例:

-k /root/.ssh/privkey
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-n --name (オプション)資格証明構成の名前。 dbcli list-bmccredentialsコマンドを使用して名前を取得します。

-p

-hp

--passPhrase

キー・ペアの作成時に指定した場合は、公開キー/秘密キー・ペアのパスフレーズ。

-p (パスフレーズなし)を指定してプロンプトを表示します。

-hp <passphrase>を指定して、コマンドにパスフレーズを入力します。

次のコマンドは、資格証明の構成を更新します:

[root@dbsys ~]# dbcli update-bmccredential -c OTHER -i 6f921b29-61b6-56f4-889a-ce9270621956
{
  "jobId" : "6e95a69e-cf73-4e51-a444-c7e4b9631c27",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 12:01:10 PM PST",
  "resourceList" : [ ],
  "description" : "Update BMC Credentials of object 6f921b29-61b6-48f4-889a-ce9270621945",
  "updatedTime" : "January 19, 2017 12:01:10 PM PST"

コンポーネント・コマンド

dbcli describe-component

ヒント

DBシステムにこの新しいコマンドが含まれていない可能性があります。 コマンドの実行に問題がある場合は、cliadm update-dbcliコマンドを使用してデータベースCLIを更新し、コマンドを再試行してください。

ノート

dbcli describe-componentコマンドは、2ノードのRAC DBシステムでは使用できません。 オブジェクト・ストレージから2ノード・システムへのパッチ適用はサポートされていません。

dbcli describe-componentコマンドを使用して、DBシステムのサーバー、ストレージ、およびデータベース・ホーム・コンポーネントのインストール済みパッチ・バージョンと使用可能パッチ・バージョンを表示します。

このコマンドには、有効なオブジェクト・ストレージ資格証明の構成が必要です。 構成をまだ作成していない場合は、dbcli create-bmccredentialコマンドを使用して構成を作成します。 構成がないか無効な場合、コマンドはエラーで失敗: Failed to connect to the object store. Please provide valid details.

CLIの更新、資格証明の構成の作成、およびパッチの適用の詳細については、「DBシステムへのパッチ適用」を参照してください。

構文

dbcli describe-component [-s <server_group>] [-d <db_group>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-d --dbhomes (オプション)データベース・ホーム・コンポーネントのみのインストール済みパッチ・バージョンと使用可能パッチ・バージョンをリストします。
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-s --server (オプション)サーバー・コンポーネントのみのインストール済みパッチ・バージョンと使用可能パッチ・バージョンをリストします。

現在のコンポーネントのバージョンと使用可能なパッチのバージョンをオブジェクト・ストアに表示するには、次のコマンドを実行します:

[root@dbsys ~]# dbcli describe-component
System Version
---------------
12.1.2.10.0

Component                                Installed Version    Available Version
---------------------------------------- -------------------- --------------------
OAK                                      12.1.2.10.0          up-to-date
GI                                       12.1.0.2.161018      up-to-date
ORADB12102_HOME1                         12.1.0.2.161018      up-to-date  
ORADB12102_HOME2, ORADB12102_HOME3       12.1.0.2.160719      12.1.0.2.161018  

データベース・コマンド

データベースを管理するには、次のコマンドを使用できます:

dbcli clone-database

dbcli clone-databaseコマンドは、データベースをクローニングする場合に使用します。

構文

dbcli clone-database -f <name> -u <name> -n <name> [-s <shape>] [-t <type>] [m <sys_password>] [-p <tde_password>] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-f --sourcedbname ソース・データベース名
-h --help (オプション)コマンドの使用に関するヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-m --syspassword (オプション) SYSのパスワード。
-n --dbname データベース名
-p --tdepassword (オプション)ソースTDEウォレットのパスワード。
-s --dbshape (オプション)データベースのシェイプ。 例: odb1, odb2.
-t --dbtype (オプション)データベース・タイプ: SI
-u --databaseUniqueName データベースの一意の名前

dbcli create-database

新しいデータベースを作成するには、dbcli create-databaseコマンドを使用します。 新規または既存のOracle Databaseホームを使用してデータベースを作成できますが、各データベース・ホームが持つデータベースは1つのみです。

データベースの作成には数分かかります。 dbcli create-databaseコマンドを実行した後、dbcli list-jobsコマンドを使用して、データベース作成ジョブの状況をチェックすることができます。

ヒント

別のデータベースを作成する前に、データベース作成ジョブが完了するまで待ちます。 複数のdbcli create-databaseコマンドを同時に実行すると、いくつかの作成ジョブが完了しないことがあります。

データベースを作成したら、dbcli list-databases -j コマンドを使用してデータベースに関する追加情報を表示できます。

ノート

dbcli create-databaseコマンドは、ベア・メタルDBシステムでのみ使用可能です。

作成するPDBのマスター暗号化キーを作成してアクティブ化する必要があります。 1ノードまたは2ノードのRAC DBシステムに新しいPDBを作成またはプラグインした後、dbcli update-tdekeyコマンドを使用して、PDBのマスター暗号化キーを作成してアクティブ化します。 それ以外の場合は、PDBに表領域を作成しようとするときにORA-28374: typed master key not found in walletエラーが発生する可能性があります。 マルチテナント環境では、各PDBには、すべてのコンテナで使用される単一のキーストアに格納された独自のマスター暗号化キーがあります。 詳細は、「Oracle Database管理者ガイド」のマルチテナント環境の管理の概要を参照してください。

構文

dbcli create-database -dh <db_home_id> -cl {OLTP|DSS|IMDB} -n <db_name> -u <unique_name> -bi <bkup_config_id> -bn <bkup_config_name> -m -s <db_shape> -r {ACFS|ASM} -y {SI|RAC|RACOne} [-dn <name>] -io -d <pdb_admin_user> [-p <pdb>] [-ns <nlcharset>] [-cs <charset>] [-l <language>] [-dt <territory>] -v <version> [-c|-no-c] [-co|-no-co] [-h] [-j]

パラメータ

パラメータ 完全名 説明
-bi --backupconfigid 将来の使用のためにバックアップ構成IDを定義します。 IDを取得するには、dbcli list-backupconfigsコマンドを使用します。
-bn --backupconfigname 将来の使用に備えてバックアップ構成名を定義します。 dbcli list-backupconfigsコマンドを使用して名前を取得します。

-c

-no-c

--cdb

--no-cdb

(オプション)コンテナ・データベースを作成するかどうかを指定します。 省略すると、コンテナ・データベースは作成されません。
-cs --characterset (オプション)データベースの文字セットを定義します。 デフォルトはAL32UTF8です。
-cl --dbclass

データベース・クラスを定義します。 オプションは、OLTP、DSS、またはIMDBです。 デフォルトはOLTPです。 Enterprise Editionsでは、3つのクラスがすべてサポートされています。 Standard Editionでは、OLTPのみがサポートされています。

-co

-no-co

--dbconsole

--no-dbconsole

(オプション)データベース・コンソールが有効かどうかを示します。 省略すると、コンソールは有効になりません。

このパラメータは、2ノードのRAC DBシステム上のバージョン11.2.0.4データベースでは使用できません。 詳細は、「マルチ・ノードDBシステム上でバージョン11.2.0.4データベースのコンソールを有効にするには」を参照してください。

-d --pdbadmin プラガブル・データベース(PDB)管理ユーザーの名前を定義します。 デフォルト値はpdbadminです。
-dn --dbdomainname

(オプション)データベース・ドメイン名(ネットワーク構造内でのデータベースの論理的なロケーションを示します)。

-dt --dbterritory (オプション)データベースの領域を定義します。 デフォルトはAMERICAです。
-dh

--dbhomeid

 

データベースを作成するデータベース・ホームを示します。 各データベース・ホームは1つのデータベースのみを持つことができるため、データベース・ホームは空である必要があります。 dbcli list dbhomesコマンドを使用すると、DBホームIDを取得できます。

このパラメータを省略すると、データベースは新しいOracleホームで作成されます。

-h --help (オプション)コマンドのヘルプを表示します。
-j --json (オプション)JSON出力を表示します。
-l --dblanguage (オプション)データベースの言語を定義します。 デフォルトはAMERICANです。

-m

--adminpassword

SYS、SYSTEM、TDEウォレット、およびPDB Adminの強力なパスワード。 パスワードは9から30文字で、少なくとも2大文字、2小文字、2個の数値、2個の特殊文字を含む必要があります。 特殊文字は、_、#、または -でなければなりません。 パスワードには、ユーザー名(SYS、SYSTEMなど)や単語oracleを前方または逆変換の順序で含めたりしないでください。

-m (パスワードなし)を指定すると、パスワードの入力が要求されます。

-n --dbname 新しいデータベースに与えられた名前を定義します。 データベース名はアルファベットの文字で始まり、最大8文字の英数字を含めることができます。 特殊文字は使用できません。
-ns --nationalscharacterset (オプション)データベースの各国語キャラクタ・セットを定義します。 デフォルトはAL16UTF16です。
-p --pdbname

(任意)PDBの一意の名前を定義します。 PDB名はアルファベットの文字で始まり、最大30文字の英数字を含む必要があります。 許可される唯一の特殊文字はアンダースコア(_)です。 デフォルト値はpdb1です。

PDB名は、CDB内およびそれらが登録されているリスナー内で一意でなければなりません。 PDB名がシステム上で一意であることを確認してください。 一意性を保証するために、デフォルトの名前値(pdb1)を使用しないでください。

-r --dbstorage

ACFSまたはASMのいずれかのデータベース・ストレージを定義します。 デフォルト値はASMです。

詳細については、「使用上の注意」を参照してください。

-s --dbshape データベースに使用するデータベース・サイジング・テンプレートを指定します。 たとえば、odb1、odb2、またはodb3です。 デフォルトはodb1です。 詳細は、「データベース・サイジング・テンプレート」を参照してください。
-u --databaseUniqueName

Oracle Data Guardグループ(プライマリ・データベースとそのスタンバイ・データベース)内の一意性を確保するために、データベースの一意の名前を定義します。 一意の名前には、英数字とアンダースコア(_)のみを使用できます。 一意の名前は変更できません。 一意の名前のデフォルトは、--dbnameパラメータで指定された名前です。

-v --version

データベースのバージョンを次のいずれかとして定義します:

  • 18.1.0.0
  • 12.2.0.1
  • 12.1.0.2 (デフォルト)
  • 11.2.0.4
-y --dbtype

データベース・タイプを定義します。 1ノード・インスタンスにはSI、2ノード・クラスタにはRAC、コールド・スタンバイ・モードで第2ノードを持つ1ノード・インスタンスにはRACOneを指定します。 デフォルト値はRACです。 これらの値は大文字と小文字を区別しません。

使用上の注意

  • Oracle Database Standard EditionとEnterprise Editionデータベースを同じDBシステムに混在させることはできません。 (サポートされているデータベースのバージョンは、DBシステム上で混在させることができますが、エディションでは使用できません)。
  • --dbhomeidが指定されない場合は、dbcli create-databaseコマンドによって新しいOracle Databaseホームが作成されます。

    ノート

    ベア・メタルDBシステムでは、データベース・ホームごとに1つのデータベースのみが許可されます。

  • --dbhomeidを指定すると、dbcli create-databaseコマンドは、指定されたOracleホームを使用してデータベースを作成します。 dbhomeidを取得するには、dbcli list-dbhomesコマンドを使用します。 指定するデータベース・ホームは空である必要があります。
  • Oracle Database 12.1以降のデータベースは、Oracle AutomaticストレージManagement (ASM)とOracle ASMクラスタ・ファイル・システム(ACFS)の両方でサポートされています。 デフォルトはOracle ACFSです。
  • Oracle Database 11.2はOracle ACFSでサポートされています。
  • 各データベースは、データファイル用に自身のOracle ACFSファイル・システムを使用して構成され、次の命名規則を使用します: /u02/app/db user/oradata/db このマウント・ポイントのデフォルト・サイズは100Gです。
  • オンライン・ログは/u03/app/db user/redo/ディレクトリに保存されます。
  • Oracle Fast Recovery Area (FRA)は、/u03/app/db user/fast_recovery_areaディレクトリにあります。

データベースを作成し、対話形式でパスワードを入力するように要求するには:

[root@dbsys ~]# dbcli create-database -n hrdb -c -m -cl OLTP -s odb2 -p pdb1

Password for SYS,SYSTEM and PDB Admin:
{
   "jobId" : "f12485f2-dcbe-4ddf-aee1-de24d37037b6",
   "status" : "Created",
   "message" : null,
   "reports" : [ ],
   "createTimestamp" : "August 08, 2016 03:54:03 AM EDT",
   "description" : "Database service creation with db name: hrdb",
   "updatedTime" : "August 08, 2016 03:54:03 AM EDT"
}

非対話形式でデータベースを作成するには、コマンドラインでパスワードを入力します:

[root@dbsys ~]# dbcli create-database -n crmdb -hm <password> -cl OLTP -s odb2
{
   "jobId" : "30b5e2a6-493b-4461-98b8-78e9a15f8cdd",
   "status" : "Created",
   "message" : null,
   "reports" : [ ],
   "createTimestamp" : "August 08, 2016 03:59:22 AM EDT",
   "description" : "Database service creation with db name: crmdb",
   "updatedTime" : "August 08, 2016 03:59:22 AM EDT"
}

dbcli delete-database

データベースを削除するには、dbcli delete-databaseコマンドを使用します。