Crear objetos visuales de Power BI con RCreate Power BI visuals using R

Con Power BI Desktop, puede usar R para visualizar los datos.With Power BI Desktop, you can use R to visualize your data.

Instalar RInstall R

Power BI Desktop no incluye, implementa ni instala el motor de R.Power BI Desktop does not include, deploy or install the R engine. Para ejecutar scripts de R en Power BI Desktop, deberá instalar R en el equipo local por separado.To run R scripts in Power BI Desktop, you must separately install R on your local computer. Puede descargar e instalar R gratuitamente desde varias ubicaciones, incluyendo la página de descarga de Revolution Open y el repositorio de CRAN.You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. La versión actual de Scripting de R en Power BI Desktop admite caracteres Unicode, así como espacios (caracteres vacíos) en la ruta de instalación.The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Habilitar objetos visuales de REnable R visuals

Para habilitar los objetos visuales de R, seleccione Archivo > Opciones y configuración > Opciones y, en la página Opciones que aparece, asegúrese de que la instalación local de R esté especificada en la sección Scripting de R de la ventana Opciones, como se muestra en la imagen siguiente.To enable R visuals, select File > Options and settings > Options and in the Options page that appears, make sure your local R installation is specified in the R Scripting section of the Options window, as shown in the following image. En la imagen siguiente, la instalación local de la ruta de acceso de R es C:\Program Files\R\R-3.2.0 y esa ruta de acceso se proporciona explícitamente en el cuadro de texto.In the following image, the path local installation of R is C:\Program Files\R\R-3.2.0 and that path is explicitly provided in the text box. Asegúrese de que la ruta de acceso que se muestra refleje correctamente la instalación local de R que quiera que use Power BI Desktop.Make sure the path it displays properly reflects the local R installation you want Power BI Desktop to use.

Cuando se especifica la instalación de R, ya está listo para empezar a crear objetos visuales de R.Once you specify your R installation, you’re ready to begin creating R visuals.

Crear objetos visuales de R en Power BI DesktopCreate R visuals in Power BI Desktop

  1. Seleccione el icono de objeto visual de R en el panel de visualización como se muestra en la siguiente imagen, para agregar un objeto visual de R.Select the R Visual icon in the Visualization pane, as shown in the following image, to add an R visual.

  2. Al agregar un objeto visual de R a un informe, Power BI Desktop hace lo siguiente:When you add an R visual to a report, Power BI Desktop does the following:

    • Una imagen de marcador de posición de objeto visual de R aparece en el lienzo de informes.A placeholder R visual image appears on the report canvas.

    • El editor de scripts de R aparece en la parte inferior del panel central.The R script editor appears along the bottom of the center pane.

  3. A continuación, agregue los campos que quiera usar en el script de R a la sección Valores del área Campos, tal como lo haría con cualquier otro objeto visual de Power BI Desktop.Next, add fields you want to consume in your R script to the Values section in the Fields well, just as you would with any other Power BI Desktop visual. Solo los campos que se hayan agregado al área Campos estarán disponibles para el script de R, y podrá agregar nuevos campos o quitar los campos innecesarios del área Campos mientras trabaja en el script de R en el editor de scripts de R de Power BI Desktop.Only fields that have been added to the Fields well are available to your R script, and you can add new fields, or remove unneeded fields from the Fields well while working on your R script in the Power BI Desktop R script editor. Power BI Desktop detecta automáticamente los campos que agrega o quita.Power BI Desktop automatically detects which fields you have added or removed.

    Nota

    El tipo de agregación predeterminado para objetos visuales de R es No resumir.The default aggregation type for R visuals is do not summarize.

  4. Ahora puede usar los datos seleccionados para crear un trazado.Now you can use the data you selected to create a plot. Cuando selecciona campos, el editor de scripts de R genera un código de enlace de scripts de R auxiliar basado en las selecciones realizadas en la sección de color gris en la parte superior del panel del editor.As you select fields, the R script editor generates supporting R script binding code based on your selections in the gray section along the top of the editor pane. Al seleccionar o quitar campos adicionales, el código auxiliar del editor de scripts de R se genera o elimina automáticamente según corresponda.As you select or remove additional fields, supporting code in the R script editor is automatically generated or removed accordingly.

    En el ejemplo que se muestra en la imagen siguiente, se seleccionaron tres campos: hp, gear y drat.In the example shown in the following image, three fields were selected: hp, gear, and drat. Como resultado de esas selecciones, el editor de scripts de R generó el siguiente código de enlace:As a result of those selections, the R script editor generated the following binding code:

    • Se creó una trama de datos llamada dataset .A dataframe called dataset was created
      • Esa trama de datos consta de los distintos campos seleccionados por el usuarioThat dataframe is comprised of the different fields selected by the user
    • La agregación predeterminada es No resumirThe default aggregation is do not summarize
    • De forma similar a los objetos visuales de tabla, los campos se agrupan y las filas duplicadas aparecen solo una vezSimilar to table visuals, fields are grouped and duplicate rows only appear once

    Sugerencia

    En ciertos casos, puede que no quiera que se produzca una agrupación automática o que quiera que aparezcan todas las filas, incluso las duplicadas.In certain cases you may not want automatic grouping to occur, or you may want all rows to appear, including duplicates. En ese caso, puede agregar un campo de índice al conjunto de datos que haga que todas las filas se consideren únicas y evite la agrupación.In that case you can add an index field to your dataset which causes all rows to be considered unique, and prevents grouping.

    La trama de datos generada se denomina dataset, y se puede acceder a las columnas seleccionadas a través de sus respectivos nombres.The generated dataframe is called dataset, and selected columns can be accessed by their respective names. Por ejemplo, para acceder al campo gear, escriba dataset$gear en el script de R.For example, the gear field can be accessed by writing dataset$gear in your R script. Para los campos con espacios o caracteres especiales, use comillas simples.For fields with spaces or special characters, use single quotes.

  5. Con la trama de datos generada automáticamente por los campos seleccionados, ya podrá escribir un script de R que genere un trazado en el dispositivo predeterminado de R.With the dataframe automatically generated by the fields you selected, you’re ready to write R script that results in plotting to the R default device. Al finalizar el script, seleccione Ejecutar en la barra de título del editor de scripts de R (la opciónEjecutar se encuentra en el lado derecho de la barra de título).When the script is complete, select Run from the R script editor title bar (Run is on the right side of the title bar).

    Al seleccionar Ejecutar, Power BI Desktop identifica el trazado y lo presenta en el lienzo.When Run is selected, Power BI Desktop identifies the plot and present it on the canvas. Dado que el proceso se ejecuta en la instalación local de R, asegúrese de que estén instalados los paquetes necesarios.Since the process is executed on your local R installation, make sure required packages are installed.

    Power BI Desktop vuelve a trazar los objetos visuales cuando se produce alguno de los siguientes eventos:Power BI Desktop replots the visual when any of the following events occur:

    • Ejecutar está seleccionado en la barra de título del editor de scripts de RRun is selected from the R script editor title bar
    • Siempre que se produce un cambio de datos, debido a la actualización, filtrado o resaltado de datosWhenever a data change occurs, due to data refresh, filtering, or highlighting

La imagen siguiente muestra un ejemplo del código de trazado de correlación y traza las correlaciones entre atributos de distintos tipos de automóviles.The following image shows an example of the correlation plot code, and plots the correlations between attributes of different types of cars.

Para obtener una vista mayor de las visualizaciones, puede minimizar el editor de scripts de R.To get a larger view of the visualizations, you can minimize the R script editor. Por supuesto, al igual que con otros objetos visuales de Power BI Desktop, puede aplicar un filtro cruzado al trazado de correlación. Para ello, seleccione solo los automóviles deportivos en el objeto visual de anillo (el objeto visual redondo de la derecha, en la imagen de ejemplo anterior).And of course, like other visuals in Power BI Desktop, you can cross filter the correlation plot by selecting only sport cars in the donut visual (the round visual on the right, in the above example image).

También puede modificar el script de R para personalizar el objeto visual y aprovechar el potencial de R mediante la adición de parámetros al comando de trazado.You can also modify the R script to customize the visual, and take advantage of the power of R by adding parameters to the plotting command.

El comando de trazado original era el siguiente:The original plotting command was the following:

corrplot(M, method = "color",  tl.cex=0.6, tl.srt = 45, tl.col = "black")

Con unos pocos cambios en el script de R, el comando es ahora el siguiente:With a few changes in the R script, the command is now the following:

corrplot(M, method = "circle", tl.cex=0.6, tl.srt = 45, tl.col = "black", type= "upper", order="hclust")

Como resultado, ahora, el objeto visual de R traza círculos, solo tiene en cuenta la mitad superior y reordena la matriz para agrupar en clúster atributos correlacionados, como se muestra en la siguiente imagen.As a result, the R visual now plots circles, only considers at the upper half, and reorders the matrix to cluster correlated attributes, as shown in the following image.

Al ejecutar un script de R que genere un error, el objeto visual de R no se traza y se muestra un mensaje de error en el lienzo.When executing a R script that results in an error, the R visual is not plotted and an error message is displayed on the canvas. Para más información sobre el error, seleccione Ver detalles en el error del objeto visual de R del lienzo.For details on the error, select See details from the R visual error on the canvas.

Seguridad de scripts R: los objetos visuales de R se crean a partir de scripts R, que podrían contener código que presente riesgos para la seguridad o la privacidad.R scripts security: R visuals are created from R scripts, which could contain code with security or privacy risks. Al intentar ver o interactuar con un objeto visual de R por primera vez, un usuario recibe un mensaje de advertencia de seguridad.When attempting to view or interact with an R visual the first time, a user is presented with a security warning message. Habilite los objetos visuales de R únicamente si confía en el autor y en el origen, o bien tras revisar el script R y asegurarse de que lo comprende.Only enable R visuals if you trust the author and source, or after you review and understand the R script.

Limitaciones conocidasKnown limitations

Los objetos visuales de R en Power BI Desktop tienen algunas limitaciones:R visuals in Power BI Desktop has a few limitations:

  • 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 cinco minutos, se agota el tiempo de espera de ejecución y se genera un error.Calculation time limitation – if an R visual calculation exceeds 5 minutes the execution times out, resulting in an error.
  • Relaciones: al igual que con otros objetos visuales de Power BI Desktop, si se seleccionan campos de datos de tablas diferentes sin ninguna relación definida entre ellos, se produce un error.Relationships – as with other Power BI Desktop visuals, if data fields from different tables with no defined relationship between them are selected, an error occurs.
  • 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. Sin embargo, la imagen en sí no es interactiva y no puede ser el origen del filtro cruzado.However, the image itself is not interactive and cannot be the source of cross-filtering.
  • 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.
  • Solo los trazados que se trazan con el dispositivo de pantalla predeterminado de R se muestran correctamente en el lienzo.Only plots that are plotted to the R default display device are displayed correctly on the canvas. Evite usar explícitamente un dispositivo de pantalla de R diferente.Avoid explicitly using a different R display device.
  • En esta versión, la versión de 32 bits de Power BI Desktop no identifica automáticamente las instalaciones RRO, por lo que debe proporcionar manualmente la ruta de acceso al directorio de instalación de R en Opciones y configuración > Opciones > Scripting de R.In this release, RRO installations are not automatically identified by the 32-bit version of Power BI Desktop, so you must manually provide the path to the R installation directory in Options and settings > Options > R Scripting.

Pasos siguientesNext steps

Eche un vistazo a la siguiente información adicional sobre R en Power BI.Take a look at the following additional information about R in Power BI.