Référence CLI de base de données Oracle

L'interface de ligne de commande de base de données (dbcli) est une interface de ligne de commande disponible pour Base Database Service. Après vous être connecté au système de base de données dans Base Database Service, vous pouvez utiliser dbcli pour effectuer des tâches telles que créer des bases de données et des répertoires de base de base de données Oracle.

Remarques sur le fonctionnement

  • Les commandes de l'interface de ligne de commande de base de données doivent être exécutées en tant qu'utilisateur root.

  • dbcli figure dans le répertoire /opt/oracle/dcs/bin/.

    Ce répertoire est inclus dans le chemin d'accès à l'environnement de l'utilisateur root.

  • Oracle Database conserve les journaux de la sortie de commande dbcli dans les fichiers dcscli.log et dcs-agent.log du répertoire /opt/oracle/dcs/log/.

  • Les commandes de l'interface de ligne de commande de base de données et la plupart des paramètres font la distinction entre les majuscules et les minuscules. Ils doivent être saisis comme indiqué. Certains paramètres ne distinguent pas les majuscules des minuscules, comme indiqué dans leur description. Ils peuvent être saisis en majuscules ou en minuscules.

Syntaxe

La syntaxe des commandes de l'interface de ligne de commande de base de données est la suivante :

dbcli command [parameters]

où :

  • command est une combinaison verbe-objet, par exemple create-database.
  • parameters inclut des options supplémentaires pour la commande. La plupart des noms de paramètre sont précédés de deux tirets, par exemple --help. Les noms de paramètre abrégés sont précédés d'un tiret, par exemple -h.
  • Les valeurs de paramètre indiquées par l'utilisateur apparaissent en caractères rouges et sont placées entre des chevrons, par exemple, <db_home_id>. Omettez les chevrons lorsque vous indiquez ces valeurs.
  • Le paramètre help est disponible pour toutes les commandes.

La suite de cette rubrique contient des éléments de syntaxe et des détails supplémentaires sur les commandes.

Commande de mise à jour de l'interface de ligne de commande

Il arrive parfois que de nouvelles commandes soient ajoutées à l'interface de ligne de commande de base de données et que d'autres soient mises à jour pour prendre en charge de nouvelles fonctionnalités. Vous pouvez exécuter la commande suivante pour mettre à jour l'interface de ligne de commande de base de données :

cliadm update-dbcli

Utilisez la commande cliadm update-dbcli pour mettre à jour l'interface de ligne de commande de base de données afin de disposer des commandes nouvelles et mises à jour.

Remarques :

Sur les systèmes de base de données RAC, exécutez la commande cliadm update-dbcli sur chaque noeud du cluster.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante met à jour dbcli : 

cliadm update-dbcli
Sortie :
{
  "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"
}

Commandes agent

La commande suivante permet de gérer les agents : 

  • dbcli ping-agent

dbcli ping-agent

Utilisez la commande dbcli ping-agent pour tester l'accessibilité d'un agent.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes autoLogCleanPolicy

Les commandes suivantes permettent de gérer les stratégies de nettoyage automatique (purge) des journaux.

  • dbcli create-autoLogCleanPolicy
  • dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

Utilisez la commande dbcli create-autoLogCleanPolicy pour créer des stratégies de nettoyage automatique (purge) des journaux.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants à purger. Les valeurs possibles sont gi, database et dcs. S'il existe plusieurs valeurs, séparez-les par une virgule. Par exemple : gi,dcs
-f --freeSpaceBelowPercentage (Facultatif) Purge les journaux lorsque l'espace disque libre est inférieur au pourcentage indiqué de la taille totale de la partition. Plage valide : 20 à 50. Valeur par défaut : 20.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --olderthan (Facultatif) Partie quantitative de la période. Valeur par défaut : 30. Nettoie les journaux antérieurs à la période indiquée (-o et -u).
-u --olderThanUnit (Facultatif) Partie unitaire de la période. Valeurs possibles : Day, Hour ou Minute. Valeur par défaut : Day. Nettoie les journaux antérieurs à la période indiquée (-o et -u).
-uMB --usageOverMB (Facultatif) Purge les journaux lorsque l'utilisation des journaux dépasse le nombre indiqué de méga-octets (Mo). Plage valide : 10 % à 50 % de la taille totale de la partition.
-uPer --usageOverPercentage (Facultatif) Purge les journaux lorsque l'utilisation des journaux dépasse le pourcentage indiqué de la taille totale de la partition. Plage valide : 10 à 50.

dbcli list-autoLogCleanPolicy

Utilisez la commande dbcli list-autoLogCleanPolicy pour répertorier les stratégies de nettoyage automatique des journaux.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants. Les valeurs possibles sont gi, database et dcs. S'il existe plusieurs valeurs, séparez-les par une virgule. Par exemple : gi,dcs
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes backup

Les commandes suivantes permettent de sauvegarder des bases de données : 

  • dbcli create-backup
  • dbcli getstatus-backup
  • dbcli schedule-backup

Remarques :

Au lieu d'utiliser dbcli, vous pouvez utiliser la console ou l'API pour gérer la sauvegarde des bases de données sur Object Storage. Toutefois, si vous passez de dbcli à l'utilisation de sauvegardes gérées, une configuration de sauvegarde est créée et associée à votre base de données. Les sauvegardes créées à l'aide de dbcli ne seront alors pas accessibles à partir des interfaces de sauvegarde gérée. Pour plus d'informations sur les sauvegardes gérées, reportez-vous à Sauvegarde et récupération dans Base Database Service.

Pour pouvoir sauvegarder une base de données à l'aide de la commande dbcli create-backup, vous devez procéder comme suit :

  1. Créez une configuration de sauvegarde à l'aide de la commande dbcli create-backupconfig.
  2. Associez la configuration de sauvegarde à la base de données à l'aide de la commande dbcli update-database.

Une fois la base de données associée à une configuration de sauvegarde, vous pouvez exécuter les sauvegardes automatiquement en utilisant la commande dbcli create-backup dans un travail cron. Vous pouvez utiliser un utilitaire Cron, comme CronMaker, pour construire des expressions. Pour plus d'informations, reportez-vous à CronMaker.

dbcli create-backup

Utilisez la commande dbcli create-backup pour créer une sauvegarde d'une base de données.

Syntaxe

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]

Paramètres

Paramètre Nom complet Description
-bt --backupType

(Facultatif) Type de sauvegarde. Les valeurs possibles sont Regular-L0, Regular-L1, Longterm et ArchiveLog. Regular-L0 et Regular-L1 correspondent aux sauvegardes incrémentielles L0 et L1. Longterm correspond à une sauvegarde complète. ArchiveLog correspond à la sauvegarde des fichiers de journalisation archivés. La valeur par défaut est Regular-L1. Les valeurs ne font pas la distinction entre les majuscules et les minuscules. Si aucune valeur n'est indiquée, la valeur par défaut est utilisée.

-c --component

(Facultatif) Composant. Les valeurs possibles sont Database et TdeWallet. La valeur par défaut est Database. La valeur TdeWallet sauvegarde les portefeuilles TDE. Les valeurs ne font pas la distinction entre les majuscules et les minuscules. Si aucune valeur n'est indiquée, la valeur par défaut est utilisée.

Les portefeuilles TDE sont sauvegardés automatiquement dans les situations suivantes :
  • Une base de données est créée avec une configuration de sauvegarde Object Storage.
  • Une base de données disposant d'une configuration de sauvegarde Object Storage est mise à jour.
  • Une configuration de sauvegarde Object Storage est mise à jour.
  • Une sauvegarde de type Longterm est créée.
  • La clé TDE d'une base de données fait l'objet d'une rotation.
  • Une base de données est sauvegardée alors qu'aucune sauvegarde de portefeuille TDE n'existe encore.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid ID de la base de données à sauvegarder. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-in --dbName Nom de la base de données à sauvegarder. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-k --keepDays

(Facultatif) Définit la durée de conservation de la sauvegarde ou de la copie. Une fois ce délai expiré, la sauvegarde devient obsolète, quels que soient les paramètres de la stratégie de conservation de sauvegarde. Pour les sauvegardes de type Longterm uniquement.

-t --tag

(Requis pour les sauvegardes de type Longterm) Spécifie le nom d'une balise définie par l'utilisateur pour un ensemble de sauvegardes et applique cette balise aux fichiers de sortie générés par la commande. Cette valeur ne fait pas la distinction entre les majuscules et les minuscules. Nombre de caractères valide : 1 à 30. Seuls les caractères valides dans les noms de fichier du système de fichiers cible peuvent être utilisés. Par exemple, ASM ne prend pas en charge l'utilisation du trait d'union (-) dans les noms de fichier qu'il utilise en interne. Par conséquent, "hebdomadaire-incrémentielle" n'est pas un nom de balise valide pour les sauvegardes dans les groupes de disques ASM. Les variables d'environnement ne sont pas valides dans le paramètre TAG.

Exemples 

La commande suivante crée une sauvegarde de la base de données indiquée à l'aide de l'ID de cette base de données.

dbcli create-backup -i 573cadb2-0cc2-4c1c-9c31-595ab8963d5b

La commande suivante crée une sauvegarde de la base de données indiquée à l'aide du nom de cette base de données ("mydb").

dbcli create-backup -in mydb

dbcli getstatus-backup

Utilisez la commande dbcli getstatus-backup pour afficher le statut d'une sauvegarde.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbId (Facultatif) ID de ressource de base de données.
-in --dbName (Facultatif) Nom de ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --isLatestBackupReport (Facultatif) Dernier rapport de sauvegarde. Valeur par défaut : Enabled.
-t --backupType Type de sauvegarde.

dbcli schedule-backup

Utilisez la commande dbcli schedule-backup pour programmer la sauvegarde d'une base de données.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-f --frequency Fréquence en minutes.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbId (Facultatif) ID de ressource de base de données.
-in --dbName (Facultatif) Nom de ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-t --backupType Type de sauvegarde.

Commandes backupconfig

Une configuration de sauvegarde détermine la destination et la fenêtre de récupération des sauvegardes de base de données. Créez la configuration de sauvegarde et associez-la à une base de données à l'aide de la commande dbcli update-database.

Remarques :

Les sauvegardes configurées à l'aide de la console peuvent devenir inutilisables si vous apportez des modifications à l'aide de ces commandes. Pour les sauvegardes configurées à l'aide de la console, utilisez uniquement ces commandes en suivant les instructions du support technique.

Remarques :

Au lieu d'utiliser dbcli, vous pouvez utiliser la console ou l'API pour gérer la sauvegarde des bases de données dans le système de base de données sur Object Storage. Pour plus d'informations sur les sauvegardes gérées, reportez-vous à Sauvegarde et récupération dans Base Database Service.

Une fois la base de données associée à une configuration de sauvegarde, vous pouvez exécuter les sauvegardes automatiquement en utilisant la commande dbcli create-backup dans un travail cron. Vous pouvez utiliser un utilitaire Cron, comme CronMaker, pour construire des expressions. Pour plus d'informations, reportez-vous à CronMaker.

Les commandes suivantes sont disponibles pour gérer les configurations de sauvegarde :

  • dbcli create-backupconfig
  • dbcli list-backupconfigs
  • dbcli describe-backupconfig
  • dbcli update-backupconfig
  • dbcli delete-backupconfig

dbcli create-backupconfig

Utilisez la commande dbcli create-backupconfig pour créer une configuration de sauvegarde qui définit la destination et les fenêtres de récupération de la sauvegarde.

Syntaxe

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]

Paramètres

Paramètre Nom complet Description
-c --container

Nom d'un bucket existant dans le service Oracle Cloud Infrastructure Object Storage. Vous pouvez utiliser la console ou l'API Object Storage pour créer le bucket. Pour plus d'informations, reportez-vous à Gestion des buckets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Facultatif) Indique si l'opération de contre-vérification doit être activée. Cette opération détermine si les fichiers présents sur le disque ou dans le catalogue de gestion des supports correspondent aux données du référentiel RMAN. Si aucune valeur n'est indiquée, le paramètre par défaut est utilisé (crosscheck est activé par défaut).

-d --backupdestination

La destination de sauvegarde doit prendre l'une des valeurs suivantes (ces valeurs ne font pas la distinction entre les majuscules et les minuscules) :

DISK : zone de récupération rapide locale.

OBJECTSTORE : service Oracle Cloud Infrastructure Object Storage. Vous devez également spécifier les paramètres --container et --objectstoreswiftId.

NONE : désactive la sauvegarde.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-n --name Nom de la configuration de sauvegarde.
-o --objectstoreswiftId

ID de la banque d'objets qui contient l'adresse et les informations d'identification pour le service Oracle Cloud Infrastructure Object Storage. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID de la banque d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer une banque d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-on --objectstoreswiftName

Nom de la banque d'objets qui contient l'adresse et les informations d'identification pour le service Oracle Cloud Infrastructure Object Storage.

Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID de la banque d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer une banque d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-w --recoverywindow

Nombre de jours pendant lesquels les sauvegardes et les fichiers de journalisation archivés sont conservés. La période se termine toujours par l'heure en cours et remonte dans le temps selon le nombre de jours spécifié.

Si la destination de sauvegarde est définie sur DISK, indiquez une période comprise entre 1 et 14 jours.

Si la destination de sauvegarde est définie sur OBJECTSTORE, indiquez une période comprise entre 1 et 30 jours.

Exemple

La commande suivante crée une configuration de sauvegarde nommée dbbkcfg1 :

dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1
Sortie :
{
  "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

Utilisez la commande dbcli list-backupconfigs pour répertorier toutes les configurations de sauvegarde dans le système de base de données.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante répertorie une configuration de sauvegarde :

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

dbcli describe-backupconfig

Utilisez la commande dbcli describe-backupconfig pour afficher les détails relatifs à une configuration de sauvegarde spécifique.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --backupconfigid ID de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des détails sur une configuration de sauvegarde :

dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d
Sortie :
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

Utilisez la commande dbcli update-backupconfig pour mettre à jour une configuration de sauvegarde existante.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-c --container

Nom d'un bucket existant dans le service Oracle Cloud Infrastructure Object Storage. Vous pouvez utiliser la console ou l'API Object Storage pour créer le bucket. Pour plus d'informations, reportez-vous à Gestion des buckets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Facultatif) Indique si l'opération de contre-vérification doit être activée. Cette opération détermine si les fichiers présents sur le disque ou dans le catalogue de gestion des supports correspondent aux données du référentiel RMAN. Si aucune valeur n'est indiquée, le paramètre par défaut est utilisé (crosscheck est activé par défaut).

-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --backupconfigid ID de la configuration de sauvegarde à mettre à jour. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde à mettre à jour. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.
-o --objectstoreswiftId

ID de la banque d'objets qui contient l'adresse et les informations d'identification pour le service Oracle Cloud Infrastructure Object Storage. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID de la banque d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer une banque d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-on --objectstoreswiftname

Nom de la banque d'objets qui contient l'adresse et les informations d'identification pour le service Oracle Cloud Infrastructure Object Storage. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID de la banque d'objets. Utilisez la commande dbcli create-objectstoreswift pour créer une banque d'objets.

Vous devez également spécifier les paramètres --backupdestination objectstore et --container.

-w --recoverywindow

Nouvelle fenêtre de récupération sur disque.

Si la destination de sauvegarde est définie sur DISK, indiquez une période comprise entre 1 et 14 jours.

Si la destination de sauvegarde est définie sur OBJECTSTORE, indiquez une période comprise entre 1 et 30 jours.

Exemple

La commande suivante met à jour la fenêtre de récupération d'une configuration de sauvegarde :

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

dbcli delete-backupconfig

Utilisez la commande dbcli delete-backupconfig pour supprimer une configuration de sauvegarde.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --id ID de la configuration de sauvegarde à supprimer. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-in --backupconfigname Nom de la configuration de sauvegarde à supprimer. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante supprime la configuration de sauvegarde indiquée :

dbcli delete-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d

Commande component

dbcli describe-component

Le système de base de données peut ne pas inclure cette commande, qui est plus récente. Si vous ne parvenez pas à exécuter cette commande, utilisez la commande CLI Update Command pour mettre à jour l'interface de ligne de commande de base de données, puis relancez-la.

Remarques :

La commande dbcli describe-component n'est pas disponible sur les systèmes de base de données RAC à deux noeuds. L'application de patches aux systèmes à deux noeuds à partir d'Object Storage n'est pas prise en charge.

Utilisez la commande dbcli describe-component afin d'afficher les versions de patch installées et celles disponibles pour les composants du serveur, du stockage et/ou du répertoire de base de base de données dans le système de base de données.

Cette commande nécessite une configuration d'informations d'identification Object Storage valide. Si la configuration est manquante ou non valide, la commande échoue et génère l'erreur suivante : Failed to connect to the object store. Please provide valid details.

Pour plus d'informations sur la mise à jour de l'interface de ligne de commande, sur la création d'une configuration d'informations d'identification et sur l'application des patches, reportez-vous à Mise à jour d'un système de base de données.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-d --dbhomes (Facultatif) Répertorie les versions de patch installées et disponibles pour les composants du répertoire de base de base de données uniquement.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-s --server (Facultatif) Répertorie les versions de patch installées et disponibles pour les composants du serveur uniquement.

Exemple

La commande suivante permet d'afficher les versions de composant en cours et les versions de patch disponibles dans la banque d'objets :

dbcli describe-component
Sortie :
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

Commandes database

Les commandes suivantes permettent de gérer les bases de données :

  • dbcli clone-database
  • dbcli describe-database
  • dbcli list-databases
  • dbcli modify-database
  • dbcli recover-database
  • dbcli register-database
  • dbcli update-database

dbcli clone-database

Utilisez la commande dbcli clone-database pour cloner une base de données.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-f --sourcedbname Nom de la base de données source.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-m --syspassword (Facultatif) Mot de passe pour SYS.
-n --dbname Nom de base de données.
-p --tdepassword (Facultatif) Mot de passe du portefeuille TDE source.
-s --dbshape (Facultatif) Forme de la base de données. Exemples : odb1, odb2.
-t --dbtype (Facultatif) Type de la base de données : SI
-u --databaseUniqueName Nom de la base de données unique.

dbcli describe-database

Utilisez la commande dbcli describe-database pour afficher les détails relatifs à la base de données.

Syntaxe

dbcli describe-database 
  -i <db_id> 
  -in <db_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid ID de la base de données à afficher. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-in --dbName Nom de la base de données à afficher. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les informations d'une base de données nommée b727bf80-c99e-4846-ac1f-28a81a725df6 :

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6
Sortie :
DB Home details
----------------------------------------------------------------
                      ID: b727bf80-c99e-4846-ac1f-28a81a725df6
                    Name: OraDB12102_home1
                 Version: 12.1.0.2
           Home Location: /u01/app/orauser/product/12.1.0.2/dbhome_1
                 Created: Jun 2, 2016 10:19:23 AM

dbcli list-databases

Utilisez la commande dbcli list-databases pour répertorier toutes les bases de données sur le système de base de données.

Syntaxe

dbcli  list-databases [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche la liste des bases de données :

dbcli  list-databases
Sortie :
ID                                       DB Name    DB Version           CDB        Class    Shape    Storage    Status
---------------------------------------- ---------- -------------------- ---------- -------- -------- ---------- ----------
80ad855a-5145-4f8f-a08f-406c5e4684ff     dbst       12.1.0.2             true       OLTP     odb2     ACFS       Configured
6f4e36ae-120b-4436-b0bf-d0c4aef9f7c9     db11tsta   11.2.0.4             false      OLTP     odb1     ACFS       Configured
d8e31790-84e6-479c-beb0-ef97207091a2     db11tstb   11.2.0.4             false      OLTP     odb1     ACFS       Configured
cce096c7-737b-447a-baa1-f4c2a330c030     pdbtst     12.1.0.2             true       OLTP     odb1     ACFS       Configured

La commande suivante affiche la sortie JSON pour une base de données :

dbcli list-databases -j
Sortie :
[ {
  "id" : "80ad855a-5145-4f8f-a08f-406c5e4684ff",
  "name" : "dbtst",
  "dbName" : "dbtst",
  "databaseUniqueName" : "dbtst_phx1cs",
  "dbVersion" : "12.1.0.2",
  "dbHomeId" : "2efe7af7-0b70-4e9b-ba8b-71f11c6fe287",
  "instanceOnly" : false,
  "registerOnly" : false,
  "dbId" : "167525515",
  "isCdb" : true,
  "pdBName" : "pdb1",
  "pdbAdminUserName" : "pdbuser",
  "enableTDE" : true,
  "dbType" : "SI",
  "dbTargetNodeNumber" : "0",
  "dbClass" : "OLTP",
  "dbShape" : "odb2",
  "dbStorage" : "ACFS",
  "dbCharacterSet" : {
    "characterSet" : "US7ASCII",
    "nlsCharacterset" : "AL16UTF16",
    "dbTerritory" : "AMERICA",
    "dbLanguage" : "AMERICAN"
  },
  "dbConsoleEnable" : false,
  "backupConfigId" : null,
  "backupDestination" : "NONE",
  "cloudStorageContainer" : null,
  "state" : {
    "status" : "CONFIGURED"
  },
  "createTime" : "November 09, 2016 17:23:05 PM UTC",
  "updatedTime" : "November 09, 2016 18:00:47 PM UTC"
}

dbcli modify-database

Utilisez la commande dbcli modify-database pour modifier une base de données.

Syntaxe

dbcli modify-database 
  -i <db_id> 
  -dh <destination_db_home_id> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-dh --destdbhomeid ID du répertoire de base de la base de données de destination.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --databaseid ID de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli recover-database

Utilisez la commande dbcli recover-database pour récupérer une base de données.

Syntaxe

dbcli recover-database 
  [-br <json>] 
  [-in <db_name>] 
  [-i <db_id>] 
  [-r <time>] 
  [-t {Latest|PITR|SCN}] 
  [-s] 
  [-l <location>] 
  [-tp <tde_password>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-br --backupReport (Facultatif) Entrée JSON pour le rapport de sauvegarde.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid (Facultatif) ID de ressource de base de données.
-in --dbName (Facultatif) Nom de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --tdeWalletLocation (Facultatif) Emplacement de sauvegarde du portefeuille TDE. Le portefeuille TDE doit être sauvegardé au format tar.gz.
-r --recoveryTimeStamp (Requis lorsque le type de récupération est PITR) Horodatage de récupération au format mm/dd/yyyy hh:mi:ss. Valeur par défaut : [ ]
-s --scn (Requis lorsque le type de récupération est SCN) SCN.
-t --recoverytype (Requis lorsque le rapport de sauvegarde est fourni) Type de récupération. Les valeurs possibles sont Latest, PITR et SCN.
-tp --tdeWalletPassword (Facultatif) Mot de passe du portefeuille TDE

dbcli register-database

Utilisez la commande dbcli register-database pour inscrire une base de données ayant été migrée vers Oracle Cloud Infrastructure. La commande inscrit la base de données auprès de dcs-agent afin qu'elle puisse être gérée par la pile dcs-agent.

Remarques :

La commande dbcli register-database n'est pas disponible sur les systèmes de base de données RAC à deux noeuds.

Syntaxe

dbcli  register-database 
  -bi <bkup_config_id> 
  -c {OLTP|DSS|IMDB} 
  [-co|-no-co] 
  -s {odb1|odb2|...} 
  -t SI 
  [-o <db_host_name>] 
  [-tp <password>] 
  -sn <service_name> 
  -p 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-bi --backupconfigid Définit l'ID de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-c --dbclass Définit la classe de la base de données. Les options disponibles sont OLTP, DSS ou IMDB. La valeur par défaut est OLTP. Pour Enterprise Edition, les trois classes sont prises en charge. Pour Standard Edition, seul OLTP est pris en charge.

-co

-no-co

--dbconsole

--no-dbconsole

(Facultatif) Indique si la console de base de données est activée. Si aucune valeur n'est indiquée, la console n'est pas activée.

-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --hostname (Facultatif) Définit le nom de l'hôte de la base de données. La valeur par défaut est Local host name.
-p --syspassword

Définit un mot de passe renforcé pour SYS. Indiquez -p sans mot de passe. Le mot de passe vous sera demandé.

Si vous devez fournir le mot de passe dans la commande, par exemple dans un script, utilisez -hp <password> au lieu de -p.

-s --dbshape Définit le modèle de dimensionnement de base de données à utiliser pour la base de données. Par exemple, odb1, odb2 et odb3.
-sn --servicename Définit le nom du service de base de données utilisé pour créer la chaîne EZCONNECT en vue de la connexion à la base de données. Le format de la chaîne de connexion est le suivant : hostname:port/servicename.
-t --dbtype (Facultatif) Définit le type de base de données sur SI (base de données à noeud unique). La valeur par défaut est SI.
-tp --tdeWalletPassword

(Facultatif) Mot de passe du portefeuille TDE. Requis lorsque TDE est activé sur la base de données migrée.

Exemple

La commande suivante inscrit la base de données avec la classe de base de données, le nom de service et le modèle de dimensionnement de base de données indiqués.

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
Sortie :
Password for SYS:
{
  "jobId" : "317b430f-ad5f-42ae-bb07-13f053d266e2",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "August 08, 2016 05:55:49 AM EDT",
  "description" : "Database service registration with db service name: crmdb.example.com",
  "updatedTime" : "August 08, 2016 05:55:49 AM EDT"
}

dbcli update-database

Utilisez la commande dbcli update-database pour associer une configuration de sauvegarde à une base de données.

Syntaxe

dbcli update-database 
  -i <db_id> 
  -bi <bkup_config_id> 
  -bin <bkup_config_name>;
  [-id <id>] 
  -in <name> 
  [-no-ab] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-bi --backupconfigid Définit l'ID de la configuration de sauvegarde. Utilisez la commande dbcli list-backupconfigs pour obtenir l'ID.
-bin --backupconfigname Définit le nom de la configuration de sauvegarde en vue d'une utilisation ultérieure. Utilisez la commande dbcli list-backupconfigs pour obtenir le nom.
-id --databaseid

(Facultatif.) Indique l'ID de base de données, un numéro d'identification 32 bits unique calculé lors de la création de la base de données. RMAN affiche l'ID de base de données lors de la connexion à la base de données cible. Pour obtenir l'ID de base de données, vous pouvez interroger la vue V$DATABASE ou les vues de catalogue de récupération RC_DATABASE et RC_DATABASE_INCARNATION.
-in --dbName

Définit le nom de la base de données à mettre à jour. Utilisez la commande dbcli list-databases pour obtenir le nom de la base de données.

-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid Définit l'ID de la base de données à mettre à jour. Utilisez la commande dbcli list-databases pour obtenir l'ID de la base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-no-ab --noautobackup

(Facultatif) Désactive les sauvegardes automatiques pour la base de données indiquée.

Une fois la sauvegarde automatique désactivée, celle-ci ne peut plus être réactivée à l'aide de l'interface de ligne de commande. Pour réactiver la sauvegarde automatique, utilisez la console.

Exemple

La commande suivante associe un fichier de configuration de sauvegarde à une base de données :

dbcli update-database -bi 78a2a5f0-72b1-448f-bd86-cf41b30b64ee -i 71ec8335-113a-46e3-b81f-235f4d1b6fde
Sortie :
{
  "jobId" : "2b104028-a0a4-4855-b32a-b97a37f5f9c5",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467775842977,
  "description" : "update database id:71ec8335-113a-46e3-b81f-235f4d1b6fde",
  "updatedTime" : 1467775842978
}

Commandes dbhome

Les commandes suivantes permettent de gérer les répertoires de base de base de données :

  • dbcli create-dbhome
  • dbcli describe-dbhome
  • dbcli delete-dbhome
  • dbcli list-dbhomes
  • dbcli update-dbhome

dbcli create-dbhome

Utilisez la commande dbcli create-dbhome pour créer un répertoire de base de base de données Oracle.

Syntaxe

dbcli create-dbhome -v <version> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-v --version Définit la version du répertoire de base de base de données.

Exemple

La commande suivante crée un répertoire de base de base de données Oracle de version 12.1.0.2 :

dbcli create-dbhome -v 12.1.0.2

dbcli describe-dbhome

Utilisez la commande dbcli describe-dbhome pour afficher les détails du répertoire de base de base de données Oracle.

Syntaxe

dbcli describe-dbhome -i <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbhomeid Identifie l'ID du répertoire de base de base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La sortie suivante est un exemple d'utilisation de la commande d'affichage des détails du répertoire de base de base de données Oracle.

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b
Sortie :
DB Home details
----------------------------------------------------------------
                     ID: 52850389-228d-4397-bbe6-102fda65922b
                   Name: OraDB12102_home1
                Version: 12.1.0.2
          Home Location: /u01/app/oracle/product/12.1.0.2/dbhome_1
                Created: June 29, 2016 4:36:31 AM UTC

dbcli delete-dbhome

Utilisez la commande dbcli delete-dbhome pour supprimer un répertoire de base de base de données du système de base de données.

Syntaxe

dbcli delete-dbhome -i <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbhomeid Identifie l'ID du répertoire de base de base de données à supprimer. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-dbhomes

Utilisez la commande dbcli list-dbhomes pour afficher la liste des répertoires de base Oracle.

Syntaxe

dbcli list-dbhomes [-h] [-j]

Paramètre

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche la liste des répertoires de base Oracle.

dbcli  list-dbhomes
Sortie :
ID                                   Name               DB Version Home Location
------------------------------------ -----------------  ---------- ------------------------------------------
b727bf80-c99e-4846-ac1f-28a81a725df6 OraDB12102_home1	 12.1.0.2  /u01/app/orauser/product/12.1.0.2/dbhome_1

dbcli update-dbhome

Remarques :

Le système de base de données peut ne pas inclure cette commande, qui est plus récente. Si vous ne parvenez pas à exécuter cette commande, utilisez la commande CLI Update pour mettre à jour l'interface de ligne de commande de base de données, puis relancez-la.

Utilisez la commande dbcli update-dbhome pour appliquer le package de patches DBBP à un répertoire de base de base de données. Pour plus d'informations sur l'application de patches, reportez-vous à Mise à jour d'un système de base de données.

Syntaxe

dbcli update-dbhome 
  -i <db_home_id> 
  -n <node> 
  [--local] 
  [--precheck] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbhomeid ID du répertoire de base de base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID.
-j --json (Facultatif) Affiche la sortie JSON.
-n --node

(Facultatif) Numéro du noeud à mettre à jour. Utilisez la commande dbcli list-nodes pour obtenir le numéro de noeud.

 -l --local

(Facultatif) Effectue l'opération sur le noeud local d'un système haute disponibilité à plusieurs noeuds. Ce paramètre n'est pas nécessaire pour effectuer l'opération sur un système à noeud unique.

-p --precheck

(Facultatif) Exécute les opérations de prévérification pour vérifier les prérequis.

Exemple

Les commandes suivantes mettent à jour le répertoire de base de base de données et affichent la sortie du travail de mise à jour :

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6
Sortie :
{
  "jobId" : "493e703b-46ef-4a3f-909d-bbd123469bea",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 10:03:21 AM PST",
  "resourceList" : [ ],
  "description" : "DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6",
  "updatedTime" : "January 19, 2017 10:03:21 AM PST"
}
dbcli describe-job -i 493e703b-46ef-4a3f-909d-bbd123469bea
Sortie :
Job details
----------------------------------------------------------------
                     ID:  493e703b-46ef-4a3f-909d-bbd123469bea
            Description:  DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6
                 Status:  Running
                Created:  January 19, 2017 10:03:21 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Download latest patch metadata           January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update System version                    January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update Patching Repository               January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:31 AM PST    Success
Opatch updation                          January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Success
Patch conflict check                     January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Running

Commandes dbstorage

Les commandes suivantes permettent de gérer le stockage de base de données :

  • dbcli list-dbstorages
  • dbcli describe-dbstorage

dbcli list-dbstorages

Utilisez la commande dbcli list-dbstorages pour répertorier les espaces de stockage de base de données dans le système de base de données.

Syntaxe

dbcli list-dbstorages [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des détails relatifs au stockage de base de données :

dbcli list-dbstorages
Sortie :
ID                                       Type   DBUnique Name        Status
---------------------------------------- ------ -------------------- ----------
afb4a1ce-d54d-4993-a149-0f28c9fb33a4     Acfs   db1_2e56b3a9b815     Configured
d81e8013-4551-4d10-880b-d1a796bca1bc     Acfs   db11xp               Configured

dbcli describe-dbstorage

Utilisez la commande dbcli describe-dbstorage pour afficher des informations détaillées sur une ressource de stockage de base de données spécifique.

Syntaxe

dbcli describe-dbstorage -i <db_storage_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --id Définit l'ID du stockage de base de données. Utilisez la commande dbcli list-dbstorages pour obtenir l'ID du stockage de base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les détails du stockage de base de données pour la ressource 105a2db2-625a-45ba-8bdd-ee46da0fd83a :

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a
Sortie :
DBStorage details
----------------------------------------------------------------

                     ID: 105a2db2-625a-45ba-8bdd-ee46da0fd83a
                DB Name: db1
          DBUnique Name: db1
         DB Resource ID: 439e7bd7-f717-447a-8046-08b5f6493df0
           Storage Type:
          DATA Location: /u02/app/oracle/oradata/db1
          RECO Location: /u03/app/oracle/fast_recovery_area/
          REDO Location: /u03/app/oracle/redo/
                  State: ResourceState(status=Configured)
                Created: July 3, 2016 4:19:21 AM UTC
            UpdatedTime: July 3, 2016 4:41:29 AM UTC

Commandes dgconfig

dbcli list-dgconfigs

Utilisez la commande dbcli list-dgconfigs pour répertorier les configurations DG.

Syntaxe

dbcli list-dgconfigs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes jobs

Les commandes suivantes permettent de gérer les travaux :

  • dbcli describe-job
  • dbcli list-jobs

dbcli describe-job

Utilisez la commande dbcli describe-job pour afficher les détails d'un travail spécifique.

Syntaxe

dbcli describe-job -i <job_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --jobid Identifie le travail. Utilisez la commande dbcli list-jobs pour obtenir l'ID du travail.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des détails relatifs à l'ID de travail indiqué :

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17
Sortie :
Job details
----------------------------------------------------------------
                     ID:  74731897-fb6b-4379-9a37-246912025c17
            Description:  Backup service creation with db name: dbtst
                 Status:  Success
                Created:  November 18, 2016 8:33:04 PM UTC
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Backup Validations                       November 18, 2016 8:33:04 PM UTC    November 18, 2016 8:33:13 PM UTC    Success
validate recovery window                 November 18, 2016 8:33:13 PM UTC    November 18, 2016 8:33:17 PM UTC    Success
Db cross check                           November 18, 2016 8:33:17 PM UTC    November 18, 2016 8:33:23 PM UTC    Success
Database Backup                          November 18, 2016 8:33:23 PM UTC    November 18, 2016 8:34:22 PM UTC    Success
Backup metadata                          November 18, 2016 8:34:22 PM UTC    November 18, 2016 8:34:22 PM UTC    Success

dbcli list-jobs

Utilisez la commande dbcli list-jobs pour afficher la liste des travaux, notamment leur ID, leur statut,

leur date de création et leur horodatage.

Syntaxe

dbcli list-jobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche la liste des travaux :

dbcli list-jobs
Sortie :
ID                                       Description                                                                 Created                             Status
---------------------------------------- --------------------------------------------------------------------------- ----------------------------------- ----------
0a362dac-0339-41b5-9c9c-4d229e363eaa     Database service creation with db name: db11                                November 10, 2016 11:37:54 AM UTC   Success
9157cc78-b487-4ee9-9f46-0159f10236e4     Database service creation with db name: jhfpdb                              November 17, 2016 7:19:59 PM UTC    Success
013c408d-37ca-4f58-a053-02d4efdc42d0     create backup config:myBackupConfig                                         November 18, 2016 8:28:14 PM UTC    Success
921a54e3-c359-4aea-9efc-6ae7346cb0c2     update database id:80ad855a-5145-4f8f-a08f-406c5e4684ff                     November 18, 2016 8:32:16 PM UTC    Success
74731897-fb6b-4379-9a37-246912025c17     Backup service creation with db name: dbtst                                 November 18, 2016 8:33:04 PM UTC    Success
40a227b1-8c47-46b9-a116-48cc1476fc12     Creating a report for database 80ad855a-5145-4f8f-a08f-406c5e4684ff         November 18, 2016 8:41:39 PM UTC    Success

Commande latestpatch

dbcli describe-latestpatch

Remarques :

  • Le système de base de données peut ne pas inclure cette commande, qui est plus récente. Si vous ne parvenez pas à exécuter cette commande, utilisez la commande CLI Update pour mettre à jour l'interface de ligne de commande de base de données, puis relancez-la.
  • La commande dbcli describe-latestpatch n'est pas disponible sur les systèmes de base de données RAC à deux noeuds. L'application de patches aux systèmes à deux noeuds à partir d'Object Storage n'est pas prise en charge.

Utilisez la commande dbcli describe-latestpatch pour afficher les derniers patches applicables au système de base de données et disponibles dans Oracle Cloud Infrastructure Object Storage.

Cette commande nécessite une configuration d'informations d'identification Object Storage valide. Si la configuration est manquante ou non valide, la commande échoue et génère l'erreur suivante : Failed to connect to the object store. Please provide valid details.

Pour plus d'informations sur la mise à jour de l'interface de ligne de commande, sur la création d'une configuration d'informations d'identification et sur l'application des patches, reportez-vous à Mise à jour d'un système de base de données.

Syntaxe

dbcli describe-latestpatch [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche les patches disponibles dans la banque d'objets :

dbcli describe-latestpatch
Sortie :
componentType   availableVersion
--------------- --------------------
gi              12.1.0.2.161018
db              11.2.0.4.161018
db              12.1.0.2.161018
oak             12.1.2.10.0

Commandes logcleanjob

Les commandes suivantes permettent de gérer les travaux de nettoyage des journaux : 

  • dbcli create-logCleanJob
  • dbcli describe-logCleanJob
  • dbcli list-logCleanJobs

dbcli create-logCleanJob

Utilisez la commande dbcli create-logCleanJob pour créer un travail de nettoyage des journaux.

Syntaxe

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

Paramètres

Paramètre Nom complet Description
-c --components (Facultatif) Composants. Les valeurs possibles sont gi, database et dcs. S'il existe plusieurs valeurs, séparez-les par une virgule.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-o --olderThan (Facultatif) Partie quantitative de la période. Valeur par défaut : 30. Nettoie les journaux antérieurs à la période indiquée (-o et -u).
-u --unit (Facultatif) Partie unitaire de la période. Valeurs possibles : Day, Hour ou Minute. Valeur par défaut : Day. Nettoie les journaux antérieurs à la période indiquée (-o et -u).

dbcli describe-logCleanJob

Utilisez la commande dbcli describe-logCleanJob pour afficher le récapitulatif d'un travail de nettoyage des journaux.

Syntaxe

dbcli describe-logCleanJob 
  -i <job_id> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --jobid ID du travail de nettoyage des journaux pour lequel afficher le récapitulatif.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-logCleanJobs

Utilisez la commande dbcli list-logCleanJobs pour répertorier les travaux de nettoyage des journaux.

Syntaxe

dbcli list-logCleanJobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes netsecurity

Les commandes suivantes permettent de gérer le cryptage réseau sur le système de base de données :

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli describe-netsecurity

Utilisez la commande dbcli describe-netsecurity pour afficher le paramètre de cryptage réseau en cours d'un répertoire de base de base de données.

Syntaxe

dbcli describe-netsecurity -H <db_home_id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-H --dbHomeId Définit l'ID du répertoire de base de base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID du répertoire de base de la base de données.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche le paramètre de cryptage du répertoire de base de base de données indiqué :

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d
Sortie :
NetSecurity Rules
----------------------------------------------------------------
         DatabaseHomeID: 16c96a9c-f579-4a4c-a645-8d4d22d6889d

                   Role: Server
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

                   Role: Client
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

dbcli update-netsecurity

Utilisez la commande dbcli update-netsecurity pour mettre à jour la configuration de la sécurité Oracle Net sur le système de base de données.

Syntaxe

dbcli update-netsecurity 
  {-c|-s} 
  -t {REJECTED|ACCEPTED|REQUESTED|REQUIRED} 
  -H <db_home_id> 
  -e {AES256|AES192|AES128} 
  -i {SHA1|SHA512|SHA384|SHA256} 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-c --client

Indique que la configuration spécifiée du cryptage des données ou de l'intégrité des données est destinée au client. (--client et --server s'excluent mutuellement.)

-e -- encryptionAlgorithms Définit l'algorithme à utiliser pour le cryptage. Choisissez AES256, AES192 ou AES128.
-H --dbHomeId Définit l'ID du répertoire de base de base de données. Utilisez la commande dbcli list-dbhomes pour obtenir l'ID du répertoire de base de la base de données.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --integrityAlgorithms Définit l'algorithme à utiliser pour l'intégrité. Choisissez SHA1, SHA512, SHA384 ou SHA256. Pour Oracle Database 11g, la seule valeur acceptée est SHA1.
-j --json (Facultatif) Affiche la sortie JSON.
-s --server Indique que la configuration spécifiée du cryptage des données ou de l'intégrité des données est destinée au serveur. (--client et --server s'excluent mutuellement.)
-t --connectionType

Indique comment le cryptage des données et l'intégrité des données Oracle Net Services sont négociés avec les clients. Les valeurs suivantes sont répertoriées par ordre de sécurité croissante :

REJECTED : n'active pas le cryptage des données ni l'intégrité des données, même s'ils sont demandés par le client.

ACCEPTED : active le cryptage des données ou l'intégrité des données si nécessaire ou si demandé par le client.

REQUESTED : active le cryptage des données ou l'intégrité des données si le client l'autorise.

REQUIRED : active le cryptage des données ou l'intégrité des données. Si l'activation est impossible, la connexion est refusée.

Exemple

La commande suivante met à jour le type de connexion sur ACCEPTED :

dbcli update-netsecurity -H a2ffbb07-c9c0-4467-a458-bce4d3b76cd5 -t ACCEPTED

Commandes objectstoreswift

Vous pouvez sauvegarder une base de données dans un bucket existant du service Oracle Cloud Infrastructure Object Storage à l'aide de la commande dbcli create-backup. Toutefois, vous devez d'abord procéder comme suit :

  1. Sur le système de base de données, créez une banque d'objets qui contient l'adresse et les informations d'identification permettant d'accéder à Object Storage à l'aide de la commande dbcli create-objectstoreswift.
  2. Créez une configuration de sauvegarde faisant référence à l'ID de la banque d'objets et au nom du bucket à l'aide de la commande dbcli create-backupconfig.
  3. Associez la configuration de sauvegarde à la base de données à l'aide de la commande dbcli update-database.

Les commandes suivantes permettent de gérer les banques d'objets.

  • dbcli create-objectstoreswift
  • dbcli describe-objectstoreswift
  • dbcli list-objectstoreswifts

dbcli create-objectstoreswift

Utilisez la commande dbcli create-objectstoreswift pour créer une banque d'objets.

Syntaxe

dbcli create-objectstoreswift 
  -n <object_store_name> 
  -t <object_storage_namespace> 
  -u <user_name> 
  -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 
  -p <password>
  [-h] [-j]

où <object_storage_namespace> est l'espace de noms Object Storage de votre location.

Paramètres

Paramètre Nom complet Description
-e --endpointurl

URL endpoint suivante : https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-n --name

Nom de la banque d'objets à créer.

-p --swiftpassword

Jeton d'authentification généré à l'aide de la console ou de l'API IAM. Pour plus d'informations sur la génération d'un jeton d'authentification à utiliser avec Swift, reportez-vous à Gestion des informations d'identification utilisateur.

Il ne s'agit pas du mot de passe de l'utilisateur Oracle Cloud Infrastructure.

Spécifiez -p (sans mot de passe) pour que le système vous invite à indiquer le mot de passe.

Spécifiez -hp "<password>" entre guillemets droits pour fournir le mot de passe (jeton d'authentification) dans la commande.

-t --tenantname Espace de noms Object Storage de votre location.
-u --username Nom utilisateur du compte utilisateur Oracle Cloud Infrastructure, par exemple : -u djones@example.com

Il s'agit du nom utilisateur qui sert pour la connexion à la console.

Le nom utilisateur doit disposer d'un accès au niveau de la location à Object Storage. Pour ce faire, vous pouvez simplement ajouter le nom utilisateur au groupe d'administrateurs. Toutefois, cette opération donne accès à l'ensemble des services cloud. A la place, un administrateur peut créer une stratégie qui autorise l'accès au niveau de la location uniquement pour Object Storage. Vous trouverez ci-dessous un exemple d'une stratégie de ce type. 

Allow group DBAdmins to manage buckets in tenancy
Allow group DBAdmins to manage objects in tenancy

Pour plus d'informations sur l'ajout d'un utilisateur à un groupe, reportez-vous à Gestion des groupes. Pour plus d'informations sur les stratégies, reportez-vous à Introduction aux stratégies.

Exemple

La commande suivante crée une banque d'objets et invite à saisir le mot de passe Swift :

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p
Sortie :
Password for Swift:
{
  "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
  "status" : "Created",
  "message" : "Create object store swift",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 11:11:33 AM PST",
  "resourceList" : [ {
    "resourceId" : "8a0fe039-f5d4-426a-8707-256c612b3a30",
    "resourceType" : "ObjectStoreSwift",
    "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
    "updatedTime" : "January 19, 2017 11:11:33 AM PST"
  } ],
  "description" : "create object store:biyanr2swift",
  "updatedTime" : "January 19, 2017 11:11:33 AM PST"
}

dbcli describe-objectstoreswift

Utilisez la commande dbcli describe-objectstoreswift pour afficher des détails concernant une banque d'objets.

Syntaxe

dbcli describe-objectstoreswift 
  -i <object_store_swift_id> 
  -in <object_store_swift_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --objectstoreswiftid ID de la banque d'objets. Utilisez la commande dbcli list-objectstoreswifts pour obtenir l'ID.
-in --objectstoreswiftName Nom de la banque d'objets. Utilisez la commande dbcli list-objectstoreswifts pour obtenir le nom.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante affiche des détails relatifs à une banque d'objets :

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87
Sortie :
Object Store details
----------------------------------------------------------------
                     ID: 910e9e2d-25b4-49b4-b88e-ff0332f7df87
                   Name: objstrswift15
               UserName: djones@example.com
             TenantName: CompanyABC
           endpoint URL: https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
            CreatedTime: November 16, 2016 11:25:34 PM UTC
            UpdatedTime: November 16, 2016 11:25:34 PM UTC

dbcli list-objectstoreswifts

Utilisez la commande dbcli list-objectstoreswifts pour répertorier les banques d'objets sur un système de base de données.

Syntaxe

dbcli list-objectstoreswifts [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante répertorie les banques d'objets sur le système de base de données :

dbcli list-objectstoreswifts
Sortie :
ID                                       Name                 UserName              TenantName     Url                                                         createTime
---------------------------------------- -------------------- --------------------  -------------- ------ ---------------------------------------------------- -----------------------------------
2915bc6a-6866-436a-a38c-32302c7c4d8b     swiftobjstr1         djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 10, 2016 8:42:18 PM UTC
910e9e2d-25b4-49b4-b88e-ff0332f7df87     objstrswift15        djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 16, 2016 11:25:34 PM UTC

Commande pendingjob

dbcli list-pendingjobs

Utilisez la commande dbcli list-pendingjobs pour afficher la liste des travaux en attente.

Syntaxe

dbcli list-pendingjobs [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes rmanbackupreport

Les commandes suivantes permettent de gérer les rapports de sauvegarde RMAN : 

  • dbcli create-rmanbackupreport
  • dbcli delete-rmanbackupreport
  • dbcli describe-rmanbackupreport
  • dbcli list-rmanbackupreports

dbcli create-rmanbackupreport

Utilisez la commande dbcli create-rmanbackupreport pour créer un rapport de sauvegarde RMAN.

Syntaxe

dbcli create-rmanbackupreport 
  -w {summary|detailed} 
  -rn <name> 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid (Facultatif) ID de ressource de base de données.
-in --dbname (Facultatif) Nom de ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-rn --rptname Nom du rapport de sauvegarde RMAN. Nombre maximal de caractères : 30. Placez le nom entre apostrophes lorsque vous utilisez des caractères spéciaux.
-w --reporttype Type du rapport de sauvegarde RMAN. Valeurs possibles : summary ou detailed.

dbcli delete-rmanbackupreport

Utilisez la commande dbcli delete-rmanbackupreport pour supprimer un rapport de sauvegarde RMAN.

Syntaxe

dbcli delete-rmanbackupreport 
  [-d <db_id>] 
  [-dn <db_name>] 
  [-n <number>] 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-d --dbid (Facultatif) ID de ressource de base de données.
-dn --dbname (Facultatif) Nom de ressource de base de données.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --reportid (Facultatif) ID du rapport de sauvegarde RMAN
-in --rptname (Facultatif) Nom du rapport de sauvegarde RMAN
-j --json (Facultatif) Affiche la sortie JSON.
-n --numofday (Facultatif) Nombre de jours depuis la création (fourni avec l'ID/le nom de base de données)

dbcli describe-rmanbackupreport

Utilisez la commande dbcli describe-rmanbackupreport pour

Syntaxe

dbcli describe-rmanbackupreport 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --id (Facultatif) ID du rapport de sauvegarde RMAN
-in --name (Facultatif) Nom du rapport de sauvegarde RMAN
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-rmanbackupreports

Utilisez la commande dbcli list-rmanbackupreports pour

Syntaxe

dbcli list-rmanbackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbid (Facultatif) ID de ressource de base de données.
-in --dbName (Facultatif) Nom de ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes schedule

Les commandes suivantes permettent de gérer les programmations : 

  • dbcli describe-schedule
  • dbcli list-schedules
  • dbcli update-schedule

dbcli describe-schedule

Utilisez la commande dbcli describe-schedule pour décrire une programmation.

Syntaxe

dbcli describe-schedule -i <id> [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --scheduleid ID de la programmation.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli list-schedules

Utilisez la commande dbcli list-schedules pour répertorier les programmations.

Syntaxe

dbcli list-schedules [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

dbcli update-schedule

Utilisez la commande dbcli update-schedule pour mettre à jour une programmation.

Syntaxe

dbcli update-schedule 
  -i <id> 
  [-x <expression>] 
  [-t <description>] 
  [-d] 
  [-e] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-d --disable (Facultatif) Désactive la programmation.
-e --enable (Facultatif) Active la programmation.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --scheduleid ID de la programmation.
-j --json (Facultatif) Affiche la sortie JSON.
-t --description Description (facultatif)
-x --cronExpression (Facultatif) Expression CRON. Utilisez cronmaker.com pour générer une expression CRON valide.

Commande scheduledExecutions

dbcli list-scheduledExecutions

Utilisez la commande dbcli list-scheduledExecutions pour répertorier les exécutions programmées.

Syntaxe

dbcli list-scheduledExecutions 
  [-e <execution_id>] 
  [-i <schedule_id>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-e --executionid (Facultatif) ID de l'exécution.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --scheduleid (Facultatif) ID de la programmation.
-j --json (Facultatif) Affiche la sortie JSON.

Commande server

dbcli update-server

Remarques :

Le système de base de données peut ne pas inclure cette commande, qui est plus récente. Si vous ne parvenez pas à exécuter cette commande, utilisez la commande CLI Update pour mettre à jour l'interface de ligne de commande de base de données, puis relancez-la.

Utilisez la commande dbcli update-server pour appliquer des patches aux composants de serveur dans le système de base de données. Pour plus d'informations sur l'application de patches, reportez-vous à Mise à jour d'un système de base de données.

Syntaxe

dbcli update-server 
  [-n <number>] 
  [--local] 
  [--precheck] 
  [-v]
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.
-l --local

(Facultatif) Effectue l'opération sur le noeud local d'un système haute disponibilité à plusieurs noeuds. Ce paramètre n'est pas nécessaire pour effectuer l'opération sur un système à noeud unique.

-n --node

(Facultatif) Numéro du noeud à mettre à jour. Utilisez la commande dbcli list-nodes pour obtenir le numéro de noeud.

-p --precheck

(Facultatif) Exécute les opérations de prévérification pour vérifier les prérequis.

-v --version (Facultatif) Version à mettre à jour.

Exemples 

Les commandes suivantes mettent à jour le serveur et affichent la sortie du travail de mise à jour :

dbcli update-server
Sortie :
{
  "jobId" : "9a02d111-e902-4e94-bc6b-9b820ddf6ed8",
  "status" : "Created",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 09:37:11 AM PST",
  "resourceList" : [ ],
  "description" : "Server Patching",
  "updatedTime" : "January 19, 2017 09:37:11 AM PST"
}
dbcli describe-job -i 9a02d111-e902-4e94-bc6b-9b820ddf6ed8
Sortie :
Job details
----------------------------------------------------------------
                     ID:  9a02d111-e902-4e94-bc6b-9b820ddf6ed8
            Description:  Server Patching
                 Status:  Running
                Created:  January 19, 2017 9:37:11 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Download latest patch metadata           January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update System version                    January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update Patching Repository               January 19, 2017 9:37:11 AM PST     January 19, 2017 9:38:35 AM PST     Success
oda-hw-mgmt upgrade                      January 19, 2017 9:38:35 AM PST     January 19, 2017 9:38:58 AM PST     Success
Opatch updation                          January 19, 2017 9:38:58 AM PST     January 19, 2017 9:38:58 AM PST     Success
Patch conflict check                     January 19, 2017 9:38:58 AM PST     January 19, 2017 9:42:06 AM PST     Success
apply clusterware patch                  January 19, 2017 9:42:06 AM PST     January 19, 2017 10:02:32 AM PST    Success
Updating GiHome version                  January 19, 2017 10:02:32 AM PST    January 19, 2017 10:02:38 AM PST    Success

La commande suivante met à jour le noeud 0 du serveur uniquement et effectue une prévérification :

dbcli update-server -n 0 -p
Sortie :
{
  "jobId" : "3e2a1e3c-83d3-4101-86b8-4d525f3f8c18",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "April 26, 2019 06:07:27 AM UTC",
  "resourceList" : [ ],
  "description" : "Server Patching Prechecks",
  "updatedTime" : "April 26, 2019 06:07:27 AM UTC"
}

Commande system

dbcli describe-system

Utilisez la commande dbcli describe-system pour afficher les détails relatifs au système. Sur un système de base de données RAC à deux noeuds, la commande fournit des informations concernant le noeud local.

Syntaxe

dbcli describe-system [-b] [-d] [-h] [-j]

Paramètres

Paramètre Nom complet Description
-b --bom (Facultatif) Affiche les informations de nomenclature.

-d

--details

 (Facultatif) Affiche des informations supplémentaires sur le système de base de données, notamment des informations de version d'agent et d'interface de ligne de commande dcs.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Commandes tde

Les commandes suivantes permettent de gérer les éléments liés à TDE (rapports de sauvegarde, clés et portefeuilles) : 

  • dbcli list-tdebackupreports
  • dbcli update-tdekey
  • dbcli recover-tdewallet

dbcli list-tdebackupreports

Utilisez la commande dbcli list-tdebackupreports pour répertorier les rapports de sauvegarde des portefeuilles TDE.

Syntaxe

dbcli  list-tdebackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-i --dbResid (Facultatif) Affiche les rapports de sauvegarde de portefeuille TDE pour l'ID de ressource de base de données spécifié. Utilisez la commande dbcli list-databases pour obtenir l'ID de la ressource de base de données.
-in --dbResname (Facultatif) Affiche les rapports de sauvegarde de portefeuille TDE pour le nom de ressource de base de données spécifié. Utilisez la commande dbcli list-databases pour obtenir le nom de la ressource de base de données.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante répertorie les rapports de sauvegarde des portefeuilles TDE :

dbcli list-tdebackupreports
Sortie :
DbResID 			            	OraDbId			BackupLocation
--------------------------------------- --------------------	----------------------------------------
538ca5b1-654d-4418-8ce1-f49b6c987a60	1257156075 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb5/1257156075/2017-08-17/TDEWALLET_BMC60_2017-08-17_10-58-17.0990.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-03-25.0953.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_BMC62_2017-08-17_11-04-41.0264.tar.gz
19714ffa-de1b-4433-9188-c0592887e609 	1157116855 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb7/1157116855/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-57-47.0605.tar.gz

dbcli update-tdekey

Utilisez la commande dbcli update-tdekey pour mettre à jour la clé de cryptage TDE dans le portefeuille TDE. Vous pouvez mettre à jour la clé de cryptage des bases de données pluggables (si -pdbNames est indiqué) et/ou de la base de données Conteneur (si -rootDatabase est indiqué).

Syntaxe

dbcli update-tdekey 
  -i <db_id> 
  -p [-all] 
  -n <pdbname1,pdbname2> 
  [-r|-no-r] 
  -t <tag_name> 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-all --allPdbNames

(Facultatif) Indicateur servant à la rotation (mise à jour) de tous les noms de base de données pluggable. Pour mettre à jour tous les noms de base de données pluggable au lieu des seuls noms indiqués, utilisez ce paramètre à la place de -n. Valeur par défaut : false.

-i --databaseId

Définit l'ID de la base de données pour laquelle la clé doit être mise à jour.
-p --password

Définit le mot de passe du portefeuille d'administration TDE. Indiquez -p sans mot de passe. Le mot de passe vous sera demandé.

Si vous devez fournir le mot de passe dans la commande, par exemple dans un script, utilisez -hp <password> au lieu de -p.

-n --pdbNames Définit les noms de base de données pluggable sur lesquels effectuer une rotation (les noms à mettre à jour).

-r

-no-r

--rootDatabase

--no-rootDatabase

 Indique si une rotation de clé de la base de données racine doit être effectuée lorsqu'il s'agit d'une base de données Conteneur.
-t -tagName Définit le nom de balise utilisé pour sauvegarder le portefeuille. La valeur par défaut est OdaRotateKey.
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-j --json (Facultatif) Affiche la sortie JSON.

Exemple

La commande suivante met à jour la clé pour pdb1 et pdb2 uniquement :

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2
Sortie :
TDE Admin wallet password:
{
  "jobId" : "08e5edb1-42e1-4d16-a47f-783c0afa4778",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876407035,
  "description" : "TDE update",
  "updatedTime" : 1467876407035
}

La commande suivante met à jour pdb1, pdb2 et la base de données Conteneur :

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2 -r
Sortie :
TDE Admin wallet password:
{
  "jobId" : "c72385f0-cd81-42df-a8e8-3a1e7cab1278",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876433783,
  "description" : "TDE update",
  "updatedTime" : 1467876433783
}

dbcli recover-tdewallet

Utilisez la commande dbcli recover-tdewallet pour récupérer un portefeuille TDE.

Syntaxe

dbcli recover-tdewallet 
  -in <db_name> 
  -tp <password> 
  [-l <location>] 
  [-h] [-j]

Paramètres

Paramètre Nom complet Description
-h --help (Facultatif) Affiche l'aide relative à l'utilisation de la commande.
-in --dbName Nom de base de données.
-j --json (Facultatif) Affiche la sortie JSON.
-l --tdeWalletBackuplocation (Facultatif) Emplacement de sauvegarde du portefeuille TDE. Le portefeuille TDE doit être sauvegardé au format tar.gz.
-tp --tdeWalletPassword

Définit le mot de passe du portefeuille d'administration TDE.