Resumen de DBMS_CLOUD_ADMIN Subprogramas
En esta sección se tratan los subprogramas DBMS_CLOUD_ADMIN
que se proporcionan con Autonomous Database.
Subprograma | Descripción |
---|---|
Este procedimiento adjunta un sistema de archivos en un directorio de la base de datos. |
|
Este procedimiento cancela la captura de carga de trabajo actual. |
|
Con este procedimiento se crea un enlace de base de datos a una base de datos de 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 la conectividad heterogénea gestionada por Oracle. |
|
Este procedimiento separa un sistema de archivos de un directorio de la base de datos. |
|
Con este procedimiento se desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. |
|
Con este procedimiento se desactiva la autenticación externa para la instancia de Autonomous Database. |
|
Revoca inmediatamente el acceso del operador en la nube en la instancia de base de datos de Autonomous Database. |
|
Con este procedimiento se revoca la autenticación basada en principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado. |
|
Con este procedimiento se desactiva la credencial de entidad de recurso y se crea la credencial |
|
Con este procedimiento se borra un enlace de base de datos. |
|
Con este procedimiento se activa la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. |
|
Este procedimiento permite a un usuario crear credenciales de ARN de AWS en Autonomous Database. |
|
Este procedimiento permite a un usuario conectarse a Autonomous Database mediante el esquema de autenticación externo especificado. |
|
Con este procedimiento se activa la función especificada en la instancia de Autonomous Database. |
|
Otorga al operador de nube acceso a una instancia de Autonomous Database durante un número especificado de horas. |
|
Con este procedimiento se permite la autenticación de principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado. |
|
Con este procedimiento se activa la credencial de entidad de recurso y se crea la credencial |
|
Con este procedimiento se para la captura de la carga de trabajo y se cargan los archivos de captura en el almacenamiento de objetos. |
|
Este procedimiento prepara la reproducción para la clonación de refrescamiento. |
|
Procedimiento PURGE_FLASHBACK_ARCHIVE | Este procedimiento depura datos históricos de Flashback Data Archive. |
Este procedimiento está sobrecargado. Inicia la reproducción de la carga de trabajo. | |
Este procedimiento permite a los usuarios ADMIN modificar el período de retención para Flashback Time Travel flashback_archive .
|
|
Este procedimiento inicia una captura de carga de trabajo. |
- Procedimiento ATTACH_FILE_SYSTEM
Este procedimiento anexa un sistema de archivos en la base de datos. - Procedimiento CANCEL_WORKLOAD_CAPTURE
Este procedimiento cancela cualquier captura de carga de trabajo en curso en la base de datos. - Procedimiento CREATE_DATABASE_LINK
Con este procedimiento se crea un enlace de base de datos a una base de datos de destino en el esquema que llama a la API. - Procedimiento DETACH_FILE_SYSTEM
Este procedimiento separa un sistema de archivos de la base de datos. - Procedimiento DISABLE_APP_CONT
Con este procedimiento se desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. - Procedimiento DISABLE_EXTERNAL_AUTHENTICATION
Desactiva la autenticación de usuario con esquemas de autenticación externos para la base de datos. - Procedimiento DISABLE_FEATURE
Con este procedimiento se desactiva la función especificada en la instancia de Autonomous Database. - Procedimiento DISABLE_OPERATOR_ACCESS
Este procedimiento revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database. - Procedimiento DISABLE_PRINCIPAL_AUTH
Con este procedimiento se revoca la autenticación basada en principal para un proveedor especificado en Autonomous Database y se aplica al usuario ADMIN o al usuario especificado. - Procedimiento DISABLE_RESOURCE_PRINCIPAL
Desactive la credencial de entidad de recurso para la base de datos o para el esquema especificado. - Procedimiento DROP_DATABASE_LINK
Con este procedimiento se borra un enlace de base de datos. - Procedimiento ENABLE_APP_CONT
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. - Procedimiento ENABLE_AWS_ARN
Este procedimiento permite a una instancia de Autonomous Database utilizar nombres de recursos de Amazon (ARN) para acceder a los recursos de AWS. - Procedimiento ENABLE_EXTERNAL_AUTHENTICATION
Permita a los usuarios conectarse a la base de datos con esquemas de autenticación externos. - Procedimiento ENABLE_FEATURE
Este procedimiento permite la función especificada en la instancia de Autonomous Database. - Procedimiento ENABLE_OPERATOR_ACCESS
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. - Procedimiento ENABLE_PRINCIPAL_AUTH
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. - Procedimiento ENABLE_RESOURCE_PRINCIPAL
Active la credencial de entidad de recurso para la base de datos o para el esquema especificado. Con este procedimiento se crea la credencialOCI$RESOURCE_PRINCIPAL
. - Procedimiento FINISH_WORKLOAD_CAPTURE
Este procedimiento finaliza la captura de carga de trabajo actual, para las solicitudes de captura de carga de trabajo posteriores en la base de datos y carga los archivos de captura en Object Storage. - Procedimiento PREPARE_REPLAY
El procedimientoPREPARE_REPLAY
prepara la clonación de refrescamiento para una reproducción. - Procedimiento PURGE_FLASHBACK_ARCHIVE
Este procedimiento permite a los usuarios ADMIN depurar datos históricos de Flashback Data Archive. Puede depurar todos los datos históricos de Flashback Data Archiveflashback_archive
o los datos selectivos basados en registros de hora o en el número de cambio del sistema. - Procedimiento REPLAY_WORKLOAD
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 servicio en la nube. - Procedimiento SET_FLASHBACK_ARCHIVE_RETENTION
Este procedimiento permite a los usuarios ADMIN modificar el período de retención para el archivo de datos de flashbackflashback_archive
. - Procedimiento START_WORKLOAD_CAPTURE
Este procedimiento inicia una captura de carga de trabajo en la instancia de Autonomous Database.
Tema principal: Paquete DBMS_CLOUD_ADMIN
Procedimiento ATTACH_FILE_SYSTEM
Este procedimiento adjunta un sistema de archivos en la base de datos.
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
parámetro | Descripción |
---|---|
|
Especifica el nombre del sistema de archivos. Este parámetro es obligatorio. |
|
Especifica la ubicación del sistema de archivos. El valor que proporciona con Por ejemplo:
Este parámetro es obligatorio. |
|
Especifica el nombre del directorio para el sistema de archivos asociado. El directorio debe existir. Este parámetro es obligatorio. |
|
(Opcional) Proporciona una descripción de la tarea. |
|
Cadena JSON que proporciona un parámetro adicional para el sistema de archivos.
|
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
enDBMS_CLOUD_ADMIN
. -
Debe tener el privilegio
WRITE
en el objeto de directorio de la base de datos para asociar un sistema de archivos medianteDBMS_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ámetroparams
connfs_version
establecido 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"
.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento CANCEL_WORKLOAD_CAPTURE
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 permite 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
enDBMS_CLOUD_ADMIN
.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento CREATE_DATABASE_LINK
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ámetrorac_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 |
---|---|
|
Nombre del enlace de base de datos que se va a crear. |
|
Nombre de host de la base de datos de destino. No se permite especificar Al especificar una conexión con conectividad heterogénea gestionada por Oracle proporcionando el parámetro
Utilice este parámetro o |
|
Especifica los nombres de host de 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 "
Cuando el destino es una base de datos Oracle RAC, utilice el parámetro Al especificar una lista de nombres de host en el parámetro Utilice este parámetro o No se permite especificar |
port |
Especifica el puerto para las conexiones a la base de datos de destino. Al especificar una conexión con conectividad heterogénea gestionada por Oracle mediante el parámetro
Consulte Tipos y puertos de base de datos de conectividad heterogénea gestionados por Oracle para obtener más información. |
|
Valor
Al especificar una conexión con conectividad heterogénea gestionada por Oracle mediante el parámetro |
ssl_server_cert_dn |
Valor de DN encontrado en el certificado del servidor. La conectividad heterogénea gestionada por Oracle viene preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y de raíz de confianza comunes. Enlace de punto final público a un destino de Autonomous Database sin una cartera: Para conectarse a un destino de Autonomous Database en un punto final público sin una cartera (TLS):
Enlace de punto final privado sin una cartera: Para conectarse a una instancia de Oracle Database en un punto final privado sin una cartera:
|
credential_name |
Nombre de una credencial almacenada creada con |
directory_name |
Directorio para el archivo La conectividad heterogénea gestionada por Oracle viene preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y de raíz de confianza comunes. El parámetro Enlace de punto final público a un destino de Autonomous Database sin una cartera: Para conectarse a una instancia de Autonomous Database en un punto final público sin una cartera (TLS):
Además, para conectarse a una instancia de Autonomous Database con TCP, el parámetro Enlace de punto final privado sin una cartera: Para conectarse a una instancia de Oracle Database de destino en un punto final privado sin una cartera:
|
gateway_link |
Indica si el enlace de base de datos se crea en otra instancia de Oracle Database o en una instancia de Oracle Database Gateway. Si Si Cuando El valor por defecto de este parámetro es |
public_link |
Indica si el enlace de base de datos se ha creado como un enlace de base de datos pública. Para ejecutar El valor por defecto de este parámetro es |
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 Cuando El valor por defecto de este parámetro es |
|
Especifique 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 de
Especifique el parámetro con el formato gateway_params => json_object('db_type' value 'awsredshift') Consulte Puertos y tipos de base de datos de conectividad heterogénea gestionada por Oracle para obtener los valores Cuando Cuando |
Notas de Uso
-
Al especificar el parámetro
gateway_params
, para algunos valoresdb_type
, se soportan parámetrosgateway_params
adicionales:db_type
Valores gateway_params
adicionalesgoogle_analytics
Cuando
db_type
esgoogle_analytics
, la credencial que especifique debe ser una credencial OAuth de Google (gcp_oauth2)
Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.google_bigquery
Cuando
db_type
esgoogle_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
esgoogle_bigquery
, el parámetroproject
es válido. Este parámetro especifica el nombre del proyecto paragoogle_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
hive
Cuando
db_type
eshive
, el parámetrohttp_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
essalesforce
, 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 valorsecurity_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
yfile_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
condb_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ámetrosdirectory_name
yfile_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ámetrosdirectory_name
,file_name
ytoken_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.
snowflake
Cuando
db_type
esSNOWFLAKE
, los parámetros:role
,schema
ywarehouse
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
yfile_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
condb_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 valoryoutube
y los parámetrosdirectory_name
yfile_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.
-
- Al conectarse a una base de datos no Oracle, el enlace de base de datos solo está soportado si se puede acceder a la base de datos de destino a través de una IP pública o un nombre de host público. Consulte Creación de enlaces de base de datos a bases de datos no Oracle para obtener más información.
-
Para ejecutar
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
con un usuario que no sea ADMIN, debe otorgar privilegiosEXECUTE
yCREATE DATABASE LINK
a ese usuario. Por ejemplo, ejecute el siguiente comando como ADMIN para otorgar privilegios aadb_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 esquemaadb_user
debe ser propietario de la credencial que utilice conDBMS_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 uncwallet.sso
a la vez en el directorio que seleccione para los archivos de cartera. Esto significa que concwallet.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 archivoscwallet.sso
con enlaces de base de datos, debe crear directorios adicionales y colocar cada archivocwallet.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
enFALSE
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
esTRUE
, el parámetrohostname
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 la 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;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
DETACH_FILE_SYSTEM Procedimiento
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 |
---|---|
|
Especifica el nombre del sistema de archivos. Este parámetro es obligatorio. |
Por 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
enDBMS_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 procedimientoDBMS_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.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
DISABLE_APP_CONT Procedimiento
Con este procedimiento se 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 |
---|---|
|
Valor Para buscar nombres de servicio:
|
Notas de Uso
Consulte Descripció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
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DISABLE_EXTERNAL_AUTHENTICATION
Deshabilita 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.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DISABLE_FEATURE
Con este procedimiento se 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 |
---|---|
|
Especifica el tipo de función que se va a desactivar. Los valores soportados son:
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
oWORKLOAD_AUTO_REPLAY
para la instancia de Autonomous Database, debe estar conectado como usuario ADMIN o tener el privilegioEXECUTE
enDBMS_CLOUD_ADMIN
. -
Cuando
AUTO_DST_UPGRADE
yAUTO_DST_UPGRADE_EXCL_DATA
están desactivados, si hay nuevas versiones de zona horaria disponibles, la instancia de Autonomous Database no se actualiza para utilizar los archivos de zona horaria más recientes disponibles. -
Consulte
dba_cloud_config
para verificar queAUTO_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 queAUTO_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.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DISABLE_OPERATOR_ACCESS
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;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DISABLE_PRINCIPAL_AUTH
Con este procedimiento se 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 |
---|---|
|
Especifica el tipo de proveedor. Valores válidos:
|
|
Especifique el usuario para el que desea desactivar la autenticación basada en principal. Un valor nulo es válido para |
Notas de Uso
-
Cuando el valor de Provider es
AZURE
y deusername
esADMIN
, con el procedimiento se desactivan la autenticación basada en entidad de servicio de Azure en Autonomous Database y se suprime la aplicación Azure en la instancia de Autonomous Database. -
Cuando el valor provider es
AZURE
yusername
es un usuario distinto deADMIN
, el procedimiento revoca los privilegios del usuario especificado. El usuarioADMIN
y otros usuarios que pueden utilizar la entidad de servicio de Azure pueden seguir utilizandoADMIN.AZURE$PA
y la aplicación creada 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;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DISABLE_RESOURCE_PRINCIPAL
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 |
---|---|
|
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 valor |
Excepciones
Excepción | Error | Descripción |
---|---|---|
resource principal is already disabled |
ORA-20031 |
Si intenta desactivar la entidad de recurso cuando ya está desactivado. |
Notas de Uso
-
La entidad de recurso no está disponible con clones de refrescamiento.
-
Para poder llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
, debe configurar un grupo dinámico y una política para el grupo dinámico.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:
-
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.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento DROP_DATABASE_LINK
Con este procedimiento se 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 |
---|---|
|
Nombre del enlace de base de datos que se va a borrar. |
|
Para ejecutar El valor por defecto de este parámetro es |
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
(
db_link_name => 'SALESLINK' );
END;
/
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, suprima 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 directoriodata_pump_dir
o del directorio definido por el usuario en el que se ha cargado el archivo de cartera.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_APP_CONT
Con este procedimiento se activa 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 |
---|---|
|
Valor Para buscar nombres de servicio:
|
Notas de Uso
Consulte Descripció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
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_AWS_ARN
Este procedimiento permite a una instancia de Autonomous Database utilizar 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 |
---|---|
|
Nombre del usuario que permite utilizar nombres de recursos de Amazon (ARN). Un valor nulo es válido para |
|
Cuando se proporciona |
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 Uso de nombres de recursos de Amazon (ARN) para acceder a los recursos de AWS para obtener más información.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_EXTERNAL_AUTHENTICATION
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 |
---|---|
|
Especifica el tipo de autenticación externa. Valores válidos: o .
|
|
(Opcional) Sustituya un esquema de autenticación externa activado actualmente. Los valores válidos son El valor por defecto es |
params |
Cadena JSON que proporciona parámetros adicionales para la autenticación externa. Parámetros
Parámetros de
Parámetros de
|
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 permite la entidad de recurso conDBMS_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
You pass in a directory name that contains Kerberos configuration files through params
JSON argument.
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;
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
ENABLE_FEATURE Procedimiento
Con este procedimiento se 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 |
---|---|
|
Nombre de la función que se va a activar. Los valores soportados son:
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:
Para la función
Por defecto, la captura de carga de trabajo se inicia al activar |
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
enDBMS_CLOUD_ADMIN
para ejecutarDBMS_CLOUD_ADMIN.ENABLE_FEATURE
. -
Después de ejecutar
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
con el valorfeature_name
'JAVAVM'
, debe reiniciar la instancia de Autonomous Database para instalar Oracle Java. -
Después de ejecutar
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
con el valorfeature_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
oWORKLOAD_AUTO_REPLAY
para la base de datos, debe estar conectado como usuario ADMIN o tener el privilegioEXECUTE
enDBMS_CLOUD_ADMIN
. -
Por defecto, tanto
AUTO_DST_UPGRADE
comoAUTO_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 archivos de zona horaria más recientes disponibles. Después de activarAUTO_DST_UPGRADE
, cuando hay nuevos archivos de zona horaria disponibles, la instancia continúa actualizándose 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 queAUTO_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 archivos de zona horaria más recientes 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 deAUTO_DST_UPGRADE_EXCL_DATA
no actualiza ninguna fila afectada).Consulte
dba_cloud_config
para verificar queAUTO_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
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_OPERATOR_ACCESS
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 |
---|---|
|
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 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 a ningún otro usuario. Todas las operaciones realizadas por el operador en la nube se almacenan en la vistaDBA_OPERATOR_ACCESS
. Consulte Visualización de acciones de operaciones de Oracle Cloud Infrastructure para obtener más información. -
Puede permitir que un operador en la nube acceda a los esquemas de base de datos mediante la ejecución del 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 de operador ejecutandoDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_PRINCIPAL_AUTH
Con este procedimiento se 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 |
---|---|
|
Especifica el tipo de proveedor. Valores válidos:
|
|
Nombre del usuario que tiene activado el uso de autenticación principal. Un valor nulo es válido para |
|
Especifica los parámetros de configuración. Cuando el parámetro
Cuando se especifica Cuando el parámetro
Cuando el parámetro
|
Notas de Uso
-
Cuando el parámetro
provider
esAZURE
, el parámetroparams
debe incluirazure_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 aDBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
con el parámetroprovider
AZURE
yusername
ADMIN
.
-
-
Cuando el parámetro
provider
esAWS
:-
Después de activar el ARN en la instancia de Autonomous Database mediante la ejecución de
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
, la credencial denominadaAWS$ARN
está disponible para su uso con cualquier API deDBMS_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;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento ENABLE_RESOURCE_PRINCIPAL
Active la credencial de entidad de recurso para la base de datos o para el esquema especificado. Con este procedimiento se 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 |
---|---|
|
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 |
|
Cuando se proporciona |
Excepciones
Excepción | Error | Descripción |
---|---|---|
resource principal is already enabled |
ORA-20031 |
Si intenta activar la principal de recurso cuando ya está activado. |
Notas de Uso
-
Debe llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
con el valor ADMIN parausername
o sin argumentos antes de llamar aDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
con un valorusername
para un esquema de usuario de base de datos. -
Para poder llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
, debe configurar un grupo dinámico y una política para el grupo dinámico.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 única. No es necesario volver a activar la entidad de recurso, a menos que ejecuteDBMS_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
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento FINISH_WORKLOAD_CAPTURE
Este procedimiento finaliza la captura de carga de trabajo actual, para las solicitudes de captura de carga de trabajo posteriores 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
enDBMS_CLOUD_ADMIN
. -
Al transferir el parámetro
duration
aSTART_WORKLOAD_CAPTURE
, la captura finaliza cuando alcanza la hora especificada. Sin embargo, si llama aFINISH_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.
Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information
para recibir una notificación sobre la finalización de FINISH_WORKLOAD_CAPTURE
y el 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 informativos en Autonomous Database para obtener más información.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento PREPARE_REPLAY
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 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
enDBMS_CLOUD_ADMIN
.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento PURGE_FLASHBACK_ARCHIVE
Este procedimiento permite a los usuarios ADMIN depurar datos históricos de Flashback Data Archive. Puede depurar todos los datos históricos de Flashback Data Archive flashback_archive
o los 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.
|
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 archivo de flashback. |
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento REPLAY_WORKLOAD
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 servicio 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 |
CAPTURE_SOURCE_TENANCY_OCID |
Especifica el OCID de arrendamiento de origen de la captura de carga de trabajo.
Si no proporciona un valor 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 de origen de la captura de carga de trabajo
Si no proporciona un valor 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 |
SYNCHRONIZATION |
Especifica el método de sincronización utilizado durante la reproducción de la carga de trabajo.
Si no proporciona un valor |
PROCESS_CAPTURE |
Especifica si necesita o no especificar el valor process_capture . Se puede definir en FALSE solo cuando se reproduce la misma carga de trabajo en la base de datos de destino varias veces.
Si no proporciona un valor |
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ámetroprocess_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 principal de recurso para acceder a los recursos de Oracle Cloud Infrastructure 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:
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 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
enDBMS_CLOUD_ADMIN
. -
Antes de iniciar la reproducción, debería cargar los subdirectorios
cap
ycapfiles
, 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
enDBMS_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.
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 informativos en Autonomous Database para obtener más información.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento SET_FLASHBACK_ARCHIVE_RETENTION
Este procedimiento permite a los usuarios ADMIN modificar el período de retención para el archivo de datos de flashback 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;
/
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas
Procedimiento START_WORKLOAD_CAPTURE
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.
|
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
enDBMS_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.
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 informativos en Autonomous Database para obtener más información.
Tema principal: Resumen de DBMS_CLOUD_ADMIN Subprogramas