Resumo dos Subprogramas DBMS_CLOUD_ADMIN

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

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 em DBMS_CLOUD_ADMIN.

• Você deve ter o privilégio WRITE no objeto de diretório no banco de dados para anexar um sistema de arquivos usando DBMS_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âmetro params com nfs_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".

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

Observação do Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

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

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

gateway_params => JSON_OBJECT(
     'db_type' value 'snowflake',
     'enable_ssl' value true)

Observações de Uso

• Quando você especifica o parâmetro gateway_params, para alguns valores db_type, são suportados parâmetros gateway_params adicionais:

  db_type	Valores Adicionais gateway_params
  azure	Quando o valor db_type é azure, há dois parâmetros opcionais, auth_method e domain para suportar a autenticação NTLM/AD. Quando NTLMv2 estiver configurado, defina auth_method=10 e domain como o valor de domínio do Windows. Para usar uma senha do Azure Active Directory, defina auth_method=13. Não use auth_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 for google_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 for google_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âmetro project é válido. Este parâmetro especifica o nome do projeto para google_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 com DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve ser um tipo de credencial OAuth usando o parâmetro params com valores de gcp_oauth2 especificados (client_id, client_secret e refresh_token). Para se conectar ao Google Drive e obter dados, você deve fornecer os parâmetros de gateway directory_name e file_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 com db_type google_drive, você deve fornecer o parâmetro gateway_params db_type com o valor 'google_drive' e os parâmetros directory_name e file_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âmetro http_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 valor security_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 e file_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âmetro db_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âmetros directory_name e file_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âmetros directory_name, file_name e token_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 com db_type sharepoint, também especifique valores para auth_uri, scope, service_url e token_uri. Para db_type sharepoint, a credencial fornecida com DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve ser um tipo de credencial OAuth usando o parâmetro params com valores de gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte CREATE_CREDENTIAL Procedures para obter mais informações. Gere o refresh_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 para db_type sharepoint: auth_uri: Defina o auth_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 o service_url. Consulte URL do Serviço para obter mais informações. token_uri: Obtenha a token_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 e warehouse 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 e file_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 db_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 valor youtube, os parâmetros directory_name e file_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égios EXECUTE e CREATE DATABASE LINK a esse usuário. Por exemplo, execute o seguinte comando como ADMIN para conceder privilégios para o adb_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 esquema adb_user deve possuir a credencial usada com DBMS_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 um cwallet.sso por vez para o diretório escolhido para arquivos da wallet. Isso significa que, com um cwallet.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 arquivos cwallet.sso com links de banco de dados, você precisa criar diretórios adicionais e colocar cada cwallet.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 como FALSE 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âmetro hostname especifica um host privado dentro da VCN.

Exemplos

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

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 em DBMS_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 procedimento DBMS_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.

Sintaxe

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parâmetros

Observações de Uso

Consulte Visão Geral da Continuidade de Aplicativos para obter mais informações sobre a Continuidade de Aplicativos.

Exemplo

Sintaxe

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

Exceções

Exemplo

BEGIN 
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

Sintaxe

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

Parâmetros

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 ou WORKLOAD_AUTO_REPLAY da sua instância do Autonomous Database, você deverá estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Quando AUTO_DST_UPGRADE e AUTO_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 o AUTO_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 o AUTO_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.  

Sintaxe

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

Exemplo

BEGIN 
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;   
END;
/

Sintaxe

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

Parâmetros

Observações de Uso

• Quando o valor do provedor é AZURE e o username é 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 o username for um usuário diferente do usuário ADMIN, o procedimento revogará os privilégios do usuário especificado. O usuário ADMIN e outros usuários que estão ativados para usar o controlador de serviços do Azure podem continuar a usar ADMIN.AZURE$PA e o aplicativo criado para a instância do Autonomous Database permanece na instância.

Exemplos

Sintaxe

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

Parâmetro

Exceções

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:

  • Usar o Controlador de Recursos para Acessar os Recursos do Oracle Cloud Infrastructure

  • Gerenciando Grupos Dinâmicos

  • Gerenciando Políticas

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

Sintaxe

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

Parâmetros

Exemplos

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ório data_pump_dir ou do diretório definido pelo usuário no qual foi feito upload do arquivo da wallet.

Sintaxe

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parâmetros

Observações de Uso

Consulte Visão Geral da Continuidade de Aplicativos para obter mais informações sobre a Continuidade de Aplicativos.

Exemplo

Sintaxe

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

Parâmetros

Exemplo

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.

Sintaxe

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

Parâmetro

Exceções

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 com DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• Este procedimento define os parâmetros do sistema IDENTITY_PROVIDER_TYPE e IDENTITY_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;

Sintaxe

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

Parâmetros

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 em DBMS_CLOUD_ADMIN para executar DBMS_CLOUD_ADMIN.ENABLE_FEATURE.

• Depois de executar o DBMS_CLOUD_ADMIN.ENABLE_FEATURE com o valor feature_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 valor feature_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 ou WORKLOAD_AUTO_REPLAY para seu banco de dados, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Por padrão, AUTO_DST_UPGRADE e AUTO_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 do AUTO_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 o AUTO_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 do AUTO_DST_UPGRADE_EXCL_DATA não atualiza nenhuma linha afetada).

  Consulte dba_cloud_config para verificar se o AUTO_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

Sintaxe

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

Parâmetros

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 view DBA_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 executando DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS.

Sintaxe

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

Parâmetros

Observações de Uso

• Quando o parâmetro provider for AZURE, o parâmetro params deverá incluir o azure_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 que DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH é chamado com o parâmetro provider AZURE e o username 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 chamada AWS$ARN estará disponível para uso com qualquer API DBMS_CLOUD que obtenha uma credencial como entrada.

Exemplos

Sintaxe

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

Parâmetro

Exceções

Observações de Uso

• Chame DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL com o ADMIN username ou sem argumentos antes de chamar DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL com um username 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:

  • Usar o Controlador de Recursos para Acessar os Recursos do Oracle Cloud Infrastructure

  • Gerenciando Grupos Dinâmicos

  • Gerenciando Políticas

• 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ê execute DBMS_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

Exemplo

Observações de Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Quando você passa o parâmetro duration para START_WORKLOAD_CAPTURE, a captura termina quando atinge o tempo especificado. No entanto, se você chamar FINISH_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.

Parâmetros

Sintaxe

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Exemplo

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 em DBMS_CLOUD_ADMIN.

Sintaxe

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

Exemplo

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

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

Exemplo para reproduzir a carga de trabalho de um banco de dados local em uma instância do Autonomous Database:

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âmetro process_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:

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 em DBMS_CLOUD_ADMIN.

• Antes de iniciar a repetição, você deve fazer upload dos subdiretórios cap e capfiles, 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 em DBMS_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.

Sintaxe

DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);

Exemplo

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

Sintaxe

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

Parâmetros

Exemplo

Observações de Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_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.