El procedimiento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM adjunta 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:

Adjuntar 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;
/     

Asociar 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 de almacenamiento de archivos de OCI 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 puede que aparezca un error como: "Protocol not supported".

Sintaxis

Este procedimiento cancela la captura de carga de trabajo actual y permite 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 soportar la autenticación NTLM/AD. Cuando se configura NTLMv2, defina auth_method=10 y domain en el valor del 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. Es necesario 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 Restablecimiento del 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 REST) 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 servicenow, hay dos opciones soportadas: Autenticación básica: debe proporcionar el parámetro gateway_params db_type con el valor 'servicenow' y los parámetros directory_name y file_name junto con las credenciales de nombre de usuario/tipo de contraseña. OAuth 2.0 Autenticación: 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 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 REST que ha descargado, "servicenow.rest". A continuación, puede utilizar el archivo de configuración REST ServiceNow con autenticación básica o OAuth2.0. A continuación, puede utilizar el archivo de configuración 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 los 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 mediante el parámetro params con los valores gcp_oauth2 especificados (client_id, client_secret y refresh_token). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información. Genere 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 de 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 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 valor de esquema, rol o almacén diferente al 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 REST) 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 youtube, la credencial que especifique debe ser una credencial OAuth de Google (gcp_oauth2). Consulte Procedimiento CREATE_CREDENTIAL para obtener más información. OAuth 2.0 Autenticación: 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 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 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 ser propietario de la credencial que utilice con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

• Solo es válido un archivo de cartera 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 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 sea válida. Para utilizar varios archivos cwallet.sso con enlaces de base de datos, debe crear directorios adicionales y colocar cada archivo cwallet.sso en un directorio diferente.

  Consulte Creación de directorios 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 (no 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

El procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM desasocia 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 de almacenamiento de archivos de OCI 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 Descripció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 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.  

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 de proveedor es AZURE y username es ADMIN, el procedimiento desactiva la autenticación basada en entidad de servicio de Azure en Autonomous Database y suprime la aplicación Azure en la instancia de Autonomous Database.

• Cuando el valor provider es AZURE y username es un usuario distinto de ADMIN, el procedimiento revocará los privilegios del usuario especificado. El usuario ADMIN y otros usuarios que pueden utilizar la entidad de servicio de Azure pueden seguir utilizando ADMIN.AZURE$PA y la aplicación creada para la instancia de Autonomous Database permanece en la instancia.

Ejemplos

Sintaxis

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

parámetro

Excepciones

Notas de Uso

• La entidad de recurso no está disponible con clones 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 las 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, como usuario ADMIN, consulte 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

Después de utilizar un enlace de base de datos y ejecutar 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 Descripció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 Uso de nombres de recursos de Amazon (ARN) para acceder a los recursos de AWS 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 Autonomous Database, esta rutina activa la entidad de recurso con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• Con este procedimiento se definen los parámetros del sistema IDENTITY_PROVIDER_TYPE eIDENTITY_PROVIDER_CONFIG en los usuarios necesarios para acceder a la instancia con autenticación y autorización de Oracle Cloud Infrastructure Identity and Access Management.

Ejemplos

Activar la autenticación OCI_IAM

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

PL/SQL procedure successfully completed.

Activación de la autenticación CMU para Microsoft Active Directory

Debe transferir un nombre de directorio que contenga 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.

Debe 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 la 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.

Activación de autenticación de Kerberos

Debe transferir un nombre de directorio que contenga 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 Autonomous Database, 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 para activar la función JAVAVM:

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

Ejemplo para activar 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 activar 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 ORA-20000: Invalid argument for target_db_ocid podría indicar que el OCID 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 'JAVAVM' de feature_name, 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 'OWM' de feature_name, 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 desactivadas. 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 hay nuevos archivos de zona horaria disponibles, la instancia sigue actualizando a la última versión disponible en cada reinicio o parada e inicio posteriores, hasta que la función esté desactivada.

  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. Una vez activada 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 el acceso del operador ya se ha otorgado. En este caso, tiene dos opciones:

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

  • Desactive explícitamente el acceso de 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 para ningún otro usuario. Todas las operaciones realizadas por Cloud Operator 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.

• Puede permitir que un operador de nube acceda a los esquemas de base de datos ejecutando el procedimiento DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Esto significa que si archiva una solicitud de servicio con los Servicios de Soporte Oracle Cloud y los operadores de Oracle Cloud necesitan acceder a los esquemas de base de datos, también debe activar el acceso de 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 Autonomous Database 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 valor ADMIN para username o sin argumentos antes de llamar a DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL con un valor 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.

• La entidad de recurso no está disponible con clones 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 finaliza cuando alcanza la hora especificada. Sin embargo, si llama a FINISH_WORKLOAD_CAPTURE, esto para la captura de carga de trabajo (posiblemente antes del tiempo especificado 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 activarla hasta 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 Autonomous Database:

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.

• Permite reproducir la carga de trabajo capturada según el valor del parámetro synchronization.

En este ejemplo, namespace-string es el espacio de nombres de almacenamiento de objetos de Oracle Cloud Infrastructure, 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.

El valor credential_name que utiliza en este paso son las credenciales del almacén de objetos.

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

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

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 la reproducción de 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 iniciar la reproducción, debería 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 un 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 los impactos 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.