Resumo dos Subprogramas DBMS_CLOUD_ADMIN
Esta seção abrange os subprogramas DBMS_CLOUD_ADMIN
fornecidos com o Autonomous Database.
Subprograma | Descrição |
---|---|
Este procedimento anexa um sistema de arquivos em um diretório do banco de dados. |
|
Este procedimento cancela a captura da carga de trabalho atual. |
|
Este procedimento cria um link de banco de dados para um banco de dados de destino. There are options to create a database link to another Autonomous Database instance, to an Oracle Database that is not an Autonomous Database, or to a non-Oracle Database using Oracle-managed heterogeneous connectivity. |
|
Este procedimento desanexa um sistema de arquivos de um diretório no banco de dados. |
|
Este procedimento desativa a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database. |
|
Este procedimento desativa a autenticação externa da instância do Autonomous Database. |
|
Revoga imediatamente o acesso do Operador da Nuvem na instância do Autonomous Database Database. |
|
Este procedimento revoga a autenticação baseada em principal para o provedor especificado e se aplica ao usuário ADMIN ou ao usuário especificado. |
|
Este procedimento desativa as credenciais do controlador de recursos para o banco de dados ou para o esquema especificado. Com um nome de usuário especificado, diferente de ADMIN, o procedimento revoga o acesso ao esquema especificado à credencial do controlador de recursos. |
|
Este procedimento elimina um link de banco de dados. |
|
Este procedimento permite a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database. |
|
Este procedimento permite que um usuário crie credenciais do AWS ARN no Autonomous Database. |
|
Este procedimento permite que um usuário faça log-on no Autonomous Database usando o esquema de autenticação externa especificado. |
|
Este procedimento ativa o recurso especificado na instância do Autonomous Database. |
|
Concede ao Operador de Nuvem acesso a uma instância do Autonomous Database por um número especificado de horas. |
|
Este procedimento ativa a autenticação principal para o provedor especificado e se aplica ao usuário ADMIN ou ao usuário especificado. |
|
Este procedimento ativa a credencial do controlador de recursos e cria a credencial |
|
Este procedimento interrompe a captura da carga de trabalho e faz upload dos arquivos de captura para o armazenamento de objetos. |
|
Este procedimento prepara a repetição para o clone atualizável. |
|
PURGE_FLASHBACK_ARCHIVE Procedimento | Este procedimento limpa dados históricos do Flashback Data Archive. |
Este procedimento é sobrecarregado. Inicia a repetição da carga de trabalho. | |
Este procedimento permite que os usuários ADMIN modifiquem o período de retenção do Flashback Time Travel flashback_archive .
|
|
Este procedimento inicia uma captura de carga de trabalho. |
- ATTACH_FILE_SYSTEM Procedimento
Esse procedimento anexa um sistema de arquivos no banco de dados. - CANCEL_WORKLOAD_CAPTURE Procedimento
Este procedimento cancela qualquer captura de carga de trabalho contínua no banco de dados. - CREATE_DATABASE_LINK Procedimento
Esse procedimento cria um link de banco de dados para um banco de dados de destino no esquema que chama a API. - DETACH_FILE_SYSTEM Procedimento
Este procedimento desanexa um sistema de arquivos do banco de dados. - DISABLE_APP_CONT Procedimento
Este procedimento desativa a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database. - DISABLE_EXTERNAL_AUTHENTICATION Procedimento
Desativa a autenticação do usuário com esquemas de autenticação externos para o banco de dados. - Procedimento DISABLE_FEATURE
Este procedimento desativa o recurso especificado na instância do Autonomous Database. - DISABLE_OPERATOR_ACCESS Procedimento
Este procedimento revoga imediatamente o acesso do Operador de Nuvem na instância do Autonomous Database. - DISABLE_PRINCIPAL_AUTH Procedimento
Esse procedimento revoga a autenticação baseada em principal para um provedor especificado no Autonomous Database e se aplica ao usuário ADMIN ou ao usuário especificado. - DISABLE_RESOURCE_PRINCIPAL Procedimento
Desative a credencial do controlador de recursos para o banco de dados ou para o esquema especificado. - DROP_DATABASE_LINK Procedimento
Este procedimento elimina um link de banco de dados. - ENABLE_APP_CONT Procedimento
Esse procedimento permite a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database. - Procedimento ENABLE_AWS_ARN
Esse procedimento permite que uma instância do Autonomous Database use ADNs (Amazon Resource Names) para acessar recursos da AWS. - ENABLE_EXTERNAL_AUTHENTICATION Procedimento
Permita que os usuários façam log-in no banco de dados com esquemas de autenticação externos. - ENABLE_FEATURE Procedimento
Esse procedimento ativa o recurso especificado na instância do Autonomous Database. - Procedimento ENABLE_OPERATOR_ACCESS
O Oracle Cloud Operations não acessa sua instância do Autonomous Database e o acesso é proibido por padrão. Quando o acesso for necessário para solucionar ou mitigar um problema, você poderá permitir que um operador de nuvem acesse os esquemas de banco de dados por um tempo limitado. - ENABLE_PRINCIPAL_AUTH Procedimento
Esse procedimento permite a autenticação do principal no Autonomous Database para o provedor especificado e se aplica ao usuário ADMIN ou ao usuário especificado. - Procedimento ENABLE_RESOURCE_PRINCIPAL
Ative a credencial do controlador de recursos para o banco de dados ou para o esquema especificado. Este procedimento cria a credencialOCI$RESOURCE_PRINCIPAL
. - FINISH_WORKLOAD_CAPTURE Procedimento
Este procedimento conclui a captura da carga de trabalho atual, interrompe todas as solicitações de captura de carga de trabalho subsequentes para o banco de dados e faz upload dos arquivos de captura para o Object Storage. - PREPARE_REPLAY Procedimento
O procedimentoPREPARE_REPLAY
prepara o clone atualizável para uma repetição. - PURGE_FLASHBACK_ARCHIVE Procedimento
Este procedimento permite que os usuários ADMIN expurguem dados históricos do Flashback Data Archive. Você pode expurgar todos os dados históricos do Flashback Data Archiveflashback_archive
ou dados seletivos com base em timestamps ou Número de Alteração do Sistema. - REPLAY_WORKLOAD Procedimento
Este procedimento inicia uma repetição de carga de trabalho na sua instância do Autonomous Database. O formulário sobrecarregado permite que você reproduza os arquivos de captura de uma instância do Autonomous Database, banco de dados on-premises ou outros bancos de dados de serviço de nuvem. - SET_FLASHBACK_ARCHIVE_RETENTION Procedimento
Este procedimento permite que os usuários ADMIN modifiquem o período de retenção do Flashback Data Archiveflashback_archive
. - START_WORKLOAD_CAPTURE Procedimento
Este procedimento inicia uma captura de carga de trabalho na sua instância do Autonomous Database.
Tópico principal: Pacote DBMS_CLOUD_ADMIN
Procedimento ATTACH_FILE_SYSTEM
Este procedimento anexa um sistema de arquivos no banco de dados.
O procedimento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
anexa um sistema de arquivos em seu banco de dados e armazena informações sobre o sistema de arquivos na exibição DBA_CLOUD_FILE_SYSTEMS
.
Sintaxe
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 | Descrição |
---|---|
|
Especifica o nome do sistema de arquivos. Este parâmetro é obrigatório. |
|
Especifica o local do sistema de arquivos. O valor fornecido com Por exemplo:
Este parâmetro é obrigatório. |
|
Especifica o nome do diretório do sistema de arquivos anexado. O diretório deve existir. Este parâmetro é obrigatório. |
|
(Opcional) Fornece uma descrição da tarefa. |
|
Uma string JSON que fornece um parâmetro adicional para o sistema de arquivos.
|
Exemplos:
Anexe a um sistema de arquivos 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;
/
Anexe a um sistema de arquivos 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;
/
Observações de Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Você deve ter o privilégio
WRITE
no objeto de diretório no banco de dados para anexar um sistema de arquivos usandoDBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
. -
O procedimento
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
só pode anexar um File Storage Service privado em bancos de dados com Pontos Finais Privados ativados.Consulte Serviço OCI File Storage e Configurar Acesso à Rede com Pontos Finais Privados para obter mais informações.
-
O procedimento
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
procura o nome do host do Sistema de Arquivos de Rede na rede virtual na nuvem (VCN) do cliente. O erro"ORA-20000: Mounting NFS fails"
será retornado se o nome do host especificado no local não puder ser localizado. -
O Oracle Cloud Infrastructure File Storage usa NFSv3 para compartilhar
-
Se você anexar a sistemas que não sejam do Oracle Cloud Infrastructure File Storage, o procedimento suportará NFSv3 e NFSv4
-
Se você tiver um servidor NFS anexado que use NFSv3 e a versão do NFS for atualizada para NFSv4 no servidor NFS, execute
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
e, em seguida,DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM
(usando o parâmetroparams
comnfs_version
definido como 4). Isso anexa o NFS ao protocolo correspondente para que o Autonomous Database possa acessar o Servidor NFSv4. Sem desanexar e depois reanexar, o servidor NFS ficará inacessível e você poderá ver um erro como:"Protocol not supported"
.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
CANCEL_WORKLOAD_CAPTURE Procedimento
Este procedimento cancela qualquer captura de carga de trabalho contínua no banco de dados.
Sintaxe
Este procedimento cancela a captura da carga de trabalho atual e ativa a atualização no clone atualizável.
DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE
;
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE
;
END;
/
Observação do Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
CREATE_DATABASE_LINK Procedimento
Os formulários sobrecarregados suportam o seguinte:
-
Quando você usa o parâmetro
gateway_params
, isso permite criar um link de banco de dados com conectividade heterogênea gerenciada pela Oracle em que o link se encontra com um banco de dados não Oracle suportado. -
Quando você usa o parâmetro
rac_hostnames
, isso permite criar um link de banco de dados de um Autonomous Database em um ponto final privado para um banco de dados Oracle RAC de destino. Nesse caso, você usa o parâmetrorac_hostnames
para especificar os nomes de host de um ou mais nós individuais do banco de dados Oracle RAC de destino.
Sintaxe
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 | Descrição |
---|---|
|
O nome do link do banco de dados a ser criado. |
|
O nome de host do banco de dados de destino. A especificação de Quando você especifica uma conexão com a conectividade heterogênea gerenciada pela Oracle fornecendo o parâmetro
Use esse parâmetro ou A entrada |
|
Especifica os nomes de host do banco de dados Oracle RAC de destino. O valor é um array JSON que especifica um ou mais nomes de host individuais para os nós do banco de dados Oracle RAC de destino. Vários nomes de host podem ser especificados no JSON, separados por um "
Quando o destino for um banco de dados Oracle RAC, use o parâmetro Quando você especifica uma lista de nomes de host no parâmetro Use esse parâmetro ou Não é permitido especificar |
port |
Especifica a porta das conexões com o banco de dados de destino. Quando você especificar uma conexão com conectividade heterogênea gerenciada pelo sistema Oracle usando o parâmetro
Consulte Tipos e Portas de Banco de Dados de Conectividade Heterogênea Gerenciada pela Oracle para obter mais informações. |
|
O
Quando você especifica uma conexão com a conectividade heterogênea gerenciada pela Oracle usando o parâmetro |
ssl_server_cert_dn |
O valor DN encontrado no certificado do servidor. A conectividade heterogênea gerenciada pela Oracle é pré-configurada com uma wallet que contém a maioria dos certificados SSL raiz e intermediários confiáveis comuns. O Link de Ponto Final Público para um Destino do Autonomous Database sem uma Wallet: Para estabelecer conexão com um destino do Autonomous Database em um ponto final público sem uma wallet (TLS):
Link de Ponto Final Privado sem uma Wallet: Para estabelecer conexão com um Oracle Database em um ponto final privado sem uma wallet:
|
credential_name |
O nome de uma credencial armazenada criada com |
directory_name |
O diretório do arquivo A conectividade heterogênea gerenciada pela Oracle é pré-configurada com uma wallet que contém a maioria dos certificados SSL raiz e intermediários confiáveis comuns. O parâmetro Link de Ponto Final Público para um Destino do Autonomous Database sem uma Wallet: Para estabelecer conexão com um Autonomous Database em um ponto final público sem uma wallet (TLS):
Além disso, para estabelecer conexão com um Autonomous Database com TCP, o parâmetro Link de Ponto Final Privado sem uma Wallet: Para estabelecer conexão com um Oracle Database de destino em um ponto final privado sem uma wallet:
|
gateway_link |
Indica se o link do banco de dados é criado para outro Oracle Database ou para um Oracle Database Gateway. Se Se Quando O valor padrão para este parâmetro é |
public_link |
Indica se o link de banco de dados é criado como um link de banco de dados público. Para executar O valor padrão para esse parâmetro é |
private_target |
Quando um link de banco de dados acessar um nome de host que precisa ser resolvido em um servidor DNS da VCN, especifique o parâmetro Quando Quando O valor padrão para esse parâmetro é |
|
Especifique o parâmetro com o form Por exemplo:
Consulte Tipos e Portas de Banco de Dados de Conectividade Heterogênea Gerenciada pela Oracle para obter os valores Quando Quando
Para um banco de dados em um ponto final privado, o parâmetro Por exemplo:
|
Observações de Uso
-
Quando você especifica o parâmetro
gateway_params
, para alguns valoresdb_type
, são suportados parâmetrosgateway_params
adicionais:db_type
Valores Adicionais gateway_params
azure
Quando o valor
db_type
éazure
, há dois parâmetros opcionais,auth_method
edomain
para suportar a autenticação NTLM/AD.Quando NTLMv2 estiver configurado, defina
auth_method=10
edomain
como o valor de domínio do Windows.Para usar uma senha do Azure Active Directory, defina
auth_method=13
. Não useauth_method=13
para acessar um Banco de Dados Oracle on-premises.Consulte Método de Autenticação do Microsoft SQL Server para obter mais informações.
google_analytics
Quando
db_type
forgoogle_analytics
, a credencial especificada deverá ser uma credencial OAuth do Google (gcp_oauth2
). Consulte CREATE_CREDENTIAL Procedures para obter mais informações.google_bigquery
Quando o
db_type
forgoogle_bigquery
, a credencial especificada deverá ser uma credencial OAuth do Google (gcp_oauth2)
Consulte Procedimento CREATE_CREDENTIAL para obter mais informações.Quando
db_type
égoogle_bigquery
, o parâmetroproject
é válido. Este parâmetro especifica o nome do projeto paragoogle_bigquery
e é obrigatório.O nome da tabela especificado quando você usa
SELECT
com o Google BigQuery deve estar entre aspas. Por exemplo:SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
google_drive
Para
db_type
google_drive
, a credencial fornecida comDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
deve ser um tipo de credencial OAuth usando o parâmetroparams
com valores degcp_oauth2
especificados (client_id
,client_secret
erefresh_token
).Para se conectar ao Google Drive e obter dados, você deve fornecer os parâmetros de gateway
directory_name
efile_name
. Esses parâmetros especificam um arquivo de modelo (arquivo REST automático) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações.Ao usar o parâmetro
gateway_params
comdb_type
google_drive
, você deve fornecer o parâmetrogateway_params
db_type
com o valor'google_drive'
e os parâmetrosdirectory_name
efile_name
, juntamente com as credenciais do tipo OAuth:O parâmetro
directory_name
especifica o diretório com o arquivo de configuração REST. Você poderia criar esse diretório da seguinte forma:create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR';
Obtenha e faça download do arquivo REST automático para o diretório especificado. Por exemplo:
exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR');
Defina o valor
file_name
como o nome do arquivo REST automático que você baixou, "google_drive.rest
". Em seguida, você pode usar o arquivo de configuração REST com o OAuth 2.0.hive
Quando
db_type
éhive
, o parâmetrohttp_path
é válido. Esse parâmetro especifica o valor HttpPath, se necessário, para estabelecer conexão com a instância do Hive.salesforce
Quando o
db_type
ésalesforce
, o parâmetro:security_token
é válido. Um token de segurança é um código alfanumérico que faz distinção entre maiúsculas e minúsculas. É necessário fornecer um valorsecurity_token
para acessar o Salesforce. Por exemplo:gateway_params => JSON_OBJECT( 'db_type' value 'salesforce', 'security_token' value 'security_token_value' )
Consulte Redefinir Seu Token de Segurança para obter mais informações.
servicenow
Para se conectar a ServiceNow e obter dados, você deve fornecer os parâmetros de gateway
directory_name
efile_name
. Esses parâmetros especificam um arquivo de modelo (arquivo de configuração REST) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações.Quando você usa o parâmetro
gateway_params
com o parâmetrodb_type
servicenow
, há duas opções suportadas:-
Autenticação Básica: você deve fornecer o parâmetro
gateway_params
db_type
com o valor'servicenow'
e fornecer os parâmetrosdirectory_name
efile_name
juntamente com as credenciais do tipo de nome de usuário/senha. -
Autenticação OAuth 2.0: você deve fornecer o parâmetro
gateway_params
db_type
com o valor'servicenow'
e os parâmetrosdirectory_name
,file_name
etoken_uri
, juntamente com as credenciais do tipo OAuth.
O parâmetro
directory_name
especifica o diretório com o arquivo de configuração REST ServiceNow. Você poderia criar esse diretório da seguinte forma:create or replace directory servicenow_dir as 'SERVICENOW_DIR';
Obtenha e faça download do arquivo de configuração REST ServiceNow para o diretório especificado. Por exemplo:
exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR');
Defina o valor
file_name
como o nome do arquivo de configuração REST que você baixou, "servicenow.rest
".Em seguida, você pode usar o arquivo de configuração REST ServiceNow com autenticação básica ou OAuth2.0.
Em seguida, você pode usar o arquivo de configuração REST ServiceNow com autenticação básica ou OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obter amostras.
sharepoint
Ao usar o parâmetro
gateway_params
comdb_type
sharepoint
, também especifique valores paraauth_uri
,scope
,service_url
etoken_uri
.Para
db_type
sharepoint
, a credencial fornecida comDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
deve ser um tipo de credencial OAuth usando o parâmetroparams
com valores degcp_oauth2
especificados (client_id
,client_secret
erefresh_token
). Consulte CREATE_CREDENTIAL Procedures para obter mais informações. Gere orefresh_token
para tenant_id.sharepoint.com/.default
offline_access. Consulte o seguinte para obter mais informações: Determinar o escopo e Autenticação OAuth 2.0.Defina valores para
gateway_params
paradb_type
sharepoint
:-
auth_uri
: Defina oauth_uri
do Azure. Consulte Obter informações e pontos finais do cliente do aplicativo para obter mais informações. -
scope
: Defina o escopo. Consulte Descrições da opção de conexão para obter mais informações. -
service_url
: Defina oservice_url
. Consulte URL do Serviço para obter mais informações. -
token_uri
: Obtenha atoken_uri
do Azure. Consulte Obter informações e pontos finais do cliente do aplicativo para obter mais informações.
snowflake
Quando a
db_type
éSNOWFLAKE
, os parâmetros opcionais:role
,schema
ewarehouse
são válidos. Esses valores especificam um esquema, atribuição ou valor de depósito diferente do padrão. Por exemplo:gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
youtube
Para se conectar ao Youtube e obter dados, você deve fornecer os parâmetros de gateway
directory_name
efile_name
. Esses parâmetros especificam um arquivo de modelo (arquivo de configuração REST) que mapeia a resposta JSON para o modelo relacional. O arquivo de modelo especifica os pontos finais, o mapeamento de tabela e o código de resposta HTTP para processar a resposta JSON. Consulte Sintaxe de arquivo de modelo e Arquivo de modelo de exemplo para obter mais informações.Quando você usa o parâmetro
gateway_params
comdb_type
youtube
, a credencial especificada deve ser uma credencial OAuth do Google (gcp_oauth2
). Consulte Procedimento CREATE_CREDENTIAL para obter mais informações.Autenticação OAuth 2.0: você deve fornecer o parâmetro
gateway_params
db_type
com o valoryoutube
, os parâmetrosdirectory_name
efile_name
, juntamente com as credenciais do tipo OAuth.O parâmetro
directory_name
especifica o diretório com o arquivo de configuração REST ServiceNow. Você poderia criar esse diretório da seguinte forma:create or replace directory youtube_dir as 'YOUTUBE_DIR';
Obtenha e faça download do arquivo de configuração REST ServiceNow para o diretório especificado. Por exemplo:
exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR');
Defina o valor
file_name
como o nome do arquivo de configuração REST que você baixou, "youtube.rest
".Em seguida, você pode usar o arquivo de configuração REST ServiceNow com o OAuth2.0. Consulte HETEROGENEOUS_CONNECTIVITY_INFO View para obter amostras.
-
-
Para executar o
DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
com um usuário diferente de ADMIN, você precisa conceder os privilégiosEXECUTE
eCREATE DATABASE LINK
a esse usuário. Por exemplo, execute o seguinte comando como ADMIN para conceder privilégios para oadb_user
:GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO adb_user; GRANT CREATE DATABASE LINK TO adb_user;
Além disso, quando você cria um Link de Banco de Dados em um esquema diferente do esquema ADMIN, por exemplo, em um esquema chamado
adb_user
, o esquemaadb_user
deve possuir a credencial usada comDBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK
. -
Somente um arquivo de wallet é válido por diretório especificado com o parâmetro
directory_name
. Você só pode fazer upload de umcwallet.sso
por vez para o diretório escolhido para arquivos da wallet. Isso significa que, com umcwallet.sso
em um diretório, você só pode criar links de banco de dados para os bancos de dados para os quais a wallet nesse diretório é válida. Para usar vários arquivoscwallet.sso
com links de banco de dados, você precisa criar diretórios adicionais e colocar cadacwallet.sso
em um diretório diferente.Consulte Criar Diretório no Autonomous Database para obter informações sobre como criar diretórios.
-
Para criar um link de banco de dados para um Autonomous Database, defina
GLOBAL_NAMES
comoFALSE
no banco de dados de origem (não Autonomous Database).SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE; System altered. SQL> SHOW PARAMETER GLOBAL_NAMES NAME TYPE VALUE ---------------------- ----------- ----------- global_names boolean FALSE
-
Quando o parâmetro
private_target
éTRUE
, o parâmetrohostname
especifica um host privado dentro da VCN.
Exemplos
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;
/
O nome da tabela que você especifica ao usar SELECT
com o Google BigQuery ou o Google Analytics deve estar entre aspas. Por exemplo:
SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
Use o parâmetro rac_hostnames
com um banco de dados Oracle RAC de destino em um ponto 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;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
Procedimento DETACH_FILE_SYSTEM
Este procedimento desanexa um sistema de arquivos do banco de dados.
O procedimento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
desanexa um sistema de arquivos do banco de dados. Além disso, o procedimento DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
também remove as informações sobre o sistema de arquivos da exibição DBA_CLOUD_FILE_SYSTEMS
.
Sintaxe
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
(
file_system_name IN VARCHAR2
);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Especifica o nome do sistema de arquivos. Este parâmetro é obrigatório. |
Exemplo:
BEGIN
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
(
file_system_name => 'FSS'
);
END;
/
Observações de Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Você deve ter o privilégio
WRITE
no objeto de diretório no banco de dados para desanexar um sistema de arquivos de um diretório usando o procedimentoDBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
. -
O procedimento
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
só pode desanexar um File Storage Service privado em bancos de dados com Pontos Finais Privados ativados.Consulte Serviço OCI File Storage e Configurar Acesso à Rede com Pontos Finais Privados para obter mais informações.
-
O procedimento
DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM
procura o nome do host do Sistema de Arquivos de Rede na rede virtual na nuvem (VCN) do cliente. O erro"ORA-20000: Mounting NFS fails"
será retornado se o nome do host especificado no local não puder ser localizado.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DISABLE_APP_CONT Procedimento
Este procedimento desativa a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_APP_CONT
(
service_name IN VARCHAR2);
Parâmetros
Parâmetro | Descrição |
---|---|
|
O Para localizar nomes de serviço:
|
Observações de Uso
Consulte Visão Geral da Continuidade de Aplicativos para obter mais informações sobre a Continuidade de Aplicativos.
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_APP_CONT
(
service_name => 'nv123abc1_adb1_high.adb.oraclecloud.com' );
END;
/
Verifique o valor da seguinte forma:
SELECT name, failover_type FROM DBA_SERVICES;
NAME FAILOVER_TYPE
------------------------------------------------------- --------------
nv123abc1_adb1_high.adb.oraclecloud.com
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
Procedimento DISABLE_EXTERNAL_AUTHENTICATION
Desativa a autenticação do usuário com esquemas de autenticação externos para o banco de dados.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION
;
Exceções
Exceção | Erro | Descrição |
---|---|---|
invalid_ext_auth |
ORA-20004 |
Consulte a mensagem de acompanhamento para obter uma explicação detalhada. |
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION
;
END;
/
PL/SQL procedure successfully completed.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DISABLE_FEATURE Procedimento
Este procedimento desativa o recurso especificado na instância do Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_FEATURE
(
feature_name IN VARCHAR2);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Especifica o tipo de recurso a ser desabilitado. Os valores suportados são:
Este parâmetro é obrigatório. |
Exemplos
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;
/
Observações de Uso
-
Para desativar os recursos
OraMTS
,AUTO_DST_UPGRADE
,AUTO_DST_UPGRADE_EXCL_DATA
,OWM
ouWORKLOAD_AUTO_REPLAY
da sua instância do Autonomous Database, você deverá estar conectado como usuário ADMIN ou ter o privilégioEXECUTE
emDBMS_CLOUD_ADMIN
. -
Quando
AUTO_DST_UPGRADE
eAUTO_DST_UPGRADE_EXCL_DATA
são desativados, se novas versões de fuso horário estiverem disponíveis, a instância do Autonomous Database não fará upgrade para usar os arquivos de fuso horário mais recentes disponíveis. -
Consulte
dba_cloud_config
para verificar se oAUTO_DST_UPGRADE
está desativado.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 se oAUTO_DST_UPGRADE_EXCL_DATA
está desativado.SELECT param_name, param_value FROM dba_cloud_config WHERE LOWER(param_name) = 'auto_dst_upgrade_excl_data'; 0 rows selected.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DISABLE_OPERATOR_ACCESS Procedimento
Este procedimento revoga imediatamente o acesso do Operador da Nuvem na instância do Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS
;
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS
;
END;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DISABLE_PRINCIPAL_AUTH Procedimento
Este procedimento revoga a autenticação baseada em principal para um provedor especificado no Autonomous Database e se aplica ao usuário ADMIN ou ao usuário especificado.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider IN VARCHAR2,
username IN VARCHAR2 DEFAULT 'ADMIN' );
Parâmetros
Parâmetro | Descrição |
---|---|
|
Especifica o tipo de provedor. Valores válidos:
|
|
Especificador para o qual o usuário deve desativar a autenticação baseada em principal. Um valor nulo é válido para o |
Observações de Uso
-
Quando o valor do provedor é
AZURE
e ousername
éADMIN
, o procedimento desativa a autenticação baseada no controlador de serviços do Azure no Autonomous Database e exclui o aplicativo Azure na instância do Autonomous Database. -
Quando o valor do provedor for
AZURE
e ousername
for um usuário diferente do usuárioADMIN
, o procedimento revogará os privilégios do usuário especificado. O usuárioADMIN
e outros usuários que estão ativados para usar o controlador de serviços do Azure podem continuar a usarADMIN.AZURE$PA
e o aplicativo criado para a instância do Autonomous Database permanece na instância.
Exemplos
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider => 'AZURE',
username => 'SCOTT');
END;
/
BEGIN
DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
(
provider => 'GCP');
END;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DISABLE_RESOURCE_PRINCIPAL Procedimento
Desative a credencial do controlador de recursos para o banco de dados ou para o esquema especificado.
Sintaxe
DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL
(
username IN VARCHAR2);
Parâmetro
Parâmetro | Descrição |
---|---|
|
Especifica um nome de usuário opcional. O nome do esquema do banco de dados para remover o acesso do controlador de recursos. Se você não fornecer uma |
Exceções
Exceção | Erro | Descrição |
---|---|---|
resource principal is already disabled |
ORA-20031 |
Se você tentar desativar o controlador de recursos quando ele já estiver desativado. |
Observações de Uso
-
O controlador de recursos não está disponível com clones atualizáveis.
-
Você deve configurar um grupo dinâmico e políticas para o grupo dinâmico antes de chamar
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
.Consulte o seguinte para obter mais informações sobre como criar políticas, criar um grupo dinâmico e criar regras:
-
Verifique se uma credencial do controlador de recursos está ativada consultando uma das views: DBA_CREDENTIALS ou ALL_TAB_PRIVS.
Por exemplo, como o usuário ADMIN consulta a view
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 exemplo, como um usuário não ADMIN, consulte a view
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
Exemplo
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.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
DROP_DATABASE_LINK Procedimento
Este procedimento elimina um link de banco de dados.
Sintaxe
DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
(
db_link_name IN VARCHAR2,
public_link IN BOOLEAN DEFAULT);
Parâmetros
Parâmetro | Descrição |
---|---|
|
O nome do link do banco de dados a ser eliminado. |
|
Para executar o O valor padrão para esse parâmetro é |
Exemplos
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;
/
Observações de Uso
Depois de terminar de usar um link de banco de dados e executar DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK
, para garantir a segurança do seu banco de dados Oracle, remova todos os arquivos da wallet armazenados. Por exemplo:
-
Remova o arquivo da wallet no Object Store.
-
Use
DBMS_CLOUD.DELETE_FILE
para remover o arquivo da wallet do diretóriodata_pump_dir
ou do diretório definido pelo usuário no qual foi feito upload do arquivo da wallet.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_APP_CONT Procedimento
Este procedimento permite a continuidade do aplicativo de banco de dados para a sessão associada ao nome de serviço especificado no Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_APP_CONT
(
service_name IN VARCHAR2);
Parâmetros
Parâmetro | Descrição |
---|---|
|
O Para localizar nomes de serviço:
|
Observações de Uso
Consulte Visão Geral da Continuidade de Aplicativos para obter mais informações sobre a Continuidade de Aplicativos.
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_APP_CONT
(
service_name => 'nvthp2ht_adb1_high.adb.oraclecloud.com'
);
END;
/
Verifique o valor da seguinte forma:
SELECT name, failover_type FROM DBA_SERVICES;
NAME FAILOVER_TYPE
------------------------------------------------------- -------------
nvthp2ht_adb1_high.adb.oraclecloud.com TRANSACTION
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_AWS_ARN Procedimento
Esse procedimento permite que uma instância do Autonomous Database use ADNs (Amazon Resource Names) para acessar os recursos da AWS.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN
(
username IN VARCHAR2 DEFAULT NULL,
grant_option IN BOOLEAN DEFAULT FALSE);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Nome do usuário para ativar o uso de ADNs (Amazon Resource Names). Um valor nulo é válido para o |
|
Quando |
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN
(
username => 'adb_user');
END;
/
Observação do Uso
-
Você deve ser o usuário ADMIN para executar o procedimento
DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN
.
Consulte Usar ADNs (Amazon Resource Names) para Acessar Recursos do AWS para obter mais informações.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
Procedimento ENABLE_EXTERNAL_AUTHENTICATION
Permite que os usuários façam log-in no banco de dados com esquemas de autenticação externos.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE,
params IN CLOB DEFAULT NULL
);
Parâmetro
Parâmetro | Descrição |
---|---|
|
Especifica o tipo de autenticação externa. Valores válidos: ou .
|
|
(Opcional) Substitua um esquema de autenticação externa ativado no momento. Os valores válidos são O valor padrão é |
params |
Uma string JSON que fornece parâmetros adicionais para a autenticação externa. Parâmetros
Parâmetros
Parâmetros
|
Exceções
Exceção | Erro | Descrição |
---|---|---|
invalid_ext_auth |
ORA-20004 |
Consulte a mensagem de acompanhamento para obter uma explicação detalhada. |
Observações de Uso
-
Com
type
OCI_IAM
, se o controlador de recursos não estiver ativado na instância do Autonomous Database, essa rotina ativará o controlador de recursos comDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
. -
Este procedimento define os parâmetros do sistema
IDENTITY_PROVIDER_TYPE
eIDENTITY_PROVIDER_CONFIG
para que os usuários necessários acessem a instância com autenticação e autorização do Oracle Cloud Infrastructure Identity and Access Management.
Exemplos
Ativar Autenticação OCI_IAM
BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION
(
type => 'OCI_IAM',
force=> TRUE );
END;
/
PL/SQL procedure successfully completed.
Ativar Autenticação CMU
para o Microsoft Active Directory
Informe um nome de diretório que contenha os arquivos de configuração de CMU por meio do 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.
Você informa um URI de local que aponta para um local do serviço Object Storage que contém arquivos de configuração de CMU por meio do 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.
Ativar Autenticação do 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.
Ativar Autenticação Kerberos
Informe um nome de diretório que contenha arquivos de configuração do Kerberos por meio do 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.
Você informa um URI de local que aponta para um local do serviço Object Storage que contém arquivos de configuração do Kerberos por meio do 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;
/
Você informa um nome de serviço com o kerberos_service_name
no 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;
/
Após a ativação do Kerberos em sua instância do Autonomous Database, use a seguinte consulta para exibir o nome do serviço Kerberos:
SELECT SYS_CONTEXT('USERENV','KERBEROS_SERVICE_NAME') FROM DUAL;
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_FEATURE Procedimento
Este procedimento ativa o recurso especificado na instância do Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name IN VARCHAR2,
params IN CLOB DEFAULT NULL);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Nome do recurso a ser ativado. Os valores compatíveis são:
Este parâmetro é obrigatório. |
params |
Uma string JSON que fornece parâmetros adicionais para alguns recursos. Para o recurso
OraMTS , o parâmetro params é:
Para o recurso
Por padrão, a captura da carga de trabalho começa quando você ativa o |
Exemplo para Ativar o Recurso JAVAVM:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'JAVAVM' );
END;
/
Exemplo para habilitar o recurso DST automático:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'AUTO_DST_UPGRADE' );
END;
/
Exemplo para Ativar o Recurso de Dados DST EXCL Automático:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'AUTO_DST_UPGRADE_EXCL_DATA' );
END;
/
Exemplo para Ativar o Recurso OraMTS:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'ORAMTS',
params => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
);
END;
/
Exemplo para Ativar o Recurso OWM:
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
(
feature_name => 'OWM' );
END;
/
Exemplo para Ativar o Recurso de Repetição Automática da Carga de Trabalho
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;
/
Um valor de erro ORA-20000: Invalid argument for target_db_ocid
pode indicar que o OCID fornecido não é um clone atualizável. Nesse caso, você precisa fornecer um OCID com um valor para um clone atualizável.
Observações de Uso
-
Você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
para executarDBMS_CLOUD_ADMIN.ENABLE_FEATURE
. -
Depois de executar o
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
com o valorfeature_name
'JAVAVM'
, reinicie a instância do Autonomous Database para instalar o Oracle Java.Depois que você reiniciar a instância do Autonomous Database, a instalação do Java continuará por algum tempo após a abertura do banco de dados.
Consulte Verificar a Versão do Oracle Java para obter detalhes sobre como verificar o status da instalação do Java.
-
Depois de executar
DBMS_CLOUD_ADMIN.ENABLE_FEATURE
com o valorfeature_name
'OWM'
, reinicie a instância do Autonomous Database para ativar o Oracle Workspace Manager. Oracle. -
Para ativar os recursos
AUTO_DST_UPGRADE
,AUTO_DST_UPGRADE_EXCL_DATA
,ORAMTS
,JAVAVM
,OWM
ouWORKLOAD_AUTO_REPLAY
para seu banco de dados, você deve estar conectado como usuário ADMIN ou ter o privilégioEXECUTE
emDBMS_CLOUD_ADMIN
. -
Por padrão,
AUTO_DST_UPGRADE
eAUTO_DST_UPGRADE_EXCL_DATA
são desativados. É possível ativar uma ou outra dessas opções, mas não ambas. -
Depois de ativar o
AUTO_DST_UPGRADE
, na próxima vez que você reiniciar ou interromper e, em seguida, iniciar a instância do Autonomous Database, a instância fará upgrade para usar os arquivos de fuso horário mais recentes disponíveis. Após a ativação doAUTO_DST_UPGRADE
, quando novos arquivos de fuso horário estiverem disponíveis, a instância continuará a fazer upgrade para a versão mais recente disponível a cada reinicialização ou interrupção e inicialização subsequentes, até que o recurso seja desativado.Consulte
dba_cloud_config
para verificar se oAUTO_DST_UPGRADE
está ativado.SELECT param_name, param_value FROM dba_cloud_config WHERE LOWER(param_name) = 'auto_dst_upgrade'; PARAM_NAME PARAM_VALUE ---------------- -------------- auto_dst_upgrade enabled
-
Depois de ativar o
AUTO_DST_UPGRADE_EXCL_DATA
, a instância do Autonomous Database fará upgrade para usar os arquivos de fuso horário mais recentes disponíveis. Depois que esse recurso for ativado, cada janela de manutenção subsequente fará upgrade da instância para usar a versão mais recente do fuso horário disponível. Esse recurso garante que os arquivos de fuso horário sejam atualizados para o banco de dados (a ativação doAUTO_DST_UPGRADE_EXCL_DATA
não atualiza nenhuma linha afetada).Consulte
dba_cloud_config
para verificar se oAUTO_DST_UPGRADE_EXCL_DATA
está ativado.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
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_OPERATOR_ACCESS Procedimento
O Oracle Cloud Operations não acessa sua instância de Autonomous Database e o acesso é proibido por padrão. Quando o acesso for necessário para solucionar ou mitigar um problema, você poderá permitir que um operador de nuvem acesse os esquemas de banco de dados por um tempo limitado.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
(
auth_duration IN NUMBER DEFAULT 1
);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Especifica o número de Horas para as quais o Operador de Nuvem recebe acesso. Valores válidos: devem ser números inteiros na faixa de 1 a 24. Valor padrão: 1 |
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
(
auth_duration => 12 );
END;
/
Observações de Uso
-
ORA-20000: Operator access is already enabled
indica que o acesso do operador já foi concedido. Nesse caso, você tem duas opções:-
Aguarde a expiração do acesso do operador e, em seguida, conceda acesso ao operador novamente com
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
- Desative explicitamente o acesso do operador com o DISABLE_OPERATOR_ACCESS Procedure.
-
-
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
permite o acesso somente ao Operador de Nuvem e não permite o acesso para nenhum outro usuário. Todas as operações executadas pelo Operador da Nuvem são armazenadas na viewDBA_OPERATOR_ACCESS
. Consulte Exibir Ações de Operações do Oracle Cloud Infrastructure para obter mais informações. -
Você permite que um operador de nuvem acesse os esquemas de banco de dados executando o procedimento
DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
. Isso significa que, se você registrar uma solicitação de serviço no Suporte do Oracle Cloud e os Operadores do Oracle Cloud precisarem acessar seus esquemas de banco de dados, também será necessário ativar o acesso do operador executandoDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS
.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_PRINCIPAL_AUTH Procedimento
Este procedimento permite a autenticação do principal no Autonomous Database para o provedor especificado e se aplica ao usuário ADMIN ou ao usuário especificado.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
(
provider IN VARCHAR2,
username IN VARCHAR2 DEFAULT 'ADMIN',
params IN CLOB DEFAULT NULL);
Parâmetros
Parâmetro | Descrição |
---|---|
|
Especifica o tipo de provedor. Valores válidos:
|
|
Nome do usuário que tem o uso de autenticação principal ativado. Um valor nulo é válido para o |
|
Especifica os parâmetros de configuração. Quando o parâmetro
Quando Quando o parâmetro
Quando o parâmetro
|
Observações de Uso
-
Quando o parâmetro
provider
forAZURE
, o parâmetroparams
deverá incluir oazure_tenantid
nos seguintes casos:-
Quando
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
é chamado pela primeira vez. -
Quando
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
é chamado pela primeira vez depois queDBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH
é chamado com o parâmetroprovider
AZURE
e ousername
ADMIN
.
-
-
Quando o parâmetro
provider
éAWS
:-
Depois que você ativar o ARN na instância do Autonomous Database executando
DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH
, a credencial chamadaAWS$ARN
estará disponível para uso com qualquer APIDBMS_CLOUD
que obtenha uma credencial como entrada.
-
Exemplos
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;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
ENABLE_RESOURCE_PRINCIPAL Procedimento
Ative a credencial do controlador de recursos para o banco de dados ou para o esquema especificado. Este procedimento cria a credencial OCI$RESOURCE_PRINCIPAL
.
Sintaxe
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
(
username IN VARCHAR2,
grant_option IN BOOLEAN DEFAULT FALSE);
Parâmetro
Parâmetro | Descrição |
---|---|
|
Especifica um nome de usuário opcional. O nome do esquema de banco de dados ao qual será concedido acesso do controlador de recursos. Se você não fornecer uma |
|
Quando |
Exceções
Exceção | Erro | Descrição |
---|---|---|
resource principal is already enabled |
ORA-20031 |
Se você tentar ativar o controlador de recursos quando ele já estiver ativado. |
Observações de Uso
-
Chame
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
com o ADMINusername
ou sem argumentos antes de chamarDBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
com umusername
para um esquema de usuário do banco de dados. -
Você deve configurar um grupo dinâmico e políticas para o grupo dinâmico antes de chamar
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
.Consulte o seguinte para obter mais informações sobre políticas, criação de um grupo dinâmico e criação de regras:
-
A ativação do controlador de recursos com
DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL
é uma operação única. Não é necessário ativar o controlador de recursos novamente, a menos que você executeDBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL
para desativar o controlador de recursos. -
O controlador de recursos não está disponível com clones atualizáveis.
Exemplo
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
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
FINISH_WORKLOAD_CAPTURE Procedimento
Este procedimento conclui a captura da carga de trabalho atual, interrompe todas as solicitações de captura de carga de trabalho subsequentes para o banco de dados e faz upload dos arquivos de captura para o Object Storage.
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE
END;
/
Observações de Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Quando você passa o parâmetro
duration
paraSTART_WORKLOAD_CAPTURE
, a captura termina quando atinge o tempo especificado. No entanto, se você chamarFINISH_WORKLOAD_CAPTURE
, isso interromperá a captura da carga de trabalho (possivelmente antes do horário especificado com o parâmetro de duração).Você pode consultar a exibição
DBA_CAPTURE_REPLAY_STATUS
para verificar o status da carga de trabalho final. Consulte DBA_CAPTURE_REPLAY_STATUS View para obter mais informações.
Você deve se inscrever no evento de Informações com.oraclecloud.databaseservice.autonomous.database.information
para ser notificado sobre a conclusão do FINISH_WORKLOAD_CAPTURE
, bem como o link do Object Storage para fazer download do arquivo de captura. Este URL da PAR está contido no campo captureDownloadURL
do evento e é válido por 7 dias a partir da data de geração. Consulte Eventos de Informações no Autonomous Database para obter mais informações.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
PREPARE_REPLAY Procedimento
O procedimento PREPARE_REPLAY
prepara o clone atualizável para uma repetição.
Parâmetros
Parâmetro | Descrição |
---|---|
capture_name |
Especifica o nome da captura da carga de trabalho.
Este parâmetro é obrigatório. |
Sintaxe
DBMS_CLOUD_ADMIN.PREPARE_REPLAY
(
capture_name IN VARCHAR2);
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.PREPARE_REPLAY
capture_name => 'cap_test1');
END;
/
Este exemplo prepara o clone atualizável para repetir a carga de trabalho indicada pelo parâmetro capture_name
, que envolve atualizá-lo para o horário inicial da captura e, em seguida, desconectá-lo.
Observação do Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
PURGE_FLASHBACK_ARCHIVE Procedimento
Este procedimento permite que usuários ADMIN expurguem dados históricos do Flashback Data Archive. Você pode expurgar todos os dados históricos do Flashback Data Archive flashback_archive
ou dados seletivos com base em timestamps ou Número de Alteração do Sistema.
Sintaxe
DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE
(
scope IN VARCHAR2,
before_scn IN INTEGER DEFAULT NULL,
before_ts IN TIMESTAMP DEFAULT NULL);
Parâmetro | Descrição |
---|---|
scope |
Isso especifica o escopo para remover dados do arquivo de dados de flashback.
|
before_scn |
Isso especifica o número de alteração do sistema antes do qual todos os dados são removidos do arquivo de flashback. |
before_timestamp |
Isso especifica o timestamp antes do qual todos os dados são removidos do arquivo de flashback. |
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.PURGE_FLASHBACK_ARCHIVE(
scope => 'ALL'); // Purge all historical data from Flashback Data Archive flashback_archive
END;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
REPLAY_WORKLOAD Procedimento
Este procedimento inicia uma repetição de carga de trabalho na sua instância do Autonomous Database. O formulário sobrecarregado permite que você reproduza os arquivos de captura de uma instância do Autonomous Database, banco de dados on-premises ou outros bancos de dados de serviço de nuvem.
Sintaxe
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 | Descrição |
---|---|
CAPTURE_NAME |
Especifica o nome da captura da carga de trabalho.
Este parâmetro é obrigatório. |
REPLAY_NAME |
Especifica o nome da repetição.
Se você não fornecer um valor |
CAPTURE_SOURCE_TENANCY_OCID |
Especifica o OCID da tenancy de origem da captura da carga de trabalho.
Se você não fornecer um valor Esse parâmetro só é obrigatório ao executar a captura da carga de trabalho em um clone completo. |
CAPTURE_SOURCE_DB_NAME |
Especifica o nome do banco de dados de origem da captura da carga de trabalho
Se você não fornecer um valor Esse parâmetro só é obrigatório ao executar a captura da carga de trabalho em um clone completo. |
LOCATION_URI |
Especifica o URI que aponta para um local do Object Storage que contém os arquivos capturados.
Este parâmetro é obrigatório. |
CREDENTIAL_NAME |
Especifica a credencial para acessar o bucket de armazenamento de objetos.
Se você não fornecer um valor |
SYNCHRONIZATION |
Especifica o método de sincronização usado durante a repetição da carga de trabalho.
Se você não fornecer um valor |
PROCESS_CAPTURE |
Especifica se você precisa ou não especificar o valor process_capture . Ela só pode ser definida como FALSE quando você repete a mesma carga de trabalho no banco de dados de destino repetidamente.
Se você não fornecer um valor |
Exemplo para reproduzir a carga de trabalho de um banco de dados local em uma instância do 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;
/
Quando você executa este exemplo, ele:
-
Faz download dos arquivos de captura do local do Object Storage especificado em
location_uri
e processa os arquivos de captura com base no valor do parâmetroprocess_capture
. -
Reproduz a carga de trabalho capturada com base no valor do parâmetro
synchronization
.
Neste exemplo, namespace-string
é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname
é o nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.
Consulte Navegar até o Oracle Cloud Infrastructure Object Storage e Criar um Bucket para obter mais informações sobre o serviço Object Storage.
Consulte Fazer Upload de Arquivos para o Bucket do Oracle Cloud Infrastructure Object Store para obter mais informações sobre o upload de arquivos para o Armazenamento de Objetos.
O credential_name
usado nesta etapa são as credenciais do Object Store.
Não será necessário criar uma credencial para acessar o Oracle Cloud Infrastructure Object Store se você ativar credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos da Oracle Cloud Infrastructure para obter mais informações.
Exemplo para reproduzir a carga de trabalho de uma instância do Autonomous Database em outro Autonomous Database:
BEGIN
DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD
(
capture_name => 'CAP_TEST1');
END;
/
Quando você executa este exemplo, ele:
-
Desconecta a instância atual do Autonomous Database.
-
Faz download dos arquivos de captura do Object Storage.
-
Reproduz a carga de trabalho capturada.
-
Faz upload do relatório de repetição após uma repetição.
Observações de Uso para Repetir a Carga de Trabalho de um Banco de Dados Local ou de Outro Cloud Service em outro Autonomous Database
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Antes de iniciar a repetição, você deve fazer upload dos subdiretórios
cap
ecapfiles
, que contêm os arquivos de captura de carga de trabalho, para o local de armazenamento de objetos.
Observações de Uso para Repetir a Carga de Trabalho de uma instância do Autonomous Database em outro Autonomous Database
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Os arquivos de repetição são carregados automaticamente no Object Store como um arquivo zip.
-
Você pode consultar a exibição
DBA_CAPTURE_REPLAY_STATUS
para verificar o status de repetição da carga de trabalho.Consulte DBA_CAPTURE_REPLAY_STATUS View para obter mais informações.
Você deve se inscrever no evento de Informações com.oraclecloud.databaseservice.autonomous.database.information
para ser notificado sobre o início e a conclusão do REPLAY_WORKLOAD
, bem como o link do Object Storage para fazer download dos relatórios de repetição. Este URL da PAR está contido no campo replayDownloadURL
do evento e é válido por 7 dias a partir da data de geração. Consulte Eventos de Informações no Autonomous Database para obter mais informações.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
SET_FLASHBACK_ARCHIVE_RETENTION Procedimento
Este procedimento permite que os usuários ADMIN modifiquem o período de retenção do Flashback Data Archive flashback_archive
.
Sintaxe
DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION
(
retention_days INTEGER);
Parâmetro | Descrição |
---|---|
retention_days |
Especifica o período em dias durante o qual os dados arquivados devem ser mantidos. O valor de retention_days deve ser maior que 0.
|
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION
(
retention_days => 90); // sets the retention time to 90 days
END;
/
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN
START_WORKLOAD_CAPTURE Procedimento
Este procedimento inicia uma captura de carga de trabalho na sua instância do Autonomous Database.
Sintaxe
DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE
(
capture_name IN VARCHAR2,
duration IN NUMBER DEFAULT NULL);
Parâmetros
Parâmetro | Descrição |
---|---|
capture_name |
Especifica o nome da captura da carga de trabalho.
Este parâmetro é obrigatório. |
duration |
Especifica a duração em minutos pela qual você deseja executar a captura da carga de trabalho.
|
Exemplo
BEGIN
DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE
(
capture_name => 'test');
END;
/
Observações de Uso
-
Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio
EXECUTE
emDBMS_CLOUD_ADMIN
. -
Para medir os impactos de uma alteração do sistema em uma carga de trabalho, é necessário garantir que os sistemas de captura e repetição estejam no mesmo estado lógico.
-
Antes de iniciar uma captura de carga de trabalho, você deve considerar o provisionamento de um clone atualizável para garantir o mesmo ponto inicial para a repetição.
Você deve se inscrever no evento de Informações com.oraclecloud.databaseservice.autonomous.database.information
para ser notificado no início de START_WORKLOAD_CAPTURE
. Consulte Eventos de Informações no Autonomous Database para obter mais informações.
Tópico principal: Resumo de Subprogramas DBMS_CLOUD_ADMIN