La procedura DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM collega 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:

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

Collegare 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 per uso

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

• Per collegare un file system con 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ò solo collegare un servizio di storage di file privato nei database con endpoint privati abilitati.

  Per ulteriori informazioni, vedere OCI File Storage Service e Configure Network Access with Private Endpoints.

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

• Oracle Cloud Infrastructure File Storage utilizza NFSv3 per condividere

• Se ti colleghi 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). Ciò collega NFS con il protocollo corrispondente in modo che Autonomous Database possa accedere al server NFSv4. Senza scollegare e quindi ricollegare, il server NFS non sarà accessibile e potrebbe essere visualizzato un errore, ad esempio "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 eseguire 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 per uso

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

  db_type	Valori gateway_params aggiuntivi
  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 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 in locale. 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 Procedura CREATE_CREDENTIAL). 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 racchiuso 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 il token di sicurezza.
  servicenow	Per connettersi a ServiceNow e ottenere i dati, è necessario fornire i parametri gateway directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che esegue il mapping della 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. OAuth 2.0 Autenticazione: è 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". Successivamente, puoi utilizzare il file di configurazione REST ServiceNow con l'autenticazione di base o OAuth2.0. Successivamente, puoi utilizzare il file di configurazione REST ServiceNow con l'autenticazione di base o OAuth2.0. Per esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO Visualizza.
  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 utilizzando il parametro params con i valori gcp_oauth2 specificati (client_id, client_secret e refresh_token). Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedura. Generare il file refresh_token per tenant_id.sharepoint.com/.default offline_access. Per ulteriori informazioni, vedere: Determinare l'ambito e OAuth 2.0, autenticazione. 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 del client dell'applicazione. scope: impostare l'ambito. Per ulteriori informazioni, vedere Descrizione delle opzioni di connessione. service_url: impostare il valore 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 del client dell'applicazione.
  snowflake	Se db_type è SNOWFLAKE, i parametri facoltativi: role, schema e warehouse sono validi. Questi valori specificano un valore di schema, ruolo o 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 i dati è necessario fornire i parametri del gateway directory_name e file_name. Questi parametri specificano un file modello (file di configurazione REST) che esegue il mapping della 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 Procedura CREATE_CREDENTIAL. 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 esempi, vedere HETEROGENEOUS_CONNECTIVITY_INFO Visualizza.

• 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 i 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 dallo schema 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.

• Per ogni directory specificata con il parametro directory_name è valido un solo file wallet. È 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. Oltre a ciò, la procedura DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM rimuove anche le informazioni sul file system dalla vista DBA_CLOUD_FILE_SYSTEMS.

Sintassi

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM(
    file_system_name         IN VARCHAR2
);

Parametri

Ad esempio:

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

Note per uso

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

• Per scollegare un file system da una directory mediante 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 Configure Network Access with Private Endpoints.

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

Sintassi

DBMS_CLOUD_ADMIN.DISABLE_APP_CONT(
    service_name      IN VARCHAR2);

Parametri

Note per 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 per 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 in uso, è necessario eseguire 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 più recenti del fuso orario disponibile.

• Eseguire la query 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 la query 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 per uso

• Quando il valore del provider è AZURE e username è ADMIN, la procedura disabilita l'autenticazione del principal del servizio Azure basata 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 dell'utente specificato. L'utente ADMIN e gli altri utenti abilitati a utilizzare il principal del servizio di 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 per uso

• Il principal risorsa non è disponibile con le copie aggiornabili.

• È necessario impostare un gruppo dinamico e criteri per il gruppo dinamico prima di chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

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

  • Usa Resource Principal per accedere alle risorse di Oracle Cloud Infrastructure

  • Gestione dei gruppi dinamici

  • Gestione dei criteri

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

  Ad esempio, quando 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 per uso

Al termine, utilizzare un database link ed eseguire DBMS_CLOUD_ADMIN.DROP_DATABASE_LINK per garantire la sicurezza del database Oracle, rimuovere 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 per 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, consulta la sezione relativa all'utilizzo dei 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 per uso

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

• Questa procedura imposta i parametri di sistema IDENTITY_PROVIDER_TYPE e IDENTITY_PROVIDER_CONFIG agli utenti necessari 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 un nome di directory contenente 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 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.

Abilitazione dell'autenticazione Kerberos

Si passa un nome di directory contenente i file di configurazione Kerberos tramite 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 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 aver abilitato Kerberos 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 per abilitare la funzione JAVAVM:

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

Esempio per abilitare la funzione DST automatica:

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

Esempio per abilitare la funzione dati ESCL DST automatica:

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

Esempio per abilitare la funzione OraMTS:

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

Esempio per abilitare la funzione OWM:

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

Esempio per abilitare la 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 per uso

• Per eseguire DBMS_CLOUD_ADMIN.ENABLE_FEATURE, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE in 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 aver riavviato l'istanza di Autonomous Database, l'installazione di Java prosegue per un certo periodo di tempo dopo l'apertura del database.

  Vedere Controllare la versione Oracle Java per i dettagli sul controllo dello stato dell'installazione 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 eseguire il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_ADMIN.

• Per impostazione predefinita, le opzioni AUTO_DST_UPGRADE e AUTO_DST_UPGRADE_EXCL_DATA sono disabilitate. È 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 l'upgrade per utilizzare i file più recenti dei fusi orari disponibili. Dopo l'abilitazione di AUTO_DST_UPGRADE, quando sono disponibili nuovi file di fuso orario, l'istanza continua a eseguire l'upgrade alla versione più recente disponibile a ogni riavvio o arresto e avvio successivi, fino a quando la funzione non viene disabilitata.

  Eseguire la query 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 viene aggiornata per utilizzare i file di fuso orario disponibili più recenti. Dopo aver abilitato questa funzione, ogni finestra di manutenzione successiva aggiorna l'istanza in modo da utilizzare la versione più recente del fuso orario disponibile. Questa funzione garantisce che i file del fuso orario vengano aggiornati per il database (l'abilitazione di AUTO_DST_UPGRADE_EXCL_DATA non comporta l'aggiornamento di righe interessate).

  Eseguire la query 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 per uso

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

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

  • Disabilitare esplicitamente l'accesso operatore con la procedura DISABLE_OPERATOR_ACCESS.

• 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 sulle operazioni di Oracle Cloud Infrastructure.

• È possibile consentire a un operatore cloud di accedere agli schemi di database eseguendo la procedura DBMS_CLOUD_ADMIN.ENABLE_OPERATOR_ACCESS. Ciò significa che se inoltri una richiesta di servizio con il Supporto Oracle Cloud e gli operatori Oracle Cloud devono accedere agli schemi del database, è necessario abilitare anche l'accesso operatore eseguendo DBMS_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 per uso

• Quando il parametro provider è AZURE, il parametro params deve includere il parametro azure_tenantid nei seguenti casi:

  • Quando si chiama DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH per la prima volta.

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

• Quando il parametro provider è AWS:

  • Dopo aver abilitato ARN nell'istanza di Autonomous Database eseguendo DBMS_CLOUD_ADMIN.ENABLE_PRINCIPAL_AUTH, la credenziale denominata AWS$ARN è disponibile per l'uso con qualsiasi interfaccia 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 per 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.

• È necessario impostare un gruppo dinamico e criteri per il gruppo dinamico prima di chiamare DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL.

  Per ulteriori informazioni sui criteri, sulla creazione di un gruppo dinamico e sulla creazione di regole, vedere quanto segue.

  • Usa Resource Principal 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 le 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 per uso

• Per eseguire questa procedura, è necessario eseguire 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 arrestata (eventualmente prima dell'ora specificata con il parametro duration).

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

Parametri

Sintassi

DBMS_CLOUD_ADMIN.PREPARE_REPLAY(
        capture_name IN VARCHAR2);

Esempio

In questo esempio la copia aggiornabile viene preparata per la ripetizione del carico di lavoro indicato dal parametro capture_name, che comporta l'aggiornamento all'ora di inizio dell'acquisizione e quindi la disconnessione.

Nota per l'uso

• Per eseguire questa procedura, è necessario eseguire 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 di ripetizione del 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.

• Ripete 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, vedere Passare a Oracle Cloud Infrastructure Object Storage e Crea bucket.

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

Il valore credential_name utilizzato in questo passo sono le 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 relativa all'uso del principal delle risorse per accedere alle risorse di Oracle Cloud Infrastructure.

Esempio di ripetizione del 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.

• Ripete il carico di lavoro acquisito.

• Carica il report di ripetizione dopo una ripetizione.

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

• Per eseguire questa procedura, è necessario eseguire 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 d'uso per la ripetizione del carico di lavoro da un'istanza di Autonomous Database su un altro Autonomous Database

• Per eseguire questa procedura, è necessario eseguire 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 per uso

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

• Per misurare l'impatto 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.