Conexión a la base de datos informática

En esta sección, se trata la conexión de los recursos informáticos de su AI Data Platform Workbench con otras herramientas de inteligencia empresarial.

Temas:

Conexiones

Puede conectar su área de trabajo de AI Data Platform con Oracle Analytics Cloud u otras herramientas de inteligencia empresarial.

Puede conectarse a Oracle AI Data Platform Workbench desde diferentes herramientas de inteligencia empresarial mediante un JDBC u ODBC personalizado proporcionado por AI Data Platform Workbench. AI Data Platform Workbench también admite conexiones de herramientas de BI comerciales de terceros (Tableau, Power BI) o herramientas de BI de código abierto como DBeaver. Para conectarse desde estas herramientas, necesita los detalles de conexión del cluster de recursos informáticos en el área de trabajo de AI Data Platform, que puede encontrar en el separador Detalles de conexión. La información necesaria varía según el producto desde el que se conecte.


Separador Detalles de conexión para el cluster de recursos informáticos Dev_cluster_1

Conecte Oracle Analytics al área de trabajo de AI Data Platform

Puede conectarse al catálogo o las tablas gestionadas por la instancia de AI Data Platform Workbench desde una instancia de Oracle Analytics Cloud.

Para crear una conexión de Oracle Analytics a Oracle AI Data Platform Workbench, debe hacer lo siguiente:

  1. Obtención de una clave de API de OCI.
  2. Obtención de un archivo de configuración de conexión de Oracle Analytics.
  3. Combine la clave de API y el archivo de configuración para crear la conexión. Consulte Creación de un archivo de conexión de Oracle Analytics.
  4. Utilice la conexión en Oracle Analytics Cloud. Consulte Conexión del área de trabajo de Oracle AI Data Platform a Oracle Analytics.

Puede realizar los pasos 1 y 2 en cualquier orden, pero ambos se deben realizar antes de continuar.

Oracle recomienda crear un usuario en OCI que esté dedicado al caso de uso de Oracle Analytics. Ese usuario debe tener los permisos adecuados para las tablas de su área de trabajo de AI Data Platform a las que desea acceder desde Oracle Analytics. Genere la clave de API necesaria en OCI y descargue el archivo PEM para el usuario creado para este fin.

Note:

  • Para conectarse a su AI Data Platform Workbench desde Oracle Analytics, debe proporcionar el nombre del catálogo durante la configuración de la conexión.
  • Actualmente, el catálogo es necesario para que el sistema localice el esquema y los objetos de datos correctos dentro del cluster de AI Data Platform.
  • Este requisito se aliviará en futuras versiones.

Obtención de una clave de API de OCI

Necesita una clave de API de OCI para un usuario que tenga acceso a su área de trabajo de Oracle AI Data Platform al crear una conexión a Oracle Analytics.

El usuario para el que cree la clave de API debe ser el creador de la instancia de AI Data Platform Workbench o tener permisos de administrador para la instancia. También debe tener un cluster de AI Data Platform Workbench válido en la instancia.
  1. En OCI, haga clic en el icono de usuario y, a continuación, en Configuración de usuario.

    Página inicial de OCI con perfil de usuario abierto y valores de usuario resaltados

  2. En Mi perfil, haga clic en Tokens y claves y, a continuación, en Agregar clave de API.

    Perfil de usuario de OCI abierto con nombre de usuario, claves de API y agregación de claves de API resaltadas

  3. Seleccione Generar par de claves de API y, a continuación, haga clic en Descargar clave privada.

    Se abre la página Agregar clave de API con el par Generar clave de API seleccionado y se resalta la opción Descargar clave privada

  4. Haga clic en Agregar.
Guarde la clave privada (archivo .pem) que recibe en una ubicación segura y persistente. Es necesario para las conexiones y solo se puede descargar una vez. Este archivo se utiliza como huella al conectar Oracle Analytics a su área de trabajo de AI Data Platform.

Obtener un archivo de configuración de conexión de Oracle Analytics

Debe descargar un archivo config.json de la instancia de Oracle AI Data Platform Workbench para conectarlo a Oracle Analytics.

Necesita un cluster de recursos informáticos con al menos 2 OCPU, 32 GB de memoria tanto para los nodos de controlador como de trabajador, y al menos 2 trabajadores.
  1. Vaya al espacio de trabajo y haga clic en Recursos informáticos.

    Página Compute abierta con cluster_High Compute resaltada

  2. Haga clic en el cluster al que desea conectarse a Oracle Analytics.
  3. En el separador Detalles de conexión, haga clic en el icono Descargar debajo del logotipo de Oracle Analytics Cloud. Un archivo config.json se descarga en su máquina.

    Página de recursos informáticos para el cluster Cluster_High abierta con el separador Detalles de conexión y la descarga de Oracle Analytics Cloud resaltada

Falta el par de valores de clave de huella en el archivo config.json que ha descargado. Se debe combinar con el valor de clave de huella de una clave de API que pertenezca a un usuario de OCI que haya creado el área de trabajo de AI Data Platform o un usuario con permisos de administrador.
contenido del archivo config.json, incluidos nombre de usuario, arrendamiento, región y dsn

Creación de un archivo de conexión de Oracle Analytics

Debe agregar manualmente el par de valores de clave de huella al archivo config.json descargado de Oracle AI Data Platform Workbench para que el archivo se pueda utilizar para conectarse a Oracle Analytics.

Debe haber creado una clave de API para un usuario de OCI que haya creado la instancia de AI Data Platform Workbench o que tenga permisos de administrador para la instancia. También debe haber descargado config.json del cluster al que desea conectarse Oracle Analytics.
  1. Abra el archivo config.json y el archivo de configuración de la clave de API.
  2. Edite config.json para agregar el valor de huella desde el archivo de configuración de clave de API.

    Clave de API con usuario, huella digital, arrendamiento y región resaltados y Copiar resaltados

  3. Guarde los cambios en el archivo config.json.

    archivo config.json abierto con el par de claves de huella incluido

En futuras versiones, config.json incluirá la huella de la clave pública de la clave de API y ya no tendrá que agregarla manualmente. En esa versión, la última clave de API disponible para el usuario se utilizará en config.json.

Conecte Oracle AI Data Platform Workbench a Oracle Analytics

Puede conectarse al catálogo o las tablas gestionadas por la instancia de AI Data Platform Workbench desde una instancia de Oracle Analytics.

Las conexiones de Oracle Analytics a instancias de AI Data Platform Workbench solo soportan un catálogo por conexión. Debe crear conexiones adicionales para utilizar más de un catálogo.
  1. En la página de inicio de Oracle Analytics, haga clic en Crear y, a continuación, en Conexión.

    Página de inicio de Oracle Analytics con Crear y conectar resaltada

  2. Haga clic en Oracle AI Data Platform.

    Se abre el cuadro de diálogo Crear conexión con Oracle AI Data Platform resaltado

  3. Introduzca el nombre y la descripción de la conexión.

    Crear conexión para Oracle AI Data Platform abierta con detalles de conexión, catálogo y clave de API privada resaltados

  4. En Detalles de conexión, haga clic en Seleccionar, vaya al archivo config.json y haga clic en Abrir. Para obtener más información, consulte Creación de un archivo de conexión de Oracle Analytics.
  5. Seleccione Clave de API como tipo de autenticación.
  6. Introduzca el nombre del catálogo que se usará en los conjuntos de datos.
  7. En Private API Key, haga clic en Select y navegue hasta su clave de API privada (. Archivo PEM) y haga clic en Abrir. Para obtener más información, consulte Obtención de una clave de API de OCI.
  8. Haga clic en Guardar.
  9. Pruebe la nueva conexión creando un nuevo juego de datos. Para obtener más información, consulte Creación de un juego de datos a partir de una conexión.

Si ha seguido las instrucciones y aún tiene problemas para guardar la conexión o mostrar los esquemas, puede que sea necesario reiniciar el cluster.

Descargar controlador JDBC

Puede descargar el controlador JDBC desde el separador Detalles de conexión y configurarlo para diferentes herramientas de BI.

  1. Vaya al espacio de trabajo y haga clic en Recursos informáticos.
  2. Haga clic en el cluster que desea conectar a una herramienta de BI compatible con JDBC y haga clic en Conexiones.
  3. Haga clic en Descargar controlador JDBC.

Configuración de DBeaver

Debe instalar DBeaver y preparar los archivos descargados desde Oracle AI Data Platform Workbench para poder conectarlo a un cluster de recursos informáticos en su AI Data Platform Workbench.

  1. Descargue e instale el cliente DBeaver. Puede utilizar las versiones de Community o Enterprise, pero deben ser al menos 22.x.DBeaver solo está disponible para Windows, Mac OS X, Eclipse Plugin y Linux.
  2. Descomprima el archivo desde Descargar controlador JDBC.
  3. En los archivos descomprimidos, descomprima el archivo de controlador simbaSpark.zip.

Configuración de DBeaver con el controlador JDBC de Spark Simba

Puede configurar DBeaver para conectarse a un cluster de recursos informáticos en el área de trabajo de Oracle AI Data Platform.

Debe haber instalado DBeaver y extraído los archivos simbaSpark.zip descargados de AI Data Platform Workbench.
  1. Abra DBeaver.
  2. Haga clic en Navegador de base de datos.
  3. Haga clic en Gestor de controladores.
  4. Haga clic en Nuevo.
  5. Introduzca AI Data Platform como Nombre del controlador.
  6. Haga clic en Bibliotecas.
  7. Haga clic en Agregar Carpeta.
  8. Busque la ubicación de la extracción sparkSimba.zip.
  9. Haga clic en Buscar clase.
  10. Seleccione Aceptar.
  11. Defina Clase de controlador en com.simba.spark.jdbc.Driver.
  12. Haga clic en Configuración.
  13. Defina Nombre de clase en com.simba.spark.jdbc.Driver.
  14. Haga clic en Aceptar.

Creación de una conexión de base de datos en DBeaver

Para conectar DBeaver a un cluster de recursos informáticos en su Oracle AI Data Platform Workbench, primero debe crear una conexión a la base de datos en DBeaver.

Debe haber configurado DBeaver con el controlador JDBC de Spark Simba descargado desde AI Data Platform Workbench. Para obtener más información, consulte Configuración de DBeaver con el controlador JDBC de Spark Simba.
  1. Abra DBeaver.
  2. Haga clic en Base de datos.
  3. Haga clic en Nueva Conexión a Base de Datos.
  4. Haga clic en Todo.
  5. Seleccione Plataforma de datos de IA.
  6. Haga clic en Siguiente.
  7. Introduzca la URL del controlador JDBC. Puede encontrar la URL de JDBC en el separador Detalles de conexión del cluster de recursos informáticos en AI Data Platform Workbench.
  8. Haga clic en Finalizar.

Conexión de DBeaver a Oracle AI Data Platform Workbench mediante JDBC

Una vez que DBeaver esté configurado y tenga una conexión de base de datos a su AI Data Platform Workbench, puede completar la conexión entre DBeaver y AI Data Platform Workbench.

  1. Abra DBeaver.
  2. Haga clic en Conectar.
  3. Elija conectarse con un token de autorización o una clave de API.
    • Conexión mediante token de autorización
      • Utilice un token al no especificar ningún perfil en la URL si no tiene un perfil DEFAULT. Por ejemplo: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5

        La URL abre una ventana del explorador.

        Conéctese al arrendamiento en el que se crea la instancia de AI Data Platform Workbench.

        Para obtener más información, consulte Autenticación basada en token para CLI.

    • Conéctese mediante una clave de API especificando el perfil de OCI con ociProfile=<profile_name> en la URL de conexión.

      • Utilice la autenticación de clave de API para conectarse a una instancia de AI Data Platform Workbench.

        Utilice la clave de API especificando el perfil de OCI con ociProfile=<profile_name> en la URL de conexión. Por ejemplo, para utilizar la demostración de nombre de perfil de OCI: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo

        Para obtener más información, consulte Claves y OCID necesarios.

  4. DBeaver crea una conexión para leer metadatos y una conexión para todas las demás operaciones. Si tiene limitaciones para las conexiones, puede desactivar la segunda para que DBeaver utilice una conexión para todas las operaciones.
    1. Haga clic en Preferencias.
    2. Haga clic en Común.
    3. Haga clic en Metadatos.
    4. Anule la selección de Abrir conexión independiente para lecturas de metadatos.

Conexión de Tableau a AI Data Platform con JDBC

Puede conectar datos de su plataforma de datos de IA a Tableau para utilizarlos con sus análisis y visualizaciones.

  1. Vaya al espacio de trabajo y haga clic en Recursos informáticos.
  2. Haga clic en el cluster al que desea conectarse a Tableau y haga clic en el separador Detalles de conexión.
  3. Haga clic en Descargar controlador JDBC.
  4. Extraiga los archivos del archivo .zip descargado.
  5. Abra la carpeta principal de los archivos extraídos y extraiga el archivo JAR de Simba a la siguiente carpeta según el tipo de sistema operativo:
    • Linux: /opt/tableau/tableau_driver/jdbc
    • MacOS: ~/Library/Tableau/Drivers/
    • Windows: C:\Program Files\Tableau\Driver
    Por ejemplo, en MacOS, la ubicación del archivo JAR sería ~/Library/Tableau/Drivers/SparkJDBC42.jar.
  6. Abra el cliente Tableau.
  7. En la lista Conectar a un Servidor, busque bases de datos JDBC.
  8. Copie la URL de JDBC.
  9. Seleccione SQL92 para Dialect.
  10. Autenticar la conexión con uno de los siguientes métodos:
    • Autenticar con una clave de API
      • Utilizar el archivo de configuración de OCI por defecto y el perfil por defecto. Por ejemplo:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0
      • O, si no utiliza la ubicación por defecto, agregue la ubicación del archivo de configuración de OCI en la URL de JDBC de la conexión. Por ejemplo:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>
      • O, si no utiliza el perfil por defecto, agregue el perfil de OCI en la URL de JDBC de conexión. Por ejemplo:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>OCIProfile=<profile_name>
    • Autenticar mediante un token de autorización:
      • Para utilizar un token de autorización, no tenga un archivo de configuración en la ruta de acceso por defecto (por ejemplo, /Users/xyz/.oci/config) y no especifique ningún perfil en la URL. Por ejemplo:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0

      Para obtener más información, consulte Autenticación basada en token para CLI.

  11. Haga clic en Conectar.
  12. Opcional: si utiliza la autenticación basada en token, conéctese al arrendamiento en el que se ha creado la plataforma de datos de AI en la ventana del explorador que aparece.

Descargar controlador ODBC

Puede descargar el controlador ODBC desde el separador Detalles de conexión y configurarlo para diferentes herramientas de BI.

  1. Vaya al espacio de trabajo y haga clic en Recursos informáticos.
  2. Haga clic en el cluster al que desea conectarse a una herramienta de BI compatible con ODBC y haga clic en Conexiones.
  3. Haga clic en Descargar controlador ODBC.
  4. Seleccione el sistema operativo adecuado de la lista.

    ODBC Driver OS desplegable abierto con las opciones de Mac, Windows y Linx mostradas