O procedimento DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM anexa um sistema de arquivos no banco de dados e armazena informações sobre o sistema de arquivos na view 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 de:

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 esse procedimento, você deve fazer log-in como o 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 Serviço de Armazenamento de Arquivos privado em bancos de dados com Pontos Finais Privados ativados.

  Consulte OCI File Storage Service 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 são 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 NFS ao protocolo de correspondência 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

Nota de Uso

• Para executar esse procedimento, você deve fazer log-in como o 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, parâmetros gateway_params adicionais são suportados:

  db_type	Valores gateway_params Adicionais
  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 local da Oracle. 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 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. Esse 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 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 estabelecer conexão com ServiceNow e obter dados, forneça 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 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	Quando você usa o parâmetro gateway_params com db_type sharepoint, especifique também 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 do tipo OAuth usando o parâmetro params com os valores gcp_oauth2 especificados (client_id, client_secret e refresh_token). Consulte Procedimento CREATE_CREDENTIAL 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 o token_uri do Azure. Consulte Obter informações e pontos finais do cliente do aplicativo para obter mais informações.
  snowflake	Quando 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 estabelecer conexão com o Youtube e obter dados, forneça 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 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 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 DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK com um usuário diferente de ADMIN, conceda privilégios EXECUTE e CREATE DATABASE LINK a esse usuário. Por exemplo, execute o seguinte comando como ADMIN para conceder privilégios a 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 que você usa 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 de cada vez para o diretório escolhido para arquivos de 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 cuja wallet nesse diretório é válida. Para usar vários arquivos cwallet.sso com links de banco de dados, crie diretórios adicionais e coloque cada cwallet.sso em um diretório diferente.

  Consulte Criar Diretório no Autonomous Database para obter informações sobre a criação de 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 na 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 view DBA_CLOUD_FILE_SYSTEMS.

Sintaxe

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

Parâmetros

Por exemplo:

BEGIN
   DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'FSS'                                       
  );                                                                          
END;                                                                          
/     

Observações de Uso

• Para executar esse procedimento, você deve fazer log-in como o 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 Serviço de Armazenamento de Arquivos privado em bancos de dados com Pontos Finais Privados ativados.

  Consulte OCI File Storage Service 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 do continuidade de aplicativos para obter mais informações sobre 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, faça log-in como usuário ADMIN ou tenha o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Quando AUTO_DST_UPGRADE e AUTO_DST_UPGRADE_EXCL_DATA estã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 disponíveis mais recentes.

• Consulte dba_cloud_config para verificar se 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 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 do serviço do Azure no Autonomous Database e exclui o aplicativo Azure na instância do Autonomous Database.

• Quando o valor do provedor é AZURE e username é um usuário diferente de ADMIN, o procedimento chama os privilégios do usuário especificado. O usuário ADMIN e outros usuários com permissão para usar o controlador de serviços do Azure podem continuar usando 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.

• Configure um grupo dinâmico e políticas para o grupo dinâmico antes de chamar DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  Consulte os seguintes tópicos 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 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, à medida que 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 consulta de usuário não ADMIN, 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 que 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 de wallet armazenados. Por exemplo:

• Remova o arquivo da wallet no Armazenamento de Objetos.

• Use DBMS_CLOUD.DELETE_FILE para remover o arquivo de wallet do diretório data_pump_dir ou do diretório definido pelo usuário no qual o upload do arquivo de wallet foi feito.

Sintaxe

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parâmetros

Observações de Uso

Consulte Visão Geral do continuidade de aplicativos para obter mais informações sobre 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

Nota de Uso

• Você deve ser o usuário ADMIN para executar o procedimento DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN.

Consulte Usar ARNs (Amazon Resource Names) para Acessar Recursos da 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 o ativará com DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• Este procedimento define os parâmetros de sistema IDENTITY_PROVIDER_TYPE e IDENTITY_PROVIDER_CONFIG como obrigatórios para que os usuá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

Você informa um nome de diretório que contém 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 localização apontando para um local de Armazenamento de Objetos 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 do Kerberos

Você informa um nome de diretório 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('directory_name' value 'KERBEROS_DIR'); // KERBEROS_DIR directory object already exists
END;
/

PL/SQL procedure successfully completed.

Você informa um URI de localização apontando para um local de Armazenamento de Objetos 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;
/

Depois que o Kerberos for ativado na 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 ativar recurso de horário de verão automático:

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

Exemplo para Ativar o Recurso de Dados Auto DST EXCL:

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 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 fazer log-in como usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN para executar DBMS_CLOUD_ADMIN.ENABLE_FEATURE.

• Depois de executar DBMS_CLOUD_ADMIN.ENABLE_FEATURE com o valor 'JAVAVM' de feature_name, 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 'OWM' feature_name, reinicie a instância do Autonomous Database para ativar o Oracle Workspace Manager. da 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 ficam desativados. Você pode ativar uma ou outra dessas opções, mas não ambas.

• Depois de ativar 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 será atualizada para usar os arquivos de fuso horário disponíveis mais recentes. Depois que AUTO_DST_UPGRADE for ativado, quando novos arquivos de fuso horário estiverem disponíveis, a instância continuará fazendo upgrade para a versão disponível mais recente em cada reinicialização subsequente ou interrupção e inicialização, até que o recurso seja desativado.

  Consulte dba_cloud_config para verificar se 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 AUTO_DST_UPGRADE_EXCL_DATA, a instância do Autonomous Database fará upgrade para usar os arquivos de fuso horário disponíveis mais recentes. Depois que esse recurso é ativado, cada janela de manutenção subsequente atualiza a instância para usar a versão de fuso horário disponível mais recente. Esse recurso garante que os arquivos de fuso horário sejam atualizados para o banco de dados (a ativação de AUTO_DST_UPGRADE_EXCL_DATA não atualiza nenhuma linha afetada).

  Consulte dba_cloud_config para verificar se 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. Neste caso, existem duas opções:

  • Aguarde a expiração do acesso do operador e, em seguida, conceda o acesso do operador novamente com DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS

  • Desative explicitamente o acesso do operador com o Procedimento DISABLE_OPERATOR_ACCESS.

• DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS permite acesso somente ao Cloud Operator e não permite 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 do banco de dados executando o procedimento DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Isso significa que, se você arquivar uma solicitação de serviço com o Suporte do Oracle Cloud e os Operadores do Oracle Cloud precisarem acessar seus esquemas de banco de dados, você também deverá ativar o acesso do operador executandoDBMS_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 é AZURE, o parâmetro params deve 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ê ativa o ARN na instância do Autonomous Database executando DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, a credencial chamada AWS$ARN está disponível para uso com qualquer API DBMS_CLOUD que use 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 de banco de dados.

• Configure um grupo dinâmico e políticas para o grupo dinâmico antes de chamar DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  Consulte os seguintes tópicos 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 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 esse procedimento, você deve fazer log-in como o 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 tempo 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 reproduzir 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.

Nota de Uso

• Para executar esse procedimento, você deve fazer log-in como o 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 esse exemplo, ele:

• Faz download dos arquivos de captura do local de Armazenamento de Objetos especificados 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 corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao 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.

As credential_name que você usa nesta etapa são as credenciais do Armazenamento de Objetos.

Você não precisará criar uma credencial para acessar o Oracle Cloud Infrastructure Object Store se ativar credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos do 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 esse exemplo, ele:

• Desconecta a instância atual do Autonomous Database.

• Faz download dos arquivos de captura do Object Storage.

• Repete a carga de trabalho capturada.

• Carrega o 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 Outro Cloud Service em outro Autonomous Database

• Para executar esse procedimento, você deve fazer log-in como o usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Antes de iniciar a reprodução, faça 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 esse procedimento, você deve fazer log-in como o usuário ADMIN ou ter o privilégio EXECUTE em DBMS_CLOUD_ADMIN.

• Os arquivos de repetição são carregados automaticamente no Armazenamento de Objetos como um arquivo zip.

• Você pode consultar a view 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 esse procedimento, você deve fazer log-in como o 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, considere provisionar um clone atualizável para garantir o mesmo ponto inicial para a repetição.