Creazione di oggetti visivi R nel servizio Power BICreating R visuals in the Power BI service

Il servizio Power BI supporta la visualizzazione e l'interazione con oggetti visivi creati con gli script R.The Power BI service supports viewing and interacting with visuals created with R scripts. Gli oggetti visivi creati con gli script R, comunemente denominati oggetti visivi R, possono presentare funzionalità avanzate di data shaping e analisi, ad esempio le previsioni, usando le funzionalità avanzate di analisi e visualizzazione di 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

Il linguaggio di programmazione R è uno dei linguaggi di programmazione maggiormente usati da statistici, data scientist e business analyst.The R programming language is among the most widely used programming languages by statisticians, data scientists, and business analysts. Per il linguaggio R è disponibile una community open source che offre oltre 7.000 pacchetti di componenti aggiuntivi nonché gruppi di utenti R ampiamente usati.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 versione di R distribuita nel servizio Power BI è Revolution R Open 3.2.2.The version of R deployed in the Power BI service is Revolution R Open 3.2.2.

L'immagine seguente mostra un dashboard di Power BI con una raccolta di oggetti visivi R usati per l'analisi avanzata.The following image shows a Power BI dashboard with a collection of R visuals used for advanced analytics.

Gli oggetti visivi R vengono creati in un report di Power BI Desktop, simile al report mostrato nell'immagine seguente.R visuals are created in a Power BI Desktop report, like the report shown in the following image.

Dopo aver creato il report in Power BI Desktop, è possibile pubblicare il report che contiene uno o più oggetti visivi di R nel servizio 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. Attualmente gli oggetti visivi R possono essere creati solo in Power BI Desktop e quindi pubblicati nel servizio Power BI.R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. Per maggiori informazioni sulla creazione di oggetti visivi R, vedere Creare oggetti visivi di Power BI usando R (Power BI Desktop).For more information on creating R visuals, see Create Power BI visuals using R (Power BI Desktop).

Si noti che non tutti i pacchetti R sono supportati nel servizio.Note that in the service not all of the R packages are supported. L'elenco dei pacchetti attualmente supportati nel servizio Power BI è riportato alla fine di questo articolo.See supported packages at the end of this article for the list of packages currently supported in the Power BI service.

È possibile scaricare il file Power BI Desktop di esempio (file PBIX) che contiene alcuni oggetti visivi R utili per vedere il funzionamento del servizio e provare a usarlo.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.

Gli oggetti visivi R che vengono creati in Power BI Desktop, e quindi pubblicati nel servizio Power BI, nella maggior parte dei casi si comportano come qualsiasi altro oggetto visivo nel servizio Power BI; è possibile interagire con essi, filtrarli, suddividerli e quindi aggiungerli a un dashboard oppure condividerli con altri.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. Per maggiori informazioni sulla condivisione di dashboard e oggetti visivi, vedere Condividere un dashboard con i colleghi e altri utenti.For more information about sharing dashboards and visuals, see share a dashboard with colleagues and others. Rispetto ad altri oggetti visivi, gli oggetti visivi R non possono visualizzare descrizioni comandi e non possono essere usati per filtrare altri oggetti visivi.One difference from other visuals is that R visuals cannot show tool tips and cannot be used to filter other visuals.

Come è possibile vedere nell'immagine seguente, gli oggetti visivi R nel servizio Power BI, in dashboard o report, nella maggior parte dei casi vengono visualizzati e si comportano come qualsiasi altro oggetto visivo e non richiedono la conoscenza dello script R sottostante da parte degli utenti.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.

Sicurezza degli script RR scripts security

Gli oggetti visivi R vengono creati in base agli script R, che potrebbero contenere codice con rischi per la sicurezza o per la privacy.R visuals are created from R scripts, which could potentially contain code with security or privacy risks.

Tali rischi si manifestano principalmente nella fase di creazione, quando l'autore esegue lo script nel proprio computer.These risks mainly exist in the authoring phase when the script author run the script on their own computer.

Il servizio Power BI applica una tecnologia sandbox per proteggere gli utenti e il servizio dai rischi per la sicurezza.The Power BI service applies a sandbox technology to protect users and the service from security risks.

Questo approccio basato su sandbox impone alcune limitazioni relative agli script R in esecuzione nel servizio Power BI, ad esempio l'accesso a Internet o l'accesso ad altre risorse che non sono necessarie per creare l'oggetto visivo 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.

Errori degli script RR scripts error experience

In caso di errore di uno script R, l'oggetto visivo R non viene tracciato e viene visualizzato un messaggio di errore.When an R script encounters an error, the R visual is not plotted and an error message is displayed. Per informazioni dettagliate sull'errore, selezionare Visualizza i dettagli dall'errore dell'oggetto visivo R nell'area di disegno, come mostrato nell'immagine seguente.For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

Come ulteriore esempio, l'immagine seguente mostra il messaggio di errore visualizzato quando uno script R non è stato eseguito correttamente a causa di un pacchetto R mancante in 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.

Gestione delle licenzeLicensing

Gli oggetti visivi R richiedono una licenza Power BI Pro per il rendering nei report, l'aggiornamento, il filtro e il filtro incrociato.R visuals require a Power BI Pro license to render in reports, refresh, filter and cross-filter. Per maggiori informazioni sulle licenze Power BI Pro e sugli aspetti che le distinguono dalle licenze gratuite, vedere Contenuto Power BI Pro: di cosa si tratta?For more information about Power BI Pro licenses, and how they differ from free licenses, see Power BI Pro content - what is it?

Gli utenti della versione di Power BI gratuita possono usare solo i riquadri condivisi con loro.Free users of Power BI can only consume tiles shared with them. Vedere Acquisto di Power BI Pro per maggiori informazioni.See purchasing Power BI Pro for more information.

La tabella seguente descrive le funzionalità degli oggetti visivi R in base alle licenze.The following table describes R visuals capabilities based on licensing.

Limitazioni noteKnown Limitations

Gli oggetti visivi R nel servizio Power BI presentano alcune limitazioni:R visuals in the Power BI service have a few limitations:

  • Il supporto degli oggetti visivi R è limitato ai pacchetti identificati nella pagina seguente .R visuals support is limited to the packages identified on the following page . Attualmente non è disponibile il supporto per i pacchetti personalizzati.There currently is no support for custom packages.
  • Limitazioni relative alle dimensioni di dati: i dati usati dall'oggetto visivo R per il tracciato sono limitati a 150.000 righe.Data size limitations – data used by the R visual for plotting is limited to 150,000 rows. Se vengono selezionate più di 150.000 righe, vengono utilizzate solo le prime 150.000 righe e viene visualizzato un messaggio sull'immagine.If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.
  • Limitazione relativa al tempo di calcolo: se un calcolo dell'oggetto visivo R è maggiore di 60 secondi, si verifica il timeout dello script, determinando la generazione di un errore.Calculation time limitation – if an R visual calculation exceeds 60 seconds the script times out, resulting in an error.
  • Gli oggetti visivi R vengono aggiornati al momento dell'aggiornamento, del filtraggio e dell'evidenziazione dei dati.R visuals are refreshed upon data updates, filtering, and highlighting. Tuttavia, l'immagine stessa non è interattiva e non supporta le descrizioni comandi.However, the image itself is not interactive and does not support tool tips.
  • Gli oggetti visivi R rispondono all'evidenziazione di altri oggetti visivi, ma è possibile fare clic sugli elementi nell'oggetto visivo R per applicare un filtro incrociato ad altri elementi.R visuals respond to highlighting other visuals, but you cannot click on elements in the R visual in order to cross filter other elements.
  • Gli oggetti visivi R non sono attualmente supportati per il tipo di dati Time.R visuals are currently not supported for the Time data type. Usare invece Date/Time.Please use Date/Time instead.
  • Gli oggetti visivi R non vengono visualizzati quando si usa l'opzione Pubblica sul Web.R Visuals do not display when using Publish to web.
  • Gli oggetti visivi R attualmente non vengono stampati quando si esegue la stampa di dashboard e report.R visuals currently do not print with dashboard and reports printing
  • Gli oggetti visivi R non sono attualmente supportati nella modalità DirectQuery di Analysis Services.R visuals are currently not supported in the DirectQuery mode of Analysis Services
  • Per il corretto funzionamento dei tipi di carattere cinesi, giapponesi e coreani nel servizio Power BI, è necessario eseguire le operazioni aggiuntive seguenti:Chinese, Japanese and Korean fonts require all of the additional following steps to work properly in the Power BI service:

    • Installare innanzitutto il pacchetto R showtext e tutte le relative dipendenzeFirst, install the R package showtext and all of its dependencies. È possibile farlo eseguendo lo script seguente:You can do this by running the following script:

      *install.packages("showtext")*
      
    • Aggiungere quindi la riga seguente all'inizio dello script R:Next, add the following line at the beginning of the R script:

      powerbi_rEnableShowTextForCJKLanguages =  1
      

Panoramica dei pacchetti ROverview of R packages

I pacchetti R sono raccolte di funzioni, dati e codice compilato di R che vengono combinati in un formato ben definito.R packages are collections of R functions, data, and compiled code that are combined in a well-defined format. Quando si installa R, questo è dotato di un set standard di pacchetti e altri pacchetti sono disponibili per il download e l'installazione.When R is installed, it comes with a standard set of packages, and other packages are available for download and installation. Una volta installato, per usare un pacchetto R è necessario caricarlo nella sessione.Once installed, an R packages must be loaded into the session to be used. L'origine principale di pacchetti R gratuiti è CRAN, Comprehensive R Archive Network.The primary source of free R packages is CRAN, the Comprehensive R Archive Network.

Power BI Desktop può usare qualsiasi tipo di pacchetti R senza alcuna limitazione.Power BI Desktop can use any type of R packages without limitation. È possibile installare pacchetti R da usare in Power BI Desktop autonomamente (usando l'IDE RStudio, ad esempio).You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

Gli oggetti visivi R nel servizio Power BI sono supportati dai pacchetti reperibili nella sezione Pacchetti supportati in questo articolo.R visuals in the Power BI service are supported by the packages found in the Supported Packages section found in this article. Se nell'elenco dei pacchetti supportati non si trova un pacchetto a cui si è interessati, è possibile richiedere il supporto del pacchetto.If you don't find a package you're interested in among the supported packages list, you can request the support of the package. Per informazioni su come richiedere assistenza, vedere Pacchetti R nel servizio Power BI.See R packages in the Power BI service for information on how to request support.

Requisiti e limitazioni dei pacchetti RRequirements and Limitations of R packages

Ci sono alcuni requisiti e limitazioni per i pacchetti R:There are a handful of requirements and limitations for R packages:

  • Il servizio Power BI, nella maggior parte, supporta pacchetti R con licenze software gratuite e open source, ad esempio GPL-2, GPL-3, MIT+ e così via.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.
  • Il servizio Power BI supporta i pacchetti pubblicati in CRAN.The Power BI service supports packages published in CRAN. Il servizio non supporta i pacchetti R personalizzati o privati.The service does not support private or custom R packages. Si consiglia agli utenti di rendere i pacchetti privati disponibili in CRAN prima di richiedere la disponibilità del pacchetto nel servizio 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.
  • Per Power BI Desktop esistono due varianti per i pacchetti R:For Power BI Desktop has two variations for R packages:

    • Per gli oggetti visivi R, è possibile installare qualsiasi pacchetto, inclusi i pacchetti R personalizzatiFor R visuals, you can install any package, including custom R packages
    • Per gli oggetti visivi R personalizzati, sono supportati solo i pacchetti CRAN pubblici per l'installazione automatica dei pacchettiFor Custom R visuals, only public CRAN packages are supported for auto-installation of the packages
  • Per motivi di privacy e sicurezza, attualmente non sono supportati i pacchetti R che forniscono query client-server sul Web (ad esempio RgoogleMaps) nel servizio.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. La rete è bloccata per tali tentativi.Networking is blocked for such attempts. Per un elenco dei pacchetti R supportati e non supportati, vedere Pacchetti R nel servizio Power BI.See R packages in the Power BI service for a list of supported and unsupported R packages.
  • Il processo di approvazione per l'inclusione di un nuovo pacchetto R è caratterizzato da una struttura ad albero delle dipendenze; alcune dipendenze la cui installazione è richiesta nel servizio non possono essere supportate.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.

Pacchetti supportati:Supported Packages:

Per un lungo elenco di pacchetti R supportati (e il breve elenco dei pacchetti non supportati), vedere l'articolo seguente:For a long list of supported R packages (and the short list of unsupported packages) please see the following article: