Referencia de la CLI de Oracle Database

La CLI de base de datos (dbcli) es una interfaz de línea de comandos disponible para Base Database Service. Después de conectarse al sistema de base de datos en Base Database Service, puede utilizar dbcli para realizar tareas como la creación de bases de datos y directorios raíz de base de datos de Oracle.

Notas operativas

  • Los comandos de la CLI de base de datos se deben ejecutar como usuario root.

  • dbcli está en el directorio /opt/oracle/dcs/bin/.

    Este directorio se incluye en la ruta del entorno del usuario root.

  • Oracle Database mantiene los logs de la salida del comando dbcli en los archivos dcscli.log y dcs-agent.log del directorio /opt/oracle/dcs/log/.

  • Los comandos de la CLI de base de datos y la mayoría de los parámetros son sensibles a mayúsculas/minúsculas y se deben escribir como se muestra. Algunos parámetros no son sensibles a mayúsculas y minúsculas, como se indica en las descripciones de los parámetros, y se pueden escribir en mayúsculas o en minúsculas.

Sintaxis

Los comandos de la CLI de base de datos utilizan la siguiente sintaxis:

dbcli command [parameters]

donde:

  • command es una combinación verbo-objeto, como create-database.
  • parameters incluye opciones adicionales para el comando. La mayoría de los nombres de parámetro están precedidos por dos guiones, por ejemplo, --help. Los nombres de parámetro abreviados están precedidos por un guion, por ejemplo, -h.
  • Los valores de parámetro especificados por el usuario se muestran en texto rojo entre paréntesis angulares, por ejemplo, <db_home_id>. Omita los paréntesis angulares al especificar estos valores.
  • El parámetro help está disponible con cada comando.

El resto de este tema contiene la sintaxis y otros detalles sobre los comandos.

Comando update de la CLI

En ocasiones, se agregan comandos nuevos a la CLI de base de datos y se actualizan otros comandos para soportar nuevas funciones. Puede utilizar el siguiente comando para actualizar la CLI de base de datos:

cliadm update-dbcli

Utilice el comando cliadm update-dbcli para actualizar la CLI de base de datos con los comandos nuevos y actualizados más recientes.

Note:

En los sistemas de base de datos RAC, ejecute el comando cliadm update-dbcli en cada nodo del cluster.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando actualiza la dbcli: 

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

Comandos de agentes

El siguiente comando está disponible para gestionar agentes: 

  • dbcli ping-agent

dbcli ping-agent

Utilice el comando dbcli ping-agent para probar la accesibilidad de un agente.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de autologcleanpolicy

Los siguientes comandos están disponibles para gestionar políticas de limpieza automática (depuración) de logs.

  • dbcli create-autoLogCleanPolicy
  • dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

Utilice el comando dbcli create-autoLogCleanPolicy para crear políticas para la limpieza automática (depuración) de logs.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-c --components Componentes que depurar (opcional). Los valores posibles son gi, database y dcs. Separe los diversos valores con comas. Ejemplo: gi,dcs
-f --freeSpaceBelowPercentage (Opcional) Purga los logs cuando el espacio libre en disco está por debajo del porcentaje especificado del tamaño total de la partición. Rango válido: 20-50. Valor por defecto: 20.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-o --olderthan (Opcional) Parte de la cantidad de intervalo de tiempo. Valor por defecto: 30. Limpia los logs anteriores al intervalo de tiempo especificado (-o y -u).
-u --olderThanUnit (Opcional) Parte de la unidad de intervalo de tiempo. Valores posibles: Day, Hour o Minute. Valor por defecto: Day. Limpia los logs anteriores al intervalo de tiempo especificado (-o y -u).
-uMB --usageOverMB (Opcional) Depura los logs cuando el uso de logs excede el número especificado de MegaBytes (MB). Rango válido: del 10 al 50 % del tamaño total de partición.
-uPer --usageOverPercentage (Opcional) Depura los logs cuando el uso de logs excede el porcentaje especificado del tamaño total de la partición. Rango válido: 10-50.

lista dbcli-autoLogCleanPolicy

Utilice el comando dbcli list-autoLogCleanPolicy para mostrar las políticas de limpieza automática de logs.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-c --components (Opcional) Componentes. Los valores posibles son gi, database y dcs. Separe los diversos valores con comas. Ejemplo: gi,dcs
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de copia de seguridad

Los siguientes comandos están disponibles para realizar copias de seguridad de base de datos: 

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

Note:

En lugar de utilizar dbcli, puede utilizar la consola o la API para gestionar la copia de seguridad de las bases de datos del sistema de base de datos en Object Storage. Sin embargo, si cambia de dbcli a usar copias de seguridad gestionadas, se creará una nueva configuración de copia de seguridad y se asociará a la base de datos, y no se podrá acceder a las copias de seguridad creadas mediante dbcli desde las interfaces de copia de seguridad gestionadas. Para obtener información sobre las copias de seguridad gestionadas, consulte Copia de seguridad y recuperación en Base Database Service.

Para poder realizar una copia de seguridad de una base de datos mediante el comando dbcli create-backup, deberá:

  1. Crear una configuración de copia de seguridad mediante el comando dbcli create-backupconfig.
  2. Asociar la configuración de copia de seguridad a la base de datos mediante el comando dbcli update-database.

Después de asociar una base de datos a una configuración de copia de seguridad, puede utilizar el comando dbcli create-backup en un trabajo cron para ejecutar copias de seguridad automáticamente. Puede utilizar una utilidad cron, como CronMaker, para ayudar a crear expresiones. Para obtener más información, consulte CronMaker.

dbcli create-backup

Utilice el comando dbcli create-backup para crear una copia de seguridad de una base de datos.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-bt --backupType

(Opcional) Tipo de copia de seguridad. Los valores posibles son Regular-L0, Regular-L1, Longterm y ArchiveLog. Regular-L0 y Regular L1 corresponden a las copias de seguridad incrementales L0 y L1. Longterm corresponde a una copia de seguridad completa. ArchiveLog corresponde a la copia de seguridad de redo logs archivados. El valor por defecto es Regular-L1. Los valores no son sensibles a mayúsculas/minúsculas. Si se omite, se utiliza el valor por defecto.

-c --component

(Opcional) Componente. Los valores posibles son Database y TdeWallet. El valor por defecto es Database. El valor TdeWallet realiza una copia de seguridad de las carteras de TDE. Los valores no son sensibles a mayúsculas/minúsculas. Si se omite, se utiliza el valor por defecto.

Tenga en cuenta que se realiza una copia de seguridad automática de las carteras de TDE en las siguientes situaciones: 
  • Se crea una base de datos con una configuración de copia de seguridad de Object Storage.
  • Se actualiza una base de datos que tiene una configuración de copia de seguridad de Object Storage.
  • Se actualiza una configuración de copia de seguridad de Object Storage.
  • Se crea una copia de seguridad del tipo Longterm.
  • Se rota la clave TDE para una base de datos.
  • Se realiza una copia de seguridad de una base de datos y aún no existe ninguna copia de seguridad de la cartera de TDE.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid Identificador de la base de datos de la que se realizará la copia de seguridad. Utilice el comando dbcli list-databases para obtener el identificador de la base de datos.
-in --dbName Nombre de la base de datos de la que se realizará la copia de seguridad. Utilice el comando dbcli list-databases para obtener el nombre de la base de datos.
-j --json (Opcional) Muestra la salida JSON.
-k --keepDays

(Opcional) Especifica la hora hasta la que se debe mantener la copia o la copia de seguridad. Después de esta hora, la copia de seguridad quedará obsoleta, independientemente de la configuración de la política de retención de copias de seguridad. Solo para el tipo de copia de seguridad Longterm.

-t --tag

(Necesario para el tipo de copia de seguridad Longterm) Indica un nombre de etiqueta especificado por el usuario para un juego de copias de seguridad y aplica esta etiqueta a los archivos de salida generados por el comando. Este valor no es sensible a mayúsculas/minúsculas. Número válido de caracteres: de 1 a 30. Los caracteres están limitados a los caracteres que son válidos en los nombres de archivo del sistema de archivos de destino. Por ejemplo, ASM no soporta el uso del guion (-) en los nombres de archivo que utiliza internamente, por lo que weekly-incremental no es un nombre de etiqueta válido para las copias de seguridad en los grupos de discos de ASM. Las variables de entorno no son válidas en el parámetro TAG.

Ejemplos

El siguiente comando crea una copia de seguridad de la base de datos especificada utilizando el identificador de base de datos.

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

El siguiente comando crea una copia de seguridad de la base de datos especificada utilizando el nombre de la base de datos ("mydb").

dbcli create-backup -in mydb

dbcli getstatus-backup

Utilice el comando dbcli getstatus-backup para mostrar el estado de una copia de seguridad.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbId (Opcional) Identificador de recurso de base de datos.
-in --dbName (Opcional) Nombre de recurso de base de datos.
-j --json (Opcional) Muestra la salida JSON.
-l --isLatestBackupReport (Opcional) Informe de copia de seguridad más reciente. Valor por defecto: true.
-t --backupType Tipo de copia de seguridad.

dbcli schedule-backup

Utilice el comando dbcli schedule-backup para programar una copia de seguridad de una base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-f --frequency Frecuencia en minutos.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbId (Opcional) Identificador de recurso de base de datos.
-in --dbName (Opcional) Nombre de recurso de base de datos.
-j --json (Opcional) Muestra la salida JSON.
-t --backupType Tipo de copia de seguridad.

Comandos de backupconfig

La configuración de copia de seguridad determina el destino de la copia de seguridad y la ventana de recuperación para las copias de seguridad de la base de datos. Puede crear la configuración de copia de seguridad y asociarla a una base de datos mediante el comando dbcli update-database.

Note:

Es posible que las copias de seguridad que se han configurado mediante la consola no se puedan utilizar si realiza cambios con estos comandos. Para las copias de seguridad configuradas mediante la consola, use estos comandos solo con orientación de asistencia.

Note:

En lugar de utilizar dbcli, puede utilizar la consola o la API para gestionar la copia de seguridad de las bases de datos del sistema de base de datos en Object Storage. Para obtener información sobre las copias de seguridad gestionadas, consulte Copia de seguridad y recuperación en Base Database Service.

Después de asociar una base de datos a una configuración de copia de seguridad, puede utilizar el comando dbcli create-backup en un trabajo cron para ejecutar copias de seguridad automáticamente. Puede utilizar una utilidad cron, como CronMaker, para ayudar a crear expresiones. Para obtener más información, consulte CronMaker.

Los siguientes comandos están disponibles para gestionar las configuraciones de copia de seguridad:

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

dbcli create-backupconfig

Utilice el comando dbcli create-backupconfig para crear una configuración de copia de seguridad que defina el destino de la copia de seguridad y las ventanas de recuperación.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-c --container

Nombre de un cubo existente en el servicio Oracle Cloud Infrastructure Object Storage. Puede utilizar la consola o la API de Object Storage para crear el cubo. Para obtener más información, consulte Gestión de cubos.

También debe especificar los parámetros --backupdestination objectstore y --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Opcional) Indica si se debe activar la operación de comprobación cruzada. Esta operación determina si los archivos del disco o del catálogo de gestión de medios se corresponden con los datos del repositorio de RMAN. Si se omite, se utiliza el valor por defecto (la comprobación cruzada se activa por defecto).

-d --backupdestination

Destino de la copia de seguridad como uno de los siguiente (estos valores no son sensibles a mayúsculas/minúsculas):

DISK: área de recuperación rápida local.

OBJECTSTORE: servicio Oracle Cloud Infrastructure Object Storage. También debe especificar los parámetros --container y --objectstoreswiftId.

NONE: desactiva la copia de seguridad.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-n --name Nombre de la configuración de copia de seguridad.
-o --objectstoreswiftId

Identificador del almacén de objetos que contiene el punto final y las credenciales para el servicio Oracle Cloud Infrastructure Object Storage. Utilice el comando dbcli list-objectstoreswifts para obtener el identificador del almacén de objetos. Utilice el comando dbcli create-objectstoreswift para crear un almacén de objetos.

También debe especificar los parámetros --backupdestination objectstore y --container.

-on --objectstoreswiftName

Nombre del almacén de objetos que contiene el punto final y las credenciales para el servicio Oracle Cloud Infrastructure Object Storage.

Utilice el comando dbcli list-objectstoreswifts para obtener el identificador del almacén de objetos. Utilice el comando dbcli create-objectstoreswift para crear un almacén de objetos.

También debe especificar los parámetros --backupdestination objectstore y --container.

-w --recoverywindow

Número de días durante los que se mantienen las copias de seguridad y los redo logs archivados. El intervalo siempre termina con la hora actual y se extiende hacia atrás en el tiempo hasta el número de días especificado.

Para un destino de copia de seguridad DISK, especifique de 1 a 14 días.

Para un destino de copia de seguridad OBJECTSTORE, especifique de 1 a 30 días.

Ejemplo

El siguiente comando crea una configuración de copia de seguridad denominada "dbbkcfg1":

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

Utilice el comando dbcli list-backupconfigs para mostrar todas las configuraciones de copia de seguridad del sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra una configuración de copia de seguridad:

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

dbcli describe-backupconfig

Utilice el comando dbcli describe-backupconfig para mostrar detalles sobre una configuración de copia de seguridad específica.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --backupconfigid Identificador de configuración de copia de seguridad. Utilice el comando dbcli list-backupconfigs para obtener el identificador.
-in --backupconfigname Nombre de configuración de copia de seguridad. Utilice el comando dbcli list-backupconfigs para obtener el nombre.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los detalles sobre una configuración de copia de seguridad:

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

Utilice el comando dbcli update-backupconfig para actualizar una configuración de copia de seguridad existente.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-c --container

Nombre de un cubo existente en el servicio Oracle Cloud Infrastructure Object Storage. Puede utilizar la consola o la API de Object Storage para crear el cubo. Para obtener más información, consulte Gestión de cubos.

También debe especificar los parámetros --backupdestination objectstore y --objectstoreswiftId.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Opcional) Indica si se debe activar la operación de comprobación cruzada. Esta operación determina si los archivos del disco en el catálogo de gestión de medios se corresponden con los datos del repositorio de RMAN. Si se omite, se utiliza el valor por defecto (la comprobación cruzada se activa por defecto).

-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --backupconfigid Identificador de la configuración de copia de seguridad que se va a actualizar. Utilice el comando dbcli list-backupconfigs para obtener el identificador.
-in --backupconfigname Nombre de la configuración de copia de seguridad que se va a actualizar. Utilice el comando dbcli list-backupconfigs para obtener el nombre.
-j --json (Opcional) Muestra la salida JSON.
-o --objectstoreswiftId

Identificador del almacén de objetos que contiene el punto final y las credenciales para el servicio Oracle Cloud Infrastructure Object Storage. Utilice el comando dbcli list-objectstoreswifts para obtener el identificador del almacén de objetos. Utilice el comando dbcli create-objectstoreswift para crear un almacén de objetos.

También debe especificar los parámetros --backupdestination objectstore y --container.

-on --objectstoreswiftname

Nombre del almacén de objetos que contiene el punto final y las credenciales para el servicio Oracle Cloud Infrastructure Object Storage. Utilice el comando dbcli list-objectstoreswifts para obtener el identificador del almacén de objetos. Utilice el comando dbcli create-objectstoreswift para crear un almacén de objetos.

También debe especificar los parámetros --backupdestination objectstore y --container.

-w --recoverywindow

Ventana de recuperación en disco nueva.

Para un destino de copia de seguridad DISK, especifique de 1 a 14 días.

Para un destino de copia de seguridad OBJECTSTORE, especifique de 1 a 30 días.

Ejemplo

El siguiente comando actualiza la ventana de recuperación de una configuración de copia de seguridad:

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

dbcli delete-backupconfig

Utilice el comando dbcli delete-backupconfig para suprimir una configuración de copia de seguridad.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --id Identificador de la configuración de copia de seguridad que se va a suprimir. Utilice el comando dbcli list-backupconfigs para obtener el identificador.
-in --backupconfigname Nombre de la configuración de copia de seguridad que se va a suprimir. Utilice el comando dbcli list-backupconfigs para obtener el nombre.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando suprime la configuración de copia de seguridad especificada:

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

Comando de componente

dbcli describe-componente

Es posible que el sistema de base de datos no incluya este comando más reciente. Si tiene problemas para ejecutar el comando, utilice el comando update de la CLI para actualizar la CLI de la base de datos y, a continuación, vuelva a intentar el comando.

Note:

El comando dbcli describe-component no está disponible en los sistemas de base de datos RAC de 2 nodos. La aplicación de parches en sistemas de 2 nodos desde Object Storage no está soportada.

Utilice el comando dbcli describe-component para mostrar las versiones instaladas y disponibles del parche para los componentes del directorio raíz del servidor, el almacenamiento y/o la base de datos en el sistema de base de datos.

Este comando requiere una configuración de credenciales válida de Object Storage. Si falta la configuración o no es válida, el comando falla con el error: Failed to connect to the object store. Please provide valid details.

Para obtener más información sobre la actualización de la CLI, la creación de la configuración de credenciales y la aplicación de parches, consulte Actualización de un sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-d --dbhomes (Opcional) Muestra las versiones instaladas y disponibles de parches solo para los componentes del directorio raíz de base de datos.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-s --server (Opcional) Muestra las versiones instaladas y disponibles de parches solo para los componentes del servidor.

Ejemplo

El siguiente comando sirve para mostrar las versiones actuales de componentes y las versiones disponibles de parches en el almacén de objetos:

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

Comandos de base de datos

Los siguientes comandos están disponibles para gestionar bases de datos:

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

dbcli clone-database

Utilice el comando dbcli clone-database para clonar una base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-f --sourcedbname Nombre de base de datos de origen.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-m --syspassword (Opcional) Contraseña de SYS.
-n --dbname Nombre de base de datos.
-p --tdepassword (Opcional) Contraseña de la cartera de TDE de origen.
-s --dbshape (Opcional) Unidad de base de datos Ejemplos: odb1, odb2.
-t --dbtype (Opcional) Tipo de base de datos: SI
-u --databaseUniqueName Nombre único de la base de datos.

dbcli describe-database

Utilice el comando dbcli describe-database para mostrar los detalles de la base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid Identificador de la base de datos que se va a mostrar. Utilice el comando dbcli list-databases para obtener el identificador de la base de datos.
-in --dbName Nombre de la base de datos que se va a mostrar. Utilice el comando dbcli list-databases para obtener el nombre de la base de datos.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra la información de una base de datos denominada b727bf80-c99e-4846-ac1f-28a81a725df6:

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6
Salida:
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

Utilice el comando dbcli list-databases para mostrar todas las bases de datos del sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra una lista de bases de datos:

dbcli  list-databases
Salida:
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

El siguiente comando muestra la salida JSON de una base de datos:

dbcli list-databases -j
Salida:
[ {
  "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

Utilice el comando dbcli modify-database para modificar una base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-dh --destdbhomeid Identificador del directorio raíz de la base de datos destino.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --databaseid Identificador de la base de datos.
-j --json (Opcional) Muestra la salida JSON.

dbcli recover-database

Utilice el comando dbcli recover-database para recuperar una base de datos.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-br --backupReport (Opcional) Entrada JSON para el informe de copia de seguridad.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid (Opcional) Identificador del recurso de la base de datos.
-in --dbName (Opcional) Nombre de la base de datos.
-j --json (Opcional) Muestra la salida JSON.
-l --tdeWalletLocation (Opcional) Ubicación de la copia de seguridad de la cartera de TDE. Se debe realizar una copia de seguridad de la cartera de TDE en formato tar.gz.
-r --recoveryTimeStamp (Necesario cuando el tipo de recuperación es PITR) Registro de hora de recuperación con el formato mm/dd/aaaa hh:mi:ss. Valor por defecto: [ ]
-s --scn (Necesario cuando el tipo de recuperación es SCN) SCN.
-t --recoverytype (Necesario cuando se proporciona un informe de copia de seguridad) Tipo de recuperación. Los valores posibles son Latest, PITR y SCN.
-tp --tdeWalletPassword (Opcional) Contraseña de la cartera de TDE.

dbcli register-database

Utilice el comando dbcli register-database para registrar una base de datos que se haya migrado a Oracle Cloud Infrastructure. El comando registra la base de datos en dcs-agent para que la pueda gestionar la pila de dcs-agent.

Note:

El comando dbcli register-database no está disponible en los sistemas de base de datos RAC de 2 nodos.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-bi --backupconfigid Define el identificador de configuración de la copia de seguridad. Utilice el comando dbcli list-backupconfigs para obtener el identificador.
-c --dbclass Define la clase de base de datos. Las opciones son OLTP, DSS o IMDB. El valor por defecto es OLTP. Las tres clases están soportadas para la Enterprise Edition. Para la Standard Edition, solo está soportada OLTP.

-co

-no-co

--dbconsole

--no-dbconsole

(Opcional) Indica si la consola de la base de datos está activada o no. Si se omite, no se activa la consola.

-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-o --hostname (Opcional) Define el nombre del host de la base de datos. El valor por defecto es Local host name.
-p --syspassword

Define una contraseña segura para SYS. Especifique -p sin contraseña. Se le solicitará la contraseña.

Si debe proporcionar la contraseña en el comando, por ejemplo, en un script, utilice -hp <password> en lugar de -p.

-s --dbshape Define la plantilla de tamaño de base de datos que se va a utilizar para la base de datos. Por ejemplo, odb1, odb2 y odb3.
-sn --servicename Define el nombre del servicio de base de datos que se utiliza para crear la cadena EZCONNECT para conectarse a la base de datos. El formato de la cadena de conexión es hostname:port/servicename.
-t --dbtype (Opcional) Define el tipo de base de datos como de nodo único (SI). El valor por defecto es SI.
-tp --tdeWalletPassword

(Opcional) Contraseña de la cartera de TDE. Necesario si el TDE está activado en la base de datos migrada.

Ejemplo

El siguiente comando registra la base de datos con la clase de base de datos, el nombre de servicio y la plantilla de tamaño de base de datos especificados.

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
Salida:
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

Utilice el comando dbcli update-database para asociar una configuración de copia de seguridad a una base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-bi --backupconfigid Define el identificador de configuración de la copia de seguridad. Utilice el comando dbcli list-backupconfigs para obtener el identificador.
-bin --backupconfigname Define el nombre de la configuración de copia de seguridad para su uso en el futuro. Utilice el comando dbcli list-backupconfigs para obtener el nombre.
-id --databaseid

(Opcional). Especifica el DBID, que es un número de identificación de 32 bits único que se calcula cuando se crea la base de datos. RMAN muestra el DBID al conectarse a la base de datos de destino. Puede obtener el DBID consultando la vista V$DATABASE o las vistas del catálogo de recuperación RC_DATABASE y RC_DATABASE_INCARNATION.
-in --dbName

Define el nombre de la base de datos que se va a actualizar. Utilice el comando dbcli list-databases para obtener el nombre de la base de datos.

-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid Define el identificador de la base de datos que se va a actualizar. Utilice el comando dbcli list-databases para obtener el identificador de la base de datos.
-j --json (Opcional) Muestra la salida JSON.
-no-ab --noautobackup

(Opcional) Desactiva las copias de seguridad automáticas para la base de datos especificada.

Tenga en cuenta que, una vez desactivada, la copia de seguridad automática no se puede volver a activar utilizando la CLI. Para volver a activar la copia de seguridad automática, utilice la consola.

Ejemplo

El siguiente comando asocia un archivo de configuración de copia de seguridad a una base de datos:

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

Comandos de dbhome

Los siguientes comandos están disponibles para gestionar directorios raíz de base de datos:

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

dbcli create-dbhome

Utilice el comando dbcli create-dbhome para crear un directorio raíz de Oracle Database.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-v --version Define la versión del directorio raíz de la base de datos.

Ejemplo

El siguiente comando crea un directorio raíz de Oracle Database versión 12.1.0.2:

dbcli create-dbhome -v 12.1.0.2

dbcli describe-dbhome

Utilice el comando dbcli describe-dbhome para mostrar los detalles del directorio raíz de Oracle Database.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbhomeid Identifica el identificador del directorio raíz de la base de datos. Utilice el comando dbcli list-dbhomes para obtener el identificador.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

La siguiente salida es un ejemplo del uso del comando para mostrar los detalles del directorio raíz de Oracle Database.

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b
Salida:
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

Utilice el comando dbcli delete-dbhome para suprimir un directorio raíz de base de datos del sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbhomeid Identifica el identificador del directorio raíz de base de datos que se va a suprimir. Utilice el comando dbcli list-dbhomes para obtener el identificador.
-j --json (Opcional) Muestra la salida JSON.

dbcli list-dbhomes

Utilice el comando dbcli list-dbhomes para mostrar una lista de directorios raíz de Oracle.

Sintaxis

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

parámetro

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra una lista de directorios raíz de Oracle.

dbcli  list-dbhomes
Salida:
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

Note:

Es posible que el sistema de base de datos no incluya este comando más reciente. Si tiene problemas para ejecutar el comando, utilice el comando CLI Update para actualizar la CLI de la base de datos y, a continuación, vuelva a ejecutar el comando.

Utilice el comando dbcli update-dbhome para aplicar el paquete de parches DBBP a un directorio raíz de base de datos. Para obtener más información sobre la aplicación de parches, consulte Actualización de un sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbhomeid Identificador del directorio raíz de la base de datos. Utilice el comando dbcli list-dbhomes para obtener el identificador.
-j --json (Opcional) Muestra la salida JSON.
-n --node

(Opcional) Número de nodo que se va a actualizar. Utilice el comando dbcli list-nodes para obtener el número de nodo.

 -l --local

(Opcional) realiza la operación en el nodo local de un sistema de alta disponibilidad (HA) de varios nodos. Este parámetro no es necesario para realizar la operación en un sistema de nodo único.

 -p --precheck

(Opcional) Ejecuta operaciones de comprobación previa para comprobar los requisitos.

Ejemplo

Los siguientes comandos actualizan el directorio raíz de la base de datos y muestran la salida del trabajo de actualización:

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6
Salida:
{
  "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
Salida:
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

Comandos de dbstorage

Los siguientes comandos están disponibles para gestionar el almacenamiento de base de datos:

  • dbcli list-dbstorages
  • dbcli describe-dbstorage

dbcli list-dbstorages

Utilice el comando dbcli list-dbstorages para mostrar el almacenamiento de base de datos en el sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra detalles sobre el almacenamiento de base de datos:

dbcli list-dbstorages
Salida:
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

Utilice el comando dbcli describe-dbstorage para mostrar información detallada sobre un recurso de almacenamiento de base de datos específico.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --id Define el identificador de almacenamiento de base de datos. Utilice el comando dbcli list-dbstorages para obtener el identificador de almacenamiento de base de datos.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los detalles del almacenamiento de base de datos de 105a2db2-625a-45ba-8bdd-ee46da0fd83a:

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a
Salida:
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

Comandos de dgconfig

dbcli list-dgconfigs

Utilice el comando dbcli list-dgconfigs para mostrar las configuraciones de DG.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de trabajos

Los siguientes comandos están disponibles para gestionar trabajos:

  • dbcli describe-job
  • dbcli list-jobs

dbcli describe-job

Utilice el comando dbcli describe-job para mostrar los detalles de un trabajo concreto.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --jobid Identifica el trabajo. Utilice el comando dbcli list-jobs para obtener el identificador de trabajo.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra detalles sobre el identificador de trabajo especificado:

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17
Salida:
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

Utilice el comando dbcli list-jobs para mostrar una lista de trabajos, incluidos los identificadores de trabajo, el estado y el trabajo

Registro de fecha y hora de creación.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra una lista de trabajos:

dbcli list-jobs
Salida:
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

Comando latestpatch

dbcli describe-latestpatch

Note:

  • Es posible que el sistema de base de datos no incluya este comando más reciente. Si tiene problemas para ejecutar el comando, utilice el comando CLI Update para actualizar la CLI de la base de datos y, a continuación, vuelva a ejecutar el comando.
  • El comando dbcli describe-latestpatch no está disponible en los sistemas de base de datos RAC de 2 nodos. La aplicación de parches en sistemas de 2 nodos desde Object Storage no está soportada.

Utilice el comando dbcli describe-latestpatch para mostrar los parches más recientes aplicables al sistema de base de datos y que estén disponibles en Oracle Cloud Infrastructure Object Storage.

Este comando requiere una configuración de credenciales válida de Object Storage. Si la configuración falta o no es válida, el comando falla con el error: Failed to connect to the object store. Please provide valid details.

Para obtener más información sobre la actualización de la CLI, la creación de la configuración de credenciales y la aplicación de parches, consulte Actualización de un sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los parches disponibles en el almacén de objetos:

dbcli describe-latestpatch
Salida:
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

Comandos de logcleanjob

Los siguientes comandos están disponibles para gestionar los trabajos de limpieza de log: 

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

dbcli create-logCleanJob

Utilice el comando dbcli create-logCleanJob para crear un trabajo de limpieza de log.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-c --components (Opcional) Componentes. Los valores posibles son gi, database y dcs. Separe varios valores mediante comas.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-o --olderThan (Opcional) Parte de la cantidad de intervalo de tiempo. Valor por defecto: 30. Limpia los logs anteriores al intervalo de tiempo especificado (-o y -u).
-u --unit (Opcional) Parte de la unidad de intervalo de tiempo. Valores posibles: Day, Hour o Minute. Valor por defecto: Day. Limpia los logs anteriores al intervalo de tiempo especificado (-o y -u).

dbcli describe-logCleanJob

Utilice el comando dbcli describe-logCleanJob para mostrar el resumen de un trabajo de limpieza de log.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --jobid Identificador del trabajo de limpieza de log para el que se va a mostrar el resumen.
-j --json (Opcional) Muestra la salida JSON.

dbcli list-logCleanJobs

Utilice el comando dbcli list-logCleanJobs para mostrar los trabajos de limpieza de log.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de netsecurity

Los siguientes comandos están disponibles para gestionar el cifrado de red en el sistema de base de datos:

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli describe-netsecurity

Utilice el comando dbcli describe-netsecurity para mostrar la configuración de cifrado de red actual para un directorio raíz de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-H --dbHomeId Define el identificador del directorio raíz de base de datos. Utilice el comando dbcli list-dbhomes para obtener el identificador dbhomeid.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra el valor de cifrado del directorio raíz de base de datos especificado:

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d
Salida:
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

Utilice el comando dbcli update-netsecurity para actualizar la configuración de seguridad de Oracle Net en el sistema de base de datos.

Sintaxis

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]

Parámetros

parámetro Nombre completo Descripción
-c --client

Indica que la configuración de cifrado de datos o de integridad de datos especificada se refiere al cliente. (--client y --server se excluyen mutuamente).

-e -- encryptionAlgorithms Define el algoritmo que se va a utilizar para el cifrado. Especifique AES256, AES192 o AES128.
-H --dbHomeId Define el identificador del directorio raíz de base de datos. Utilice el comando dbcli list-dbhomes para obtener el identificador dbHomeId.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --integrityAlgorithms Define el algoritmo que se va a utilizar para la integridad. Especifique SHA1, SHA512, SHA384 o SHA256. Para Oracle Database 11g, el único valor aceptado es SHA1.
-j --json (Opcional) Muestra la salida JSON.
-s --server Indica que la configuración de cifrado de datos o de integridad de datos especificada se refiere al servidor. (--client and --server se excluyen mutuamente).
-t --connectionType

Especifica cómo se negocia el cifrado de datos o la integridad de datos de Oracle Net Services con los clientes. Los siguientes valores se muestran en orden de seguridad creciente:

REJECTED: no activa el cifrado de datos ni la integridad de datos, incluso si lo requiere el cliente.

ACCEPTED: activa el cifrado de datos o la integridad de datos si es necesario o lo solicita el cliente.

REQUESTED : activa el cifrado de datos o la integridad de datos si el cliente lo permite.

REQUIRED: activa el cifrado de datos o la integridad de datos o se impide la conexión.

Ejemplo

El siguiente comando actualiza el tipo de conexión a ACCEPTED:

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

Comandos de objectstoreswift

Puede realizar una copia de seguridad de una base de datos en un cubo existente en el servicio Oracle Cloud Infrastructure Object Storage mediante el comando dbcli create-backup, pero primero tendrá que:

  1. Crear un almacén de objetos en el sistema de base de datos, que contenga el punto final y las credenciales para acceder a Object Storage, mediante el comando dbcli create-objectstoreswift.
  2. Crear una configuración de copia de seguridad que haga referencia al identificador del almacén de objetos y al nombre de cubo mediante el comando dbcli create-backupconfig.
  3. Asociar la configuración de copia de seguridad a la base de datos mediante el comando dbcli update-database.

Los siguientes comandos están disponibles para gestionar almacenes de objetos.

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

dbcli create-objectstoreswift

Utilice el comando dbcli create-objectstoreswift para crear un almacén de objetos.

Sintaxis

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]

donde <object_storage_namespace> es el espacio de nombre de Object Storage de su arrendamiento.

Parámetros

parámetro Nombre completo Descripción
-e --endpointurl

La siguiente URL de punto final. https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-n --name

Nombre del almacén de objetos que se va a crear.

-p --swiftpassword

Token de autenticación que ha generado mediante la consola o la API de IAM. Para obtener información sobre la generación de un token de autenticación para utilizarlo con Swift, consulte Gestión de credenciales de usuario.

Esta no es la contraseña de usuario de Oracle Cloud Infrastructure.

Especifique -p (sin contraseña) para que se solicite.

Especifique -hp "<password>" entre comillas para proporcionar la contraseña (token de autenticación) en el comando.

-t --tenantname Espacio de nombres de Object Storage de su arrendamiento.
-u --username Nombre de usuario de la cuenta de usuario de Oracle Cloud Infrastructure, por ejemplo: -u djones@example.com

Este es el nombre de usuario que debe utilizar para conectarse a la consola.

El nombre de usuario debe tener acceso de nivel de arrendamiento a Object Storage. Una forma sencilla de hacerlo es agregar el nombre de usuario al grupo de administradores. Sin embargo, esto permite el acceso a todos los servicios en la nube. En su lugar, un administrador puede crear una política que permita el acceso a nivel de arrendamiento solo a Object Storage. A continuación se incluye un ejemplo de dicha política. 

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

Para obtener más información sobre cómo agregar un usuario a un grupo, consulte Gestión de grupos. Para obtener más información sobre las políticas, consulte Introducción a las políticas.

Ejemplo

Con el siguiente comando se crea un almacén de objetos y se solicita la contraseña Swift:

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p
Salida:
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

Utilice el comando dbcli describe-objectstoreswift para mostrar los detalles sobre un almacén de objetos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --objectstoreswiftid Identificador del almacén de objetos. Utilice el comando dbcli list-objectstoreswifts para obtener el identificador.
-in --objectstoreswiftName Nombre del almacén de objetos. Utilice el comando dbcli list-objectstoreswifts para obtener el nombre.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los detalles sobre un almacén de objetos:

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87
Salida:
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

Utilice el comando dbcli list-objectstoreswifts para mostrar los almacenes de objetos de un sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los almacenes de objetos del sistema de base de datos:

dbcli list-objectstoreswifts
Salida:
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

Comando Pendingjob

dbcli list-pendingjobs

Utilice el comando dbcli list-pendingjobs para mostrar una lista de trabajos pendientes.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de rmanbackupreport

Los siguientes comandos están disponibles para gestionar los informes de copia de seguridad de RMAN: 

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

dbcli create-rmanbackupreport

Utilice el comando dbcli create-rmanbackupreport para crear un informe de copia de seguridad de RMAN.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid (Opcional) Identificador del recurso de la base de datos.
-in --dbname (Opcional) Nombre de recurso de base de datos.
-j --json (Opcional) Muestra la salida JSON.
-rn --rptname Nombre de informe de copia de seguridad de RMAN. Número máximo de caracteres: 30. Escriba el nombre entre comillas simples cuando se utilicen caracteres especiales.
-w --reporttype Tipo de informe de copia de seguridad de RMAN. Posibles valores: resumen o detallado.

dbcli delete-rmanbackupreport

Utilice el comando dbcli delete-rmanbackupreport para suprimir un informe de copia de seguridad de RMAN.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-d --dbid (Opcional) Identificador del recurso de la base de datos.
-dn --dbname (Opcional) Nombre de recurso de base de datos.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --reportid (Opcional) Identificador del informe de copia de seguridad de RMAN
-in --rptname (Opcional) Nombre del informe de copia de seguridad de RMAN
-j --json (Opcional) Muestra la salida JSON.
-n --numofday (Opcional) Número de días desde la creación (proporcionado con el ID/nombre de la base de datos)

dbcli describe-rmanbackupreport

Utilice el comando dbcli describe-rmanbackupreport para

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --id (Opcional) Identificador del informe de copia de seguridad de RMAN
-in --name (Opcional) Nombre del informe de copia de seguridad de RMAN
-j --json (Opcional) Muestra la salida JSON.

dbcli list-rmanbackupreports

Utilice el comando dbcli list-rmanbackupreports para

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbid (Opcional) Identificador del recurso de la base de datos.
-in --dbName (Opcional) Nombre de recurso de base de datos.
-j --json (Opcional) Muestra la salida JSON.

Comandos de programación

Los siguientes comandos están disponibles para gestionar las programaciones:

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

dbcli describe-schedule

Utilice el comando dbcli describe-schedule para describir una programación.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --scheduleid Identificador de programación.
-j --json (Opcional) Muestra la salida JSON.

dbcli list-schedules

Utilice el comando dbcli list-schedules para mostrar las programaciones.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

dbcli update-schedule

Utilice el comando dbcli update-schedule para actualizar una programación.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-d --disable (Opcional) Desactiva la programación.
-e --enable (Opcional) Activa la programación.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --scheduleid Identificador de programación.
-j --json (Opcional) Muestra la salida JSON.
-t --description (Opcional) Descripción
-x --cronExpression (Opcional) Expresión cron. Utilice cronmaker.com para generar una expresión cron válida.

Comando Scheduledexecution

dbcli list-scheduledExecutions

Utilice el comando dbcli list-scheduledExecutions para mostrar las ejecuciones programadas.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-e --executionid (Opcional) Identificador de ejecución.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --scheduleid (Opcional) Identificador de programación.
-j --json (Opcional) Muestra la salida JSON.

Comando de servidor

dbcli update-server

Note:

Es posible que el sistema de base de datos no incluya este comando más reciente. Si tiene problemas para ejecutar el comando, utilice el comando CLI Update para actualizar la CLI de la base de datos y, a continuación, vuelva a ejecutar el comando.

Utilice el comando dbcli update-server para aplicar parches a los componentes del servidor del sistema de base de datos. Para obtener más información sobre la aplicación de parches, consulte Actualización de un sistema de base de datos.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.
-l --local

(Opcional) realiza la operación en el nodo local de un sistema de alta disponibilidad (HA) de varios nodos. Este parámetro no es necesario para realizar la operación en un sistema de nodo único.

-n --node

(Opcional) Número de nodo que se va a actualizar. Utilice el comando dbcli list-nodes para obtener el número de nodo.

-p --precheck

(Opcional) Ejecuta operaciones de comprobación previa para comprobar los requisitos.

-v --version (Opcional) Versión que se va a actualizar.

Ejemplos

Los siguientes comandos actualizan el servidor y muestran la salida del trabajo de actualización:

dbcli update-server
Salida:
{
  "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
Salida:
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

El siguiente comando actualiza solo el nodo 0 del servidor, con comprobación previa: 

dbcli update-server -n 0 -p
Salida:
{
  "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"
}

Comando del sistema

dbcli describe-system

Utilice el comando dbcli describe-system para mostrar los detalles del sistema. En un sistema de base de datos RAC de 2 nodos, el comando proporciona información sobre el nodo local.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-b --bom (Opcional) Muestra la información de BOM.

-d

--details

 (Opcional) Muestra información adicional sobre el sistema de base de datos, incluida la información de la versión de dcs CLI y del agente.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Comandos de TDE

Los siguientes comandos están disponibles para gestionar elementos relacionados con el TDE (informes de copia de seguridad, claves y carteras): 

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

dbcli list-tdebackupreports

Utilice el comando dbcli list-tdebackupreports para mostrar los informes de copia de seguridad de las carteras de TDE.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-i --dbResid (Opcional) Muestra los informes de copia de seguridad de cartera de TDE para el identificador de recurso de base de datos especificado. Utilice el comando dbcli list-databases para obtener el identificador de recurso de base de datos.
-in --dbResname (Opcional) Muestra los informes de copia de seguridad de cartera de TDE para el nombre de recurso de base de datos especificado. Utilice el comando dbcli list-databases para obtener el nombre de recurso de base de datos.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando muestra los informes de copia de seguridad de las carteras de TDE:

dbcli list-tdebackupreports
Salida:
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

Utilice el comando dbcli update-tdekey para actualizar la clave de cifrado de TDE dentro de la cartera de TDE. Puede actualizar la clave de cifrado para las bases de datos conectables (si se han especificado -pdbNames) y/o la base de datos de contenedores (si se ha especificado -rootDatabase).

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-all --allPdbNames

(Opcional) Indicador para rotar (actualizar) todos los nombres de PDB. Para actualizar todos los nombres de PDB en vez de los especificados, utilice este parámetro en lugar de -n. Valor por defecto: false.

-i --databaseId

Define el ID de base de datos para el que se actualizará la clave.
-p --password

Define la contraseña de la cartera del administrador de TDE. Especifique -p sin contraseña. Se le solicitará la contraseña.

Si debe proporcionar la contraseña en el comando, por ejemplo, en un script, utilice -hp <password> en lugar de -p.

-n --pdbNames Define los nombres de PDB que se van a rotar (actualizar).

-r

-no-r

--rootDatabase

--no-rootDatabase

 Indica si se debe rotar la clave para la base de datos raíz si es una base de datos de contenedores.
-t -tagName Define el TagName utilizado para realizar una copia de seguridad de la cartera. El valor por defecto es OdaRotateKey.
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-j --json (Opcional) Muestra la salida JSON.

Ejemplo

El siguiente comando actualiza la clave solo para pdb1 y pdb2:

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

El siguiente comando actualiza pdb1, pdb2 y la base de datos del contenedores:

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

dbcli recovery-tdewallet

Utilice el comando dbcli recover-tdewallet para recuperar una cartera TDE.

Sintaxis

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

Parámetros

parámetro Nombre completo Descripción
-h --help (Opcional) Muestra la ayuda para utilizar el comando.
-in --dbName Nombre de base de datos.
-j --json (Opcional) Muestra la salida JSON.
-l --tdeWalletBackuplocation (Opcional) Ubicación de la copia de seguridad de la cartera de TDE. Se debe realizar una copia de seguridad de la cartera de TDE en formato tar.gz.
-tp --tdeWalletPassword

Define la contraseña de la cartera del administrador de TDE.