Riepilogo dei sottoprogrammi DBMS_CLOUD_ADMIN

La procedura DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM allega un file system nel database e memorizza le informazioni sul file system nella vista DBA_CLOUD_FILE_SYSTEMS.

Sintassi

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
);

Parametri

Esempi:

Allega a un file system 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;
/     

Allega a un file system 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;                                                        
/

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Per allegare un file system utilizzando DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM, è necessario disporre del privilegio WRITE sull'oggetto directory nel database.

• La procedura DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM può collegare solo un servizio di storage di file privato nei database con endpoint privati abilitati.

  Per ulteriori informazioni, vedere OCI File Storage Service e Configura accesso di rete con endpoint privati.

• La procedura DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM cerca il nome host del file system di rete nella rete cloud virtuale (VCN) del cliente. Se non è possibile individuare il nome host specificato nella posizione, viene restituito l'errore "ORA-20000: Mounting NFS fails".

• Oracle Cloud Infrastructure File Storage utilizza NFSv3 per la condivisione

• Se ci si collega a sistemi di storage di file non Oracle Cloud Infrastructure, la procedura supporta NFSv3 e NFSv4

• Se si dispone di un server NFS collegato che utilizza NFSv3 e la versione NFS viene aggiornata a NFSv4 nel server NFS, è necessario eseguire DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM e quindi DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (utilizzando il parametro params con nfs_version impostato su 4). Questo allega NFS con il protocollo di corrispondenza in modo che Autonomous Database possa accedere al server NFSv4. Senza scollegare e quindi ricollegare, il server NFS sarà inaccessibile e potrebbe essere visualizzato un errore come: "Protocol not supported".

Sintassi

Questa procedura annulla l'acquisizione del carico di lavoro corrente e abilita l'aggiornamento della copia aggiornabile.

DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;

Esempio

Nota per l'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

Sintassi

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);

Parametri

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

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

Note sull'uso

• Quando si specifica il parametro gateway_params, per alcuni valori db_type sono supportati parametri gateway_params aggiuntivi:

  db_type	Valori aggiuntivi di gateway_params
  azure	Quando il valore db_type è azure, sono disponibili due parametri facoltativi, auth_method e domain per supportare l'autenticazione NTLM/AD. Quando NTLMv2 è configurato, impostare auth_method=10 e impostare domain sul valore del dominio Windows. Per utilizzare una password di Azure Active Directory, impostare auth_method=13. Non utilizzare auth_method=13 per accedere a un database Oracle on-premise. Per ulteriori informazioni, vedere Metodo di autenticazione di Microsoft SQL Server.
  google_analytics	Quando db_type è google_analytics, la credenziale specificata deve essere una credenziale Google OAuth (gcp_oauth2). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.
  google_bigquery	Se db_type è google_bigquery, la credenziale specificata deve essere una credenziale Google OAuth (gcp_oauth2) Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure). Se db_type è google_bigquery, il parametro project è valido. Questo parametro specifica il nome del progetto per google_bigquery ed è obbligatorio. Il nome della tabella specificato quando si utilizza SELECT con Google BigQuery deve essere tra virgolette. Ad esempio: SELECT * FROM "sales"@GOOGLE_BIGQUERY_LINK
  google_drive	Per db_type google_drive, la credenziale fornita con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per connettersi a Google Drive e ottenere i dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file REST automatico) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Quando si utilizza il parametro gateway_params con db_type google_drive, è necessario fornire il parametro gateway_params db_type con il valore 'google_drive' e i parametri directory_name e file_name, insieme alle credenziali di tipo OAuth: Il parametro directory_name specifica la directory con il file di configurazione REST. È possibile creare questa directory come indicato di seguito. create or replace directory google_drive_dir as 'GOOGLE_DRIVE_DIR'; Ottenere e scaricare il file REST automatico nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('google_drive_dir_cred', 'https://objectstorage.<...>/google_drive.rest','GOOGLE_DRIVE_DIR'); Impostare il valore file_name sul nome del file REST automatico scaricato, "google_drive.rest". Quindi è possibile utilizzare il file di configurazione REST con OAuth 2.0.
  hive	Se db_type è hive, il parametro http_path è valido. Questo parametro specifica il valore HttpPath, se necessario, per connettersi all'istanza Hive.
  salesforce	Se db_type è salesforce, il parametro: security_token è valido. Un token di sicurezza è un codice alfanumerico con distinzione tra maiuscole e minuscole. Per accedere a Salesforce è necessario specificare un valore security_token. Ad esempio: gateway_params => JSON_OBJECT( 'db_type' value 'salesforce', 'security_token' value 'security_token_value' ) Per ulteriori informazioni, vedere Reimposta token di sicurezza.
  servicenow	Per connettersi a ServiceNow e ottenere i dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Quando si utilizza il parametro gateway_params con db_type servicenow, sono supportate due opzioni: Autenticazione di base: è necessario fornire il parametro gateway_params db_type con il valore 'servicenow' e fornire i parametri directory_name e file_name insieme alle credenziali di tipo nome utente/password. Autenticazione OAuth 2.0: è necessario fornire il parametro gateway_params db_type con il valore 'servicenow' e i parametri directory_name, file_name e token_uri, insieme alle credenziali di tipo OAuth. Il parametro directory_name specifica la directory con il file di configurazione REST ServiceNow. È possibile creare questa directory come indicato di seguito. create or replace directory servicenow_dir as 'SERVICENOW_DIR'; Ottenere e scaricare il file di configurazione REST ServiceNow nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('servicenow_dir_cred', 'https://objectstorage.<...>/servicenow.rest','SERVICENOW_DIR'); Impostare il valore file_name sul nome del file di configurazione REST scaricato, "servicenow.rest". Quindi è possibile utilizzare il file di configurazione REST ServiceNow con autenticazione di base o OAuth2.0. Quindi è possibile utilizzare il file di configurazione REST ServiceNow con autenticazione di base o OAuth2.0. Per gli esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO View.
  sharepoint	Quando si utilizza il parametro gateway_params con db_type sharepoint, specificare anche i valori per auth_uri, scope, service_url e token_uri. Per db_type sharepoint, la credenziale fornita con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK deve essere una credenziale di tipo OAuth che utilizza il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure. Generare il valore refresh_token per tenant_id.sharepoint.com/.default offline_access. Per ulteriori informazioni, vedere: Determinare l'ambito e OAuth 2.0 authentication. Impostare i valori per gateway_params per db_type sharepoint: auth_uri: impostare auth_uri da Azure. Per ulteriori informazioni, vedere Ottenere le informazioni e gli endpoint client dell'applicazione. scope: imposta l'ambito. Per ulteriori informazioni, vedere Descrizioni delle opzioni di connessione. service_url: impostare service_url. Per ulteriori informazioni, vedere URL servizio. token_uri: ottenere token_uri da Azure. Per ulteriori informazioni, vedere Ottenere le informazioni e gli endpoint client dell'applicazione.
  snowflake	Se db_type è SNOWFLAKE, sono validi i parametri facoltativi role, schema e warehouse. Questi valori specificano uno schema, un ruolo o un valore warehouse diverso da quello predefinito. Ad esempio: gateway_params => JSON_OBJECT( 'db_type' value 'snowflake', 'role' value 'ADMIN', 'schema' value 'PUBLIC', 'warehouse' value 'TEST' )
  youtube	Per connettersi a Youtube e ottenere dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che mappa la risposta JSON al modello relazionale. Il file modello specifica gli endpoint, il mapping delle tabelle e il codice di risposta HTTP per l'elaborazione della risposta JSON. Per ulteriori informazioni, vedere Sintassi dei file modello e File modello di esempio. Quando si utilizza il parametro gateway_params con db_type youtube, la credenziale specificata deve essere una credenziale Google OAuth (gcp_oauth2) Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure. Autenticazione OAuth 2.0: è necessario fornire il parametro gateway_params db_type con il valore youtube e i parametri directory_name e file_name, insieme alle credenziali di tipo OAuth. Il parametro directory_name specifica la directory con il file di configurazione REST ServiceNow. È possibile creare questa directory come indicato di seguito. create or replace directory youtube_dir as 'YOUTUBE_DIR'; Ottenere e scaricare il file di configurazione REST ServiceNow nella directory specificata. Ad esempio: exec DBMS_CLOUD.get_object('youtube_dir_cred', 'https://objectstorage.<...>/youtube.rest','YOUTUBE_DIR'); Impostare il valore file_name sul nome del file di configurazione REST scaricato, "youtube.rest". È quindi possibile utilizzare il file di configurazione REST ServiceNow con OAuth2.0. Per gli esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO View.

• Per eseguire DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK con un utente diverso da ADMIN, è necessario concedere i privilegi EXECUTE e CREATE DATABASE LINK a tale utente. Ad esempio, eseguire il comando seguente come ADMIN per concedere privilegi a adb_user:

  GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO adb_user;
  GRANT CREATE DATABASE LINK TO adb_user;

  Inoltre, quando si crea un database link in uno schema diverso da quello ADMIN, ad esempio in uno schema denominato adb_user, lo schema adb_user deve essere proprietario della credenziale utilizzata con DBMS_CLOUD_ADMIN.CREATE_DATABASE_LINK.

• È valido un solo file wallet per ogni directory specificata con il parametro directory_name. È possibile caricare un solo file cwallet.sso alla volta nella directory scelta per i file wallet. Ciò significa che con un cwallet.sso in una directory, è possibile creare solo database link ai database per i quali il wallet in tale directory è valido. Per utilizzare più file cwallet.sso con database link è necessario creare directory aggiuntive e inserire ogni file cwallet.sso in una directory diversa.

  Per informazioni sulla creazione di directory, vedere Crea directory in Autonomous Database.

• Per creare un database link a un Autonomous Database, impostare GLOBAL_NAMES su FALSE nel database di origine (non Autonomous Database).

  SQL> ALTER SYSTEM SET GLOBAL_NAMES = FALSE;
   
  System altered.
  
  SQL> SHOW PARAMETER GLOBAL_NAMES
  NAME                     TYPE        VALUE
  ----------------------   ----------- -----------
  global_names             boolean     FALSE
  

• Quando il parametro private_target è TRUE, il parametro hostname specifica un host privato all'interno della VCN.

Esempi

La procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM scollega un file system dal database. Inoltre, la procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM rimuove le informazioni relative al file system anche dalla vista DBA_CLOUD_FILE_SYSTEMS.

Sintassi

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

Parametri

Esempio:

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

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Per scollegare un file system da una directory utilizzando la procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM, è necessario disporre del privilegio WRITE sull'oggetto directory nel database.

• La procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM può scollegare un servizio di storage di file privato solo nei database con endpoint privati abilitati.

  Per ulteriori informazioni, vedere OCI File Storage Service e Configura accesso di rete con endpoint privati.

• La procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM cerca il nome host del file system di rete nella rete cloud virtuale (VCN) del cliente. Se non è possibile individuare il nome host specificato nella posizione, viene restituito l'errore "ORA-20000: Mounting NFS fails".

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parametri

Note sull'uso

Per ulteriori informazioni sulla continuità di applicazione, vedere Panoramica sulla continuità di applicazione.

Esempio

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;

Eccezioni

Esempio

BEGIN 
   DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/

PL/SQL procedure successfully completed.

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name    IN  VARCHAR2);

Parametri

Esempi

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;
/

Note sull'uso

• Per disabilitare le funzioni OraMTS, AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, OWM o WORKLOAD_AUTO_REPLAY per l'istanza di Autonomous Database, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Quando AUTO_DST_UPGRADE e AUTO_DST_UPGRADE_EXCL_DATA sono disabilitati, se sono disponibili nuove versioni del fuso orario, l'istanza di Autonomous Database non esegue l'upgrade per utilizzare i file del fuso orario più recenti disponibili.

• Eseguire una query su dba_cloud_config per verificare che AUTO_DST_UPGRADE sia disabilitato.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade';
  
  0 rows selected.

• Eseguire una query su dba_cloud_config per verificare che AUTO_DST_UPGRADE_EXCL_DATA sia disabilitato.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade_excl_data';
  
  0 rows selected.  

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;

Esempio

BEGIN 
    DBMS_CLOUD_ADMIN.DISABLE_OPERATOR_ACCESS;   
END;
/

Sintassi

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

Parametri

Note sull'uso

• Quando il valore del provider è AZURE e username è ADMIN, la procedura disabilita il principal del servizio Azure in base all'autenticazione su Autonomous Database ed elimina l'applicazione Azure nell'istanza di Autonomous Database.

• Se il valore del provider è AZURE e username è un utente diverso dall'utente ADMIN, la procedura revoca i privilegi all'utente specificato. L'utente ADMIN e altri utenti abilitati a utilizzare il principal del servizio Azure possono continuare a utilizzare ADMIN.AZURE$PA e l'applicazione creata per l'istanza di Autonomous Database rimane nell'istanza.

Esempi

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL(
   username         IN VARCHAR2);

Parametro

Eccezioni

Note sull'uso

• Il principal risorsa non è disponibile con copie aggiornabili.

• Prima di chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL, è necessario impostare un gruppo dinamico e criteri per il gruppo dinamico.

  Per ulteriori informazioni sulla creazione di criteri, sulla creazione di un gruppo dinamico e sulla creazione di regole, vedere:

  • Utilizza il principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure

  • Gestione dei gruppi dinamici

  • Gestione dei criteri

• Verificare che una credenziale principal risorsa sia abilitata eseguendo una query su una delle viste: DBA_CREDENTIALS o ALL_TAB_PRIVS.

  Ad esempio, l'utente ADMIN esegue una query sulla vista DBA_CREDENTIALS:

  SELECT owner, credential_name FROM dba_credentials 
          WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN'; 
  
  OWNER  CREDENTIAL_NAME
  -----  ----------------------
  ADMIN  OCI$RESOURCE_PRINCIPAL 
  

  Ad esempio, come utente non ADMIN eseguire una query sulla vista ALL_TAB_PRIVS:

  SELECT grantee, table_name, grantor, FROM ALL_TAB_PRIVS 
            WHERE  grantee = 'ADB_USER';
  
  GRANTEE   TABLE_NAME GRANTOR
  --------- -------------------------------------
  ADB_USER  OCI$RESOURCE_PRINCIPAL ADMIN

Esempio

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.

Sintassi

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

Parametri

Esempi

Note sull'uso

Al termine dell'uso di un database link ed esecuzione di DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK, per garantire la sicurezza del database Oracle, rimuovere tutti i file wallet memorizzati. Ad esempio:

• Rimuovere il file wallet nell'area di memorizzazione degli oggetti.

• Utilizzare DBMS_CLOUD.DELETE_FILE per rimuovere il file wallet dalla directory data_pump_dir o dalla directory definita dall'utente in cui è stato caricato il file wallet.

Sintassi

DBMS_CLOUD_ADMIN.ENABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parametri

Note sull'uso

Per ulteriori informazioni sulla continuità di applicazione, vedere Panoramica sulla continuità di applicazione.

Esempio

Sintassi

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

Parametri

Esempio

Nota per l'uso

• Per eseguire la procedura DBMS_CLOUD_ADMIN.ENABLE_AWS_ARN, è necessario essere l'utente ADMIN.

Per ulteriori informazioni, vedere Usa i nomi delle risorse Amazon (ARN) per accedere alle risorse AWS.

Sintassi

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

Parametro

Eccezioni

Note sull'uso

• Con type OCI_IAM, se il principal risorsa non è abilitato nell'istanza di Autonomous Database, questa routine abilita il principal risorsa con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

• Questa procedura imposta i parametri di sistema IDENTITY_PROVIDER_TYPE e IDENTITY_PROVIDER_CONFIG agli utenti richiesti per accedere all'istanza con l'autenticazione e l'autorizzazione di Oracle Cloud Infrastructure Identity and Access Management.

Esempi

Abilita autenticazione OCI_IAM

BEGIN DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
     type => 'OCI_IAM',
     force=> TRUE );
END;
/

PL/SQL procedure successfully completed.

Abilita autenticazione CMU per Microsoft Active Directory

Si passa in un nome di directory che contiene i file di configurazione CMU tramite l'argomento 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.

Si passa un URI di posizione che punta a una posizione di storage degli oggetti che contiene i file di configurazione CMU tramite l'argomento 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.

Abilita autenticazione 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.

Abilita autenticazione Kerberos

Si passa in un nome di directory che contiene i file di configurazione Kerberos mediante l'argomento 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.

Si passa in un URI di posizione che punta a una posizione di storage degli oggetti che contiene i file di configurazione Kerberos tramite l'argomento 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;
/

Si passa un nome di servizio con kerberos_service_name nell'argomento 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;
/

Dopo che Kerberos è stato abilitato nell'istanza di Autonomous Database, utilizzare la query seguente per visualizzare il nome del servizio Kerberos:

SELECT SYS_CONTEXT('USERENV','KERBEROS_SERVICE_NAME') FROM DUAL;

Sintassi

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

Parametri

Esempio di abilitazione della funzione JAVAVM:

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

Esempio di abilitazione della funzione DST automatica:

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

Esempio per abilitare la funzione dati EXCL DST automatica:

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

Esempio di abilitazione della funzione OraMTS:

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'ORAMTS',   
        params       => JSON_OBJECT('location_uri' VALUE 'https://mymtsserver.mycorp.com')
   );
END;
/

Esempio di abilitazione della funzione OWM:

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

Esempio di abilitazione della funzione di ripetizione automatica del carico di lavoro

BEGIN 
   DBMS_CLOUD_ADMIN.ENABLE_FEATURE(
        feature_name => 'WORKLOAD_AUTO_REPLAY',
        params       => JSON_OBJECT('target_db_ocid' VALUE 'OCID1.autonomousdatabase.REGION..ID1', 'capture_duration' VALUE 120, 'capture_day' VALUE 'MONDAY', 'capture_time' VALUE '15:00'));
END;
/

Un valore di errore ORA-20000: Invalid argument for target_db_ocid potrebbe indicare che l'OCID fornito non è una copia aggiornabile. In questo caso, è necessario fornire un OCID con un valore per una copia aggiornabile.

Note sull'uso

• Per eseguire DBMS_CLOUD_ADMIN.ENABLE_FEATURE, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Dopo aver eseguito DBMS_CLOUD_ADMIN.ENABLE_FEATURE con il valore feature_name 'JAVAVM', è necessario riavviare l'istanza di Autonomous Database per installare Oracle Java.

  Dopo il riavvio dell'istanza di Autonomous Database, l'installazione Java prosegue per un certo periodo di tempo dopo l'apertura del database.

  Per informazioni dettagliate sul controllo dello stato dell'installazione Java, vedere Controllare la versione Oracle Java.

• Dopo aver eseguito DBMS_CLOUD_ADMIN.ENABLE_FEATURE con il valore feature_name 'OWM', è necessario riavviare l'istanza di Autonomous Database per abilitare Oracle Workspace Manager. Oracle.

• Per abilitare le funzioni AUTO_DST_UPGRADE, AUTO_DST_UPGRADE_EXCL_DATA, ORAMTS, JAVAVM, OWM o WORKLOAD_AUTO_REPLAY per il database, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Per impostazione predefinita, AUTO_DST_UPGRADE e AUTO_DST_UPGRADE_EXCL_DATA sono disabilitati. È possibile abilitare una o l'altra di queste opzioni, ma non entrambe.

• Dopo aver abilitato AUTO_DST_UPGRADE, al successivo riavvio o all'arresto e quindi all'avvio dell'istanza di Autonomous Database, l'istanza esegue gli upgrade per utilizzare i file di fuso orario più recenti disponibili. Dopo l'abilitazione di AUTO_DST_UPGRADE, quando sono disponibili nuovi file di fuso orario, l'istanza continua ad eseguire l'upgrade alla versione più recente disponibile ogni successivo riavvio o arresto e avvio, fino a quando la funzione non viene disabilitata.

  Eseguire una query su dba_cloud_config per verificare che AUTO_DST_UPGRADE sia abilitato.

  SELECT param_name, param_value FROM dba_cloud_config WHERE
         LOWER(param_name) = 'auto_dst_upgrade';
  
  PARAM_NAME       PARAM_VALUE
  ---------------- -------------- 
  auto_dst_upgrade enabled

• Dopo aver abilitato AUTO_DST_UPGRADE_EXCL_DATA, l'istanza di Autonomous Database esegue gli upgrade per utilizzare i file di fuso orario più recenti disponibili. Dopo aver abilitato questa funzione, ogni finestra di manutenzione successiva aggiorna l'istanza in modo che utilizzi la versione più recente disponibile del fuso orario. Questa funzione garantisce l'aggiornamento dei file del fuso orario per il database (l'abilitazione di AUTO_DST_UPGRADE_EXCL_DATA non comporta l'aggiornamento delle righe interessate).

  Eseguire una query su dba_cloud_config per verificare che AUTO_DST_UPGRADE_EXCL_DATA sia abilitato.

  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

Sintassi

DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
    auth_duration    IN  NUMBER  DEFAULT 1
);

Parametri

Esempio

BEGIN
   DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS(
       auth_duration => 12 );
END;
/

Note sull'uso

• ORA-20000: Operator access is already enabled indica che l'accesso operatore è già stato concesso. In questo caso sono disponibili due opzioni:

  • Attendere la scadenza dell'accesso dell'operatore, quindi concedere di nuovo l'accesso dell'operatore con DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS

  • Disabilitare esplicitamente l'accesso dell'operatore con DISABLE_OPERATOR_ACCESS Procedure.

• DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS consente l'accesso solo all'operatore cloud e non abilita l'accesso per altri utenti. Tutte le operazioni eseguite dall'operatore cloud vengono memorizzate nella vista DBA_OPERATOR_ACCESS. Per ulteriori informazioni, consulta Visualizza le azioni operative di Oracle Cloud Infrastructure.

• Per consentire a un operatore cloud di accedere agli schemi del database, eseguire la procedura DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Ciò significa che se si invia una richiesta di servizio al Supporto Oracle Cloud e gli operatori Oracle Cloud devono accedere agli schemi di database, è inoltre necessario abilitare l'accesso operatore eseguendoDBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS.

Sintassi

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

Parametri

Note sull'uso

• Se il parametro provider è AZURE, il parametro params deve includere il parametro azure_tenantid nei casi riportati di seguito.

  • Quando DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH viene chiamato per la prima volta.

  • Quando DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH viene chiamato per la prima volta dopo che DBMS_CLOUD_ADMIN.DISABLE_PRINCIPAL_AUTH viene chiamato con il parametro provider AZURE e username ADMIN.

• Quando il parametro provider è AWS:

  • Dopo aver abilitato ARN sull'istanza di Autonomous Database eseguendo DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, la credenziale denominata AWS$ARN è disponibile per l'uso con qualsiasi API DBMS_CLOUD che accetta una credenziale come input.

Esempi

Sintassi

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

Parametro

Eccezioni

Note sull'uso

• È necessario chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL con ADMIN username o senza argomenti prima di chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL con un username per uno schema utente del database.

• Prima di chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL, è necessario impostare un gruppo dinamico e criteri per il gruppo dinamico.

  Per ulteriori informazioni sui criteri, sulla creazione di un gruppo dinamico e sulla creazione di regole, vedere:

  • Utilizza il principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure

  • Gestione dei gruppi dinamici

  • Gestione dei criteri

• L'abilitazione del principal risorsa con DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL è un'operazione una tantum. Non è necessario abilitare di nuovo il principal risorsa, a meno che non si esegua DBMS_CLOUD_ADMIN.DISABLE_RESOURCE_PRINCIPAL per disabilitare il principal risorsa.

• Il principal risorsa non è disponibile con copie aggiornabili.

Esempio

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

Esempio

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Quando si passa il parametro duration a START_WORKLOAD_CAPTURE, l'acquisizione termina quando raggiunge l'ora specificata. Tuttavia, se si chiama FINISH_WORKLOAD_CAPTURE, l'acquisizione del carico di lavoro viene interrotta (probabilmente prima dell'ora specificata con il parametro duration).

  È possibile eseguire una query sulla vista DBA_CAPTURE_REPLAY_STATUS per controllare lo stato finale del carico di lavoro. Per ulteriori informazioni, vedere DBA_CAPTURE_REPLAY_STATUS View.

Parametri

Sintassi

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Esempio

In questo esempio viene preparata la copia aggiornabile per ripetere il carico di lavoro indicato dal parametro capture_name, che prevede il passaggio all'ora di inizio dell'acquisizione e la disconnessione.

Nota per l'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

Sintassi

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

Esempio

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

Sintassi

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);

Parametri

Esempio per riprodurre il carico di lavoro da un database in locale su un'istanza di Autonomous Database:

Quando si esegue questo esempio:

• Scarica i file di acquisizione dalla posizione di storage degli oggetti specificata in location_uri ed elabora i file di acquisizione in base al valore del parametro process_capture.

• Riproduce il carico di lavoro acquisito in base al valore del parametro synchronization.

In questo esempio, namespace-string è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

Per ulteriori informazioni sullo storage degli oggetti, consulta la sezione Passare a Oracle Cloud Infrastructure Object Storage and Create Bucket.

Per ulteriori informazioni sul caricamento dei file nello storage degli oggetti, vedere Carica i file nel bucket dell'area di memorizzazione degli oggetti di Oracle Cloud Infrastructure.

Il valore credential_name utilizzato in questo passo è costituito dalle credenziali per l'area di memorizzazione degli oggetti.

Non è necessario creare una credenziale per accedere all'area di memorizzazione degli oggetti di Oracle Cloud Infrastructure se si abilitano le credenziali del principal risorsa. Per ulteriori informazioni, consulta la sezione Usa principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure.

Esempio per riprodurre il carico di lavoro da un'istanza di Autonomous Database su un altro Autonomous Database:

Quando si esegue questo esempio:

• Disconnette l'istanza corrente di Autonomous Database.

• Scarica i file di acquisizione dallo storage degli oggetti.

• Riproduce il carico di lavoro acquisito.

• Carica il report di ripetizione dopo una ripetizione.

Note sull'uso per la ripetizione del carico di lavoro da un database Cloud Service in locale o in altro database Autonomous Database

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Prima di iniziare la ripetizione, è necessario caricare le sottodirectory cap e capfiles, che contengono i file di acquisizione del carico di lavoro, nella posizione di storage degli oggetti.

Note sull'uso per la ripetizione del carico di lavoro da un'istanza di Autonomous Database su un altro Autonomous Database

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• I file di ripetizione vengono caricati automaticamente nell'area di memorizzazione degli oggetti come file zip.

• È possibile eseguire una query sulla vista DBA_CAPTURE_REPLAY_STATUS per controllare lo stato della ripetizione del carico di lavoro.

  Per ulteriori informazioni, vedere DBA_CAPTURE_REPLAY_STATUS View.

Sintassi

DBMS_CLOUD_ADMIN.SET_FLASHBACK_ARCHIVE_RETENTION (
    retention_days INTEGER);

Esempio

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

Sintassi

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

Parametri

Esempio

Note sull'uso

• Per eseguire questa procedura, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Per misurare gli impatti di una modifica di sistema su un carico di lavoro, è necessario assicurarsi che i sistemi di acquisizione e ripetizione si trovino nello stesso stato logico.

• Prima di avviare un'acquisizione del carico di lavoro, è consigliabile eseguire il provisioning di una copia aggiornabile per garantire lo stesso punto di inizio per la ripetizione.