Resumen de subprogramas de DBMS_CLOUD_ADMIN

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

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 de coincidencia para que la base de datos de IA autónoma 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".

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

Nota de uso

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

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

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

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: auth_uri: defina auth_uri desde Azure. Consulte Obtención de información de cliente de aplicación y puntos finales para obtener más información. scope: defina el ámbito. Consulte Descripciones de las opciones de conexión para obtener más información. service_url: defina service_url. Consulte URL de servicio para obtener más información. token_uri: obtenga token_uri de Azure. Consulte Obtención de información de cliente de aplicación y puntos finales para obtener más información.
  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 Crear directorio en base de datos de IA autónoma para obtener información sobre la creación de directorios.

• Para crear un enlace de base de datos a una base de datos de IA autónoma, defina GLOBAL_NAMES en FALSE en la base de datos de origen (base de datos de IA no autónoma).

  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

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

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.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parámetros

Notas de uso

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

Ejemplo

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

Excepciones

Ejemplo

BEGIN 
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

Parámetros

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 base de datos de IA autónoma, 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 la base de datos de IA autónoma 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.  

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

Ejemplo

BEGIN 
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;   
END;
/

Sintaxis

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

Parámetros

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 AI Database y suprime la aplicación de Azure en la instancia de Autonomous AI 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 base de datos de IA autónoma permanece en la instancia.

Ejemplos

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

Parámetro

Excepciones

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:

  • Uso de la entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure

  • Gestión de grupos dinámicos

  • Gestión de políticas

• 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.

Sintaxis

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

Parámetros

Ejemplos

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.

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parámetros

Notas de uso

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

Ejemplo

Sintaxis

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

Parámetros

Ejemplo

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.

Sintaxis

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

Parámetro

Excepciones

Notas de uso

• Con type OCI_IAM, si la entidad de recurso no está activada en la instancia de base de datos de IA autónoma, 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;
/

Después de activar Kerberos en la instancia de la base de datos de IA autónoma, utilice la siguiente consulta para ver el nombre del servicio Kerberos:

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

Sintaxis

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

Parámetros

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 AI Database para instalar Oracle Java.

  Después de reiniciar la instancia de la base de datos de IA autónoma, 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 la base de datos de IA autónoma 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 base de datos de IA autónoma, 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, las actualizaciones de instancia de la base de datos de IA autónoma utilizan 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

Sintaxis

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

Parámetros

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.

Sintaxis

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

Parámetros

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 base de datos de IA autónoma ejecutando 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

Sintaxis

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

Parámetro

Excepciones

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:

  • Uso de la entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure

  • Gestión de grupos dinámicos

  • Gestión de políticas

• 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

Ejemplo

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.

Parámetros

Sintaxis

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Ejemplo

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.

Sintaxis

DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE( 
   scope      IN VARCHAR2, 
   before_scn IN INTEGER DEFAULT NULL, 
   before_ts  IN TIMESTAMP DEFAULT NULL); 

Ejemplo

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

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

Ejemplo para reproducir la carga de trabajo desde una base de datos local en una instancia de base de datos de IA autónoma:

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 desde una instancia de una base de datos de IA autónoma en otra base de datos de IA autónoma:

Al ejecutar este ejemplo:

• Desconecta la instancia de la base de datos de IA autónoma 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 base de datos de IA autónoma

• 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 una base de datos de IA autónoma en otra base de datos de IA autónoma

• 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.

Sintaxis

DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);

Ejemplo

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

Sintaxis

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

Parámetros

Ejemplo

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.

Sintaxis

DBMS_CLOUD_ADMIN.START_LIVE_WORKLOAD_REPLAY(
        capture_replay_name  IN VARCHAR2,
        target_db_ocid       IN VARCHAR2,
        capture_duration     IN NUMBER DEFAULT NULL,
        reconnect_target     IN BOOLEAN DEFAULT TRUE
 );

Parámetros

Ejemplo

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 reproducción de captura de carga de trabajo activa, debe considerar el aprovisionamiento de una clonación de refrescamiento para garantizar el mismo punto de inicio para la reproducción.