Database Oracle

  • Articolo

Riepilogo

Articolo 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 per Customer Insights
Analysis Services
Tipi di autenticazione supportati Windows (desktop/online)
Database (desktop)
Basic (online)
Account Microsoft (desktop)
Documentazione di riferimento sulle funzioni Oracle.Database

Nota

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.

Funzionalità supportate

  • Import
  • DirectQuery (modelli semantici di Power BI)
  • Opzioni avanzate
    • Timeout del comando in minuti
    • SQL statement
    • Includi colonne relazioni
    • Esplora con gerarchia completa

Scaricare e installare Oracle Client for Microsoft Tools

Oracle Client for Microsoft Tools installa e configura Oracle provider di dati per .NET (ODP.NET) per supportare connessioni di 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, 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 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.

Connessione 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/Nome servizio Net Oracle o stringa di connessione Easy Connessione (Plus) a cui connettersi in Server. Easy Connessione è il più semplice da usare impostando il valore Server sul server Oracle Database Hostname/ServiceName, dove ServiceName è il nome del database globale. Lo screenshot seguente usa un nome di servizio net.

    Immettere Connessione al database Oracle.

  3. Se ci si connette da Power BI Desktop, selezionare 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 altre informazioni 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)
    • Account Microsoft (ID Microsoft Entra)

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

    Immettere le credenziali del database Oracle.

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

Connessione a un database Oracle locale da Power Query Online

Per stabilire la connessione, seguire questa procedura:

  1. Installare e configurare un gateway dati 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 TNS/Nome servizio Rete Oracle, Easy Connessione Plus stringa di connessione o connettere il descrittore a cui connettersi in Server.

    Immettere la connessione online al database Oracle.

  4. Specificare un nome di Connessione ion, ad esempio "testoracleserver".

  5. Selezionare il nome del gateway dati locale.

    Nota

    È 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. Immetti le tue credenziali.

  8. Selezionare Avanti per continuare.

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

Connessione a un database autonomo Oracle

Nota

Attualmente è possibile connettersi a un database autonomo Oracle da Excel, Power BI Desktop, servizio Power BI, Fabric (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:

Scaricare le credenziali 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 Db Connessione ion.

    Db Connessione ion.

  2. Nella pagina Database Connessione ion selezionare Scarica portafoglio.

    Scarica portafoglio.

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

    Password portafoglio.

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.

    Immagine con i file portafoglio decompressi nella cartella portafoglio.

    Nota

    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 DIB sono diversi.

Immagine con tre nomi TNS di esempio, contosomart_high, contosomart_low e contosomart_medium.

Connessione Power BI Desktop ad Oracle ADB

  1. Apri Power BI Desktop.

  2. Selezionare Recupera dati.

  3. In Recupera dati selezionare Database Oracle database>.

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

    Immagine della finestra di dialogo Database Oracle con contosomart_high come nome del server e modalità di importazione selezionata.

  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 Connetti.

    Immagine della finestra di dialogo credenziali, con Database selezionato e il nome utente e la password predefiniti del database immessi.

    Nota

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

A questo punto, lo strumento di navigazione viene visualizzato e visualizza i dati di connessione.

Immagine con lo strumento di navigazione aperto e il database contosomart_high visualizzato con tutti i relativi

È 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.

Immagine dello strumento di navigazione con il nome del database nella parte superiore, ma viene visualizzato un errore anziché i dati.

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 configurare un gateway dati locale.

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

    Immagine della servizio Power BI aperta, l'icona a forma di ingranaggio selezionata e il menu Gestisci gateway con i gateway evidenziati.

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

    Immagine della finestra Aggiungi origine dati in servizio Power BI, con Aggiungi origine dati per usare il gateway evidenziato.

  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. Selezionare Aggiungi.

    Immagine della finestra Impostazioni origine dati con tutte le impostazioni dell'origine dati compilate.

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

Connessione con 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 Avanzate 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.
SQL statement Per informazioni, vedere Importare dati da un database usando una query di database nativa.
Includi colonne relazioni Se selezionata, include colonne che potrebbero avere relazioni con altre tabelle. Se questa casella è deselezionata, queste colonne non vengono visualizzate.
Esplora con 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.

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 è impostato a livello di progettazione.

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 edizione Standard RVICE_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. Immettere 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 Server di report di Power BI, vedere il materiale sussidiario nell'articolo Oracle Connessione ion Type (Tipo di Connessione Oracle).

Passaggi successivi

Ottimizzare Power Query quando si espandono le colonne della tabella