Acceso a Oracle Autonomous AI Lakehouse

Pasos para acceder a Oracle Autonomous AI Lakehouse desde Oracle NoSQL Database Analytics Integrator.

Crear una base de datos en Oracle Autonomous AI Lakehouse

Debe crear una base de datos para acceder a Oracle Autonomous AI Lakehouse desde Oracle NoSQL Database Analytics Integrator. Para crear una base de datos en Oracle Autonomous AI Lakehouse, vaya a la consola de Oracle Cloud y realice lo siguiente:

Instalación de las credenciales necesarias para una conexión de base de datos segura

Las conexiones a la base de datos que ha creado en Oracle Autonomous AI Lakehouse deben ser seguras. Para que Oracle NoSQL Database Analytics Integrator se conecte de forma segura a la base de datos de Oracle Autonomous AI Lakehouse, la utilidad utiliza las credenciales que contiene Oracle Wallet.

Para obtener Oracle Wallet, vaya a la consola de Oracle Cloud y haga lo siguiente:
El archivo zip que se genera incluye los siguientes elementos:
  • Los archivos de configuración de red (tnsnames.ora y sqlnet.ora) necesarios para conectarse a la base de datos.
  • Archivo de cartera de SSO de apertura automática, cwallet.sso.
  • El archivo PKCS12, ewallet.p12, que está protegido por la contraseña de cartera que ha proporcionado al descargar el archivo zip mediante la consola de Oracle Cloud.
  • Almacén de claves Java y archivos de almacén de confianza, keystore.jks y truststore.jks; protegidos por la contraseña de cartera.
  • El archivo ojdbc.properties, que especifica la propiedad del sistema Java relacionada con la cartera necesaria para conectarse a la base de datos mediante JDBC.
  • Archivo README que contiene información de caducidad de cartera.

Después de obtener el archivo zip de cartera, anote la contraseña y almacene la cartera en cualquier entorno desde el que se va a conectar a la base de datos. Además, para utilizar Oracle NoSQL Database Analytics Integrator, el contenido extraído del archivo zip de cartera se debe instalar en el entorno en el que se ejecutará la utilidad. Por ejemplo, si está ejecutando la utilidad desde una instancia de Oracle Cloud Compute, debe extraer el contenido del archivo zip en cualquier directorio de esa instancia. A continuación, utilice la ruta de acceso a ese directorio como valor del parámetro databaseWallet en la sección de base de datos del archivo de configuración de la utilidad.

Activar la credencial de entidad de recurso o almacenar/activar el almacenamiento de objetos del usuario AUTH_TOKEN en la base de datos de Oracle Autonomous AI Lakehouse

Después de recuperar datos de la tabla de Cloud Service NoSQL deseada y de escribir esos datos en archivos de Parquet en Object Storage, Oracle NoSQL Database Analytics Integrator utiliza subprogramas del paquete DBMS_CLOUD de PL/SQL de Oracle para recuperar los archivos de Parquet de Object Storage. A continuación, carga los datos incluidos en esos archivos en una tabla de la base de datos que ha creado en Oracle Autonomous AI Lakehouse.

Para que Oracle NoSQL Database Analytics Integrator pueda hacer esto, debe proporcionar una forma para que la base de datos de Oracle Autonomous AI Lakehouse se autentique con Object Storage para acceder a esos archivos Parquet. La base de datos de Oracle Autonomous AI Lakehouse se puede autenticar con el servicio Object Storage de una de dos formas: mediante la entidad de recurso de OCI o un AUTH_TOKEN específico del usuario que usted o el administrador del sistema generan. El mecanismo de autenticación que decide utilizar se activa ejecutando los siguientes pasos desde la consola de Oracle Cloud.
  • Seleccione Oracle AI Database en el menú de la parte izquierda de la pantalla.
  • Seleccione Autonomous AI Database.

  • En Filtros aplicados, seleccione el compartimento en el que se encuentra la base de Datos.
  • Seleccione el enlace con el nombre mostrado que ha introducido al crear la base de datos.

  • En Acciones de base de datos, seleccione SQL.
  • En la ventana con la etiqueta [Hoja de trabajo]*, si desea autenticar la base de datos de Oracle Autonomous AI Lakehouse con Object Storage mediante la entidad de recurso, ejecute el siguiente procedimiento.
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();


    Como alternativa, si desea realizar la autenticación mediante AUTH_TOKEN que le ha proporcionado el administrador del sistema o que ha generado usted mismo, ejecute el procedimiento.

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


El procedimiento DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL permite que la entidad de recurso de OCI (denominada OCI$RESOURCE_PRINCIPAL) la utilice la base de datos de Oracle Autonomous AI Lakehouse al autenticarse con un recurso de OCI como Object Storage. El procedimiento DBMS_CLOUD.CREATE_CREDENTIAL cifra la credencial AUTH_TOKEN especificada y la almacena en una tabla de la base de datos denominada adwc_user. Cualquiera que sea el procedimiento que emplee, ese procedimiento se debe ejecutar solo una vez; después de lo cual se puede especificar el mismo nombre de credencial para todas las transferencias de Object Storage a la base de datos Oracle Autonomous AI Lakehouse.

Note:

Cuando la base de datos de Oracle Autonomous AI Lakehouse utiliza la entidad de recurso de OCI para autenticarse con Object Storage, el nombre de la credencial es OCI$RESOURCE_PRINCIPAL. También puede utilizar AUTH_TOKEN para autenticarse con Object Storage, el nombre de la credencial es el valor que especifique para el parámetro credential_name en el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL. Sin embargo, tenga en cuenta que el valor mostrado anteriormente (NOSQLADWDB_OBJ_STORE_CREDENTIAL) es solo un ejemplo. Puede utilizar cualquier nombre que desee. Por lo tanto, el parámetro dbmsCredentialName del archivo de configuración debe contener el valor OCI$RESOURCE_PRINCIPAL o el nombre que especifique aquí para el parámetro credential_name; en función del mecanismo de autenticación que elija emplear para autenticar la base de datos de Oracle Autonomous AI Lakehouse con Object Storage.