Resumen de subprogramas de DBMS_CLOUD_ADMIN
En esta sección se tratan los subprogramas DBMS_CLOUD_ADMIN
proporcionados con Autonomous Database.
Subprograma | Descripción |
---|---|
Este procedimiento asocia un sistema de archivos en un directorio de la base de datos. |
|
Este procedimiento cancela la captura de carga de trabajo actual. |
|
Este procedimiento crea un enlace de base de datos a una base de datos destino. Hay opciones para crear un enlace de base de datos a otra instancia de Autonomous Database, a una instancia de Oracle Database que no sea una instancia de Autonomous Database o a una instancia que no sea de Oracle Database mediante conectividad heterogénea gestionada por Oracle. |
|
Este procedimiento separa un sistema de archivos de un directorio de la base de datos. |
|
Este procedimiento desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. |
|
Este procedimiento desactiva la autenticación externa para la instancia de Autonomous Database. |
|
Revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database Database. |
|
Este procedimiento revoca la autenticación basada en principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado. |
|
Este procedimiento desactiva las credenciales de la entidad de recurso para la base de datos o para el esquema especificado. Con un nombre de usuario especificado, que no sea ADMIN, el procedimiento revoca el acceso de esquema especificado a la credencial de entidad de recurso. |
|
Este procedimiento borra un enlace de base de datos. |
|
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. |
|
Este procedimiento permite a un usuario crear credenciales de AWS ARN en Autonomous Database. |
|
Este procedimiento permite a un usuario conectarse a Autonomous Database mediante el esquema de autenticación externa especificado. |
|
Este procedimiento activa la función especificada en la instancia de Autonomous Database. |
|
Otorga al operador en la nube acceso a una instancia de Autonomous Database durante un número especificado de horas. |
|
Este procedimiento activa la autenticación de principal para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado. |
|
Este procedimiento activa la credencial de principal de recurso y crea la credencial |
|
Este procedimiento para la captura de carga de trabajo y carga los archivos de captura en Object Storage. |
|
Este procedimiento prepara la reproducción para la clonación de refrescamiento. |
|
PURGE_FLASHBACK_ARCHIVE Procedimiento | Este procedimiento depura los datos históricos del archivo de datos de flashback. |
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 asocia un sistema de archivos en la base de datos. - CANCEL_WORKLOAD_CAPTURE Procedimiento
Este procedimiento cancela cualquier captura de carga de trabajo en curso en la base de datos. - CREATE_DATABASE_LINK Procedimiento
Este procedimiento crea un enlace de base de datos a una base de datos de destino en el esquema que llama a la API. - Procedimiento DETACH_FILE_SYSTEM
Este procedimiento separa un sistema de archivos de la base de datos. - DISABLE_APP_CONT Procedimiento
Este procedimiento desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. - DISABLE_EXTERNAL_AUTHENTICATION Procedimiento
Desactiva la autenticación de usuario con esquemas de autenticación externos para la base de datos. - DISABLE_FEATURE Procedimiento
Este procedimiento desactiva la función especificada en la instancia de Autonomous Database. - DISABLE_OPERATOR_ACCESS Procedimiento
Este procedimiento revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database. - DISABLE_PRINCIPAL_AUTH Procedimiento
Este procedimiento revoca la autenticación basada en principal para un proveedor especificado en Autonomous Database y se aplica al usuario ADMIN o al usuario especificado. - DISABLE_RESOURCE_PRINCIPAL Procedimiento
Desactive la credencial de principal de recurso para la base de datos o para el esquema especificado. - DROP_DATABASE_LINK Procedimiento
Este procedimiento borra un enlace de base de datos. - ENABLE_APP_CONT Procedimiento
Este procedimiento permite la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database. - ENABLE_AWS_ARN Procedimiento
Este procedimiento permite que una instancia de Autonomous Database utilice nombres de recursos (ARN) de Amazon para acceder a los recursos de AWS. - ENABLE_EXTERNAL_AUTHENTICATION Procedimiento
Permita a los usuarios conectarse a la base de datos con esquemas de autenticación externos. - ENABLE_FEATURE Procedimiento
Este procedimiento activa la función especificada en la instancia de Autonomous Database. - ENABLE_OPERATOR_ACCESS Procedimiento
Oracle Cloud Operations no accede a la instancia de Autonomous Database y el acceso no está permitido por defecto. Cuando se necesita acceso para solucionar o mitigar un problema, puede permitir que un operador de nube acceda a los esquemas de base de datos durante un tiempo limitado. - ENABLE_PRINCIPAL_AUTH Procedimiento
Este procedimiento permite la autenticación de principal en Autonomous Database para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado. - ENABLE_RESOURCE_PRINCIPAL Procedimiento
Active la credencial de principal de recurso para la base de datos o para el esquema especificado. Este procedimiento crea la credencialOCI$RESOURCE_PRINCIPAL
. - Procedimiento FINISH_WORKLOAD_CAPTURE
Este procedimiento finaliza la captura de carga de trabajo actual, para cualquier solicitud de captura de carga de trabajo posterior en la base de datos y carga los archivos de captura en Object Storage. - 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 de archivo de datos. Puede depurar todos los datos históricos del flashback de archivo de datosflashback_archive
o datos selectivos basados en registros de hora o en el número de cambio del sistema. - REPLAY_WORKLOAD Procedimiento
Este procedimiento inicia una reproducción de carga de trabajo en la instancia de Autonomous Database. El formulario sobrecargado permite reproducir los archivos de captura desde una instancia de Autonomous Database, una base de datos local u otras bases de datos de servicios en la nube. - Procedimiento SET_FLASHBACK_ARCHIVE_RETENTION
Este procedimiento permite a los usuarios ADMIN modificar el período de retención para el flashback de archivo de datosflashback_archive
. - START_WORKLOAD_CAPTURE Procedimiento
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 asocia un sistema de archivos en la base de datos.
El procedimiento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
asocia un sistema de archivos en la base de datos y almacena información sobre el sistema de archivos en la vista DBA_CLOUD_FILE_SYSTEMS
.
Sintaxis
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
(
file_system_name IN VARCHAR2,
file_system_location IN VARCHAR2,
directory_name IN VARCHAR2,
description IN VARCHAR2 DEFAULT NULL,
params IN CLOB DEFAULT NULL
);
Parámetros
Parámetro | Descripción |
---|---|
|
Especifica el nombre del sistema del archivo. Este parámetro es obligatorio. |
|
Especifica la ubicación del sistema del archivo. El valor que proporciona con Por ejemplo:
Este parámetro es obligatorio. |
|
Especifica el nombre del directorio para el sistema de archivos adjunto. 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:
Conecte a un sistema de archivos NFSv3:
BEGIN
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
(
file_system_name => 'FSS',
file_system_location => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
directory_name => 'FSS_DIR',
description => 'Source NFS for sales data'
);
END;
/
Conecte a un sistema de archivos NFSv4:
BEGIN
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
(
file_system_name => 'FSS',
file_system_location => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
directory_name => 'FSS_DIR',
description => 'Source NFS for sales data',
params => JSON_OBJECT('nfs_version' value 4)
);
END;
/
Notas de uso
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
enDBMS_CLOUD_ADMIN
. -
Debe tener el privilegio
WRITE
en el objeto de directorio de la base de datos para adjuntar 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
definido en 4). Esto asocia NFS con el protocolo coincidente para que Autonomous Database pueda acceder al servidor NFSv4. Sin desconectar y volver a conectar, no se podrá acceder al servidor NFS y es posible que aparezca un error como:"Protocol not supported"
.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
CANCEL_WORKLOAD_CAPTURE Procedimiento
Este procedimiento cancela cualquier captura de carga de trabajo en curso en la base de datos.
Sintaxis
Este procedimiento cancela la captura de carga de trabajo actual y activa el refrescamiento en la clonación de refrescamiento.
DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE
;
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE
;
END;
/
Nota de uso
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
enDBMS_CLOUD_ADMIN
.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
CREATE_DATABASE_LINK Procedimiento
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 de 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 mediante el suministro del parámetro
Utilice este parámetro o La entrada |
|
Especifica los nombres de host para la base de datos Oracle RAC de destino. El valor es una matriz de JSON que especifica uno o más nombres de host individuales para los nodos de la base de datos Oracle RAC de destino. Se pueden transferir varios nombres de host en JSON, separados por "
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 destino. Al especificar una conexión con una conectividad heterogénea gestionada por Oracle mediante el parámetro
Consulte Tipos y puertos de bases de datos de conectividad heterogénea gestionada por Oracle para obtener más información. |
|
Al especificar una conexión con una 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 está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. Enlace de punto final público a un destino de Autonomous Database sin cartera: Para conectarse a un destino de Autonomous Database en un punto final público sin cartera (TLS):
Enlace de punto final privado sin cartera: Para conectarse a una instancia de Oracle Database en un punto final privado sin cartera:
|
credential_name |
Nombre de una credencial almacenada creada con |
directory_name |
Directorio para el archivo La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. El parámetro Enlace de punto final público a un destino de Autonomous Database sin cartera: Para conectarse a una instancia de Autonomous Database en un punto final público sin cartera (TLS):
Además, para conectarse a una instancia de Autonomous Database con TCP, el parámetro Enlace de punto final privado sin cartera: Para conectarse a una instancia de Oracle Database de destino en un punto final privado sin cartera:
|
gateway_link |
Indica si el enlace de base de datos se ha creado a otra instancia de Oracle Database o a Oracle Database Gateway. Si 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 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 Cuando El valor predeterminado de este parámetro es |
|
Especifique el parámetro con el formulario Por ejemplo:
Consulte Puertos y tipos de base de datos de conectividad heterogénea gestionados por Oracle para obtener los valores Cuando Cuando
Para una base de datos en un punto final privado, el parámetro Por ejemplo:
|
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
adicionalesazure
Cuando el valor
db_type
esazure
, hay dos parámetros opcionales,auth_method
ydomain
para admitir la autenticación NTLM/AD.Cuando se configura NTLMv2, defina
auth_method=10
ydomain
en el valor de dominio de Windows.Para utilizar una contraseña de Azure Active Directory, defina
auth_method=13
. No utiliceauth_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
esgoogle_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
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
google_drive
Para
db_type
google_drive
, la credencial que proporcione conDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
debe ser una credencial de tipo OAuth con el parámetroparams
con los valoresgcp_oauth2
especificados (client_id
,client_secret
yrefresh_token
).Para conectarse a Google Drive y obtener datos, debe proporcionar los parámetros de gateway
directory_name
yfile_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
condb_type
google_drive
, debe proporcionar el parámetrogateway_params
db_type
con el valor'google_drive'
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. 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
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. Se necesita 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 Restablecer el token de seguridad para obtener más información.
servicenow
Para conectarse a ServiceNow y obtener datos, debe proporcionar los parámetros de gateway
directory_name
yfile_name
. Estos parámetros especifican un archivo de modelo (archivo de configuración de REST) que asigna la respuesta de JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información.Al utilizar el parámetro
gateway_params
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 proporcionar los parámetrosdirectory_name
yfile_name
junto con las credenciales de tipo de nombre de usuario/contraseña. -
Autenticación OAuth 2.0: debe proporcionar el parámetro
gateway_params
db_type
con el valor'servicenow'
y los pará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 de REST ServiceNow en el directorio especificado. Por ejemplo:
exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR');
Defina el valor
file_name
en el nombre del archivo de configuración de REST que ha descargado, "servicenow.rest
".A continuación, puede utilizar el archivo de configuración de REST ServiceNow con autenticación básica o OAuth2.0.
A continuación, puede utilizar el archivo de configuración de REST ServiceNow con autenticación básica o OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.
sharepoint
Al utilizar el parámetro
gateway_params
condb_type
sharepoint
, especifique también valores paraauth_uri
,scope
,service_url
ytoken_uri
.Para
db_type
sharepoint
, la credencial que proporcione conDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
debe ser una credencial de tipo OAuth con el parámetroparams
con los valoresgcp_oauth2
especificados (client_id
,client_secret
yrefresh_token
). Consulte CREATE_CREDENTIAL Procedure para obtener más información. Genere el valorrefresh_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
paradb_type
sharepoint
:-
auth_uri
: definaauth_uri
desde Azure. Consulte Obtención de información de cliente de aplicación y puntos finales para obtener más información. -
scope
: defina el ámbito. Consulte Descripciones de las opciones de conexión para obtener más información. -
service_url
: definaservice_url
. Consulte URL de servicio para obtener más información. -
token_uri
: obtengatoken_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
esSNOWFLAKE
, los parámetros opcionales:role
,schema
ywarehouse
son válidos. Estos valores especifican un esquema, rol o valor de almacén distinto del valor por defecto. Por ejemplo:gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
youtube
Para conectarse a Youtube y obtener datos, debe proporcionar los parámetros de gateway
directory_name
yfile_name
. Estos parámetros especifican un archivo de modelo (archivo de configuración de REST) que asigna la respuesta de JSON al modelo relacional. El archivo de modelo especifica los puntos finales, la asignación de tablas y el código de respuesta HTTP para procesar la respuesta JSON. Consulte Sintaxis de archivo de modelo y Archivo de modelo de ejemplo para obtener más información.Al utilizar el parámetro
gateway_params
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.Autenticación OAuth 2.0: 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 de REST ServiceNow en el directorio especificado. Por ejemplo:
exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR');
Defina el valor
file_name
en el nombre del archivo de configuración de REST que ha descargado, "youtube.rest
".A continuación, puede utilizar el archivo de configuración REST ServiceNow con OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obtener ejemplos.
-
-
Para ejecutar
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
con un usuario que no sea ADMIN, debe otorgar 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 poseer la credencial que utilice conDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
. -
Solo un archivo de cartera es válido por directorio especificado con el parámetro
directory_name
. Solo puede cargar uncwallet.sso
a la vez en el directorio que seleccione para los archivos de cartera. Esto significa que con uncwallet.sso
en un directorio, solo puede crear enlaces de base de datos a las bases de datos para las que la cartera de ese directorio es válida. Para utilizar varios archivoscwallet.sso
con enlaces de base de datos, debe crear directorios adicionales y colocar cadacwallet.sso
en un directorio diferente.Consulte Creación de directorio en Autonomous Database para obtener información sobre la creación de directorios.
-
Para crear un enlace de base de datos a una instancia de Autonomous Database, defina
GLOBAL_NAMES
enFALSE
en la base de datos de origen (que no sea Autonomous Database).SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE; System altered. SQL> SHOW PARAMETER GLOBAL_NAMES NAME TYPE VALUE ---------------------- ----------- ----------- global_names boolean FALSE
-
Cuando el parámetro
private_target
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 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 subprogramas DBMS_CLOUD_ADMIN
Procedimiento DETACH_FILE_SYSTEM
Este procedimiento separa un sistema de archivos de la base de datos.
El procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
separa un sistema de archivos de la base de datos. Además, el procedimiento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
también elimina la información sobre el sistema de archivos de la vista DBA_CLOUD_FILE_SYSTEMS
.
Sintaxis
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
(
file_system_name IN VARCHAR2
);
Parámetros
Parámetro | Descripción |
---|---|
|
Especifica el nombre del sistema del archivo. Este parámetro es obligatorio. |
Ejemplo:
BEGIN
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
(
file_system_name => 'FSS'
);
END;
/
Notas de uso
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
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 subprogramas DBMS_CLOUD_ADMIN
DISABLE_APP_CONT Procedimiento
Este procedimiento desactiva la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_APP_CONT
(
service_name IN VARCHAR2);
Parámetros
Parámetro | Descripción |
---|---|
|
Para buscar nombres de servicio:
|
Notas de uso
Consulte Visión general de la continuidad de aplicaciones para obtener más información sobre la continuidad de aplicaciones.
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_APP_CONT
(
service_name => 'nv123abc1_adb1_high.adb.oraclecloud.com' );
END;
/
Verifique el valor de la siguiente manera:
SELECT name, failover_type FROM DBA_SERVICES;
NAME FAILOVER_TYPE
------------------------------------------------------- --------------
nv123abc1_adb1_high.adb.oraclecloud.com
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
DISABLE_EXTERNAL_AUTHENTICATION Procedimiento
Desactiva la autenticación de usuario con esquemas de autenticación externos para la base de datos.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION
;
Excepciones
Excepción | Error | Descripción |
---|---|---|
invalid_ext_auth |
ORA-20004 |
Consulte el mensaje adjunto para obtener una explicación detallada. |
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION
;
END;
/
PL/SQL procedure successfully completed.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
DISABLE_FEATURE Procedimiento
Este procedimiento desactiva la función especificada en la instancia de Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_FEATURE
(
feature_name IN VARCHAR2);
Parámetros
Parámetro | Descripción |
---|---|
|
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 se desactivan
AUTO_DST_UPGRADE
yAUTO_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 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 subprogramas DBMS_CLOUD_ADMIN
DISABLE_OPERATOR_ACCESS Procedimiento
Este procedimiento revoca inmediatamente el acceso del operador en la nube en la instancia de Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS
;
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS
;
END;
/
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
DISABLE_PRINCIPAL_AUTH Procedimiento
Este procedimiento revoca la autenticación basada en principal para un proveedor especificado en Autonomous Database y se aplica al usuario ADMIN o al usuario especificado.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider IN VARCHAR2,
username IN VARCHAR2 DEFAULT 'ADMIN' );
Parámetros
Parámetro | Descripción |
---|---|
|
Especifica el tipo de proveedor. Valores válidos:
|
|
Especificar el usuario para el que desactivar la autenticación basada en principal. Un valor nulo es válido para |
Notas de uso
-
Cuando el valor del proveedor es
AZURE
yusername
esADMIN
, el procedimiento desactiva la autenticación basada en el principal de servicio de Azure en Autonomous Database y suprime la aplicación de Azure en la instancia de Autonomous Database. -
Cuando el valor del proveedor es
AZURE
yusername
es un usuario distinto del usuarioADMIN
, el procedimiento revoca los privilegios del usuario especificado. El usuarioADMIN
y otros usuarios que están activados para utilizar el principal de servicio de Azure pueden seguir utilizandoADMIN.AZURE$PA
y la aplicación que se crea para la instancia de Autonomous Database permanece en la instancia.
Ejemplos
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider => 'AZURE',
username => 'SCOTT');
END;
/
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider => 'GCP');
END;
/
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
DISABLE_RESOURCE_PRINCIPAL Procedimiento
Desactive la credencial de entidad de recurso para la base de datos o para el esquema especificado.
Sintaxis
DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL
(
username IN VARCHAR2);
Parámetro
Parámetro | Descripción |
---|---|
|
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 |
Excepciones
Excepción | Error | Descripción |
---|---|---|
resource principal is already disabled |
ORA-20031 |
Si intenta desactivar la entidad de recurso cuando ya está desactivada. |
Notas de uso
-
El principal de recurso no está disponible con clonaciones de refrescamiento.
-
Debe configurar un grupo dinámico y políticas para el grupo dinámico antes de llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
.Consulte lo siguiente para obtener más información sobre la creación de políticas, la creación de un grupo dinámico y la creación de reglas:
-
Verifique que una credencial de entidad de recurso está activada consultando una de las vistas: DBA_CREDENTIALS o ALL_TAB_PRIVS.
Por ejemplo, cuando el usuario ADMIN consulta la vista
DBA_CREDENTIALS
:SELECT owner, credential_name FROM dba_credentials WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN'; OWNER CREDENTIAL_NAME ----- ---------------------- ADMIN OCI$RESOURCE_PRINCIPAL
Por ejemplo, como usuario no ADMIN, consulte la vista
ALL_TAB_PRIVS
:SELECT grantee, table_name, grantor, FROM ALL_TAB_PRIVS WHERE grantee = 'ADB_USER'; GRANTEE TABLE_NAME GRANTOR --------- ------------------------------------- ADB_USER OCI$RESOURCE_PRINCIPAL ADMIN
Ejemplo
EXEC DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL
();
PL/SQL procedure successfully completed.
SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL';
No rows selected.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
DROP_DATABASE_LINK Procedimiento
Este procedimiento borra un enlace de base de datos.
Sintaxis
DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
(
db_link_name IN VARCHAR2,
public_link IN BOOLEAN DEFAULT);
Parámetros
Parámetro | Descripción |
---|---|
|
Nombre de enlace de base de datos que se va a borrar. |
|
Para ejecutar El valor por defecto de este parámetro es |
Ejemplos
BEGIN
DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
(
db_link_name => 'SALESLINK' );
END;
/
BEGIN
DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
(
db_link_name => 'SALESLINK'
public_link => TRUE );
END;
/
Notas de uso
Una vez que haya terminado de utilizar un enlace de base de datos y haya ejecutado DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
, para garantizar la seguridad de la base de datos Oracle, elimine los archivos de cartera almacenados. Por ejemplo:
-
Elimine el archivo de cartera del almacén de objetos.
-
Utilice
DBMS_CLOUD.DELETE_FILE
para eliminar el archivo de cartera del directoriodata_pump_dir
o del directorio definido por el usuario en el que se ha cargado el archivo de cartera.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
ENABLE_APP_CONT Procedimiento
Este procedimiento permite la continuidad de la aplicación de base de datos para la sesión asociada al nombre de servicio especificado en Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_APP_CONT
(
service_name IN VARCHAR2);
Parámetros
Parámetro | Descripción |
---|---|
|
Para buscar nombres de servicio:
|
Notas de uso
Consulte Visión general de la continuidad de aplicaciones para obtener más información sobre la continuidad de aplicaciones.
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_APP_CONT
(
service_name => 'nvthp2ht_adb1_high.adb.oraclecloud.com'
);
END;
/
Verifique el valor de la siguiente manera:
SELECT name, failover_type FROM DBA_SERVICES;
NAME FAILOVER_TYPE
------------------------------------------------------- -------------
nvthp2ht_adb1_high.adb.oraclecloud.com TRANSACTION
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
ENABLE_AWS_ARN Procedimiento
Este procedimiento permite que una instancia de Autonomous Database utilice nombres de recursos de Amazon (ARN) para acceder a los recursos de AWS.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN
(
username IN VARCHAR2 DEFAULT NULL,
grant_option IN BOOLEAN DEFAULT FALSE);
Parámetros
Parámetro | Descripción |
---|---|
|
Nombre del usuario que se va a activar para utilizar los 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 Use Amazon Resource Names (ARNs) to Access AWS Resources para obtener más información.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
ENABLE_EXTERNAL_AUTHENTICATION Procedimiento
Permite a los usuarios conectarse a la base de datos con esquemas de autenticación externos.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE,
params IN CLOB DEFAULT NULL
);
Parámetro
Parámetro | Descripción |
---|---|
|
Especifica el tipo de autenticación externa. Valores válidos: o .
|
|
(Opcional) Sustituir 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
Parámetros
|
Excepciones
Excepción | Error | Descripción |
---|---|---|
invalid_ext_auth |
ORA-20004 |
Consulte el mensaje adjunto para obtener una explicación detallada. |
Notas de uso
-
Con
type
OCI_IAM
, si la entidad de recurso no está activada en la instancia de Autonomous Database, esta rutina activa la entidad de recurso conDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
. -
Este procedimiento define los parámetros del sistema
IDENTITY_PROVIDER_TYPE
yIDENTITY_PROVIDER_CONFIG
para que los usuarios necesarios accedan a la instancia con la autenticación y autorización de Oracle Cloud Infrastructure Identity and Access Management.
Ejemplos
Activar autenticación OCI_IAM
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'OCI_IAM',
force=> TRUE );
END;
/
PL/SQL procedure successfully completed.
Activar autenticación CMU
para Microsoft Active Directory
Transfiere un nombre de directorio que contiene los archivos de configuración de CMU mediante el argumento JSON params
.
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'CMU',
force => TRUE,
params => JSON_OBJECT('directory_name' value 'CMU_DIR'); // CMU_DIR directory object already exists
END;
/
PL/SQL procedure successfully completed.
Puede transferir un URI de ubicación que apunte a una ubicación de Object Storage que contenga archivos de configuración de CMU mediante el argumento JSON params
.
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'CMU',
params => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
'credential_name' value 'my_credential_name')
);
END;
/
PL/SQL procedure successfully completed.
Activar autenticación de Azure AD
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'AZURE_AD',
force => TRUE,
params => JSON_OBJECT( 'tenant_id' VALUE '....',
'application_id' VALUE '...',
'application_id_uri' VALUE '.....' ));
END;
/
PL/SQL procedure successfully completed.
Activar Autenticación de Kerberos
Transfiere un nombre de directorio que contiene archivos de configuración de Kerberos mediante el argumento JSON params
.
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'KERBEROS',
force => TRUE,
params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR'); // KERBEROS_DIR directory object already exists
END;
/
PL/SQL procedure successfully completed.
Transfiere un URI de ubicación que apunta a una ubicación de Object Storage que contiene archivos de configuración de Kerberos mediante el argumento JSON params
:
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'KERBEROS',
force => TRUE,
params => JSON_OBJECT('location_uri' value 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
'credential_name' value 'my_credential_name');
END;
/
Transfiere un nombre de servicio con kerberos_service_name
en el argumento JSON params
:
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'KERBEROS',
force => TRUE,
params => JSON_OBJECT('directory_name' value 'KERBEROS_DIR', // KERBEROS_DIR directory object already exists
'kerberos_service_name' value 'oracle' ));
END;
/
Una vez que Kerberos esté activado en la instancia de Autonomous Database, utilice la siguiente consulta para ver el nombre del servicio Kerberos:
SELECT SYS_CONTEXT('USERENV','KERBEROS_SERVICE_NAME') FROM DUAL;
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
ENABLE_FEATURE Procedimiento
Este procedimiento activa la función especificada en la instancia de Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name IN VARCHAR2,
params IN CLOB DEFAULT NULL);
Parámetros
Parámetro | Descripción |
---|---|
|
Nombre de la función que desea activar. Los valores admitidos 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 de activación de la función JAVAVM:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'JAVAVM' );
END;
/
Ejemplo para habilitar la función de horario de ahorro de energía automático:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'AUTO_DST_UPGRADE' );
END;
/
Ejemplo para habilitar la función de datos Auto DST EXCL:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA' );
END;
/
Ejemplo para activar la función OraMTS:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'ORAMTS',
params => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
);
END;
/
Ejemplo para activar la función OWM:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'OWM' );
END;
/
Ejemplo para activar la función de reproducción automática de carga de trabajo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'WORKLOAD_AUTO_REPLAY',
params => JSON_OBJECT('target_db_ocid' VALUE 'OCID1.autonomousdatabase.REGION..ID1', 'capture_duration' VALUE 120, 'capture_day' VALUE 'MONDAY', 'capture_time' VALUE '15:00'));
END;
/
Un valor de error de ORA-20000: Invalid argument for target_db_ocid
podría indicar que el OCID que ha proporcionado no es una clonación de refrescamiento. En este caso, debe proporcionar un OCID con un valor para una clonación de refrescamiento.
Notas de uso
-
Debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
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 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 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 desactivados. Puede activar una u otra de estas opciones, pero no ambas. -
Después de activar
AUTO_DST_UPGRADE
, la próxima vez que reinicie o pare y, a continuación, inicie la instancia de Autonomous Database, la instancia se actualiza para utilizar los últimos archivos de zona horaria disponibles. Después de activarAUTO_DST_UPGRADE
, cuando haya nuevos archivos de zona horaria disponibles, la instancia seguirá actualizando a la última versión disponible cada reinicio o parada e inicio posteriores, hasta que se desactive la función.Consulte
dba_cloud_config
para verificar 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 últimos archivos de zona horaria disponibles. Después de activar esta función, cada ventana de mantenimiento posterior actualiza la instancia para utilizar la última versión de zona horaria disponible. Esta función garantiza que los archivos de zona horaria se actualicen para la base de datos (la activación 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 subprogramas DBMS_CLOUD_ADMIN
ENABLE_OPERATOR_ACCESS Procedimiento
Oracle Cloud Operations no accede a la instancia de Autonomous Database y el acceso no está permitido por defecto. Cuando se necesita acceso para solucionar o mitigar un problema, puede permitir que un operador de nube acceda a los esquemas de base de datos durante un tiempo limitado.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
(
auth_duration IN NUMBER DEFAULT 1
);
Parámetros
Parámetro | Descripción |
---|---|
|
Especifica el número de horas para las que se otorga acceso al operador en la nube. Valores válidos: deben ser números enteros en el rango de 1 a 24. Valor por defecto: 1 |
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
(
auth_duration => 12 );
END;
/
Notas de uso
-
ORA-20000: Operator access is already enabled
indica que ya se ha otorgado el acceso de operador. En este caso, tiene dos opciones:-
Espere a que caduque el acceso del operador y, a continuación, vuelva a otorgar el acceso del operador con
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
- Desactive explícitamente el acceso del operador con el procedimiento DISABLE_OPERATOR_ACCESS.
-
-
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
solo permite el acceso al operador en la nube y no permite el acceso a ningún otro usuario. Todas las operaciones realizadas por el operador en la nube se almacenan en la vistaDBA_OPERATOR_ACCESS
. Consulte Visualización de acciones de operaciones de Oracle Cloud Infrastructure para obtener más información. -
Para permitir que un operador en la nube acceda a los esquemas de base de datos, ejecute el procedimiento
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
. Esto significa que si archiva una solicitud de servicio con Oracle Cloud Support y los operadores de Oracle Cloud necesitan acceder a los esquemas de base de datos, también debe activar el acceso del operador ejecutandoDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
ENABLE_PRINCIPAL_AUTH Procedimiento
Este procedimiento permite la autenticación de principal en Autonomous Database para el proveedor especificado y se aplica al usuario ADMIN o al usuario especificado.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
(
provider IN VARCHAR2,
username IN VARCHAR2 DEFAULT 'ADMIN',
params IN CLOB DEFAULT NULL);
Parámetros
Parámetro | Descripción |
---|---|
|
Especifica el tipo de proveedor. Valores válidos:
|
|
Nombre del usuario que tiene activado el uso de autenticación de principal. Un valor nulo es válido para |
|
Especifica los parámetros de configuración. Cuando el parámetro
Cuando se especifican 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 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 APIDBMS_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 subprogramas DBMS_CLOUD_ADMIN
ENABLE_RESOURCE_PRINCIPAL Procedimiento
Active la credencial de entidad de recurso para la base de datos o para el esquema especificado. Este procedimiento crea la credencial OCI$RESOURCE_PRINCIPAL
.
Sintaxis
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
(
username IN VARCHAR2,
grant_option IN BOOLEAN DEFAULT FALSE);
Parámetro
Parámetro | Descripción |
---|---|
|
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 entidad de recurso cuando ya está activada. |
Notas de uso
-
Debe llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
con el administradorusername
o sin argumentos antes de llamar aDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
con unusername
para un esquema de usuario de base de datos. -
Debe configurar un grupo dinámico y políticas para el grupo dinámico antes de llamar a
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
.Consulte lo siguiente para obtener más información sobre las políticas, la creación de un grupo dinámico y la creación de reglas:
-
La activación de la entidad de recurso con
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
es una operación puntual. No es necesario volver a activar la entidad de recurso, a menos que ejecuteDBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL
para desactivar la entidad de recurso. -
El principal de recurso no está disponible con clonaciones de refrescamiento.
Ejemplo
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
();
PL/SQL procedure successfully completed.
SQL> select owner, credential_name from dba_credentials where credential_name = 'OCI$RESOURCE_PRINCIPAL';
OWNER CREDENTIAL_NAME
------- ---------------
ADMIN OCI$RESOURCE_PRINCIPAL
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
FINISH_WORKLOAD_CAPTURE Procedimiento
Este procedimiento finaliza la captura de carga de trabajo actual, para cualquier solicitud de captura de carga de trabajo posterior en la base de datos y carga los archivos de captura en Object Storage.
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE
END;
/
Notas de uso
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
enDBMS_CLOUD_ADMIN
. -
Al transferir el parámetro
duration
aSTART_WORKLOAD_CAPTURE
, la captura termina cuando alcanza la hora especificada. Sin embargo, si llama aFINISH_WORKLOAD_CAPTURE
, esto para la captura de carga de trabajo (posiblemente antes de la hora especificada con el parámetro de duración).Puede consultar la vista
DBA_CAPTURE_REPLAY_STATUS
para comprobar el estado de la carga de trabajo de finalización. Consulte DBA_CAPTURE_REPLAY_STATUS View para obtener más información.
Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information
para que se le notifique la finalización de FINISH_WORKLOAD_CAPTURE
, así como al enlace de Object Storage para descargar el archivo de captura. Esta URL de PAR está incluida en el campo captureDownloadURL
del evento y es válida durante 7 días a partir de la fecha de generación. Consulte Eventos de información en Autonomous Database para obtener más información.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
PREPARE_REPLAY Procedimiento
El procedimiento PREPARE_REPLAY
prepara la clonación de refrescamiento para una reproducción.
Parámetros
Parámetro | Descripción |
---|---|
capture_name |
Especifica el nombre de la captura de carga de trabajo.
Este parámetro es obligatorio. |
Sintaxis
DBMS_CLOUD_ADMIN.PREPARE_REPLAY
(
capture_name IN VARCHAR2);
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.PREPARE_REPLAY
capture_name => 'cap_test1');
END;
/
En este ejemplo, se prepara la clonación de refrescamiento para reproducir la carga de trabajo indicada por el parámetro capture_name
, que implica llevarla a la hora de inicio de la captura y, a continuación, desconectarla.
Nota de uso
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
enDBMS_CLOUD_ADMIN
.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
PURGE_FLASHBACK_ARCHIVE Procedimiento
Este procedimiento permite a los usuarios ADMIN depurar datos históricos desde el flashback de archivo de datos. Puede depurar todos los datos históricos del flashback de archivo de datos flashback_archive
o datos selectivos basados en registros de hora o en el número de cambio del sistema.
Sintaxis
DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE
(
scope IN VARCHAR2,
before_scn IN INTEGER DEFAULT NULL,
before_ts IN TIMESTAMP DEFAULT NULL);
Parámetro | Descripción |
---|---|
scope |
Especifica el ámbito para eliminar datos del flashback de archivo de datos.
|
before_scn |
Especifica el número de cambio del sistema antes del cual se eliminan todos los datos del flashback de archivo. |
before_timestamp |
Especifica el registro de hora antes del cual se eliminan todos los datos del flashback de archivo. |
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
REPLAY_WORKLOAD Procedimiento
Este procedimiento inicia una reproducción de carga de trabajo en la instancia de Autonomous Database. El formulario sobrecargado permite reproducir los archivos de captura desde una instancia de Autonomous Database, una base de datos local u otras bases de datos de servicios en la nube.
Sintaxis
DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD
(
capture_name IN VARCHAR2,
replay_name IN VARCHAR2 DEFAULT NULL,
capture_source_tenancy_ocid IN VARCHAR2 DEFAULT NULL,
capture_source_db_name IN VARCHAR2 DEFAULT NULL);
DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD
(
location_uri IN VARCHAR2,
credential_name IN VARCHAR2 DEFAULT NULL,
synchronization IN BOOLEAN DEFAULT TRUE,
process_capture IN BOOLEAN DEFAULT TRUE);
Parámetros
Parámetro | Descripción |
---|---|
CAPTURE_NAME |
Especifica el nombre de la captura de carga de trabajo.
Este parámetro es obligatorio. |
REPLAY_NAME |
Especifica el nombre de la reproducción.
Si no proporciona un valor |
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 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 debe especificar o no el valor process_capture . Se puede definir en FALSE solo cuando reproduzca la misma carga de trabajo en la base de datos destino repetidamente.
Si no proporciona un valor |
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
. -
Reproduce la carga de trabajo capturada en función del valor del parámetro
synchronization
.
En este ejemplo, namespace-string
es el espacio Oracle Cloud Infrastructure Object Storage Namepace, y bucketname
es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.
Consulte Navegación a Oracle Cloud Infrastructure Object Storage y creación de un cubo para obtener más información sobre Object Storage.
Consulte Carga de archivos en el cubo de almacenamiento de objetos de Oracle Cloud Infrastructure para obtener más información sobre la carga de archivos en Object Storage.
credential_name
que utiliza en este paso son las credenciales para el almacén de objetos.
No es necesario que cree una credencial para acceder al almacén de objetos de Oracle Cloud Infrastructure si activa las credenciales de entidad de recurso. Consulte Uso de la entidad de recurso para acceder a recursos de Oracle Cloud Infrastructure para obtener más información.
Ejemplo para reproducir la carga de trabajo de una instancia de Autonomous Database en otra instancia de Autonomous Database:
BEGIN
DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD
(
capture_name => 'CAP_TEST1');
END;
/
Al ejecutar este ejemplo:
-
Desconecta la instancia de Autonomous Database actual.
-
Descarga los archivos de captura de Object Storage.
-
Reproduce la carga de trabajo capturada.
-
Carga el informe de reproducción después de una reproducción.
Notas de uso para reproducir la carga de trabajo desde una base de datos local u otra base de datos de Cloud Service en otra instancia de Autonomous Database
-
Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN o tener el privilegio
EXECUTE
enDBMS_CLOUD_ADMIN
. -
Antes de empezar a reproducir, debe 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 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 de información en Autonomous Database para obtener más información.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
SET_FLASHBACK_ARCHIVE_RETENTION Procedimiento
Este procedimiento permite a los usuarios ADMIN modificar el período de retención para el flashback de archivo de datos flashback_archive
.
Sintaxis
DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION
(
retention_days INTEGER);
Parámetro | Descripción |
---|---|
retention_days |
Especifica el tiempo en días durante el que se deben conservar los datos archivados. El valor de retention_days debe ser mayor que 0.
|
Ejemplo
BEGIN
DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION
(
retention_days => 90); // sets the retention time to 90 days
END;
/
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN
START_WORKLOAD_CAPTURE Procedimiento
Este procedimiento inicia una captura de carga de trabajo en la instancia de Autonomous Database.
Sintaxis
DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE
(
capture_name IN VARCHAR2,
duration IN NUMBER DEFAULT NULL);
Parámetros
Parámetro | Descripción |
---|---|
capture_name |
Especifica el nombre de la captura de carga de trabajo.
Este parámetro es obligatorio. |
duration |
Especifica la duración en minutos para la que desea ejecutar la captura de carga de trabajo.
|
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 el impacto de un cambio del sistema en una carga de trabajo, debe asegurarse de que los sistemas de captura y reproducción estén en el mismo estado lógico.
-
Antes de iniciar una captura de carga de trabajo, debe considerar el aprovisionamiento de una clonación de refrescamiento para garantizar el mismo punto de inicio para la reproducción.
Debe suscribirse al evento de información com.oraclecloud.databaseservice.autonomous.database.information
para recibir una notificación al inicio de START_WORKLOAD_CAPTURE
. Consulte Eventos de información en Autonomous Database para obtener más información.
Tema principal: Resumen de subprogramas DBMS_CLOUD_ADMIN