Resumen de subprogramas de DBMS_CLOUD_ADMIN

En esta sección se tratan los subprogramas DBMS_CLOUD_ADMIN proporcionados con Autonomous Database.

Subprograma Descripción

Procedimiento ATTACH_FILE_SYSTEM

Este procedimiento asocia un sistema de archivos en un directorio de la base de datos.

CANCEL_WORKLOAD_CAPTURE Procedimiento

Este procedimiento cancela la captura de carga de trabajo actual.

CREATE_DATABASE_LINK Procedimiento

Este procedimiento crea un enlace de base de datos a una base de datos destino. Hay opciones para crear un enlace de base de datos a otra instancia de Autonomous Database, a una instancia de Oracle Database que no sea una instancia de Autonomous Database o a una instancia que no sea de Oracle Database mediante conectividad heterogénea gestionada por Oracle.

Procedimiento DETACH_FILE_SYSTEM

Este procedimiento separa un sistema de archivos de un directorio de la base de datos.

DISABLE_APP_CONT Procedimiento

Este procedimiento desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.

DISABLE_EXTERNAL_AUTHENTICATION Procedimiento

Este procedimiento desactiva la autenticación externa para la instancia de Autonomous Database.

DISABLE_OPERATOR_ACCESS Procedimiento

Revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database Database.

DISABLE_PRINCIPAL_AUTH Procedimiento

Este procedimiento revoca la autenticación basada en principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado.

DISABLE_RESOURCE_PRINCIPAL Procedimiento

Este procedimiento desactiva las credenciales de la entidad de recurso para la base de datos o para el esquema especificado. Con un nombre de usuario especificado, que no sea ADMIN, el procedimiento revoca el acceso de esquema especificado a la credencial de entidad de recurso.

DROP_DATABASE_LINK Procedimiento

Este procedimiento borra un enlace de base de datos.

ENABLE_APP_CONT Procedimiento

Este procedimiento permite la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.

ENABLE_AWS_ARN Procedimiento

Este procedimiento permite a un usuario crear credenciales de AWS ARN en Autonomous Database.

ENABLE_EXTERNAL_AUTHENTICATION Procedimiento

Este procedimiento permite a un usuario conectarse a Autonomous Database mediante el esquema de autenticación externa especificado.

ENABLE_FEATURE Procedimiento

Este procedimiento activa la función especificada en la instancia de Autonomous Database.

ENABLE_OPERATOR_ACCESS Procedimiento

Otorga al operador en la nube acceso a una instancia de Autonomous Database durante un número especificado de horas.

ENABLE_PRINCIPAL_AUTH Procedimiento

Este procedimiento activa la autenticación de principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado.

ENABLE_RESOURCE_PRINCIPAL Procedimiento

Este procedimiento activa la credencial de principal de recurso y crea la credencial OCI$RESOURCE_PRINCIPAL. Con un nombre de usuario especificado, que no sea ADMIN, el procedimiento otorga al esquema especificado acceso a la credencial de entidad de recurso.

FINISH_WORKLOAD_CAPTURE Procedimiento

Este procedimiento para la captura de carga de trabajo y carga los archivos de captura en Object Storage.

PREPARE_REPLAY Procedimiento

Este procedimiento prepara la reproducción para la clonación de refrescamiento.

PURGE_FLASHBACK_ARCHIVE Procedimiento Este procedimiento depura los datos históricos del archivo de datos de flashback.

REPLAY_WORKLOAD Procedimiento

Este procedimiento está sobrecargado. Inicia la reproducción de la carga de trabajo.

SET_FLASHBACK_ARCHIVE_RETENTION Procedimiento

Este procedimiento permite a los usuarios ADMIN modificar el período de retención para Flashback Time Travel flashback_archive.

START_WORKLOAD_CAPTURE Procedimiento

Este procedimiento inicia una captura de carga de trabajo.

Procedimiento ATTACH_FILE_SYSTEM

Este procedimiento asocia un sistema de archivos en la base de datos.

El procedimiento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM asocia un sistema de archivos en la base de datos y almacena información sobre el sistema de archivos en la vista DBA_CLOUD_FILE_SYSTEMS.

Sintaxis

DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name         IN VARCHAR2,
    file_system_location     IN VARCHAR2,
    directory_name           IN VARCHAR2,
    description              IN VARCHAR2 DEFAULT NULL,
    params                   IN CLOB DEFAULT NULL
);

Parámetros

Parámetro Descripción

file_system_name

Especifica el nombre del sistema del archivo.

Este parámetro es obligatorio.

file_system_location

Especifica la ubicación del sistema del archivo.

El valor que proporciona con file_system_location consta de un nombre de dominio completo (FQDN) y una ruta de archivo con el formato: FQDN:file_path.

Por ejemplo:

  • NOMBRE DE ARCHIVO: myhost.sub000445.myvcn.oraclevcn.com

    Para Oracle Cloud Infrastructure File Storage, defina el FQDN en Mostrar opciones avanzadas al crear un sistema de archivos. Consulte Creación de sistemas de archivos para más información.

  • Ruta de archivo: /results

Este parámetro es obligatorio.

directory_name

Especifica el nombre del directorio para el sistema de archivos adjunto. El directorio debe existir.

Este parámetro es obligatorio.

description

(Opcional) Proporciona una descripción de la tarea.

params

Cadena JSON que proporciona un parámetro adicional para el sistema de archivos.

  • nfs_version: especifica la versión de NFS que se utilizará cuando NFS esté conectado (NFSv3 o NFSv4). Valores válidos: 3, 4.

    Valor por defecto: 3

Ejemplos:

Conecte a un sistema de archivos NFSv3:

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',
    description           => 'Source NFS for sales data'
  );
END;
/     

Conecte a un sistema de archivos NFSv4:

BEGIN
   DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'FSS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'FSS_DIR',  
    description           => 'Source NFS for sales data',
    params                => JSON_OBJECT('nfs_version' value 4)
);                                                      
END;                                                        
/

Notas de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Debe tener el privilegio WRITE en el objeto de directorio de la base de datos para adjuntar un sistema de archivos mediante DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM.

  • El procedimiento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM solo puede asociar un servicio de almacenamiento de archivos privado en bases de datos con puntos finales privados activados.

    Consulte Servicio OCI File Storage y Configuración del acceso de red con puntos finales privados para obtener más información.

  • El procedimiento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM busca el nombre de host del sistema de archivos de red en la red virtual en la nube (VCN) del cliente. Se devuelve el error "ORA-20000: Mounting NFS fails" si no se puede localizar el nombre de host especificado en la ubicación.

  • Oracle Cloud Infrastructure File Storage utiliza NFSv3 para compartir

  • Si se asocia a sistemas que no sean de Oracle Cloud Infrastructure File Storage, el procedimiento soporta NFSv3 y NFSv4

  • Si tiene un servidor NFS conectado que utiliza NFSv3 y la versión de NFS se actualiza a NFSv4 en el servidor NFS, debe ejecutar DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM y, a continuación, DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (mediante el parámetro params con nfs_version definido en 4). Esto asocia NFS con el protocolo coincidente para que Autonomous Database pueda acceder al servidor NFSv4. Sin desconectar y volver a conectar, no se podrá acceder al servidor NFS y es posible que aparezca un error como: "Protocol not supported".

CANCEL_WORKLOAD_CAPTURE Procedimiento

Este procedimiento cancela cualquier captura de carga de trabajo en curso en la base de datos.

Sintaxis

Este procedimiento cancela la captura de carga de trabajo actual y activa el refrescamiento en la clonación de refrescamiento.


DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;

Ejemplo

BEGIN
   DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

Nota de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

CREATE_DATABASE_LINK Procedimiento

Este procedimiento crea un enlace de base de datos a una base de datos de destino en el esquema que llama a la API.

Los formularios sobrecargados admiten lo siguiente:

  • Al utilizar el parámetro gateway_params, esto permite crear un enlace de base de datos con conectividad heterogénea gestionada por Oracle donde el enlace está a una base de datos no Oracle soportada.

  • Al utilizar el parámetro rac_hostnames, esto permite crear un enlace de base de datos desde una instancia de Autonomous Database en un punto final privado a una base de datos Oracle RAC de destino. En este caso, utilice el parámetro rac_hostnames para especificar los nombres de host de uno o más nodos individuales de la base de datos Oracle RAC de destino.

Sintaxis

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       hostname             IN VARCHAR2,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT
       gateway_params       IN CLOB DEFAULT);
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
       db_link_name         IN VARCHAR2,
       rac_hostnames        IN CLOB,
       port                 IN NUMBER,
       service_name         IN VARCHAR2,
       ssl_server_cert_dn   IN VARCHAR2 DEFAULT,
       credential_name      IN VARCHAR2 DEFAULT,
       directory_name       IN VARCHAR2 DEFAULT,
       gateway_link         IN BOOLEAN DEFAULT,
       public_link          IN BOOLEAN DEFAULT,
       private_target       IN BOOLEAN DEFAULT);

Parámetros

Parámetro Descripción

db_link_name

Nombre de enlace de base de datos que se va a crear.

hostname

Nombre de host de la base de datos de destino.

No se permite especificar localhost para hostname.

Al especificar una conexión con conectividad heterogénea gestionada por Oracle mediante el suministro del parámetro gateway_params, tenga en cuenta lo siguiente:

Utilice este parámetro o rac_hostnames, no utilice ambos.

La entrada DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK debe mencionar el nombre de exploración de la instancia de Autonomous Database dedicada de destino como parámetro 'hostname'.

rac_hostnames

Especifica los nombres de host para la base de datos Oracle RAC de destino. El valor es una matriz de JSON que especifica uno o más nombres de host individuales para los nodos de la base de datos Oracle RAC de destino. Se pueden transferir varios nombres de host en JSON, separados por ",". Por ejemplo:

'["sales1-svr1.domain", "sales1-svr2.domain",
      "sales1-svr3.domain"]'

Cuando el destino es una base de datos Oracle RAC, utilice el parámetro rac_hostnames para especificar uno o más nombres de host con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK. Esto le permite aprovechar las capacidades de alta disponibilidad de Oracle RAC. No se admite el uso de una dirección IP, una IP de SCAN o un nombre de host de SCAN en el valor rac_hostnames.

Al especificar una lista de nombres de host en el parámetro rac_hostnames, CREATE_DATABASE_LINK utiliza todos los nombres de host especificados como direcciones en la cadena de conexión. Si uno de los hosts especificados no está disponible en la base de datos Oracle RAC de destino, Autonomous Database intenta conectarse automáticamente mediante otro nombre de host de la lista.

Utilice este parámetro o hostname, no utilice ambos.

No se permite especificar localhost para un valor rac_hostname.

port

Especifica el puerto para las conexiones a la base de datos destino.

Al especificar una conexión con una conectividad heterogénea gestionada por Oracle mediante el parámetro gateway_params, defina el puerto según el valor db_type:

  • awsredshift: utilice el puerto 5439
  • azure: utilice el puerto 1433
  • db2: utilice el puerto 2500 para las versiones Db2 >= 11.5.6
  • db2: utilice el puerto 5000 para las versiones Db2 <= 11.5.5
  • google_analytics: utilice el puerto 443
  • google_bigquery: utilice el puerto 443
  • google_drive: utilice el puerto 443
  • hive: utilice el puerto 433
  • mongodb: utilice el puerto 27017
  • mysql: utilice el puerto 3306
  • mysql_community: utilice el puerto 3306
  • postgres: utilice el puerto 5432
  • salesforce: utilice el puerto 19937
  • servicenow: utilice el puerto 443
  • sharepoint: utilice el puerto 443
  • snowflake: utilice el puerto 443
  • youtube: utilice el puerto 443

Consulte Tipos y puertos de bases de datos de conectividad heterogénea gestionada por Oracle para obtener más información.

service_name

service_name para la base de datos a la que enlazar. Para una instancia de Autonomous Database de destino, busque el nombre del servicio mediante uno de los siguientes métodos:

  • Busque en el archivo tnsnames.ora de wallet.zip que descargue de una instancia de Autonomous Database para su conexión.

  • Haga clic en Conexión de base de datos en la consola de Oracle Cloud Infrastructure. En el área Cadenas de conexión, cada cadena de conexión incluye una entrada service_name con la cadena de conexión para el servicio correspondiente. Cuando se permiten conexiones TLS mutuas (mTLS) y TLS, en autenticación TLS, seleccione TLS para ver los nombres de TNS y las cadenas de conexión para las conexiones con autenticación TLS. Consulte Visualización de nombres de TNS y cadenas de conexión para una instancia de Autonomous Database para obtener más información.

  • Consulte la vista V$SERVICES. Por ejemplo:

    SELECT name FROM V$SERVICES;

Al especificar una conexión con una conectividad heterogénea gestionada por Oracle mediante el parámetro gateway_params, service_name es el nombre de la base de datos que no es de Oracle.

ssl_server_cert_dn

Valor de DN encontrado en el certificado del servidor.

La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. ssl_server_cert_dn debe ser NULL al proporcionar el parámetro gateway_params o al no incluir el parámetro ssl_server_cert_dn (el valor por defecto es NULL).

Enlace de punto final público a un destino de Autonomous Database sin cartera:

Para conectarse a un destino de Autonomous Database en un punto final público sin cartera (TLS):

  • El parámetro directory_name debe ser NULL.
  • El parámetro ssl_server_cert_dn debe ser NULL o no incluir este parámetro (el valor por defecto es NULL).

Enlace de punto final privado sin cartera:

Para conectarse a una instancia de Oracle Database en un punto final privado sin cartera:

  • La base de datos de destino debe estar en un punto final privado.
  • El parámetro directory_name debe ser NULL.
  • El parámetro ssl_server_cert_dn debe ser NULL o no incluir este parámetro (el valor por defecto es NULL).
  • El parámetro private_target debe ser TRUE.
credential_name

Nombre de una credencial almacenada creada con DBMS_CLOUD.CREATE_CREDENTIAL. Se trata de las credenciales para acceder a la base de datos destino.

directory_name

Directorio para el archivo cwallet.sso. El valor por defecto de este parámetro es 'data_pump_dir'.

La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. El parámetro directory_name no es necesario al proporcionar el parámetro gateway_params.

Enlace de punto final público a un destino de Autonomous Database sin cartera:

Para conectarse a una instancia de Autonomous Database en un punto final público sin cartera (TLS):

  • El parámetro directory_name debe ser NULL.
  • El parámetro ssl_server_cert_dn debe ser NULL o no incluir este parámetro (el valor por defecto es NULL).

Además, para conectarse a una instancia de Autonomous Database con TCP, el parámetro ssl_server_cert_dn debe ser NULL o no incluir este parámetro (el valor por defecto es NULL).

Enlace de punto final privado sin cartera:

Para conectarse a una instancia de Oracle Database de destino en un punto final privado sin cartera:

  • La base de datos de destino debe estar en un punto final privado.
  • El parámetro directory_name debe ser NULL.
  • El parámetro ssl_server_cert_dn debe ser NULL o no incluir este parámetro (el valor por defecto es NULL).
  • El parámetro private_target debe ser TRUE.
gateway_link

Indica si el enlace de base de datos se ha creado a otra instancia de Oracle Database o a Oracle Database Gateway.

Si gateway_link está definido en FALSE, especifica un enlace de base de datos a otra instancia de Autonomous Database u otra instancia de Oracle Database.

Si gateway_link está definido en TRUE, especifica un enlace de base de datos a un sistema que no sea de Oracle. Esto crea un descriptor de conexión en la definición de enlace de base de datos que especifica (HS=OK).

Cuando gateway_link se define en TRUE y gateway_params en NULL, especifica un enlace de base de datos a un gateway de Oracle gestionado por el cliente.

El valor por defecto de este parámetro es FALSE.

public_link

Indica si el enlace de base de datos se ha creado como enlace de base de datos pública.

Para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK con este parámetro definido en TRUE, el usuario que llama al procedimiento debe tener el privilegio EXECUTE en la credencial asociada al enlace de base de datos pública y debe tener el privilegio del sistema CREATE PUBLIC DATABASE LINK. El privilegio EXECUTE de la credencial puede ser otorgado por el usuario ADMIN o por el propietario de la credencial.

El valor por defecto de este parámetro es FALSE.

private_target

Cuando un enlace de base de datos accede a un nombre de host que se debe resolver en un servidor DNS de VCN, especifique el parámetro private_target con el valor TRUE.

Cuando private_target es TRUE, el parámetro hostname debe ser un único nombre de host (en un punto final privado, no está soportado el uso de una dirección IP, una IP de SCAN o un nombre de host de SCAN).

Cuando private_target => TRUE, no está soportada la creación de enlaces de base de datos entre dominios, donde la base de datos de origen y la base de datos de destino están en distintos dominios de Oracle Cloud Infrastructure.

El valor predeterminado de este parámetro es FALSE.

gateway_params

db_type Este parámetro especifica el tipo de base de datos de destino para la conectividad heterogénea gestionada por Oracle para conectarse a bases de datos que no sean de Oracle. El valor db_type es uno de los siguientes:

  • awsredshift
  • azure

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es azure.

  • db2
  • google_analytics
  • google_bigquery

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es google_bigquery.

  • google_drive

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es google_drive.

  • hive

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es hive.

  • mongodb
  • mysql
  • postgres
  • salesforce

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es salesforce.

  • servicenow

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es servicenow.

  • sharepoint

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es sharepoint.

  • snowflake

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es snowflake.

  • youtube

    * Consulte las notas de uso para obtener información adicional sobre gateway_params cuando db_type es youtube.

  • NULL

    Cuando gateway_params es NULL y gateway_link está definido en TRUE, especifica un enlace de base de datos a un gateway de Oracle gestionado por el cliente.

Especifique el parámetro con el formulario json_object.

Por ejemplo:

gateway_params => json_object('db_type' value 'awsredshift')

Consulte Puertos y tipos de base de datos de conectividad heterogénea gestionados por Oracle para obtener los valores port necesarios para cada tipo de base de datos.

Cuando gateway_params es NULL y private_target es TRUE, si directory_name es NULL, se crea un enlace de base de datos basado en TCP.

Cuando gateway_params es NULL y private_target es TRUE, si directory_name es NULL, se crea un enlace de base de datos basado en TCPS.

enable_ssl:

Para una base de datos en un punto final privado, el parámetro gateway_params soporta el parámetro opcional enable_ssl. Defina este parámetro en true para soportar conexiones SSL/TLS para una base de datos de destino remota en un punto final privado. Por defecto, enable_ssl es false.

Por ejemplo:

gateway_params => JSON_OBJECT(
     'db_type' value 'snowflake',
     'enable_ssl' value true)

Notas de uso

  • Al especificar el parámetro gateway_params, para algunos valores db_type, se soportan parámetros gateway_params adicionales:

    db_type Valores gateway_params adicionales
    azure

    Cuando el valor db_type es azure, hay dos parámetros opcionales, auth_method y domain para admitir la autenticación NTLM/AD.

    Cuando se configura NTLMv2, defina auth_method=10 y domain en el valor de dominio de Windows.

    Para utilizar una contraseña de Azure Active Directory, defina auth_method=13. No utilice auth_method=13 para acceder a una base de datos local de Oracle.

    Consulte Método de autenticación de Microsoft SQL Server para obtener más información.

    google_analytics

    Cuando db_type es google_analytics, la credencial que especifique debe ser una credencial OAuth de Google (gcp_oauth2). Consulte CREATE_CREDENTIAL Procedure para obtener más información.

    google_bigquery

    Cuando db_type es google_bigquery, la credencial que especifique debe ser una credencial OAuth de Google (gcp_oauth2) Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.

    Cuando db_type es google_bigquery, el parámetro project es válido. Este parámetro especifica el nombre del proyecto para google_bigquery y es necesario.

    El nombre de tabla que especifique al utilizar SELECT con Google BigQuery debe estar entre comillas. Por ejemplo:

    SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
    google_drive

    Para db_type google_drive, la credencial que proporcione con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK debe ser una credencial de tipo OAuth con el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token).

    Para conectarse a Google Drive y obtener datos, debe proporcionar los parámetros de gateway directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo REST automático) que asigna la respuesta JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información.

    Al utilizar el parámetro gateway_params con db_type google_drive, debe proporcionar el parámetro gateway_params db_type con el valor 'google_drive' y los parámetros directory_name y file_name, junto con las credenciales de tipo OAuth:

    El parámetro directory_name especifica el directorio con el archivo de configuración REST. Puede crear este directorio de la siguiente manera:

    create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR';

    Obtenga y descargue el archivo REST automático en el directorio especificado. Por ejemplo:

    exec DBMS_CLOUD.get_object('google_drive_dir_cred',
         'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR');

    Defina el valor file_name en el nombre del archivo REST automático que descargó, "google_drive.rest". A continuación, puede utilizar el archivo de configuración de REST con OAuth 2.0.

    hive

    Cuando db_type es hive, el parámetro http_path es válido. Este parámetro especifica el valor HttpPath, si es necesario, para conectarse a la instancia de Hive.

    salesforce

    Cuando db_type es salesforce, el parámetro: security_token es válido. Un token de seguridad es un código alfanumérico sensible a mayúsculas/minúsculas. Se necesita proporcionar un valor security_token para acceder a Salesforce. Por ejemplo:

    gateway_params => JSON_OBJECT(
         'db_type' value 'salesforce',
         'security_token' value 'security_token_value' )

    Consulte Restablecer el token de seguridad para obtener más información.

    servicenow

    Para conectarse a ServiceNow y obtener datos, debe proporcionar los parámetros de gateway directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo de configuración de REST) que asigna la respuesta de JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información.

    Al utilizar el parámetro gateway_params con db_type servicenow, hay dos opciones soportadas:

    • Autenticación básica: debe proporcionar el parámetro gateway_params db_type con el valor 'servicenow' y proporcionar los parámetros directory_name y file_name junto con las credenciales de tipo de nombre de usuario/contraseña.

    • Autenticación OAuth 2.0: debe proporcionar el parámetro gateway_params db_type con el valor 'servicenow' y los parámetros directory_name, file_name y token_uri, junto con las credenciales de tipo OAuth.

    El parámetro directory_name especifica el directorio con el archivo de configuración REST ServiceNow. Puede crear este directorio de la siguiente manera:

    create or replace directory servicenow_dir as 'SERVICENOW_DIR';

    Obtenga y descargue el archivo de configuración de REST ServiceNow en el directorio especificado. Por ejemplo:

    exec DBMS_CLOUD.get_object('servicenow_dir_cred',
         'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR');

    Defina el valor file_name en el nombre del archivo de configuración de REST que ha descargado, "servicenow.rest".

    A continuación, puede utilizar el archivo de configuración de REST ServiceNow con autenticación básica o OAuth2.0.

    A continuación, puede utilizar el archivo de configuración de REST ServiceNow con autenticación básica o OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.

    sharepoint

    Al utilizar el parámetro gateway_params con db_type sharepoint, especifique también valores para auth_uri, scope, service_url y token_uri.

    Para db_type sharepoint, la credencial que proporcione con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK debe ser una credencial de tipo OAuth con el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte CREATE_CREDENTIAL Procedure para obtener más información. Genere el valor refresh_token para tenant_id.sharepoint.com/.default offline_access. Consulte lo siguiente para obtener más información: Determine the scope y OAuth 2.0 authentication.

    Defina valores para gateway_params para db_type sharepoint:

    snowflake

    Cuando db_type es SNOWFLAKE, los parámetros opcionales: role, schema y warehouse son válidos. Estos valores especifican un esquema, rol o valor de almacén distinto del valor por defecto. Por ejemplo:

    gateway_params => JSON_OBJECT(
         'db_type' value 'snowflake',
         'role' value 'ADMIN',
         'schema' value 'PUBLIC',
         'warehouse' value 'TEST' )
    youtube

    Para conectarse a Youtube y obtener datos, debe proporcionar los parámetros de gateway directory_name y file_name. Estos parámetros especifican un archivo de modelo (archivo de configuración de REST) que asigna la respuesta de JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información.

    Al utilizar el parámetro gateway_params con db_type youtube, la credencial que especifique debe ser una credencial OAuth de Google (gcp_oauth2). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.

    Autenticación OAuth 2.0: debe proporcionar el parámetro gateway_params db_type con el valor youtube y los parámetros directory_name y file_name, junto con las credenciales de tipo OAuth.

    El parámetro directory_name especifica el directorio con el archivo de configuración REST ServiceNow. Puede crear este directorio de la siguiente manera:

    create or replace directory youtube_dir as 'YOUTUBE_DIR';

    Obtenga y descargue el archivo de configuración de REST ServiceNow en el directorio especificado. Por ejemplo:

    exec DBMS_CLOUD.get_object('youtube_dir_cred',
         'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR');

    Defina el valor file_name en el nombre del archivo de configuración de REST que ha descargado, "youtube.rest".

    A continuación, puede utilizar el archivo de configuración REST ServiceNow con OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.

  • Para ejecutar DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK con un usuario que no sea ADMIN, debe otorgar privilegios EXECUTE y CREATE DATABASE LINK a ese usuario. Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios a adb_user:

    GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO adb_user;
    GRANT CREATE DATABASE LINK TO adb_user;

    Además, al crear un enlace de base de datos en un esquema que no sea el esquema ADMIN, por ejemplo, en un esquema denominado adb_user, el esquema adb_user debe poseer la credencial que utilice con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

  • Solo un archivo de cartera es válido por directorio especificado con el parámetro directory_name. Solo puede cargar un cwallet.sso a la vez en el directorio que seleccione para los archivos de cartera. Esto significa que con un cwallet.sso en un directorio, solo puede crear enlaces de base de datos a las bases de datos para las que la cartera de ese directorio es válida. Para utilizar varios archivos cwallet.sso con enlaces de base de datos, debe crear directorios adicionales y colocar cada cwallet.sso en un directorio diferente.

    Consulte Creación de directorio en Autonomous Database para obtener información sobre la creación de directorios.

  • Para crear un enlace de base de datos a una instancia de Autonomous Database, defina GLOBAL_NAMES en FALSE en la base de datos de origen (que no sea Autonomous Database).

    SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE;
     
    System altered.
    
    SQL> SHOW PARAMETER GLOBAL_NAMES
    NAME                     TYPE        VALUE
    ----------------------   ----------- -----------
    global_names             boolean     FALSE
    
  • Cuando el parámetro private_target es TRUE, el parámetro hostname especifica un host privado dentro de la VCN.

Ejemplos

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DB_LINK_CRED',
     username => 'adb_user',
     password => 'password');
  DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
     db_link_name => 'SALESLINK', 
     hostname => 'adb.eu-frankfurt-1.oraclecloud.com', 
     port => '1522',
     service_name => 'example_medium.adb.example.oraclecloud.com',
     ssl_server_cert_dn => 'CN=adb.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US',
     credential_name => 'DB_LINK_CRED');
END;
/
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AWS_REDSHIFT_LINK_CRED',
    username => 'NICK',
    password => 'password'
  );
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'AWSREDSHIFT_LINK', 
          hostname => 'example.com', 
          port => '5439',
          service_name => 'example_service_name',
          ssl_server_cert_dn => NULL,
          credential_name => 'AWS_REDSHIFT_LINK_CRED',
          gateway_params => JSON_OBJECT('db_type'  value 'awsredshift'));
END;
/
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'PRIVATE_ENDPOINT_CRED',
    username => 'db_user',
    password => 'password'
  );
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'PRIVATE_ENDPOINT_DB_LINK', 
          hostname => 'exampleHostname', 
          port => '1521',
          service_name => 'exampleServiceName',
          credential_name => 'PRIVATE_ENDPOINT_CRED',
          ssl_server_cert_dn => NULL,
          directory_name => NULL,
          private_target => TRUE);
END;
/
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'GOOGLE_BIGQUERY_CRED',
    params => JSON_OBJECT( 'gcp_oauth2' value JSON_OBJECT(
          'client_id' value 'client_id',
          'client_secret' value 'client_secret', 
          'refresh_token' value 'refresh_token' )));

DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
          db_link_name => 'GOOGLE_BIGQUERY_LINK', 
          hostname => 'example.com', 
          port => '443',
          service_name => 'example_service_name',
          credential_name => 'GOOGLE_BIGQUERY_CRED',
          gateway_params => JSON_OBJECT(
                     'db_type' value 'google_bigquery',
                     'project' value 'project_name1' ));
END;
/

El nombre de tabla que especifique al utilizar SELECT con Google BigQuery o Google Analytics debe estar entre comillas. Por ejemplo:

SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK

Utilice el parámetro rac_hostnames con una base de datos Oracle RAC de destino en un punto final privado.

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DB_LINK_CRED1',
     username => 'adb_user',
     password => 'password');
      DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK(
     db_link_name => 'SALESLINK', 
     rac_hostnames => '["sales1-svr1.example.adb.us-ashburn-1.oraclecloud.com",
                        "sales1-svr2.example.adb.us-ashburn-1.oraclecloud.com",
                        "sales1-svr3.example.adb.us-ashburn-1.oraclecloud.com"]',
     port => '1522',
     service_name => 'example_high.adb.oraclecloud.com',
     ssl_server_cert_dn => 'CN=adb.example.oraclecloud.com,OU=Oracle BMCS FRANKFURT,O=Oracle Corporation,L=Redwood City,ST=California,C=US',
     credential_name => 'DB_LINK_CRED1',
     directory_name => 'EXAMPLE_WALLET_DIR',
     private_target => TRUE);
END;
/

Procedimiento DETACH_FILE_SYSTEM

Este procedimiento separa un sistema de archivos de la base de datos.

El procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM separa un sistema de archivos de la base de datos. Además, el procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM también elimina la información sobre el sistema de archivos de la vista DBA_CLOUD_FILE_SYSTEMS.

Sintaxis

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

Parámetros

Parámetro Descripción

file_system_name

Especifica el nombre del sistema del archivo.

Este parámetro es obligatorio.

Ejemplo:

BEGIN
   DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'FSS'                                       
  );                                                                          
END;                                                                          
/     

Notas de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Debe tener el privilegio WRITE en el objeto de directorio de la base de datos para desasociar un sistema de archivos de un directorio mediante el procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM.

  • El procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM solo puede desasociar un servicio de almacenamiento de archivos privado en bases de datos con puntos finales privados activados.

    Consulte Servicio OCI File Storage y Configuración del acceso de red con puntos finales privados para obtener más información.

  • El procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM busca el nombre de host del sistema de archivos de red en la red virtual en la nube (VCN) del cliente. Se devuelve el error "ORA-20000: Mounting NFS fails" si no se puede localizar el nombre de host especificado en la ubicación.

DISABLE_APP_CONT Procedimiento

Este procedimiento desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parámetros

Parámetro Descripción

service_name

service_name para el servicio Autonomous Database.

Para buscar nombres de servicio:

  • Busque en el archivo tnsnames.ora de wallet.zip que descargue de una instancia de Autonomous Database para su conexión.

  • Haga clic en Conexión de base de datos en la consola de Oracle Cloud Infrastructure. En el área Cadenas de conexión, cada cadena de conexión incluye una entrada service_name que contiene la cadena de conexión para el servicio correspondiente. Cuando se permiten conexiones TLS mutuas (mTLS) y TLS, en autenticación TLS, seleccione TLS para ver los nombres de TNS y las cadenas de conexión para las conexiones con autenticación TLS. Consulte Visualización de nombres de TNS y cadenas de conexión para una instancia de Autonomous Database para obtener más información.

  • Consulte la vista V$SERVICES. Por ejemplo:

    SELECT name FROM V$SERVICES;

Notas de uso

Consulte Visión general de la continuidad de aplicaciones para obtener más información sobre la continuidad de aplicaciones.

Ejemplo

BEGIN
    DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
        service_name => 'nv123abc1_adb1_high.adb.oraclecloud.com' );
END;
/

Verifique el valor de la siguiente manera:

SELECT name, failover_type FROM DBA_SERVICES;

NAME                                                    FAILOVER_TYPE
------------------------------------------------------- --------------
nv123abc1_adb1_high.adb.oraclecloud.com      

DISABLE_EXTERNAL_AUTHENTICATION Procedimiento

Desactiva la autenticación de usuario con esquemas de autenticación externos para la base de datos.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

Excepciones

Excepción Error Descripción
invalid_ext_auth ORA-20004

Consulte el mensaje adjunto para obtener una explicación detallada.

Ejemplo

BEGIN 
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

DISABLE_FEATURE Procedimiento

Este procedimiento desactiva la función especificada en la instancia de Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

Parámetros

Parámetro Descripción

feature_name

Especifica el tipo de función que se va a desactivar. Los valores soportados son:

  • 'AUTO_DST_UPGRADE': deshabilite la función AUTO DST.

  • 'AUTO_DST_UPGRADE_EXCL_DATA': deshabilite la función AUTO DST EXCL DATA.

  • 'ORAMTS': desactive la función OraMTS.

  • 'OWM': desactive Oracle Workspace Manager.

  • 'WORKLOAD_AUTO_REPLAY': desactiva la función de reproducción automática de carga de trabajo.

Este parámetro es obligatorio.

Ejemplos

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'ORAMTS');   
END;
/
BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE');   
END;
/
BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA');   
END;
/
BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'OWM');   
END;
/
BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');   
END;
/

Notas de uso

  • Para desactivar las funciones OraMTS, AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, OWM o WORKLOAD_AUTO_REPLAY para la instancia de Autonomous Database, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Cuando se desactivan AUTO_DST_UPGRADE y AUTO_DST_UPGRADE_EXCL_DATA, si hay nuevas versiones de zona horaria disponibles, la instancia de Autonomous Database no se actualiza para utilizar los últimos archivos de zona horaria disponibles.

  • Consulte dba_cloud_config para verificar que AUTO_DST_UPGRADE está desactivado.

    SELECT param_name, param_value FROM dba_cloud_config WHERE
           LOWER(param_name) = 'auto_dst_upgrade';
    
    0 rows selected.
  • Consulte dba_cloud_config para verificar que AUTO_DST_UPGRADE_EXCL_DATA está desactivado.
    SELECT param_name, param_value FROM dba_cloud_config WHERE
           LOWER(param_name) = 'auto_dst_upgrade_excl_data';
    
    0 rows selected.  

DISABLE_OPERATOR_ACCESS Procedimiento

Este procedimiento revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

Ejemplo

BEGIN 
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;   
END;
/

DISABLE_PRINCIPAL_AUTH Procedimiento

Este procedimiento revoca la autenticación basada en principal para un proveedor especificado en Autonomous Database y se aplica al usuario ADMIN o al usuario especificado.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN' );

Parámetros

Parámetro Descripción

provider

Especifica el tipo de proveedor.

Valores válidos:

  • AWS
  • AZURE
  • GCP
  • OCI

username

Especificar el usuario para el que desactivar la autenticación basada en principal.

Un valor nulo es válido para username. Si no se especifica username, el procedimiento se aplica al usuario "ADMIN".

Notas de uso

  • Cuando el valor del proveedor es AZURE y username es ADMIN, el procedimiento desactiva la autenticación basada en el principal de servicio de Azure en Autonomous Database y suprime la aplicación de Azure en la instancia de Autonomous Database.

  • Cuando el valor del proveedor es AZURE y username es un usuario distinto del usuario ADMIN, el procedimiento revoca los privilegios del usuario especificado. El usuario ADMIN y otros usuarios que están activados para utilizar el principal de servicio de Azure pueden seguir utilizando ADMIN.AZURE$PA y la aplicación que se crea para la instancia de Autonomous Database permanece en la instancia.

Ejemplos

BEGIN 
     DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider => 'AZURE',
       username => 'SCOTT');
END;
/
BEGIN 
     DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH(
       provider => 'GCP');
END;
/

DISABLE_RESOURCE_PRINCIPAL Procedimiento

Desactive la credencial de entidad de recurso para la base de datos o para el esquema especificado.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

Parámetro

Parámetro Descripción

username

Especifica un nombre de usuario opcional. Nombre del esquema de base de datos para eliminar el acceso a la entidad de recurso.

Si no proporciona un username, username se define en ADMIN y el comando elimina la credencial OCI$RESOURCE_PRINCIPAL.

Excepciones

Excepción Error Descripción
resource principal is already disabled ORA-20031

Si intenta desactivar la entidad de recurso cuando ya está desactivada.

Notas de uso

  • El principal de recurso no está disponible con clonaciones de refrescamiento.

  • Debe configurar un grupo dinámico y políticas para el grupo dinámico antes de llamar a DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

    Consulte lo siguiente para obtener más información sobre la creación de políticas, la creación de un grupo dinámico y la creación de reglas:

  • Verifique que una credencial de entidad de recurso está activada consultando una de las vistas: DBA_CREDENTIALS o ALL_TAB_PRIVS.

    Por ejemplo, cuando el usuario ADMIN consulta la vista DBA_CREDENTIALS:

    SELECT owner, credential_name FROM dba_credentials 
            WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN'; 
    
    OWNER  CREDENTIAL_NAME
    -----  ----------------------
    ADMIN  OCI$RESOURCE_PRINCIPAL 
    

    Por ejemplo, como usuario no ADMIN, consulte la vista ALL_TAB_PRIVS:

    SELECT grantee, table_name, grantor, FROM ALL_TAB_PRIVS 
              WHERE  grantee = 'ADB_USER';
    
    GRANTEE   TABLE_NAME GRANTOR
    --------- -------------------------------------
    ADB_USER  OCI$RESOURCE_PRINCIPAL ADMIN

Ejemplo

EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed. 

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL'; 

No rows selected.

DROP_DATABASE_LINK Procedimiento

Este procedimiento borra un enlace de base de datos.

Sintaxis

DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name      IN VARCHAR2,
        public_link       IN BOOLEAN DEFAULT);

Parámetros

Parámetro Descripción

db_link_name

Nombre de enlace de base de datos que se va a borrar.

public_link

Para ejecutar DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK con public_link definido en TRUE, debe tener el privilegio del sistema DROP PUBLIC DATABASE LINK.

El valor por defecto de este parámetro es FALSE.

Ejemplos

BEGIN
    DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name => 'SALESLINK' );
END;
/
BEGIN
    DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK(
        db_link_name => 'SALESLINK' 
        public_link => TRUE );
END;
/

Notas de uso

Una vez que haya terminado de utilizar un enlace de base de datos y haya ejecutado DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK, para garantizar la seguridad de la base de datos Oracle, elimine los archivos de cartera almacenados. Por ejemplo:

  • Elimine el archivo de cartera del almacén de objetos.

  • Utilice DBMS_CLOUD.DELETE_FILE para eliminar el archivo de cartera del directorio data_pump_dir o del directorio definido por el usuario en el que se ha cargado el archivo de cartera.

ENABLE_APP_CONT Procedimiento

Este procedimiento permite la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parámetros

Parámetro Descripción

service_name

service_name para el servicio Autonomous Database.

Para buscar nombres de servicio:

  • Busque en el archivo tnsnames.ora de wallet.zip que descargue de una instancia de Autonomous Database para su conexión.

  • Haga clic en Conexión de base de datos en la consola de Oracle Cloud Infrastructure. En el área Cadenas de conexión, cada cadena de conexión incluye una entrada service_name que contiene la cadena de conexión para el servicio correspondiente. Cuando se permiten conexiones TLS mutuas (mTLS) y TLS, en autenticación TLS, seleccione TLS para ver los nombres de TNS y las cadenas de conexión para las conexiones con autenticación TLS. Consulte Visualización de nombres de TNS y cadenas de conexión para una instancia de Autonomous Database para obtener más información.

  • Consulte la vista V$SERVICES. Por ejemplo:

    SELECT name FROM V$SERVICES;

Notas de uso

Consulte Visión general de la continuidad de aplicaciones para obtener más información sobre la continuidad de aplicaciones.

Ejemplo

BEGIN
    DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
        service_name => 'nvthp2ht_adb1_high.adb.oraclecloud.com'
    );
END;
/

Verifique el valor de la siguiente manera:

SELECT name, failover_type FROM DBA_SERVICES;

NAME                                                    FAILOVER_TYPE
------------------------------------------------------- -------------
nvthp2ht_adb1_high.adb.oraclecloud.com                 TRANSACTION

ENABLE_AWS_ARN Procedimiento

Este procedimiento permite que una instancia de Autonomous Database utilice nombres de recursos de Amazon (ARN) para acceder a los recursos de AWS.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN(
       username     IN VARCHAR2 DEFAULT NULL,
       grant_option IN BOOLEAN DEFAULT FALSE);

Parámetros

Parámetro Descripción

username

Nombre del usuario que se va a activar para utilizar los nombres de recursos de Amazon (ARN).

Un valor nulo es válido para username. Si no se especifica username, el procedimiento se aplica al usuario "ADMIN".

grant_option

Cuando se proporciona username, si grant_option es TRUE, el username especificado puede activar el uso de nombres de recursos (ARN) de Amazon para otros usuarios.

Ejemplo

BEGIN
    DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN(
        username => 'adb_user'); 
END;
/

Nota de uso

  • Debe ser el usuario ADMIN para ejecutar el procedimiento DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN.

Consulte Use Amazon Resource Names (ARNs) to Access AWS Resources para obtener más información.

ENABLE_EXTERNAL_AUTHENTICATION Procedimiento

Permite a los usuarios conectarse a la base de datos con esquemas de autenticación externos.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
   type         IN VARCHAR2,
   force        IN BOOLEAN DEFAULT FALSE,
   params       IN CLOB DEFAULT NULL
);

Parámetro

Parámetro Descripción

type

Especifica el tipo de autenticación externa. Valores válidos: o .

  • 'OCI_IAM'
  • 'AZURE_AD'
  • 'CMU'
  • 'KERBEROS'

force

(Opcional) Sustituir un esquema de autenticación externa activado actualmente. Los valores válidos son TRUE o FALSE.

El valor por defecto es FALSE.

params

Cadena JSON que proporciona parámetros adicionales para la autenticación externa.

Parámetros CMU:

  • location_uri: especifica el URI de almacenamiento en la nube para el cubo donde se almacenan los archivos necesarios para CMU.

    Si especifica location_uri, hay un objeto de directorio de nombre fijo CMU_WALLET_DIR creado en la base de datos en la ruta de acceso 'cmu_wallet' para guardar los archivos de configuración de CMU. En este caso, no es necesario proporcionar el parámetro directory_name.

  • credential_name: especifica las credenciales que se utilizan para descargar los archivos de configuración de CMU del almacén de objetos en el objeto de directorio.

    El valor por defecto es NULL, que permite proporcionar una URL pública, autenticada previamente o firmada previamente para el cubo o la subcarpeta del almacén de objetos.

  • directory_name: especifica el nombre del directorio donde se almacenan los archivos de configuración necesarios para CMU. Si se proporciona directory_name, se espera que copie los archivos de configuración de CMU dsi.ora y cwallet.sso en este objeto de directorio.

Parámetros KERBEROS:

  • location_uri: especifica el URI de almacenamiento en la nube para el cubo donde se almacenan los archivos necesarios para Kerberos.

    Si especifica location_uri, hay un objeto de directorio de nombre fijo KERBEROS_DIR creado en la base de datos para guardar los archivos de configuración de Kerberos. En este caso, no es necesario proporcionar el parámetro directory_name.

  • credential_name: especifica la credencial que se utiliza para descargar los archivos de configuración de Kerberos de la ubicación del almacén de objetos en el objeto de directorio.

    El valor por defecto es NULL, que permite proporcionar una URL pública, autenticada previamente o firmada previamente para el cubo o la subcarpeta del almacén de objetos.

  • directory_name: especifica el nombre del directorio donde se almacenan los archivos necesarios para Kerberos. Si se proporciona directory_name, se espera que copie los archivos de configuración de Kerberos en este objeto de directorio.
  • kerberos_service_name: especifica un nombre para utilizar como nombre de servicio de Kerberos. Este parámetro es opcional.

    Valor por defecto: si no se especifica, el valor kerberos_service_name se define en el GUID de la instancia de Autonomous Database.

Parámetros AZURE_AD:

  • tenant_id: ID de inquilino de la cuenta de Azure. El ID de inquilino especifica el registro de la aplicación Azure AD de la instancia de Autonomous Database.
  • application_id: ID de aplicación de Azure creado en Azure AD para asignar asignaciones de roles/esquemas para la autenticación externa en la instancia de Autonomous Database.
  • application_id_uri: URI único asignado a la aplicación de Azure.

    Es el identificador de la instancia de Autonomous Database. El nombre debe estar cualificado para el dominio (soporta el acceso a recursos entre arrendamientos).

    La longitud máxima de este parámetro es de 256 caracteres.

Excepciones

Excepción Error Descripción
invalid_ext_auth ORA-20004

Consulte el mensaje adjunto para obtener una explicación detallada.

Notas de uso

  • Con type OCI_IAM, si la entidad de recurso no está activada en la instancia de Autonomous Database, esta rutina activa la entidad de recurso con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  • Este procedimiento define los parámetros del sistema IDENTITY_PROVIDER_TYPE y IDENTITY_PROVIDER_CONFIG para que los usuarios necesarios accedan a la instancia con la autenticación y autorización de Oracle Cloud Infrastructure Identity and Access Management.

Ejemplos

Activar autenticación OCI_IAM

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'OCI_IAM',
     force=> TRUE );
END;
/

PL/SQL procedure successfully completed.

Activar autenticación CMU para Microsoft Active Directory

Transfiere un nombre de directorio que contiene los archivos de configuración de CMU mediante el argumento JSON params.

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'CMU',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'CMU_DIR'); // CMU_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

Puede transferir un URI de ubicación que apunte a una ubicación de Object Storage que contenga archivos de configuración de CMU mediante el argumento JSON params.

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
       type     => 'CMU',
       params   => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                               'credential_name' value 'my_credential_name')
   );
END;
/

PL/SQL procedure successfully completed.

Activar autenticación de Azure AD

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'AZURE_AD',
     force => TRUE,
     params   => JSON_OBJECT( 'tenant_id' VALUE '....',
                              'application_id' VALUE '...',
                              'application_id_uri' VALUE '.....' ));
END;
/

PL/SQL procedure successfully completed.

Activar Autenticación de Kerberos

Transfiere un nombre de directorio que contiene archivos de configuración de Kerberos mediante el argumento JSON params.

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR'); // KERBEROS_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

Transfiere un URI de ubicación que apunta a una ubicación de Object Storage que contiene archivos de configuración de Kerberos mediante el argumento JSON params:

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
                           'credential_name' value 'my_credential_name');
END;
/

Transfiere un nombre de servicio con kerberos_service_name en el argumento JSON params:

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'KERBEROS',
     force => TRUE,
     params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR', // KERBEROS_DIR directory object already exists
                           'kerberos_service_name' value 'oracle' ));
END;
/

Una vez que Kerberos esté activado en la instancia de Autonomous Database, utilice la siguiente consulta para ver el nombre del servicio Kerberos:

SELECT SYS_CONTEXT('USERENV','KERBEROS_SERVICE_NAME') FROM DUAL;

ENABLE_FEATURE Procedimiento

Este procedimiento activa la función especificada en la instancia de Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
    feature_name     IN VARCHAR2,
    params           IN  CLOB   DEFAULT NULL);

Parámetros

Parámetro Descripción

feature_name

Nombre de la función que desea activar. Los valores admitidos son:

  • 'AUTO_DST_UPGRADE': habilite la función AUTO DST.

  • 'AUTO_DST_UPGRADE_EXCL_DATA': habilite la función AUTO DST EXCL DATA.

  • 'JAVAVM': active la función JAVAVM.

  • 'OLAP': activa la función OLAP. OLAP necesita que Java esté activado. Al activar OLAP, Java se activa automáticamente junto con la función OLAP.

  • 'ORAMTS': active la función OraMTS.

  • 'OWM': active Oracle Workspace Manager.

  • 'WORKLOAD_AUTO_REPLAY': active la función de reproducción automática de carga de trabajo.

Este parámetro es obligatorio.

params

Cadena JSON que proporciona parámetros adicionales para algunas funciones.

Para la función OraMTS, el parámetro params es:
  • location_uri: location_uri acepta un valor string. El valor especifica la URL HTTPS para el servidor OraMTS en una red de cliente.

Para la función WORKLOAD_AUTO_REPLAY, los parámetros params son:

  • target_db_ocid: valor string. El valor especifica el OCID de una base de datos de clonación de refrescamiento de destino en la que se reproduce la carga de trabajo capturada. La clonación de refrescamiento debe tener el nivel de parche Inicial definido.

    Este parámetro es obligatorio.

  • capture_duration: valor number. El valor especifica la duración en minutos para la que se captura la carga de trabajo en la base de datos de producción. El valor debe estar en el rango entre 1 y 720 minutos.

    Este parámetro es obligatorio.

  • capture_day: valor string. El valor especifica el día de la semana en que debe comenzar la captura de la carga de trabajo en la base de datos de producción.

    Este parámetro es opcional.

  • capture_time: valor en formato HH24:MM. El valor especifica la hora del día en que debe comenzar la captura de la carga de trabajo en la base de datos de producción.

    Este parámetro es opcional.

Por defecto, la captura de carga de trabajo se inicia al activar WORKLOAD_AUTO_REPLAY. Si se especifican los valores capture_day y capture_time opcionales, la captura y la reproducción se producen en el registro de hora especificado. Por ejemplo, si capture_day es lunes y capture_time es 15:00, la primera captura se produce a las 3 p.m. del próximo lunes. El día de la semana y la hora también se utilizan para programar la reproducción posterior en la clonación de refrescamiento.

Ejemplo de activación de la función JAVAVM:

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'JAVAVM' );
END;
/

Ejemplo para habilitar la función de horario de ahorro de energía automático:

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE' );
END;
/

Ejemplo para habilitar la función de datos Auto DST EXCL:

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE (
        feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA' );
END;
/

Ejemplo para activar la función OraMTS:

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'ORAMTS',   
        params       => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
   );
END;
/

Ejemplo para activar la función OWM:

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'OWM' );
END;
/

Ejemplo para activar la función de reproducción automática de carga de trabajo

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'WORKLOAD_AUTO_REPLAY',
        params       => JSON_OBJECT('target_db_ocid' VALUE 'OCID1.autonomousdatabase.REGION..ID1', 'capture_duration' VALUE 120, 'capture_day' VALUE 'MONDAY', 'capture_time' VALUE '15:00'));
END;
/

Un valor de error de ORA-20000: Invalid argument for target_db_ocid podría indicar que el OCID que ha proporcionado no es una clonación de refrescamiento. En este caso, debe proporcionar un OCID con un valor para una clonación de refrescamiento.

Notas de uso

  • Debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN para ejecutar DBMS_CLOUD_ADMIN.ENABLE_FEATURE.

  • Después de ejecutar DBMS_CLOUD_ADMIN.ENABLE_FEATURE con el valor feature_name 'JAVAVM', debe reiniciar la instancia de Autonomous Database para instalar Oracle Java.

    Después de reiniciar la instancia de Autonomous Database, la instalación de Java continúa durante algún tiempo después de abrir la base de datos.

    Consulte Comprobación de la versión de Oracle Java para obtener más información sobre la comprobación del estado de la instalación de Java.

  • Después de ejecutar DBMS_CLOUD_ADMIN.ENABLE_FEATURE con el valor feature_name 'OWM', debe reiniciar la instancia de Autonomous Database para activar Oracle Workspace Manager. Oracle.

  • Para activar las funciones AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, ORAMTS, JAVAVM, OWM o WORKLOAD_AUTO_REPLAY para la base de datos, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Por defecto, tanto AUTO_DST_UPGRADE como AUTO_DST_UPGRADE_EXCL_DATA están desactivados. Puede activar una u otra de estas opciones, pero no ambas.

  • Después de activar AUTO_DST_UPGRADE, la próxima vez que reinicie o pare y, a continuación, inicie la instancia de Autonomous Database, la instancia se actualiza para utilizar los últimos archivos de zona horaria disponibles. Después de activar AUTO_DST_UPGRADE, cuando haya nuevos archivos de zona horaria disponibles, la instancia seguirá actualizando a la última versión disponible cada reinicio o parada e inicio posteriores, hasta que se desactive la función.

    Consulte dba_cloud_config para verificar que AUTO_DST_UPGRADE está activado.

    SELECT param_name, param_value FROM dba_cloud_config WHERE
           LOWER(param_name) = 'auto_dst_upgrade';
    
    PARAM_NAME       PARAM_VALUE
    ---------------- -------------- 
    auto_dst_upgrade enabled
  • Después de activar AUTO_DST_UPGRADE_EXCL_DATA, la instancia de Autonomous Database se actualiza para utilizar los últimos archivos de zona horaria disponibles. Después de activar esta función, cada ventana de mantenimiento posterior actualiza la instancia para utilizar la última versión de zona horaria disponible. Esta función garantiza que los archivos de zona horaria se actualicen para la base de datos (la activación de AUTO_DST_UPGRADE_EXCL_DATA no actualiza ninguna fila afectada).

    Consulte dba_cloud_config para verificar que AUTO_DST_UPGRADE_EXCL_DATA está activado.

    SELECT param_name, param_value FROM dba_cloud_config WHERE
           LOWER(param_name) = 'auto_dst_upgrade_excl_data';
    
    PARAM_NAME                    PARAM_VALUE
    --------------------------    -----------
    auto_dst_upgrade_excl_data    enabled

ENABLE_OPERATOR_ACCESS Procedimiento

Oracle Cloud Operations no accede a la instancia de Autonomous Database y el acceso no está permitido por defecto. Cuando se necesita acceso para solucionar o mitigar un problema, puede permitir que un operador de nube acceda a los esquemas de base de datos durante un tiempo limitado.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

Parámetros

Parámetro Descripción

auth_duration

Especifica el número de horas para las que se otorga acceso al operador en la nube.

Valores válidos: deben ser números enteros en el rango de 1 a 24.

Valor por defecto: 1

Ejemplo

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
       auth_duration => 12 );
END;
/

Notas de uso

  • ORA-20000: Operator access is already enabled indica que ya se ha otorgado el acceso de operador. En este caso, tiene dos opciones:

    • Espere a que caduque el acceso del operador y, a continuación, vuelva a otorgar el acceso del operador con DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS

    • Desactive explícitamente el acceso del operador con el procedimiento DISABLE_OPERATOR_ACCESS.
  • DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS solo permite el acceso al operador en la nube y no permite el acceso a ningún otro usuario. Todas las operaciones realizadas por el operador en la nube se almacenan en la vista DBA_OPERATOR_ACCESS. Consulte Visualización de acciones de operaciones de Oracle Cloud Infrastructure para obtener más información.

  • Para permitir que un operador en la nube acceda a los esquemas de base de datos, ejecute el procedimiento DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Esto significa que si archiva una solicitud de servicio con Oracle Cloud Support y los operadores de Oracle Cloud necesitan acceder a los esquemas de base de datos, también debe activar el acceso del operador ejecutandoDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS.

ENABLE_PRINCIPAL_AUTH Procedimiento

Este procedimiento permite la autenticación de principal en Autonomous Database para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
       provider    IN VARCHAR2,
       username    IN VARCHAR2 DEFAULT 'ADMIN',
       params      IN CLOB DEFAULT NULL);

Parámetros

Parámetro Descripción

provider

Especifica el tipo de proveedor.

Valores válidos:

  • AWS: activar el uso de nombres de recursos de Amazon (ARN)
  • AZURE: activar el uso del principal de servicio de Azure
  • GCP: habilitar el uso de la cuenta de servicio de Google
  • OCI: activación del uso de la entidad de recurso

username

Nombre del usuario que tiene activado el uso de autenticación de principal.

Un valor nulo es válido para username. Si no se especifica username, el procedimiento se aplica al usuario "ADMIN".

params

Especifica los parámetros de configuración.

Cuando el parámetro provider es AWS, GCP o OCI, params no es necesario. El valor por defecto es NULL.

grant_option: este parámetro es válido para todos los proveedores y es un valor booleano TRUE o FALSE. El valor por defecto es FALSE.

Cuando se especifican TRUE y username, el usuario especificado puede utilizar ENABLE_PRINCIPAL_AUTH para activar a otros usuarios.

Cuando el parámetro provider es AWS, estas opciones también son válidas:

  • aws_role_arn: especifica el rol de AWS ARN.

  • external_id_type: especifica el tipo de ID externo. Los valores válidos son: "TENANT_OCID", "DATABASE_OCID" o "COMPARTMENT_OCID". El valor por defecto para external_id_type es "DATABASE_OCID".

    Consulte Perform AWS Management Prerequisites to Use Amazon Resource Names (ARNs) para obtener detalles sobre los valores de external_id_type.

Cuando el parámetro provider es AZURE, esta opción también es válida:

  • azure_tenantid: con el valor del ID de inquilino de Azure.

Notas de uso

  • Cuando el parámetro provider es AZURE, el parámetro params debe incluir azure_tenantid en los siguientes casos:

    • Cuando se llama a DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH por primera vez.

    • Cuando se llama a DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH por primera vez después de que se llame a DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH con el parámetro provider AZURE y username ADMIN.

  • Cuando el parámetro provider es AWS:

    • Después de activar ARN en la instancia de Autonomous Database mediante la ejecución de DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, la credencial denominada AWS$ARN está disponible para su uso con cualquier API DBMS_CLOUD que tome una credencial como entrada.

Ejemplos

BEGIN 
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH(
       provider => 'AZURE',
       username => 'SCOTT',
       params   => JSON_OBJECT('azure_tenantid' value 'azure_tenantid'));
END;
/
BEGIN
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH( 
     provider => 'GCP',
     username => 'SCOTT',
     params => JSON_OBJECT(
         'grant_option' value 'TRUE' ));
END;
/
BEGIN
     DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH( 
     provider => 'AWS',
     username => 'SCOTT',
     params => JSON_OBJECT(
         'aws_role_arn' value 'arn:aws:iam::123456:role/AWS_ROLE_ARN',
          'external_id_type' value 'TENANT_OCID'));
END;
/

ENABLE_RESOURCE_PRINCIPAL Procedimiento

Active la credencial de entidad de recurso para la base de datos o para el esquema especificado. Este procedimiento crea la credencial OCI$RESOURCE_PRINCIPAL.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2,
   grant_option     IN BOOLEAN DEFAULT FALSE);

Parámetro

Parámetro Descripción

username

Especifica un nombre de usuario opcional. Nombre del esquema de base de datos al que se va a otorgar acceso de entidad de recurso.

Si no proporciona username, username se define en ADMIN.

grant_option

Cuando se proporciona username, si grant_option es TRUE, el username especificado puede activar el uso de la entidad de recurso para otros usuarios.

Excepciones

Excepción Error Descripción
resource principal is already enabled ORA-20031

Si intenta activar la entidad de recurso cuando ya está activada.

Notas de uso

  • Debe llamar a DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL con el administrador username o sin argumentos antes de llamar a DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL con un username para un esquema de usuario de base de datos.

  • Debe configurar un grupo dinámico y políticas para el grupo dinámico antes de llamar a DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

    Consulte lo siguiente para obtener más información sobre las políticas, la creación de un grupo dinámico y la creación de reglas:

  • La activación de la entidad de recurso con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL es una operación puntual. No es necesario volver a activar la entidad de recurso, a menos que ejecute DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL para desactivar la entidad de recurso.

  • El principal de recurso no está disponible con clonaciones de refrescamiento.

Ejemplo

EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

PL/SQL procedure successfully completed. 

SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL'; 

OWNER    CREDENTIAL_NAME
-------  ---------------
ADMIN    OCI$RESOURCE_PRINCIPAL

FINISH_WORKLOAD_CAPTURE Procedimiento

Este procedimiento finaliza la captura de carga de trabajo actual, para cualquier solicitud de captura de carga de trabajo posterior en la base de datos y carga los archivos de captura en Object Storage.

Ejemplo

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE
END;
/

Notas de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Al transferir el parámetro duration a START_WORKLOAD_CAPTURE, la captura termina cuando alcanza la hora especificada. Sin embargo, si llama a FINISH_WORKLOAD_CAPTURE, esto para la captura de carga de trabajo (posiblemente antes de la hora especificada con el parámetro de duración).

    Puede consultar la vista DBA_CAPTURE_REPLAY_STATUS para comprobar el estado de la carga de trabajo de finalización. Consulte DBA_CAPTURE_REPLAY_STATUS View para obtener más información.

Nota

Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information para que se le notifique la finalización de FINISH_WORKLOAD_CAPTURE, así como al enlace de Object Storage para descargar el archivo de captura. Esta URL de PAR está incluida en el campo captureDownloadURL del evento y es válida durante 7 días a partir de la fecha de generación. Consulte Eventos de información en Autonomous Database para obtener más información.

PREPARE_REPLAY Procedimiento

El procedimiento PREPARE_REPLAY prepara la clonación de refrescamiento para una reproducción.

Parámetros

Parámetro Descripción
capture_name Especifica el nombre de la captura de carga de trabajo.

Este parámetro es obligatorio.

Sintaxis

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Ejemplo

BEGIN
    DBMS_CLOUD_ADMIN.PREPARE_REPLAY
      capture_name => 'cap_test1');
END;
/

En este ejemplo, se prepara la clonación de refrescamiento para reproducir la carga de trabajo indicada por el parámetro capture_name, que implica llevarla a la hora de inicio de la captura y, a continuación, desconectarla.

Nota de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

PURGE_FLASHBACK_ARCHIVE Procedimiento

Este procedimiento permite a los usuarios ADMIN depurar datos históricos desde el flashback de archivo de datos. Puede depurar todos los datos históricos del flashback de archivo de datos flashback_archive o datos selectivos basados en registros de hora o en el número de cambio del sistema.

Sintaxis

DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE( 
   scope      IN VARCHAR2, 
   before_scn IN INTEGER DEFAULT NULL, 
   before_ts  IN TIMESTAMP DEFAULT NULL); 
Parámetro Descripción
scope Especifica el ámbito para eliminar datos del flashback de archivo de datos.
  • all implica que PURGE ALL;before_scn y before_timestamp deben ser NULL.

  • scn implica que PURGE BEFORE SCN;before_scn no debe ser NULL y before_timestamp debe ser NULL.

  • TIMESTAMP implica que PURGE BEFORE timestamp;before_scn debe ser NULL y before_timestamp no debe ser NULL.

before_scn Especifica el número de cambio del sistema antes del cual se eliminan todos los datos del flashback de archivo.
before_timestamp Especifica el registro de hora antes del cual se eliminan todos los datos del flashback de archivo.

Ejemplo

BEGIN
	DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
           scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/

REPLAY_WORKLOAD Procedimiento

Este procedimiento inicia una reproducción de carga de trabajo en la instancia de Autonomous Database. El formulario sobrecargado permite reproducir los archivos de captura desde una instancia de Autonomous Database, una base de datos local u otras bases de datos de servicios en la nube.

Sintaxis


DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        capture_name                  IN VARCHAR2,        
        replay_name                   IN VARCHAR2 DEFAULT NULL,
        capture_source_tenancy_ocid   IN VARCHAR2 DEFAULT NULL,
        capture_source_db_name        IN VARCHAR2 DEFAULT NULL);

DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        location_uri      IN VARCHAR2,               
        credential_name   IN VARCHAR2 DEFAULT NULL,
        synchronization   IN BOOLEAN  DEFAULT TRUE,
        process_capture   IN BOOLEAN  DEFAULT TRUE);

Parámetros

Parámetro Descripción
CAPTURE_NAME Especifica el nombre de la captura de carga de trabajo.

Este parámetro es obligatorio.

REPLAY_NAME Especifica el nombre de la reproducción.

Si no proporciona un valor REPLAY_NAME, el valor REPLAY_NAME se genera automáticamente con el formato REPLAY_RANDOMNUMBER, por ejemplo, REPLAY_1678329506.

CAPTURE_SOURCE_TENANCY_OCID Especifica el OCID de arrendamiento de origen de la captura de carga de trabajo.

Si no proporciona un valor CAPTURE_SOURCE_TENANCY_OCID, CAPTURE_SOURCE_TENANCY_OCID se define en NULL.

Este parámetro solo es obligatorio cuando se ejecuta la captura de carga de trabajo en una clonación completa.

CAPTURE_SOURCE_DB_NAME Especifica el nombre de la base de datos origen de la captura de carga de trabajo

Si no proporciona un valor CAPTURE_SOURCE_DB_NAME, CAPTURE_SOURCE_DB_NAME se define en NULL.

Este parámetro solo es obligatorio cuando se ejecuta la captura de carga de trabajo en una clonación completa.

LOCATION_URI Especifica el URI que apunta a una ubicación de Object Storage que contiene los archivos capturados.

Este parámetro es obligatorio.

CREDENTIAL_NAME Especifica la credencial para acceder al cubo de almacenamiento de objetos.

Si no proporciona un valor credential_name, se utilizan las credenciales por defecto de la base de datos.

SYNCHRONIZATION Especifica el método de sincronización utilizado durante la reproducción de la carga de trabajo.
  • TRUE especifica que la sincronización se basa en SCN.

  • FALSE especifica que la sincronización se basa en TIME.

Si no proporciona un valor synchronization, synchronization se define en TRUE.

PROCESS_CAPTURE Especifica si debe especificar o no el valor process_capture. Se puede definir en FALSE solo cuando reproduzca la misma carga de trabajo en la base de datos destino repetidamente.

Si no proporciona un valor process_capture, process_capture se define en TRUE.

Ejemplo para reproducir la carga de trabajo desde una base de datos local en una instancia de Autonomous Database:

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
        credential_name => 'CRED_TEST',
        synchronization => TRUE,
        process_capture => TRUE);    
END;
/

Al ejecutar este ejemplo:

  • Descarga los archivos de captura de la ubicación de Object Storage especificada en location_uri y procesa los archivos de captura según el valor del parámetro process_capture.

  • Reproduce la carga de trabajo capturada en función del valor del parámetro synchronization.

En este ejemplo, namespace-string es el espacio Oracle Cloud Infrastructure Object Storage Namepace, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

Consulte Navegación a Oracle Cloud Infrastructure Object Storage y creación de un cubo para obtener más información sobre Object Storage.

Consulte Carga de archivos en el cubo de almacenamiento de objetos de Oracle Cloud Infrastructure para obtener más información sobre la carga de archivos en Object Storage.

credential_name que utiliza en este paso son las credenciales para el almacén de objetos.

No es necesario que cree una credencial para acceder al almacén de objetos de Oracle Cloud Infrastructure si activa las credenciales de entidad de recurso. Consulte Uso de la entidad de recurso para acceder a recursos de Oracle Cloud Infrastructure para obtener más información.

Ejemplo para reproducir la carga de trabajo de una instancia de Autonomous Database en otra instancia de Autonomous Database:

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
        capture_name => 'CAP_TEST1');
END;
/

Al ejecutar este ejemplo:

  • Desconecta la instancia de Autonomous Database actual.

  • Descarga los archivos de captura de Object Storage.

  • Reproduce la carga de trabajo capturada.

  • Carga el informe de reproducción después de una reproducción.

Notas de uso para reproducir la carga de trabajo desde una base de datos local u otra base de datos de Cloud Service en otra instancia de Autonomous Database

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Antes de empezar a reproducir, debe cargar los subdirectorios cap y capfiles, que contienen los archivos de captura de carga de trabajo, en la ubicación de almacenamiento de objetos.

Notas de uso para reproducir la carga de trabajo desde una instancia de Autonomous Database en otra instancia de Autonomous Database

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Los archivos de reproducción se cargan automáticamente en el almacén de objetos como archivo zip.

  • Puede consultar la vista DBA_CAPTURE_REPLAY_STATUS para comprobar el estado de reproducción de la carga de trabajo.

    Consulte DBA_CAPTURE_REPLAY_STATUS View para obtener más información.

Nota

Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information para recibir una notificación sobre el inicio y la finalización de REPLAY_WORKLOAD, así como el enlace de Object Storage para descargar los informes de reproducción. Esta URL de PAR está incluida en el campo replayDownloadURL del evento y es válida durante 7 días a partir de la fecha de generación. Consulte Eventos de información en Autonomous Database para obtener más información.

SET_FLASHBACK_ARCHIVE_RETENTION Procedimiento

Este procedimiento permite a los usuarios ADMIN modificar el período de retención para el flashback de archivo de datos flashback_archive.

Sintaxis


DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);
Parámetro Descripción
retention_days Especifica el tiempo en días durante el que se deben conservar los datos archivados. El valor de retention_days debe ser mayor que 0.

Ejemplo

BEGIN
     DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION(
           retention_days => 90); // sets the retention time to 90 days
END;
/

START_WORKLOAD_CAPTURE Procedimiento

Este procedimiento inicia una captura de carga de trabajo en la instancia de Autonomous Database.

Sintaxis

DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name  IN VARCHAR2,
        duration      IN NUMBER   DEFAULT NULL);

Parámetros

Parámetro Descripción
capture_name Especifica el nombre de la captura de carga de trabajo.

Este parámetro es obligatorio.

duration Especifica la duración en minutos para la que desea ejecutar la captura de carga de trabajo.
  • Si no proporciona un valor duration, duration se define en NULL.

  • Si se define en NULL, la carga de trabajo continuará hasta que ejecute el procedimiento FINISH_WORKLOAD_CAPTURE.

Ejemplo

BEGIN 
  DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test');
END;
/

Notas de uso

  • Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio EXECUTE en DBMS_CLOUD_ADMIN.

  • Para medir el impacto de un cambio del sistema en una carga de trabajo, debe asegurarse de que los sistemas de captura y reproducción estén en el mismo estado lógico.

  • Antes de iniciar una captura de carga de trabajo, debe considerar el aprovisionamiento de una clonación de refrescamiento para garantizar el mismo punto de inicio para la reproducción.

Nota

Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information para recibir una notificación al inicio de START_WORKLOAD_CAPTURE. Consulte Eventos de información en Autonomous Database para obtener más información.