Condividi tramite


Tipo di connessione Oracle (Power BI Report Builder)

SI APPLICA A: Power BI Report Builder Power BI Desktop

Per usare dati di un database Oracle nel report è necessario avere un set di dati basato su un'origine dati del report di tipo Oracle. Questo tipo di origine dati predefinita usa il provider di dati Oracle direttamente e richiede un componente software client Oracle. Questo articolo illustra come scaricare e installare i driver per Power BI Report Builder.

Importante

I comandi seguenti che usano lo strumento OraProvCfg.exe di Oracle per registrare i driver ODP.NET gestiti e non gestiti di Oracle sono forniti come esempi per l'uso con i prodotti Microsoft precedenti. Per la configurazione dei driver ODP.NET specifici per l'ambiente in uso, potrebbe essere necessario contattare il supporto Oracle o consultare la documentazione di Oracle per configurare il provider di dati Oracle per .NET.

Driver a 32 bit per Power BI Report Builder

Generatore report di Power BI usa ODP.NET gestito per la creazione di report impaginati (RDL). Quando si usano i driver Oracle ODAC 12.2 e versioni successive, è necessario eseguire solo i passaggi seguenti. In caso contrario, vengono installati per impostazione predefinita in una configurazione non a livello di computer per una nuova installazione della Oracle home. Questi passaggi presuppongono che i file ODAC 18.x siano stati installati nella cartella c:\oracle32 in cui è installato Power BI Report Builder. Per registrare ODP.NET gestito, seguire questa procedura:

  1. Nel sito di download Oracle installare Oracle "ODAC con Oracle Developer Tools per Visual Studio - OUI" (32 bit).

  2. Registrare il client ODP.NET gestito nella GAC:

    C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
    
  3. Aggiungere le voci del client ODP.NET gestito a machine.config:

    C:\oracle32\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle32\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
    

Driver a 64 bit per Generatore report di Power BI

Nota

Le istruzioni seguenti si applicano a Generatore report di Power BI versione 15.7.01678.0001 e successive. Per le versioni precedenti alla 15.7.01678.0001, seguire le istruzioni Driver a 32 bit per Power BI Report Builder precedenti.

Generatore report di Power BI usa ODP.NET gestito per la creazione di report impaginati (RDL). Quando si usano i driver Oracle ODAC 12.2 e versioni successive, è necessario eseguire solo i passaggi seguenti. In caso contrario, vengono installati per impostazione predefinita in una configurazione non a livello di computer per una nuova installazione della Oracle home. Questi passaggi presuppongono che siano stati installati i file ODAC 18.x nella cartella c:\oracle64 in cui è installato Generatore report di Power BI. Per registrare ODP.NET gestito, seguire questa procedura:

  1. Dal sito di download di Oracle installare il programma di installazione Oracle 64-bit ODAC Oracle Universal Installer (OUI).

  2. Registrare il client ODP.NET gestito nella GAC:

    C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:gac /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
    
  3. Aggiungere le voci del client ODP.NET gestito a machine.config:

    C:\oracle64\product\18.0.0\client_1\odp.net\bin\4\OraProvCfg.exe /action:config /force /product:odpm /frameworkversion:v4.0.30319 /providerpath:C:\oracle64\product\18.0.0\client_1\odp.net\managed\common\Oracle.ManagedDataAccess.dll
    

Stringa di connessione

Contattare l'amministratore del database per ottenere le informazioni di connessione e le credenziali da utilizzare per connettersi all'origine dati. La stringa di connessione di esempio seguente specifica un database Oracle nel server "Oracle18" che usa Unicode. Il nome del server deve corrispondere a quello definito nel file di configurazione Tnsnames.ora come nome dell'istanza del server Oracle.

Data Source="Oracle18"; Unicode="True"  

Per altri esempi di stringhe di connessione, vedere Creare stringhe di connessione dati (Power BI Report Builder).

Titolo

Le credenziali sono necessarie per eseguire query, per visualizzare in anteprima il report in locale e per visualizzare in anteprima il report nel portale Web di Power BI.

Dopo aver pubblicato il report, potrebbe essere necessario associarlo a una connessione di Power BI Gateway. Per altre informazioni, vedere Gestire l'origine dati - Oracle

Query

Per creare un set di dati, è possibile selezionare una stored procedure in un elenco a discesa oppure creare una query SQL. Per compilare una query, è necessario utilizzare la finestra Progettazione query basata su testo. Per altre informazioni, vedere Interfaccia utente di Progettazione query basata su testo (Power BI Report Builder).

È possibile specificare le stored procedure che restituiscono solo un set di risultati. Le query basate su cursori non sono supportate.

Parametri

Se la query include variabili di query, i parametri di report corrispondenti verranno generati automaticamente. I parametri denominati sono supportati da questa estensione. Per Oracle versione 9 o successiva sono supportati parametri multivalore.

I parametri di report vengono creati con valori di proprietà predefiniti che all'occorrenza possono essere modificati. Ad esempio, i dati di ogni parametro di report sono di tipo Text. Dopo aver creato i parametri di report, potrebbe essere necessario modificare i valori predefiniti.

Considerazioni e limitazioni

Prima di poter connettere un'origine dati Oracle, l'amministratore di sistema deve installare la versione del provider di dati .NET per Oracle che supporta il recupero di dati dal database Oracle. Questo provider di dati deve essere installato nello stesso computer di Power BI Report Builder e anche nel computer che ospita Power BI Gateway. Per altre informazioni, vedere Gestire l'origine dati - Oracle.

Soluzione alternativa per la chiamata di stored procedure

Quando si usa un'origine dati Oracle, se il report impaginato ha un tipo di query impostato come stored procedure, non viene eseguito nel servizio Power BI a causa di una limitazione di Power BI Gateway. Come soluzione alternativa, se si usa Oracle 12 o versione successiva, impostare il tipo di query su testo e chiamare la stored procedure inline, come nell'esempio seguente.

Screenshot della finestra di dialogo Proprietà set di dati.

DECLARE OUT_RPT_DATA SYS_REFCURSOR;
BEGIN
   SYSTEM.<Procedure_Name>(OUT_RPT_DATA);
   DBMS_SQL.RETURN_RESULT(OUT_RPT_DATA);
END;

Informazioni sulla piattaforma e sulla versione

Per altre informazioni sul supporto per piattaforme e versioni, vedere Origini dati supportate per i report impaginati di Power BI.