Accesso a Oracle Autonomous AI Lakehouse

Passi per accedere a Oracle Autonomous AI Lakehouse da Oracle NoSQL Database Analytics Integrator.

Creare un database in Oracle Autonomous AI Lakehouse

È necessario creare un database per accedere a Oracle Autonomous AI Lakehouse da Oracle NoSQL Database Analytics Integrator. Per creare un database in Oracle Autonomous AI Lakehouse, andare alla console di Oracle Cloud ed effettuare le operazioni riportate di seguito.

Installare le credenziali necessarie per una connessione sicura al database

Le connessioni al database creato in Oracle Autonomous AI Lakehouse devono essere sicure. Affinché Oracle NoSQL Database Analytics Integrator possa connettersi in modo sicuro al database Oracle Autonomous AI Lakehouse, la utility utilizza le credenziali contenute in un Oracle Wallet.

Per ottenere Oracle Wallet, andare alla console di Oracle Cloud ed effettuare le operazioni riportate di seguito.
Il file zip prodotto include i seguenti elementi:
  • I file di configurazione di rete (tnsnames.ora e sqlnet.ora) necessari per connettersi al database.
  • Il file wallet SSO con apertura automatica, cwallet.sso.
  • Il file PKCS12, ewallet.p12, protetto dalla password del wallet fornita durante il download del file zip tramite la console di Oracle Cloud.
  • I file keystore e trustore Java, keystore.jks e truststore.jks; protetti dalla password del wallet.
  • Il file ojdbc.properties, che specifica la proprietà di sistema Java correlata al wallet richiesta per la connessione al database tramite JDBC.
  • File README contenente informazioni sulla scadenza del wallet.

Dopo aver ottenuto il file zip del wallet, prendere nota della password e memorizzare il wallet in qualsiasi ambiente da cui ci si connetterà al database. Inoltre, per utilizzare Oracle NoSQL Database Analytics Integrator, il contenuto estratto del file zip del wallet deve essere installato nell'ambiente in cui verrà eseguita la utility. Ad esempio, se si esegue la utility da un'istanza di computazione Oracle Cloud, è necessario estrarre il contenuto del file zip in qualsiasi directory dell'istanza. Quindi utilizzare il percorso della directory come valore del parametro databaseWallet nella sezione del database del file di configurazione dell'utility.

Abilitare la credenziale principal risorsa o l'area di memorizzazione/abilitazione dello storage degli oggetti dell'utente AUTH_TOKEN in Oracle Autonomous AI Lakehouse Database

Dopo aver recuperato i dati dalla tabella NoSQL Cloud Service desiderata e averli scritti nei file Parquet nello storage degli oggetti, Oracle NoSQL Database Analytics Integrator utilizza i sottoprogrammi del package Oracle PL/SQL DBMS_CLOUD per recuperare i file Parquet dallo storage degli oggetti. Carica quindi i dati contenuti in tali file in una tabella del database creato in Oracle Autonomous AI Lakehouse.

Prima che Oracle NoSQL Database Analytics Integrator possa eseguire questa operazione, è necessario fornire un modo affinché il database Oracle Autonomous AI Lakehouse possa eseguire l'autenticazione con lo storage degli oggetti per accedere a tali file Parquet. Il database Oracle Autonomous AI Lakehouse può eseguire l'autenticazione con il servizio di storage degli oggetti in due modi: utilizzando il principal risorsa OCI o un AUTH_TOKEN specifico dell'utente generato dall'utente o dall'amministratore del sistema. Il meccanismo di autenticazione che si decide di utilizzare è abilitato eseguendo i passi riportati di seguito dalla console di Oracle Cloud.
  • Selezionare Oracle AI Database dal menu sul lato sinistro della visualizzazione.
  • Selezionare Autonomous AI Database.

  • In Filtri applicati, selezionare il compartimento in cui si trova il database.
  • Selezionare il collegamento con il nome visualizzato immesso durante la creazione del database.

  • In Azioni del database selezionare SQL.
  • Dalla finestra denominata [Worksheet]*, se si desidera autenticare il database Oracle Autonomous AI Lakehouse con lo storage degli oggetti utilizzando la principal risorsa, eseguire la procedura riportata di seguito.
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();


    In alternativa, se si desidera eseguire l'autenticazione utilizzando il AUTH_TOKEN fornito dall'amministratore di sistema o generato personalmente, eseguire la procedura,

    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL (
    credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
    username => '<your-Oracle-Cloud-username>',
    password => '<cut-and-paste-the-AUTH_TOKEN>'
    );
    END;


La procedura DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL abilita OCI Resource Principal (denominato OCI$RESOURCE_PRINCIPAL) per l'uso da parte del database Oracle Autonomous AI Lakehouse durante l'autenticazione con una risorsa OCI come lo storage degli oggetti. La procedura DBMS_CLOUD.CREATE_CREDENTIAL cifra la credenziale AUTH_TOKEN specificata e la memorizza in una tabella del database denominato adwc_user. Qualunque sia la procedura utilizzata, tale procedura deve essere eseguita una sola volta; dopodiché è possibile specificare lo stesso nome di credenziale per tutti i trasferimenti dallo storage degli oggetti al database Oracle Autonomous AI Lakehouse.

Nota

Quando il database Oracle Autonomous AI Lakehouse utilizza il principal risorsa OCI per eseguire l'autenticazione con lo storage degli oggetti, il nome della credenziale è OCI$RESOURCE_PRINCIPAL. In alternativa, quando si utilizza AUTH_TOKEN per eseguire l'autenticazione con lo storage degli oggetti, il nome della credenziale è il valore specificato per il parametro credential_name nella procedura DBMS_CLOUD.CREATE_CREDENTIAL. Si noti tuttavia che il valore visualizzato sopra (NOSQLADWDB_OBJ_STORE_CREDENTIAL) è solo un esempio. Puoi usare qualsiasi nome desideri. Pertanto, il parametro dbmsCredentialName nel file di configurazione deve contenere il valore OCI$RESOURCE_PRINCIPAL o il nome specificato qui per il parametro credential_name; a seconda del meccanismo di autenticazione che si sceglie di utilizzare per l'autenticazione del database Oracle Autonomous AI Lakehouse con lo storage degli oggetti.