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:
Nel sito di download Oracle installare Oracle "ODAC con Oracle Developer Tools per Visual Studio - OUI" (32 bit).
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
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:
Dal sito di download di Oracle installare il programma di installazione Oracle 64-bit ODAC Oracle Universal Installer (OUI).
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
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.
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.