Oracle データベース

概要

項目	説明
リリース状況	一般提供
プロダクツ	エクセル Power BI (セマンティックモデル) Power BI (データフロー) ファブリック (データフロー Gen2) Power Apps (データフロー) Dynamics 365 Customer Insights Analysis Services
サポートされている認証の種類	Windows (デスクトップ/オンライン) データベース (デスクトップ) Basic (オンライン) Microsoft アカウント (デスクトップ)
関数リファレンスドキュメント	Oracle.Database

注

一部の機能は 1 つの製品に存在する可能性がありますが、展開スケジュールとホスト固有の機能のため、他の製品には存在しない場合があります。

[前提条件]

サポートされている Oracle のバージョン:

Oracle Database Server 12c (12.1.0.2) 以降
Oracle Autonomous Database - すべてのバージョン

2025 年 4 月バージョンの Power BI Desktop と May 2025 バージョンのオンプレミスデータゲートウェイ以降では、組み込みの Oracle マネージド ODP.NET ドライバーを使用して Oracle データベースに接続できます。この機能を有効にした場合、OCMT を手動でインストールする必要はありません。 2026 年 6 月以降、ゲートウェイなしで Oracle Autonomous Database またはその他の Oracle クラウドエンドポイントへのクラウド接続を作成することもできます。この機能の詳細を確認してください。

新しい組み込みの Oracle ドライバーを使用しない場合は、エンタープライズオンプレミスデータゲートウェイを使用し、ゲートウェイまたは Power BI Desktop を実行しているコンピューターに 64 ビット Oracle Client for Microsoft Tools (OCMT) をインストールする必要があります。詳細については、「データソースの管理 - Oracle」を参照してください。

サポートされている機能

輸入
DirectQuery (Power BI セマンティックモデル)
高度なオプション
- コマンドのタイムアウト (分)
- SQL ステートメント
- リレーションシップ列を含める
- 完全階層を使用して移動する

oracle Client for Microsoft Tools (OCMT) オプションの使用

Oracle Client for Microsoft Tools は、Oracle Autonomous Database (ADB) を含む Oracle オンプレミスおよびクラウドデータベースとの 32 ビットおよび 64 ビットの Microsoft ツール接続をサポートするように、Oracle Data Provider for .NET (ODP.NET) をインストールして構成します。 OCMT は、Oracle データベースクライアントのセットアッププロセスを自動化するグラフィカルインストーラーです。 Power BI Desktop、Power BI サービス、Fabric (Dataflow Gen2)、Excel、SQL Server Analysis Services、SQL Server Data Tools、SQL Server Integration Services、SQL Server Reporting Services、BizTalk Server との接続がサポートされています。

OCMT はフリーソフトウェアです。 Oracle Client for Microsoft Tools ページからダウンロードできます。 64 ビット Power BI Desktop および Power BI サービスの場合は、64 ビット OCMT を使用します。 32 ビット Power BI Desktop の場合は、32 ビット OCMT を使用します。

Power BI クライアントに Oracle クライアントまたは ODP.NET が既にインストールされている場合でも、OCMT インストーラーを使用して、Power BI が Oracle データベースを操作するために必要なすべての構成手順を適切に完了することを強くお勧めします。

Power BI Desktop からオンプレミスの Oracle データベースに接続する

接続を確立するには、次の手順を実行します。

コネクタの選択で Oracle データベース オプションを選択します。
サーバーで接続する Oracle Net サービス名/TNS 別名または Easy Connect (Plus) 接続文字列を指定します。 Easy Connect は、サーバーの値を Oracle Database サーバーの Hostname/ServiceName (ServiceName はグローバルデータベース名) に設定することで最も簡単に使用できます。次のスクリーンショットでは、ネットサービス名を使用しています。
Power BI Desktop から接続する場合は、 Import または DirectQuery データ接続モードを選択します。以降の手順の例では、データのインポート接続モードを使用します。 DirectQuery の詳細については、「Power BI DesktopDirectQuery を使用する」を参照してください。
この Oracle データベースに初めて接続する場合は、使用する認証の種類を選択し、資格情報を入力します。使用できる認証の種類は次のとおりです。
- Windows (Windows 認証)
- データベース (ユーザー名とパスワード)
- Microsoft アカウント (Microsoft Entra ID)
認証の詳細については、「データソースを使用した認証」を参照してください。
ナビゲーターで、必要なデータを選択し、[読み込み] を選択してデータを読み込むか、[データの変換] を選択してデータを変換します。

Power Query Online からオンプレミスの Oracle データベースに接続する

接続を確立するには、次の手順を実行します。

オンプレミスデータゲートウェイをインストールしてセットアップします。
Power Query Online で、データソースの選択で Oracle データベース オプションを選択します。
表示される Oracle データベース ダイアログで、Oracle Net サービス名/TNS エイリアス、Easy Connect Plus 接続文字列、またはサーバーで接続する接続記述子を指定 します。
"testoracleserver" などの 接続名を指定します。
オンプレミスデータゲートウェイの名前を選択します。
この Oracle データベースに初めて接続する場合は、[ 認証の種類] で接続の資格情報の種類を選択します。 Oracle のユーザー名とパスワードを使用してサインインする場合は、[ 基本 ] を選択します。 Windows オペレーティングシステム認証を使用する場合、および Windows で実行されている Oracle クライアントとサーバーの両方で、Windows を選択します。
資格情報を入力します。
[次へ] を選択して続行します。
ナビゲーターで、必要なデータを選択し、[データの変換] を選択して Power Query エディターでデータを変換します。

Oracle 自律データベースへの接続

注

現時点では、このセクションの手順を使用して、Excel、Power BI Desktop、Power BI サービス、Fabric (Dataflow Gen2)、Power Apps、SQL Server Analysis Services、BizTalk Server から Oracle 自律データベースに接続できます。これらのツールは、アンマネージド ODP.NET を使用して接続します。 SQL Server Data Tools、SQL Server Integration Services、SQL Server Reporting Services などの他の Microsoft ツールでは、マネージド ODP.NET を使用して、ほぼ同様の手順を使用して Oracle 自律データベースに接続します。

Power BI を Oracle Autonomous Database に接続するには、次のアカウントとアプリが必要です。

Oracle.com アカウント (Oracle.com アカウントのサインアップ)
Oracle Cloud アカウント (Oracle Cloud アカウントのサインアップ)
Oracle 自律データベース (常に無料の自律データベースを取得する)
Power BI Desktop (Power BI Desktop の取得) または Power BI サービスアカウント (組織内のユーザーに対する Power BI サービスのライセンス)

クライアント資格情報をダウンロードする

Oracle Autonomous データベースへの接続を設定する最初の手順は、クライアント資格情報をダウンロードすることです。

クライアント資格情報をダウンロードするには:

Oracle Autonomous データベースの詳細ページで、[ DB 接続] を選択します。
[データベース接続] ページで、[ウォレットのダウンロード] を選択します。
このウォレットで使用するパスワードを入力し、パスワードを確認して、[ ダウンロード] を選択します。

Oracle ADB 資格情報を構成する

Windows マシンで、[クライアント資格情報のダウンロード] から Oracle ADB 資格情報をダウンロードしたフォルダーに移動します。
ORACLE 構成ファイル ディレクトリとして OCMT で指定したディレクトリに資格情報を解凍します。この例では、資格情報が c:\data\wallet\wallet_contosomart に抽出されます。

注

tnsnames.ora ファイルは、Oracle 自律データベースのアドレスと接続情報を定義します。
メモ帳などのエディターで sqlnet.ora を開きます。
[WALLET_LOCATIONで、[ディレクトリ] オプションでウォレットフォルダーへのパスを変更します。この例では：

WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))
sqlnet.ora ファイルを保存して閉じます。

ウォレットフォルダー内の tnsnames.ora ファイルを開きます。このファイルには、接続先の ADB ネットサービス名の一覧が含まれています。この例では、名前はcontosomart_high、contosomart_low、およびcontosomart_mediumです。 ADB のネットサービス名は異なります。

3 つの TNS 名、contosomart_high、contosomart_low、contosomart_mediumの例を示すスクリーンショット。

Power BI Desktop を Oracle ADB に接続する

Power BI Desktop を開きます。
[ データの取得] を選択します。
[ データの取得] で、[ データベース>Oracle データベース] を選択します。
接続先の Oracle Autonomous Database サーバーのネットサービス名を入力します。この例では、 サーバー はcontosomart_high。次に、[ OK] を選択します。
Power BI Desktop からこのサーバーに初めてサインインする場合は、資格情報の入力を求められます。 [ データベース] を選択し、Oracle データベースのユーザー名とパスワードを入力します。ここで入力する資格情報は、接続先の特定の Oracle 自律データベースのユーザー名とパスワードです。この例では、データベースの初期管理者ユーザー名とパスワードが使用されます。次に、[ 接続] を選択します。

注

Microsoft アカウントオプションを 使用して、Microsoft Entra ID 認証を使用して Oracle Autonomous Database にサインオンできます。

この時点で、 ナビゲーター が表示され、接続データが表示されます。

contosomart_high データベースが開いているナビゲーターのスクリーンショット。

構成が正しく設定されていないため、いくつかのエラーのいずれかが発生する可能性もあります。これらのエラーについては、「トラブルシューティング」を参照してください。

最初のテストで発生する可能性がある 1 つのエラーはNavigatorで発生します。そこではデータベースが接続されているように見えますが、データが含まれていません。代わりに、ORA-28759: failure to open file (ファイルが開けません) エラーがデータの代わりに表示されます。

上部にデータベース名が表示されているナビゲーターのスクリーンショット。データの代わりにエラーが表示されます。

このエラーが発生した場合は、sqlnet.ora で指定したウォレットフォルダーパスがウォレットフォルダーへの完全で正しいパスであることを確認してください。

詳細オプションを使用して接続する

Power Query Desktop と Power Query Online には、必要に応じてクエリに追加できる一連の高度なオプションが用意されています。

次の表に、Power Query Desktop と Power Query Online で設定できるすべての詳細オプションを示します。

高度なオプション	説明
コマンドのタイムアウト (分)	接続の継続時間が 10 分 (既定のタイムアウト) を超える場合は、別の値を分単位で入力して、接続を長く開いたままにすることができます。このオプションは、Power Query Desktop でのみ使用できます。
SQL ステートメント	詳細については、「ネイティブデータベースクエリを使用してデータベースからデータをインポートする」を参照してください。
リレーションシップ列を含める	オンの場合は、他のテーブルとのリレーションシップを持つ可能性のある列が含まれます。このボックスがオフの場合、これらの列は表示されません。
完全階層を使用して移動する	オンにすると、ナビゲーターには、接続先のデータベース内のテーブルの完全な階層が表示されます。オフにすると、列と行にデータが含まれるテーブルのみがナビゲーターに表示されます。

必要な詳細オプションを選択したら、Power Query Desktop で [OK] を 選択するか、Power Query Online で [次へ ] を選択して Oracle データベースに接続します。

組み込みの Oracle ドライバーを使用する

Power BI デスクトップのインポートモードの場合

2026 年 6 月バージョンの Power BI Desktop またはオンプレミスデータゲートウェイの場合、既定では、接続に組み込みの Oracle マネージド ODP.NET ドライバーが使用されます。この機能により、ユーザーがドライバーをインストールして管理する必要がなくなります。引き続き、次の手順を使用して、この機能を無効にすることができます。

Power BI デスクトップでこの組み込みドライバーを使用しない場合は、オプションと設定 ([ファイル] タブの下) >Options>Preview 機能に移動し、バンドルされた Oracle マネージド ODP プロバイダーを使用してインポートモードを有効にするオプションを有効にするチェックボックスをオフにします。

Power BI Desktop でバンドルされた Oracle マネージド ODP プロバイダーの使用を有効にするオプションのスクリーンショット。

Power BI Desktop の DirectQuery モードの場合 (プレビュー)

DirectQuery モードでは、組み込みの Oracle マネージド ODP.NET ドライバーを使用してもプレビュー段階です。オプトインするには、次の手順に従います。

Power BI デスクトップでこの組み込みドライバーを使用するには、オプションと設定 ([ファイル] タブの下) >Options>Preview 機能に移動し、チェックボックスをオフにして、バンドルされた Oracle Managed ODP Provider for DirectQuery Mode オプションを使用して有効にします。

オンプレミスゲートウェイのインポートモードの場合

2026 年 6 月バージョン以降、オンプレミスデータゲートウェイでは、既定で、組み込みの Oracle マネージド ODP.NET ドライバーが接続に使用されます。インポートモードでオンプレミスデータゲートウェイでこの組み込みドライバーを使用しないようにするには、次の手順を使用して、ゲートウェイ構成を変更して MashupFlight_DisableOracleBundledOdacProviderV2 設定を更新します。

オンプレミスデータゲートウェイがインストールされているローカルコンピューターで、C:\Program Files\On-premises data gatewayに移動します。
Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configという名前の構成ファイルのバックアップを作成します。
元の Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config 構成ファイルを開き、MashupFlight_DisableOracleBundledOdacProviderV2 エントリを見つけます。
MashupFlight_DisableOracleBundledOdacProviderV2値をTrueに更新します。
ゲートウェイを再起動します。

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

注

Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config ファイルの MashupFlight_DisableOracleBundledOdacProviderV2 設定を変更すると、オンプレミスデータゲートウェイのアップグレードを介して構成が保持されます。

注

セマンティックモデルでオンプレミスの Oracle データソースに接続するためにパーソナルゲートウェイが引き続き使用されている場合は、エンタープライズオンプレミスデータゲートウェイまたは仮想ネットワーク (VNET) ゲートウェイにアップグレードするか、クラウド Oracle ワークロードをクラウド接続に移行します。 更新された Oracle コネクタは、個人用のオンプレミスデータゲートウェイをサポートしていません。これはインポートモードと DirectQuery モードの両方に適用されます。既存のセマンティックモデルでは、データ接続バインディングを更新するまで、パーソナルゲートウェイを引き続き使用できます。バインドを更新した後は、個人用ゲートウェイに戻ることはできません。 Oracle 接続のアップグレードを適宜計画します。

オンプレミスゲートウェイの DirectQuery モードの場合 (プレビュー)

オンプレミスデータゲートウェイでは、DirectQuery 用に組み込みの Oracle マネージド ODP.NET ドライバーを使用できます。この機能はプレビュー段階です。

DirectQuery の TNS エイリアスを解決するには、環境変数を使用します。ゲートウェイサービスアカウントはユーザースコープの変数にアクセスできないため、システム (マシン) スコープで TNS_ADMIN 設定してから、オンプレミスデータゲートウェイサービスを再起動します。

組み込みドライバーは、Oracle プロキシユーザー認証をサポートしていません。詳細と回避策については、「 Oracle プロキシユーザー認証はサポートされていません」を参照してください。

組み込みの Oracle ドライバーでTNS_ADMINを指定するためのサポートされている方法

TNS_ADMINを指定するには、次の 3 つのオプションがあります。

OADC.configでTNS_ADMINを構成する
環境変数を使用する
以前にインストールした OADC の設定を使用する

ODAC.config でTNS_ADMINを構成する

組み込みの Oracle ドライバーを使用していて、プログラムファイルを変更するアクセス権がある場合は、組み込みの Oracle ドライバーで使用 ODAC.config 構成ファイルのTNS_ADMINを指定できます。ファイルは、Power BI Desktop またはオンプレミスデータゲートウェイのインストール場所の "ADO.NET プロバイダー" サブフォルダーにあります。 "C:\network\admin" TNS_ADMINパスを指定する例を次に示します。

この構成値は、他のオプションよりも優先されます。

構成例

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

ODAC.config で構成TNS_ADMINは、環境内のTNS_ADMIN設定よりも優先されることに注意してください。

環境変数を使用する

ユーザーが ODAC.configを変更するアクセス権を持っていない場合は、TNS_ADMIN環境変数を追加してTNS_ADMINを指定できます。環境変数には、Power BI Desktop またはオンプレミスデータゲートウェイを実行しているユーザーのシステム環境変数またはユーザー環境変数を指定できます。たとえば、TNS_ADMINの値を "C:\network\admin" に設定します。

環境 (特にシステムレベル) でTNS_ADMINを設定すると、このマシンで実行されている他のアプリケーションが、TNS_ADMINが指す場所からネットワーク構成ファイル (tnsnames.ora など) を取得する可能性があります。

以前にインストールした ODAC の設定を使用する

ODAC が以前にインストールされていて、TNS_ADMINが構成されている場合、Power BI は自動的にTNS_ADMINを検出します。

Power Query Desktop から Oracle データベースに接続するための残りの構成は、前のセクションで説明した構成と同じです。

許可されるプロパティリスト

ユーザーは、 (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name)))などの接続記述子を使用して Oracle サーバー名を指定できます。システムは、デスクトップとゲートウェイで使用できるプロパティを強制します。 ODAC.configで許可される既定のプロパティを次のセクションに示します。

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

ユーザーは、新しいプロパティを追加する必要がある場合、または一覧からプロパティを削除して、より厳密な規則を適用する必要がある場合に、この許可されるプロパティリストを変更できます。

注

重要な制限事項

DirectQuery 用の組み込みの Oracle マネージド ODP.NET ドライバーの使用はプレビュー段階です。詳細については、前の DirectQuery セクションを参照してください。
ファイル ODAC.config では、編集に管理者権限が必要な場合があり、Power BI ストアアプリではこのファイルの変更が許可されません。
ODAC.config に加えられた変更はアップグレード中に上書きされるため、アップグレード前にファイルを別の場所に保存する必要があります。
オンプレミスデータゲートウェイが正常に動作するには、ゲートウェイサービスを実行しているユーザーが、TNS_ADMINが指すフォルダーにアクセスできることを確認します。
構成の変更を適用した後、Power BI Desktop またはオンプレミスデータゲートウェイサービスを再起動します。

制限事項と考慮事項

その Oracle データベースに対するセマンティックモデルの更新後、約 30 分間、Power BI セッションを Oracle データベースでアクティブにすることができます。約 30 分後にのみ、これらのセッションは Oracle データベースで非アクティブ/削除されます。この動作は設計によるものです。

トラブルシューティング

名前付け構文が正しくないか、正しく構成されていない場合、Oracle からいくつかのエラーが発生する可能性があります。

ORA-12154: TNS: could not resolve the connect identifier specified.
ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
ORA-12541: TNS: no listener.
ORA-12170: TNS: connect timeout occurred.
ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

これらのエラーは、Oracle tnsnames.ora データベース接続記述子が正しく構成されていない、指定されたネットサービス名のスペルが間違っている、Oracle データベースリスナーが実行されていない、または到達できない (リスナーまたはデータベースポートをブロックしているファイアウォールなど) 場合に発生する可能性があります。インストールの最小前提条件を満たしていることを確認します。詳細情報: 前提条件

Oracle データベースエラーヘルプポータルにアクセスして、発生した特定の Oracle エラーの一般的な原因と解決策を確認してください。ポータルの検索バーに Oracle エラーを入力します。

組み込みの Oracle ドライバーでオンプレミスデータゲートウェイ経由で DirectQuery を使用する場合、次のようなエラーは、TNS エイリアスを解決できないことを示している可能性があります。

ORA-12154: TNS name resolution failure
ORA-50201: Failed to connect to server

これらのエラーが発生した場合は、 TNS_ADMIN がシステム (マシン) スコープで設定されていること、およびゲートウェイサービスアカウントが指すフォルダーにアクセスできることを確認してから、オンプレミスデータゲートウェイサービスを再起動します。詳細については、組み込みの Oracle ドライバーと Oracle のトラブルシューティング Oracle Net サービスガイドでTNS_ADMINを指定するサポートされている方法を参照してください。

組み込みの Oracle ドライバーに関する既知の問題

次の既知の問題は、組み込みの Oracle マネージド ODP.NET ドライバーに固有です。いくつかの回避策は、組み込みのドライバーをオフにすることで、ODP.NETアンマネージドドライバーにフォールバックします。各サーフェス (Power BIデスクトップインポートと DirectQuery、ゲートウェイインポートと DirectQuery) のターンオフ手順については、「組み込みの Oracle ドライバーを使用する」を参照してください。

Import と DirectQuery の両方で、オンプレミスデータゲートウェイに適用されます。

Oracle ネットワーク構成ファイル (tnsnames.ora または TNS_ADMIN ディレクトリ) がネットワーク共有 (UNC パス) に格納されている場合、組み込みドライバーは一貫してネットサービス名 (TNS エイリアス) の解決に失敗します。 ORA-12154: TNS:could not resolve the connect identifier specifiedまたはORA-50201: Failed to connect to serverが表示される場合があります。同じエイリアスは、ODP.NETアンマネージドドライバー、またはファイルがローカルパス上にある場合に正しく解決されます。組み込みのマネージドドライバーは、UNC の場所から Oracle ネットワーク構成ファイルを確実に読み取りません。

次のいずれかの回避策を使用します。

tnsnames.ora (および使用する場合はsqlnet.ora) をローカルドライブ上のフォルダーにコピーし、そのフォルダーでドライバーをポイントします。組み込みの Oracle ドライバーでTNS_ADMINを指定するサポートされている方法を参照してください。ゲートウェイ DirectQuery の場合は、ゲートウェイサービスアカウントがユーザースコープの変数を読み取り、ゲートウェイサービスを再起動できないため、システム (マシン) スコープで TNS_ADMIN を設定します。
ゲートウェイを実行しているサービスアカウントがネットワーク共有にアクセスできることを確認します。
ネットワーク構成ファイルは必要ないため、tnsnames.oraエイリアスではなく、サーバーに直接接続記述子 (host:port/service_name など) を直接入力します。
組み込みドライバーをオフにして、共有からファイルを読み取ることができる ODP.NETアンマネージドドライバーにフォールバックします。

NLS_LANGは無視されます

Import と DirectQuery の両方で、Power BI Desktop、オンプレミスデータゲートウェイ、Power BI サービスクラウド接続に適用されます。

組み込みのドライバー、Oracle セッション言語、地域、および数値と日付の形式は、NLS_LANG環境変数ではなく、コンピューターの.NETカルチャ (Windows地域と形式の設定) に従います。 NLS_LANGを設定または変更しても効果はありません。マシンのリージョンによっては、この動作により、数値または日付が間違った区切り記号または日付の順序で解析されたり、クエリによって 0 行または正しくない値が返されたり、 ORA-01722、 ORA-01858、 ORA-01861、 ORA-01843などのエラーが返されたりすることがあります。たとえば、英語 (米国) に設定されたコンピューターで作成されたレポートは、英語 (英国) に設定されたコンピューターで 0 行またはエラーを返す場合があります。マネージド ODP.NET ドライバーは、NLS_LANGを受け入れる ODP.NET アンマネージドドライバーとは異なり、NLS_LANGからではなく、.NET スレッドカルチャから各国語サポート (NLS) 設定を派生させます。

次のいずれかの回避策を使用します。

コンピューターの地域設定を、データとクエリが設計されたロケールと一致させます。
組み込みドライバーをオフにして、NLS_LANGを優先する ODP.NETアンマネージドドライバーにフォールバックします。

マネージドドライバーのグローバリゼーション動作の背景については、Oracle のグローバリゼーションサポートのドキュメントを参照してください。

`FetchSize` レジストリの組み込みドライバーでは使用されません

Oracle インポートモデルのPower BI Desktop とオンプレミスデータゲートウェイに適用されます。

組み込みドライバーに切り替えると、Oracle Import モデルの更新が ODP.NETアンマネージドドライバーよりも遅くなる場合があります。組み込みのマネージド ODP.NET プロバイダーは、レジストリから FetchSize プロパティを読み取りません。 ODP.NETアンマネージプロバイダーとマネージドプロバイダーの既定のFetchSizeは、バージョン 23.26.2 以前では 128 KB で、Power BIに含まれる 23.6 プロバイダーも含まれます。マネージドプロバイダーは、レジストリで構成されている FetchSize オーバーライドを無視します。

組み込みドライバーをオフにして、レジストリのFetchSize設定を優先する ODP.NETアンマネージドドライバーにフォールバックします。オンプレミスデータゲートウェイで、ゲートウェイ設定のバンドルされたプロバイダー構成で MashupFlight_DisableOracleBundledOdacProviderV2 を True に設定します。

Oracle プロキシユーザー認証はサポートされていません

Oracle プロキシアカウントを使用する Oracle Import および DirectQuery のオンプレミスデータゲートウェイ (2026 年 6 月以降) に適用されます。

既定で組み込みのマネージドプロバイダーである June 2026 ゲートウェイにアップグレードすると、Oracle プロキシアカウントを使用して Oracle に接続するレポートPower BI、Import と DirectQuery の両方で失敗します。接続でプロキシ以外の Oracle アカウントを使用する場合も、同じデータソースが機能します。 Oracle Database プロキシユーザー認証は、別のスキーマ (たとえば、User Id=proxy_user[target_schema] フォーム) の代わりに 1 人のデータベースユーザーとして接続する場合、現在Power BIに付属している組み込みのマネージド ODP.NET プロバイダーのバージョン 23.6 ではサポートされていません。

次のいずれかの回避策を使用します。

可能な場合は、プロキシ以外の Oracle アカウントを使用します。
インポートの場合は、MashupFlight_DisableOracleBundledOdacProviderV2を True に設定して、ゲートウェイのインポート用の組み込みドライバーをオフにして、ゲートウェイがプロキシアカウントをサポートする ODP.NETアンマネージドドライバーにフォールバックするようにします。
DirectQuery の場合、インポート設定は適用されません。ゲートウェイ DirectQuery パスの組み込みドライバーをオフにするには、Microsoft サポートにお問い合わせください。現在、この構成はセルフサービスではありません。

Oracle の個人用クラウド接続資格情報を更新できない

Oracle パーソナルクラウド接続のPower BI サービスに適用されます。

Power BI サービスの [接続とゲートウェイの管理] ページで、Oracle パーソナルクラウド接続の資格情報を更新することはできません。代わりに、セマンティックモデルの設定ウィンドウから資格情報を更新します。

セマンティックモデルの設定ウィンドウを開き、[ゲートウェイとクラウド接続] に移動します。
個人用クラウド接続を使用するようにデータソースを設定します。
[ データソースの資格情報] で、データソースの資格情報を編集します。

Microsoft Store から Power BI Desktop をダウンロードした場合、Oracle ドライバーの問題が原因で Oracle データベースに接続できない可能性があります。この問題が発生した場合、返されるエラーメッセージはオブジェクト 参照が設定されていません。 この問題に対処するには、Microsoft Store ではなくダウンロードセンターから Power BI Desktop をダウンロードします。

オンプレミスのデータゲートウェイを使用して Oracle データベースに接続するときに、Power BI で オブジェクト参照が設定されていない エラーメッセージが発生する場合は、「データソースの管理 - Oracle」の手順に従います。

Power BI Report Server を使用している場合は、 Oracle 接続の種類に関する記事のガイダンスを参照してください。

テーブル列を展開するときの Power Query の最適化

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-14

Oracle データベース

概要

[前提条件]

サポートされている機能

oracle Client for Microsoft Tools (OCMT) オプションの使用

Power BI Desktop からオンプレミスの Oracle データベースに接続する

Power Query Online からオンプレミスの Oracle データベースに接続する

Oracle 自律データベースへの接続

クライアント資格情報をダウンロードする

Oracle ADB 資格情報を構成する

Power BI Desktop を Oracle ADB に接続する

詳細オプションを使用して接続する

組み込みの Oracle ドライバーを使用する

Power BI デスクトップのインポート モードの場合

Power BI Desktop の DirectQuery モードの場合 (プレビュー)

オンプレミス ゲートウェイのインポート モードの場合

オンプレミス ゲートウェイの DirectQuery モードの場合 (プレビュー)

組み込みの Oracle ドライバーでTNS_ADMINを指定するためのサポートされている方法

ODAC.config でTNS_ADMINを構成する

環境変数を使用する

以前にインストールした ODAC の設定を使用する

許可されるプロパティ リスト

制限事項と考慮事項

トラブルシューティング

組み込みの Oracle ドライバーに関する既知の問題

ネットワーク共有の TNS エイリアスが解決されない

NLS_LANGは無視されます

FetchSize レジストリの組み込みドライバーでは使用されません

Oracle プロキシ ユーザー認証はサポートされていません

Oracle の個人用クラウド接続資格情報を更新できない

関連コンテンツ

フィードバック

その他のリソース

Power BI デスクトップのインポートモードの場合

オンプレミスゲートウェイのインポートモードの場合

オンプレミスゲートウェイの DirectQuery モードの場合 (プレビュー)

許可されるプロパティリスト

`FetchSize` レジストリの組み込みドライバーでは使用されません

Oracle プロキシユーザー認証はサポートされていません