Oracle Database

Riassunto

Elemento	Descrizione
Stato di rilascio	Disponibilità generale
Prodotti	Excel Power BI (modelli semantici) Power BI (flussi di dati) Infrastruttura (Dataflow Gen2) Power Apps (flussi di dati) Dynamics 365 Customer Insights Servizi di analisi
Tipi di autenticazione supportati	Windows (desktop/online) Database (desktop) Basic (online) Account di Microsoft (desktop)
Documentazione di riferimento sulle funzioni	Oracle.Database

Annotazioni

Alcune funzionalità possono essere presenti in un prodotto, ma non altre a causa di pianificazioni di distribuzione e funzionalità specifiche dell'host.

Prerequisiti

Versioni di Oracle supportate:

• Oracle Database Server 12c (12.1.0.2) e versioni successive
• Oracle Autonomous Database - tutte le versioni

Prima di potersi connettere a un database Oracle tramite Power Query, è necessario installare Oracle Client for Microsoft Tools (OCMT). Per connettersi a un database Oracle con il gateway dati locale, è necessario installare OCMT a 64 bit nel computer che esegue il gateway. Per altre informazioni, vedere Gestire l'origine dati - Oracle.

Annotazioni

Dalla versione di aprile 2025 di Power BI Desktop e della versione di maggio 2025 del gateway dati locale, è disponibile una nuova opzione per usare il driver Oracle gestito ODP.NET predefinito per connettersi al database Oracle, attualmente disponibile in anteprima. Con la funzionalità abilitata, non è necessario installare manualmente OCMT. Ulteriori informazioni su questa funzionalità.

Funzionalità supportate

• Importazione
• DirectQuery (modelli semantici di Power BI)
• Opzioni avanzate
  • Timeout del comando in minuti
  • Istruzione SQL
  • Includi colonne di relazioni
  • Navigare utilizzando la gerarchia completa

Scaricare e installare Oracle Client for Microsoft Tools

Oracle Client for Microsoft Tools installa e configura il provider di dati Oracle per .NET (ODP.NET) per supportare connessioni degli strumenti Microsoft a 32 bit e a 64 bit con database Oracle locali e cloud, incluso Oracle Autonomous Database (ADB). OCMT è un programma di installazione grafico che automatizza il processo di installazione del client Oracle Database. Supporta la connessione con Power BI Desktop, il servizio Power BI, Fabric (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services e BizTalk Server.

OCMT è un software gratuito. Può essere scaricato dalla pagina Oracle Client for Microsoft Tools. Per Power BI Desktop a 64 bit e il servizio Power BI, usare OCMT a 64 bit. Per Power BI Desktop a 32 bit, usare OCMT a 32 bit.

Anche se nel client Power BI è già installato un client Oracle o ODP.NET, è consigliabile usare il programma di installazione OCMT per completare correttamente tutti i passaggi di configurazione necessari per usare il database Oracle.

• Download di OCMT a 64 bit e 32 bit
• Istruzioni per l'installazione e l'installazione di OCMT

Connettersi a un database Oracle locale da Power Query Desktop

Per stabilire la connessione, seguire questa procedura:

1. Selezionare l'opzione Database Oracle nella selezione del connettore.

2. Specificare l'alias TNS del servizio Oracle net o la stringa di connessione Easy Connect (Plus) a cui connettersi in Server. Easy Connect si usa più facilmente impostando il valore server sul server Oracle Database Nome host / NomeServizio, dove NomeServizio è il nome del database globale. Lo screenshot seguente usa un nome di servizio net.

   

3. Se ti connetti da Power BI Desktop, seleziona la modalità di connettività dati Importa o DirectQuery. Nella parte restante di questi passaggi di esempio viene usata la modalità di connettività dei dati di importazione. Per saperne di più su DirectQuery, vedere Usare DirectQuery in Power BI Desktop.

4. Se ci si connette al database Oracle per la prima volta, selezionare il tipo di autenticazione da usare e quindi immettere le credenziali. I tipi di autenticazione disponibili sono:

   • Windows (autenticazione di Windows)
   • Database (nome utente e password)
   • Microsoft Account (Microsoft Entra ID)

   Per altre informazioni sull'autenticazione, vedere Autenticazione con un'origine dati.

   

5. In Strumento di navigazioneselezionare i dati necessari, quindi selezionare Carica per caricare i dati o Trasformare i dati per trasformare i dati.

Connettersi a un database Oracle locale da Power Query Online

Per stabilire la connessione, seguire questa procedura:

1. Installare e impostare un gateway di dati in locale.

2. In Power Query Online selezionare l'opzione Database Oracle nella selezione delle origini dati.

3. Nella finestra di dialogo Database Oracle visualizzata specificare l'alias nome/TNS del servizio Oracle net, la stringa di connessione Easy Connect Plus o il descrittore di connessione a cui connettersi in Server.

   

4. Specificare un nome di connessione, ad esempio "testoracleserver".

5. Seleziona il nome del gateway dati locale.

   Annotazioni

   È necessario selezionare un gateway dati locale per questo connettore, indipendentemente dal fatto che il database Oracle si trovi nella rete locale o in un sito Web.

6. Se ci si connette al database Oracle per la prima volta, selezionare il tipo di credenziali per la connessione in Tipo di autenticazione. Scegliere Basic se si prevede di accedere con un nome utente e una password Oracle. Scegliere Windows quando si usa l'autenticazione del sistema operativo Windows e con il client Oracle e il server in esecuzione in Windows.

7. Immettere le credenziali.

8. Seleziona Avanti per continuare.

9. In Strumento di navigazione selezionare i dati necessari, quindi selezionare Trasforma dati per trasformare i dati nell'editor di Power Query.

Connettersi a un database autonomo Oracle

Annotazioni

Attualmente è possibile connettersi a un database autonomo Oracle da Excel, Power BI Desktop, servizio Power BI, Infrastruttura (Dataflow Gen2), Power Apps, SQL Server Analysis Services e BizTalk Server usando le procedure descritte in questa sezione. Questi strumenti usano ODP.NET non gestiti per connettersi. Altri strumenti Microsoft, tra cui SQL Server Data Tools, SQL Server Integration Services e SQL Server Reporting Services, usano ODP.NET gestiti per connettersi al database autonomo Oracle usando procedure in gran parte simili.

Per connettere Power BI a un database autonomo Oracle, sono necessari gli account e le app seguenti:

• Un account Oracle.com (iscrizione account Oracle.com)
• Un account Oracle Cloud (iscrizione all'account Oracle Cloud)
• Un database autonomo Oracle (ottenere un database autonomo sempre gratuito)
• Power BI Desktop (Ottieni Power BI Desktop) o account del servizio Power BI (gestione delle licenze del servizio Power BI per gli utenti dell'organizzazione)
• Gateway dati locale se si usa il servizio Power BI (scaricare e installare un gateway standard)

Scarica le credenziali del client

Il primo passaggio per configurare una connessione al database Oracle Autonomo consiste nel scaricare le credenziali client.

Per scaricare le credenziali client:

1. Nella pagina dei dettagli del database autonomo Oracle selezionare Connessione al database.

   

2. Nella pagina Connessione database selezionare Scarica portafoglio.

   

3. Immettere una password da usare con questo portafoglio, confermare la password e quindi selezionare Scarica.

   

Configurare le credenziali di Oracle ADB

1. Nel computer Windows passare alla cartella in cui sono state scaricate le credenziali di Oracle ADB da Scaricare le credenziali client.

2. Decomprimere le credenziali nella directory specificata in OCMT come directory del file di configurazione Oracle. In questo esempio le credenziali vengono estratte in c:\data\wallet\wallet_contosomart.

   

   Annotazioni

   Il file tnsnames.ora definisce l'indirizzo del database autonomo Oracle e le informazioni di connessione.

3. Aprire sqlnet.ora in un editor, ad esempio Blocco note.

4. In WALLET_LOCATION modificare il percorso della cartella portafoglio sotto l'opzione Directory. In questo esempio:

   WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

5. Salvare e chiudere il file sqlnet.ora.

Aprire il file tnsnames.ora nella cartella wallets. Il file contiene un elenco di nomi di servizi net ADB a cui è possibile connettersi. In questo esempio i nomi sono contosomart_high, contosomart_low e contosomart_medium. I nomi dei servizi net ADB sono diversi.

Connettere Power BI Desktop ad Oracle ADB

1. Aprire Power BI Desktop.

2. Selezionare Recupera dati.

3. In Recupera dati selezionare Database>.

4. Immettere il nome del servizio net del server di database autonomo Oracle a cui connettersi. In questo esempio il server è contosomart_high. Quindi, seleziona OK.

   

5. Se si accede a questo server da Power BI Desktop per la prima volta, viene chiesto di immettere le credenziali. Selezionare Database, quindi immettere il nome utente e la password per il database Oracle. Le credenziali immesse di seguito sono il nome utente e la password per il database autonomo Oracle specifico a cui ci si vuole connettere. In questo esempio vengono usati il nome utente e la password iniziali dell'amministratore del database. Selezionare quindi Connetti.

   

   Annotazioni

   È possibile usare l'autenticazione di Microsoft Entra ID per accedere a Oracle Autonomous Database tramite l'opzione Account Microsoft .

A questo punto, il Navigator appare e mostra i dati di connessione.

È anche possibile che si verifichi uno dei diversi errori perché la configurazione non è stata configurata correttamente. Questi errori sono descritti in Risoluzione dei problemi.

Un errore che potrebbe verificarsi in questo test iniziale viene eseguito in Navigator, in cui il database sembra essere connesso, ma non contiene dati. Al contrario, al posto dei dati viene visualizzato un errore Oracle: ORA-28759: errore di apertura del file.

Se si verifica questo errore, assicurarsi che il percorso della cartella portafoglio fornito in sqlnet.ora sia il percorso completo e corretto della cartella wallet.

Configurare il gateway

1. Installare e impostare un gateway di dati in locale.

2. Nel servizio Power BI selezionare l'icona a forma di ingranaggio in alto a destra e quindi selezionare Gestisci gateway.

   

3. In Aggiungi origine dati selezionare Aggiungi origini dati per usare il gateway.

   

4. In Nome origine dati immettere il nome da usare come impostazione origine dati.

5. In Tipo di origine dati selezionare Oracle.

6. In Server immettere il nome del servizio net del server di database autonomo Oracle a cui connettersi.

7. In Metodo di autenticazione selezionare Basic.

8. Immettere il nome utente e la password per Oracle Autonomous Database. In questo esempio vengono usati il nome utente amministratore del database predefinito (ADMIN) e la password.

9. Seleziona Aggiungi.

   

Se tutti gli elementi sono stati installati e configurati correttamente, viene visualizzato un messaggio Connessione riuscita . È ora possibile connettersi al database autonomo Oracle usando gli stessi passaggi descritti in Connettersi a un database Oracle locale da Power Query Online.

Connettersi tramite opzioni avanzate

Power Query Desktop e Power Query Online offrono un set di opzioni avanzate che è possibile aggiungere alla query, se necessario.

La tabella seguente elenca tutte le opzioni avanzate che è possibile impostare in Power Query Desktop e Power Query Online.

Opzione avanzata	Descrizione
Timeout del comando in minuti	Se la connessione dura più di 10 minuti (timeout predefinito), è possibile immettere un altro valore in minuti per mantenere la connessione aperta più a lungo. Questa opzione è disponibile solo in Power Query Desktop.
Istruzione SQL	Per informazioni, vedere Importare dati da un database usando una query di database nativa.
Includi colonne di relazioni	Se selezionata, include colonne che potrebbero avere relazioni con altre tabelle. Se questa casella è deselezionata, queste colonne non vengono visualizzate.
Navigare utilizzando la gerarchia completa	Se selezionata, lo strumento di navigazione visualizza la gerarchia completa delle tabelle nel database a cui ci si connette. Se deselezionato, lo strumento di navigazione visualizza solo le tabelle le cui colonne e righe contengono dati.

Dopo aver selezionato le opzioni avanzate necessarie, selezionare OK in Power Query Desktop o Avanti in Power Query Online per connettersi al database Oracle.

Usare il driver Oracle predefinito (anteprima)

A partire dalla versione di Power BI Desktop di aprile 2025 e dalla versione di gateway dati locale di maggio 2025, il connettore Oracle include un driver ODP.NET gestito da Oracle integrato per la connettività. Questa funzionalità elimina la necessità per gli utenti di installare e gestire il driver. È possibile abilitare questa funzionalità seguendo le istruzioni fornite di seguito.

Per usare questo driver predefinito in Power BI Desktop, passare a Opzioni e impostazioni (nella scheda File) >Opzioni> Funzionalità in anteprima e quindi selezionare la casella di controllo per attivare l'opzione Abilita tramite Provider ODP gestito Oracle in bundle.

Per usare questo driver predefinito nel gateway dati locale, modificare le configurazioni del gateway per aggiornare l'impostazione MashupFlight_EnableOracleBundledOdacProvider seguendo questa procedura:

1. Sul computer locale in cui è installato il gateway dati on-premise, navigare a C:\Program Files\On-premises data gateway.
2. Eseguire un backup del file di configurazione denominato Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
3. Aprire il file di configurazione Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config originale e individuare la voce MashupFlight_EnableOracleBundledOdacProvider.
4. Aggiornare il MashupFlight_EnableOracleBundledOdacProvider valore come True.
5. Riavvia il tuo gateway.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_EnableOracleBundledOdacProvider" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Le configurazioni rimanenti per connettersi a un database Oracle da Power Query Desktop sono le stesse descritte nelle sezioni precedenti.

Problemi noti e limitazioni

Le sessioni di Power BI possono essere ancora attive nel database Oracle per circa 30 minuti dopo un aggiornamento semantico del modello a tale database Oracle. Solo dopo circa 30 minuti queste sessioni diventano inattive/rimosse nel database Oracle. Questo comportamento è predefinito.

Risoluzione dei problemi

Quando la sintassi di denominazione non è corretta o non è configurata correttamente, è possibile che si verifichino diversi errori di Oracle:

• ORA-12154: TNS: non è stato possibile risolvere l'identificatore di connessione specificato.
• ORA-12514: TNS: il listener attualmente non conosce il servizio richiesto nel descrittore di connessione.
• ORA-12541: TNS: nessun listener.
• ORA-12170: TNS: timeout della connessione.
• ORA-12504: TNS: il listener non ha ricevuto il SERVICE_NAME in CONNECT_DATA.

Questi errori possono verificarsi se il descrittore di connessione del database Oracle tnsnames.ora non è configurato correttamente, il nome del servizio net specificato è errato oppure il listener del database Oracle non è in esecuzione o non raggiungibile, ad esempio un firewall che blocca il listener o la porta del database. Assicurarsi di soddisfare i prerequisiti minimi di installazione. Più informazioni: Prerequisiti

Visitare il portale della Guida degli errori del database Oracle per esaminare le cause e le risoluzioni comuni per l'errore Oracle specifico riscontrato. Inserisci l'errore Oracle nella barra di ricerca del portale.

Se Power BI Desktop è stato scaricato da Microsoft Store, potrebbe non essere possibile connettersi ai database Oracle a causa di un problema di driver Oracle. Se si verifica questo problema, il messaggio di errore restituito è: Riferimento all'oggetto non impostato. Per risolvere il problema, eseguire le operazioni seguenti:

• Scaricare Power BI Desktop dall'Area download anziché da Microsoft Store.

Se il messaggio di errore Riferimento oggetto non impostato si verifica in Power BI quando ci si connette a un database Oracle usando il gateway dati locale, seguire le istruzioni in Gestire l'origine dati - Oracle.

Se si usa il server di report di Power BI, vedere le linee guida nell'articolo Tipo di connessione Oracle .

Passaggi successivi

Ottimizzare Power Query durante l'espansione delle colonne di tabella