Base de datos Oracle

Resumen

Elemento Descripción
Estado de la versión Disponibilidad general
Productos Excel
Power BI (Modelos semánticos)
Power BI (Flujos de datos)
Fabric (Flujo de datos Gen2)
Power Apps (Flujos de datos)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticación admitidos Windows (escritorio / en línea)
Base de datos (escritorio)
Basic (en línea)
Cuenta de Microsoft (escritorio)
Documentación de Referencia de Funciones Oracle.Database

Nota:

Algunas capacidades pueden estar presentes en un producto, pero otras no, debido a los programas de implementación y las capacidades específicas del host.

Requisitos previos

Versiones de Oracle compatibles:

  • Oracle Database Server 12c (12.1.0.2) y versiones posteriores
  • Oracle Autonomous Database - todas las versiones

Para poder conectarse a una base de datos de Oracle mediante Power Query, debe instalar Oracle Client for Microsoft Tools (OCMT).

Para conectarse a una base de datos de Oracle con la puerta de enlace de datos local, en el equipo donde se ejecute la puerta de enlace debe estar instalado OCMT de 64 bits. Para más información, vaya a Administrar el origen de datos: Oracle.

Funcionalidades admitidas

  • Importar
  • DirectQuery (modelos semánticos de Power BI)
  • Opciones avanzadas
    • Tiempo de espera del comando en minutos
    • SQL statement
    • Incluir columnas de relación
    • Navegar usando la jerarquía completa

Descarga e instalación de Oracle Client for Microsoft Tools

Oracle Client for Microsoft Tools instala y configura el proveedor de datos de Oracle para .NET (ODP.NET) para admitir conexiones de herramientas de Microsoft de 32 bits y 64 bits con bases de datos locales y en la nube de Oracle, incluida la base de datos autónoma de Oracle (ADB). OCMT es un instalador gráfico que automatiza el proceso de configuración de Oracle Database Client. Admite la conexión con Power BI Desktop, el servicio Power BI, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services y BizTalk Server.

OCMT es un software gratuito. Se puede descargar desde la página de Oracle Client for Microsoft Tools. Para Power BI Desktop y el servicio Power BI de 64 bits, utilice OCMT de 64 bits. Para Power BI Desktop de 32 bits, utilice OCMT de 32 bits.

Incluso si ya cuenta con un cliente de Oracle o ODP.NET instalado en el cliente de Power BI, se recomienda encarecidamente utilizar el instalador de OCMT para completar correctamente todos los pasos de configuración que Power BI necesita para trabajar con la base de datos de Oracle.

Conexión a una base de datos de Oracle local desde Power Query Desktop

Siga estos pasos para establecer la conexión:

  1. Seleccione la opción de la Base de datos de Oracle en la selección de conectores.

  2. Especifique el nombre del servicio de red de Oracle o el alias de TNS, o bien la cadena de conexión de Easy Connect (Plus), para conectarse en el servidor. Easy Connect es el más sencillo de utilizar a la hora de establecer el valor del servidor en el Hostname/ServiceName del servidor de Oracle Database, donde ServiceName es el nombre de la base de datos global. En la captura de pantalla siguiente se utiliza un nombre de servicio de red.

    Escriba la conexión de Oracle Database.

  3. Si se conecta desde el espacio de trabajo Power BI, seleccione la opción de Importación o el modo de conectividad de datos DirectQuery. El resto de estos pasos de ejemplo utilizan el modo de conectividad de importación de datos. Para obtener mayor información acerca de DirectQuery, vaya a Usar DirectQuery en el espacio de trabajo Power BI.

  4. Si es la primera vez que se conecta a esta base de datos Oracle, seleccione el tipo de autenticación que desea utilizar y, a continuación, introduzca sus credenciales. Los tipos de autenticación disponibles son:

    • Windows (autenticación de Windows)
    • Base de datos (nombre de usuario y contraseña)
    • Cuenta de Microsoft (Microsoft Entra ID)

    Para obtener más información acerca de los métodos de autenticación, vaya a Autenticación con un origen de datos.

    Escriba las credenciales de la base de datos de Oracle.

  5. En el Navegador, seleccione los datos que necesita y, a continuación, seleccione Carga para cargar los datos o Transformar los Datos para transformarlos.

Conexión a una base de datos de Oracle local desde Power Query Online

Siga estos pasos para establecer la conexión:

  1. Instalación y configuración de una puerta de enlace de datos local.

  2. En Power Query Online, seleccione la opción Base de datos de Oracle en la selección de orígenes de datos.

  3. En el cuadro de diálogo de la Base de datos de Oracle que aparece, especifique el nombre del servicio de red o el alias de TNS de Oracle, la cadena de conexión de Easy Connect Plus o el descriptor de conexión al que conectarse en el servidor.

    Escriba la conexión de Oracle Database Online.

  4. Proporcione un Nombre de conexión, como "testoracleserver".

  5. Seleccione el nombre de la puerta de enlace de datos local.

    Nota:

    Seleccione el nombre de la puerta de enlace de datos local.

  6. Si se conecta a esta base de datos Oracle por primera vez, seleccione el tipo de credenciales para la conexión en Tipo de autenticación. Elija Básico si tiene previsto iniciar sesión con un nombre de usuario y una contraseña de Oracle. Elija Windows al usar la autenticación del sistema operativo Windows y tanto con el cliente de Oracle como con el servidor que se ejecutan en Windows.

  7. Especifique sus credenciales.

  8. Seleccione Siguiente para continuar.

  9. En Navegador, seleccione los datos que necesita y, a continuación, seleccione Transformar datos para transformar los datos en el Editor de Power Query.

Conectarse a una Base de datos Autónoma de Oracle

Nota:

Actualmente, puede conectarse a una base de datos autónoma de Oracle desde Excel, Power BI Desktop, el servicio Power BI, Fabric (Dataflow Gen2), Power Apps, SQL Server Analysis Services y BizTalk Server mediante los procedimientos de esta sección. Estas herramientas utilizan ODP.NET no administrados para conectarse. Otras herramientas de Microsoft, incluidas SQL Server Data Tools, SQL Server Integration Services y SQL Server Reporting Services, utilizan ODP.NET administrados para conectarse a la base de datos autónoma de Oracle mediante procedimientos muy similares.

Para conectar Power BI a una base de datos autónoma de Oracle, necesita las siguientes cuentas y aplicaciones:

Descargue sus credenciales de cliente

El primer paso para configurar una conexión a Oracle Autonomous Database es descargar las credenciales de cliente.

Para descargar sus credenciales de cliente:

  1. En la página Detalles de Oracle Autonomous database, seleccione Conexión DB.

    Conexión de base de datos.

  2. Desde el Conexión a la Base de Datos página, seleccionar Descargar Billetera.

    Descargar cartera.

  3. Ingrese una contraseña que le gustaría usar con esta billetera, confirme la contraseña y luego seleccione Descargar.

    Contraseña de cartera.

Configurar las credenciales de Oracle ADB

  1. En su máquina Windows, vaya a la carpeta desde la cual descargó sus credenciales de Oracle ADB Descargue sus credenciales de cliente.

  2. Descomprima las credenciales en el directorio que usted especificó en OCMT como el directorio de archivos de configuración de Oracle. En este ejemplo, las credenciales se extraen a c:\data\wallet\wallet_contosomart.

    Imagen con los archivos de cartera descomprimidos en la carpeta wallet.

    Nota:

    El archivo tnsnames.ora define la dirección y la información de conexión de la base de datos autónoma de Oracle.

  3. Abra sqlnet.ora en un editor, como el Bloc de notas.

  4. Bajo WALLET_LOCATION, cambie la ruta a la carpeta de su billetera en la opción Directorio. En este ejemplo:

    WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

  5. Guarde y cierre sqlnet.ora file.

Abra el archivo de tnsnames.ora en la carpeta carteras. El archivo contiene una lista de nombres del servicios de la red ADB a los cuales puede conectarse. En este ejemplo, los nombres son contosomart_high, contosomart_low, and contosomart_medium. Los nombres de los servicios de la red ADB son diferentes.

Imagen con tres nombres de TNS de ejemplo, contosomart_high, contosomart_low y contosomart_medium.

Conectar Power BI Desktop a Oracle ADB

  1. Abra Power BI Desktop.

  2. Seleccione Obtener datos.

  3. Desde Obtener Datos, seleccione Base de datos> Base de datos de Oracle.

  4. Escriba el nombre del servidor de red de la base de datos autónoma de Oracle a la que desea conectarse. En este ejemplo, el servidor es contosomart_high. Después, seleccione Aceptar.

    Imagen del cuadro de diálogo de Oracle Database con contosomart_high como nombre del servidor y modo de importación seleccionado.

  5. Si inicia sesión en este servidor desde el espacio de trabajo de Power BI por primera vez, se le pedirá que introduzca sus credenciales. Seleccione la Base de Datos, a continuación, introduzca el nombre de usuario y la contraseña de la base de datos de Oracle. Las credenciales que introduzca aquí son el nombre de usuario y la contraseña de la base de datos autónoma de Oracle específica a la cual desea conectarse. En este ejemplo, se utilizan el nombre de usuario y la contraseña de administrador inicial de la base de datos. A continuación, seleccione Conectar.

    Imagen del cuadro de diálogo de credenciales, con Base de datos seleccionado y el nombre de usuario y la contraseña de la base de datos predeterminada.

    Nota:

    Puede utilizar la autenticación de Microsoft Entra ID para iniciar sesión en la base de datos autónoma de Oracle a través de la opción Cuenta de Microsoft.

En este punto, el Navegador aparece y muestra los datos de conexión.

Imagen con el navegador abierto y la base de datos contosomart_high mostrada con todo su

También puede encontrar uno de varios errores porque la configuración no se ha configurado correctamente. Estos errores se discuten en la Solución de Problemas.

Un error que podría ocurrir en esta prueba inicial tiene lugar en el Navegador, donde la base de datos parece estar conectada, pero no contiene datos. En cambio, un Oráculo: ORA-28759: error al abrir el archivo aparece en el lugar de los datos.

Imagen del navegador con el nombre de la base de datos en la parte superior, pero aparece un error en lugar de los datos.

Si se produce este error, asegúrese de que la ruta de la carpeta de la cartera que proporcionó en sqlnet.ora es la ruta completa y correcta a la carpeta de la billetera.

Configuración de la puerta de enlace

  1. Instalación y configuración de una puerta de enlace de datos local.

  2. En el servicio Power BI, seleccione el icono del engranaje en la parte superior derecha y, a continuación, seleccione Administrar las puertas de enlace.

    Imagen del servicio Power BI abierto, el icono de engranaje seleccionado y el menú Administrar puertas de enlace con Administrar puertas de enlace resaltado.

  3. En Añadir Fuente de Datos, seleccione Agregar los orígenes de datos para usar la puerta de enlace.

    Imagen de la ventana Agregar origen de datos al servicio Power BI, con Agregar origen de datos para usar la puerta de enlace resaltado.

  4. En el Nombre de la Fuente de Datos, escriba el nombre que desea utilizar como la configuración de origen de datos.

  5. En Tipo de Fuente de Datos, seleccione Oráculo.

  6. En el servidor, escriba el nombre del servidor de red de la base de datos autónoma de Oracle a la que desea conectarse.

  7. En el Método de Autenticación, seleccione Basic.

  8. Introduzca el nombre de usuario y la contraseña de la base de datos autónoma de Oracle. En este ejemplo, se utilizan el nombre de usuario y la contraseña predeterminados del administrador (ADMIN) de la base de datos.

  9. Seleccione Agregar.

    Imagen de la ventana Configuración del origen de datos, con toda la configuración del origen de datos rellenada.

Si todo se ha instalado y configurado correctamente, aparece el mensaje de Conexión Exitosa. Ahora puede conectarse a la base de datos autónoma de Oracle siguiendo los mismos pasos descritos en Conectarse a una base de datos local de Oracle desde Power Query Online.

Conectarse mediante las opciones avanzadas

El espacio de trabajo de Power Query y Power Query Online proporcionan un conjunto de opciones avanzadas que puede agregar a su consulta de ser necesario.

En la siguiente tabla se enumeran todas las opciones avanzadas que puede configurar en el espacio de trabajo de Power Query y en Power Query Online.

Opción avanzada Descripción
Tiempo de espera del comando en minutos Si la conexión dura más de 10 minutos (el tiempo de espera predeterminado), puede escribir otro valor en minutos para mantener la conexión abierta más tiempo. Esta opción solo está disponible en Power Query Desktop.
Instrucción SQL Para obtener información, vaya a Importar datos de una base de datos mediante una consulta de base de datos nativa.
Incluir columnas de relación Si está activada, incluye columnas que podrían tener relaciones con otras tablas. Si esta casilla está desactivada, estas columnas no aparecen.
Navegar usando la jerarquía completa Si está activada, el navegador muestra la jerarquía completa de tablas en la base de datos a la que se conecta. Si se borra, el navegador muestra solo las tablas cuyas columnas y filas contienen datos.

Una vez que haya seleccionado las opciones avanzadas que necesita, seleccione OK en el espacio de trabajo de Power Query o Siguiente en Power Query Online para conectarse a su base de datos de Oracle.

Problemas y limitaciones conocidos

Las sesiones de Power BI pueden seguir activas en la base de datos Oracle durante aproximadamente 30 minutos después de una actualización del modelo semántico en esa base de datos Oracle. Solo después de aproximadamente 30 minutos, esas sesiones se hacen inactivas / se eliminan en la base de datos Oracle. Este comportamiento es por diseño.

Solución de problemas

Es posible que encuentre alguno de los varios errores de Oracle cuando la sintaxis de la nomenclatura es incorrecta o no está configurada correctamente:

  • ORA-12154: TNS: no se pudo resolver el identificador de la conexión especificado.
  • ORA-12514: TNS: el oyente no conoce actualmente el servicio solicitado en el descriptor de la conexión.
  • ORA-12541: TNS: ningún oyente.
  • ORA-12170: TNS: se ha producido un tiempo de espera de la conexión.
  • ORA-12504: TNS: el oyente no recibió el SERVICE_NAME en CONNECT_DATA.

Estos errores pueden producirse si el descriptor de conexión de la base de datos tnsnames.ora de Oracle está mal configurado, si el nombre del servicio de red proporcionado está mal escrito o si el agente de escucha de la base de datos de Oracle no se está ejecutando o no se puede acceder a él, como un firewall que bloquea el agente de escucha o el puerto de la base de datos. Asegúrese de que cumple con los requisitos previos mínimos de instalación. Más información: Requisitos previos

Visite el Portal de ayuda para errores de Oracle Database para revisar las causas comunes y soluciones del error específico de Oracle que encuentre. Escriba el error de Oracle en la barra de búsqueda del portal.

Si descargó el espacio de trabajo de Power BI de Microsoft Store, es posible que no pueda conectarse a las bases de datos de Oracle debido a un problema con el controlador de Oracle. Si se encuentra con este problema, el mensaje de error devuelto es: No se ha establecido la referencia del objeto. Para solucionar el problema, siga los siguientes pasos:

  • Descargue el espacio de trabajo de Power BI desde el Centro de descargas en lugar de Microsoft Store.

Si en la Referencia del objeto no establecida aparece un mensaje de error en Power BI cuando se conecta a una base de datos Oracle mediante la puerta de enlace de datos local, siga las instrucciones de Administrar su fuente de datos de Oracle.

Si está utilizando Power BI Report Server, consulte la guía en el artículo del Tipo de Conexión de Oracle.

Pasos siguientes

Optimizar Power Query al expandir columnas de tabla