Crear objetos visuales R en el servicio Power BICreating R visuals in the Power BI service

El servicio Power BI permite ver e interactuar con objetos visuales creados con scripts R.The Power BI service supports viewing and interacting with visuals created with R scripts. Los objetos visuales creados con scripts R, normalmente denominados objetos visuales R, pueden presentar forma de datos y análisis avanzados como la previsión, con análisis enriquecidos y la potencia de visualización de R.Visuals created with R scripts, commonly called R visuals, can present advanced data shaping and analytics such as forecasting, using the rich analytics and visualization power of R.

Nota

El lenguaje de programación R se encuentra entre los lenguajes de programación más usados normalmente por analistas de negocios, científicos de datos y estadistas.The R programming language is among the most widely used programming languages by statisticians, data scientists, and business analysts. El lenguaje R tiene una comunidad de código abierto que ofrece más de 7.000 paquetes de complementos, así como grupos de usuarios de R ampliamente usados.The R language has an open source community that offers over 7,000 add-on packages, as well as widely used R User Groups. La versión de R implementada en el servicio Power BI es Revolution R Open 3.2.2.The version of R deployed in the Power BI service is Revolution R Open 3.2.2.

La siguiente imagen muestra un panel de Power BI con una colección de objetos visuales R que se usan para análisis avanzados.The following image shows a Power BI dashboard with a collection of R visuals used for advanced analytics.

Los objetos visuales R se crean en un informe de Power BI Desktop, al igual que el informe que se muestra en la siguiente imagen.R visuals are created in a Power BI Desktop report, like the report shown in the following image.

Una vez creado el informe en Power BI Desktop, puede publicar el informe que contiene uno o más objetos visuales R en el servicio Power BI.Once the report is created in Power BI Desktop, you can publish the report containing one or more R visuals to the Power BI service. Actualmente, los objetos visuales R solo se pueden crear en Power BI Desktop y, después, se publican en el servicio Power BI.R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. Para obtener más información sobre cómo crear objetos visuales R, consulte Crear objetos visuales de Power BI con R (Power BI Desktop).For more information on creating R visuals, see Create Power BI visuals using R (Power BI Desktop).

Tenga en cuenta que en el servicio no son compatibles todos los paquetes R.Note that in the service not all of the R packages are supported. Vea los paquetes compatibles al final de este artículo para obtener la lista de paquetes que se admiten actualmente en el servicio Power BI.See supported packages at the end of this article for the list of packages currently supported in the Power BI service.

Puede descargar este archivo de ejemplo de Power BI Desktop (archivo .pbix) que contiene algunos objetos visuales R para ver cómo funciona y experimentar.You can download this sample Power BI Desktop file (.pbix file) that contains a few R visuals to see how this works, and to experiment.

Los objetos visuales R se crean en Power BI Desktop y, después, se publican en el servicio Power BI. La mayor parte de las veces se comportan como cualquier otro objeto visual en el servicio Power BI: puede interactuar, filtrar, segmentar y anclarlos en un panel o compartirlos con otras personas.R visuals that are created in Power BI Desktop, and then published to the Power BI service, for the most part behave like any other visual in the Power BI service; you can interact, filter, slice, and pin them to a dashboard, or share them with others. Para obtener más información sobre cómo compartir paneles y objetos visuales, consulte Compartir un panel con compañeros y otros usuarios.For more information about sharing dashboards and visuals, see share a dashboard with colleagues and others. Una diferencia con otros objetos visuales es que los objetos visuales R no pueden mostrar información sobre herramientas y no se pueden usar para filtrar otros objetos visuales.One difference from other visuals is that R visuals cannot show tool tips and cannot be used to filter other visuals.

Como puede ver en la siguiente imagen, los objetos visuales R en el servicio Power BI, ya sea en paneles o informes, aparecen y se comportan en gran medida como cualquier otro objeto visual y los usuarios no tienen que tener en cuenta el script R subyacente que ha creado el objeto visual.As you can see in the following image, R visuals in the Power BI service, either in dashboards or reports, largely appear and behave like any other visual, and users don't need to be aware of the underlying R script that created the visual.

Seguridad de scripts RR scripts security

Los objetos visuales R se crean a partir de scripts R, que podrían contener código que presente riesgos para la seguridad o la privacidad.R visuals are created from R scripts, which could potentially contain code with security or privacy risks.

Estos riesgos existen principalmente en la fase de creación cuando el autor del script lo ejecuta en su propio equipo.These risks mainly exist in the authoring phase when the script author run the script on their own computer.

El servicio Power BI aplica una tecnología de espacio aislado para proteger a los usuarios y al servicio de los riesgos de seguridad.The Power BI service applies a sandbox technology to protect users and the service from security risks.

Este enfoque de espacio aislado impone algunas restricciones en los scripts R que se ejecutan en el servicio Power BI, como el acceso a Internet o a otros recursos que no se necesitan para crear el objeto visual R.This sandbox approach imposes some restrictions on the R scripts running in the Power BI service, such as accessing the Internet, or accessing to other resources that are not required to create the R visual.

Experiencia de error de scripts RR scripts error experience

Si un script R encuentra un error, el objeto visual R no se traza y se muestra un mensaje de error.When an R script encounters an error, the R visual is not plotted and an error message is displayed. Para obtener más información sobre el error, seleccione Ver detalles en el error del objeto visual R del lienzo, tal y como se muestra en la siguiente imagen.For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

Como otro ejemplo, la siguiente imagen muestra el mensaje de error que aparece si no se pudo ejecutar correctamente un script R debido a que falta un paquete R en Azure.As another example, the following image shows the error message that appears when an R script failed to run properly due to a missing R package in Azure.

Administración de licenciasLicensing

Los objetos visuales R requieren una licencia de Power BI Pro para representarse en informes, actualizar, filtrar y filtrar de forma cruzada.R visuals require a Power BI Pro license to render in reports, refresh, filter and cross-filter. Para obtener más información sobre las licencias de Power BI Pro y cómo se diferencian de las licencias gratuitas, consulte Contenido de Power BI Pro: ¿qué es?For more information about Power BI Pro licenses, and how they differ from free licenses, see Power BI Pro content - what is it?

Los usuarios gratuitos de Power BI solo pueden usar iconos compartidos con ellos.Free users of Power BI can only consume tiles shared with them. Consulte Adquisición de Power BI Pro para obtener más información.See purchasing Power BI Pro for more information.

En la siguiente tabla se describen las funcionalidades de los objetos visuales R según las licencias.The following table describes R visuals capabilities based on licensing.

Limitaciones conocidasKnown Limitations

Los objetos visuales R en el servicio Power BI tienen algunas limitaciones:R visuals in the Power BI service have a few limitations:

  • La compatibilidad con objetos visuales R se limita a los paquetes que se identifican en la siguiente página .R visuals support is limited to the packages identified on the following page . Actualmente, no hay compatibilidad para paquetes personalizados.There currently is no support for custom packages.
  • Limitaciones de tamaño de datos: los datos que usa el objeto visual de R para el trazado están limitados a 150.000 filas.Data size limitations – data used by the R visual for plotting is limited to 150,000 rows. Si se seleccionan más de 150.000 filas, solo se usan las primeras 150.000 y se muestra un mensaje en la imagen.If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.
  • Límite de tiempo de cálculo: si un cálculo de objeto visual R supera los 60 segundos, se agota el tiempo de espera del script y se genera un error.Calculation time limitation – if an R visual calculation exceeds 60 seconds the script times out, resulting in an error.
  • Los objetos visuales de R se actualizan en las actualizaciones de datos, el filtrado y el resaltado.R visuals are refreshed upon data updates, filtering, and highlighting. En cambio, la imagen en sí no es interactiva y no es compatible con la información sobre herramientas.However, the image itself is not interactive and does not support tool tips.
  • Los objetos visuales de R responden al resaltado de otros objetos visuales, pero no puede hacer clic en elementos del objeto visual de R para aplicar un filtro cruzado a otros elementos.R visuals respond to highlighting other visuals, but you cannot click on elements in the R visual in order to cross filter other elements.
  • Los objetos visuales R no se admiten para el tipo de datos Hora.R visuals are currently not supported for the Time data type. Use Fecha y hora en su lugar.Please use Date/Time instead.
  • Los objetos visuales R no se muestran al usar Publicar en Web.R Visuals do not display when using Publish to web.
  • Actualmente, los objetos visuales R no se imprimen con la impresión de informes y panelR visuals currently do not print with dashboard and reports printing
  • Actualmente, no se admiten los objetos visuales R en el modo DirectQuery de Analysis ServicesR visuals are currently not supported in the DirectQuery mode of Analysis Services
  • Las fuentes de los idiomas chino, japonés y coreano requieren todos los pasos adicionales siguientes para que funcionen correctamente en el servicio Power BI:Chinese, Japanese and Korean fonts require all of the additional following steps to work properly in the Power BI service:

    • En primer lugar, instale el paquete de R showtext y todas sus dependencias.First, install the R package showtext and all of its dependencies. Puede hacerlo mediante la ejecución del siguiente script:You can do this by running the following script:

      *install.packages("showtext")*
      
    • A continuación, agregue la línea siguiente al comienzo del script de R:Next, add the following line at the beginning of the R script:

      powerbi_rEnableShowTextForCJKLanguages =  1
      

Información general de paquetes ROverview of R packages

Los paquetes R son colecciones de funciones, datos y código compilado R que se combinan en un formato bien definido.R packages are collections of R functions, data, and compiled code that are combined in a well-defined format. Cuando se instala R, incluye un conjunto estándar de paquetes y hay otros paquetes disponibles para su descarga e instalación.When R is installed, it comes with a standard set of packages, and other packages are available for download and installation. Una vez instalado, se debe cargar un paquete R en la sesión que se usará.Once installed, an R packages must be loaded into the session to be used. El origen principal de los paquetes R gratuitos es CRAN, la red integral de archivos R.The primary source of free R packages is CRAN, the Comprehensive R Archive Network.

Power BI Desktop puede usar cualquier tipo de paquetes R sin limitaciones.Power BI Desktop can use any type of R packages without limitation. Puede instalar paquetes R para usarlos en Power BI Desktop por su cuenta (mediante el IDE de RStudio, por ejemplo).You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

Los objetos visuales de R en el servicio Power BI son compatibles con los paquetes que se encuentran en la sección Paquetes admitidos de este artículo.R visuals in the Power BI service are supported by the packages found in the Supported Packages section found in this article. Si no encuentra un paquete que le interesa en la lista de paquetes admitidos, puede solicitar la compatibilidad del paquete.If you don't find a package you're interested in among the supported packages list, you can request the support of the package. Consulte R packages in the Power BI service (Paquetes de R en el servicio Power BI) para información sobre cómo solicitar soporte técnico.See R packages in the Power BI service for information on how to request support.

Requisitos y limitaciones de los paquetes RRequirements and Limitations of R packages

Hay una serie de requisitos y limitaciones para los paquetes R:There are a handful of requirements and limitations for R packages:

  • El servicio Power BI, en su mayor parte, es compatible con los paquetes R con licencias de software gratuitas y de código abierto como GPL-2, GPL-3, MIT+, etc.The Power BI service, for the most part, supports R packages with free and open-source software licenses such as GPL-2, GPL-3, MIT+, and so on.
  • El servicio Power BI admite paquetes publicados en CRAN.The Power BI service supports packages published in CRAN. El servicio no es compatible con paquetes R personalizados o privados.The service does not support private or custom R packages. Animamos a los usuarios a que pongan sus paquetes privados a disposición de CRAN antes de solicitar que el paquete esté disponible en el servicio Power BI.We encourage users to make their private packages available on CRAN prior to requesting the package be available in the Power BI service.
  • Power BI Desktop tiene dos variaciones para paquetes R:For Power BI Desktop has two variations for R packages:

    • Para los objetos visuales R, puede instalar cualquier paquete, incluidos los paquetes R personalizados.For R visuals, you can install any package, including custom R packages
    • Para objetos visuales R personalizados, para la instalación automática solo se admiten los paquetes CRAN públicos.For Custom R visuals, only public CRAN packages are supported for auto-installation of the packages
  • Por motivos de privacidad y seguridad, actualmente no se admiten los paquetes R que proporcionan consultas cliente-servidor mediante la World Wide Web (como RgoogleMaps) en el servicio.For security and privacy reasons, we currently don't support R packages that provide client-server queries over the World-Wide Web (such as RgoogleMaps) in the service. Las redes están bloqueadas para estos intentos.Networking is blocked for such attempts. Consulte R packages in the Power BI service (Paquetes de R en el servicio Power BI) para una lista de los paquetes de R que se admiten y los que no.See R packages in the Power BI service for a list of supported and unsupported R packages.
  • El proceso de aprobación para incluir un nuevo paquete R tiene un árbol de dependencias. No se admiten algunas dependencias que deben estar instaladas en el servicio.The approval process for including a new R package has a tree of dependencies; some dependencies required to be installed in the service cannot be supported.

Paquetes admitidos:Supported Packages:

Para una lista extendida de paquetes de R compatibles (y la breve lista de paquetes incompatibles), consulte el artículo siguiente:For a long list of supported R packages (and the short list of unsupported packages) please see the following article: