データ ソースの管理 - OracleManage your data source - Oracle

オンプレミス データ ゲートウェイをインストールしたら、ゲートウェイで使用できるデータ ソースを追加する必要があります。Once you have installed the on-premises data gateway, you will need to add data sources that can be used with the gateway. この記事では、ゲートウェイとデータ ソースの操作方法について説明します。This article will look at how to work with gateways and data sources. スケジュールされた更新または DirectQuery のどちらに対しても Oracle データ ソースを使用できます。You can use the Oracle data source either for scheduled refresh or for DirectQuery.

ゲートウェイをダウンロードしてインストールするDownload and install the gateway

ゲートウェイは Power BI サービスからダウンロードできます。You can download the gateway from the Power BI service. [ダウンロード] > [Data Gateway] の順に選択するか、ゲートウェイのダウンロード ページに移動します。Select Downloads > Data Gateway, or by going to the gateway download page.

警告

ゲートウェイを Oracle サーバーに接続するには、Oracle Data Provider for .NET (ODP.NET) をインストールして構成する必要があります。In order for the gateway to be able to connect to your Oracle server, the Oracle Data Provider for .NET (ODP.NET) needs to be installed and configured. このコンポーネントは、Oracle Data Access Components (ODAC) の一部です。This is part of the Oracle Data Access Components (ODAC). Oracle プロバイダーのダウンロード方法の詳細については、「Oracle クライアントのインストール」をご覧ください。For more information on how to download the Oracle provider, see Installing the Oracle Client below.

Oracle クライアントのインストールInstalling the Oracle client

Power BI Desktop の 32 ビット バージョンの場合、次のリンクをクリックして 32 ビット Oracle クライアントをダウンロードし、インストールします。For 32-bit versions of Power BI Desktop, use the following link to download and install the 32-bit Oracle client:

Power BI Desktop の 64 ビット バージョンまたはオンプレミス データ ゲートウェイの場合は、次のリンクをクリックして 64 ビットの Oracle クライアントをダウンロードしてインストールしてください。For 64-bit versions of Power BI Desktop, or for the on-premises data gateway, use the following link to download and install the 64-bit Oracle client:

インストールした後は、データベースの適切な情報で tnsnames.ora ファイルを構成する必要があります。Once that is installed, you will need to configure your tnsnames.ora file with the proper information for your database. Power BI Desktop とゲートウェイは、tnsnames.ora ファイルで定義されている net_service_name を使用します。Power BI Desktop and the gateway will go off of the net_service_name defined in the tnsnames.ora file. 構成されていない場合は接続できません。If it isn't configured, you will not be able to connect. tnsnames.ora の既定のパスは [Oracle Home Directory]\Network\Admin\tnsnames.ora です。The default path for tnsnames.ora is the following: [Oracle Home Directory]\Network\Admin\tnsnames.ora. tnsnames.ora ファイルの構成方法の詳細は、「Oracle: Local Naming Parameters (tnsnames.ora) (Oracle: ローカル名パラメーター (tnsnames.ora))」をご覧ください。For more information about how to configure tnsnames.ora files, see Oracle: Local Naming Parameters (tnsnames.ora).

tnsnames.ora ファイルのエントリの例Example tnsnames.ora file entry

tnsname.ora のエントリの基本的な形式は次のとおりです。The basic format of an entry in tnsname.ora is the following.

net_service_name=
 (DESCRIPTION=
   (ADDRESS=(protocol_address_information))
   (CONNECT_DATA=
     (SERVICE_NAME=service_name)))

サーバーとポートの情報の設定例を次に示します。Here is an example of the server and port information filled in.

CONTOSO =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracleserver.contoso.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = CONTOSO)
    )
  )

ゲートウェイの追加Add a gateway

ゲートウェイを追加する場合は、使用している環境のサーバー上にゲートウェイをダウンロードしてインストールするだけです。To add a gateway, simply download and install the gateway on a server in your environment. インストール済みのゲートウェイは、 [ゲートウェイの管理]の下のゲートウェイ一覧に表示されます。After you have installed the gateway, it will show in the lists of gateways under Manage gateways.

注意

[ゲートウェイの管理] は、少なくとも 1 つのゲートウェイの管理者になるまで表示されません。Manage gateways will not show up until you are the admin of at least one gateway. つまり、ゲートウェイの管理者に追加されるか、または自身でゲートウェイをインストールして構成した場合に表示されます。This can happen either by being added as an admin or you installing and configuring a gateway.

ゲートウェイの削除Remove a gateway

ゲートウェイを削除すると、そのゲートウェイの下にあるデータ ソースもすべて削除されます。Removing a gateway will also delete any data sources under that gateway. それらのデータ ソースに依存するダッシュボードやレポートも中断されます。This will also break any dashboards and reports that rely on those data sources.

  1. 画面右上の歯車アイコン をクリックし、[ゲートウェイの管理] を選択します。Select the gear icon in the upper-right corner > Manage gateways.
  2. [ゲートウェイ] > [削除] をクリックします。Gateway > Remove

データ ソースの追加Add a data source

データ ソースを追加するには、ゲートウェイを選択して [データ ソースの追加] をクリックするか、または [ゲートウェイ] > [データ ソースの追加] をクリックします。You can add a data source by either selecting a gateway and click Add data source, or go to Gateway > Add data source.

次に、一覧から [データ ソースの種類] を選択します。You can then select the Data Source Type from the list.

次に、 [サーバー][データベース]など、データ ソースの情報を入力する必要があります。You will then want to fill in the information for the data source which includes the Server and the Database.

また、 [認証方法]も選択する必要があります。You will also need to choose an Authentication Method. [Windows] または [基本]を選択できます。This can either be Windows or Basic. Windows 認証ではなく Oracle 内で作成されたアカウントを使用する場合は、[基本] を選択してください。You would want to choose Basic if you are going to use an account that is created within Oracle instead of Windows Authentication. 次に、このデータ ソースで使用される資格情報を入力します。Then enter the credentials that will be used for this data source.

注意

データ ソースへのすべてのクエリは、これらの資格情報を使用して実行されます。All queries to the data source will run using these credentials. 詳細については、資格情報の保存方法を説明している主なオンプレミス データ ゲートウェイ記事を参照してください。For more information, see the main on-premises data gateway article to learn more about how credentials are stored.

すべての情報を入力したら、 [追加] をクリックできます。You can click Add after you have everything filled in. このデータ ソースは、オンプレミスの Oracle サーバーに対するスケジュールされた更新または DirectQuery に使用できるようになりました。You can now use this data source for scheduled refresh, or DirectQuery, against an Oracle server that is on-premises. 接続に成功すると、「 接続成功 」というメッセージが表示されます。You will see Connection Successful if it succeeded.

詳細設定Advanced settings

データ ソースのプライバシー レベルを構成できます。You can configure the privacy level for your data source. データを加工できる方法を制御します。This controls how data can be mashed up. これは、スケジュールされた更新にのみ使用します。This is only used for scheduled refresh. DirectQuery には適用されません。It does not apply to DirectQuery. 詳細情報Learn more

データ ソースの削除Remove a data source

データ ソースを削除すると、そのデータ ソースに依存するすべてのダッシュボードやレポートが中断されます。Removing a data source will break any dashboards or reports that rely on the given data source.

データ ソースを削除するには、[データ ソース] > [削除] をクリックします。To remove a Data Source, go to the Data Source > Remove.

管理者の管理Manage administrators

ゲートウェイの [管理者] タブで、ゲートウェイを管理できるユーザー (またはセキュリティ グループ) を追加および削除できます。On the Administrators tab for the gateway, you can add and remove users (or security groups) that can administer the gateway.

ユーザーの管理Manage users

データ ソースの [ユーザー] タブで、このデータ ソースを使用できるユーザーまたはセキュリティ グループを追加および削除できます。On the Users tab, for the data source, you can add, and remove, users, or security groups, that can use this data source.

注意

ユーザー一覧は、だれがレポートを公開できるかを制御します。The users list only controls who are allowed to publish reports. レポート所有者は、ダッシュボードやコンテンツ パックを作成し、それらを他のユーザーと共有できます。The report owners can create dashboards, or content packs, and share those with other users. レポートまたはダッシュボードを使用するユーザーをユーザー一覧に含める必要はありません。Users that are consuming the report or dashboard do not need to be in the users list.

データ ソースの使用Using the data source

作成したデータ ソースは、DirectQuery 接続かスケジュールされた更新のいずれかによって使用されます。After you have created the data source, it will be available to use with either DirectQuery connections, or through scheduled refresh.

警告

Power BI Desktop とオンプレミス データ ゲートウェイ内のデータ ソースとの間で、サーバーとデータベース名が一致している必要があります。Server and database name have to match between Power BI Desktop and the data source within the on-premises data gateway!

データセットとゲートウェイ内のデータ ソース間のリンクは、サーバー名とデータベース名に基づいています。The link between your dataset and the data source within the gateway is based on your server name and database name. このため、これらは一致している必要があります。These have to match! たとえば、Power BI Desktop 内でサーバー名の IP アドレスを指定する場合は、ゲートウェイ構成内のデータ ソースでもその IP アドレスを使用する必要があります。For example, if you supply an IP Address for the server name, within Power BI Desktop, you will need to use the IP Address for the data source within the gateway configuration. また、この名前は、tnsnames.ora ファイルで定義されている別名と一致している必要があります。This name also has to match an alias defined within the tnsnames.ora file. tnsnames.ora ファイルの詳細は、「Oracle クライアントのインストール」をご覧ください。For more information about the tnsnames.ora file, see Installing the Oracle Client.

これは、DirectQuery とスケジュールされた更新のどちらにも該当します。This is the case for both DirectQuery and scheduled refresh.

DirectQuery 接続でデータ ソースを使用するUsing the data source with DirectQuery connections

Power BI Desktop とゲートウェイ用に構成されているデータ ソースとの間では、サーバーとデータベース名が一致している必要があります。You will need to make sure the server and database name matches between Power BI Desktop and the configured data source for the gateway. また、DirectQuery のデータセットを公開するには、自分のアカウントがデータ ソースの [ユーザー] タブの一覧に表示されている必要があります。You will also need to make sure your user is listed in the Users tab of the data source in order to publish DirectQuery datasets. DirectQuery の選択は、最初にデータをインポートする Power BI Desktop 内で発生します。The selection, for DirectQuery, occurs within Power BI Desktop when you first import data. 詳細情報Learn more

公開した後は、Power BI Desktop か [データの取得] のいずれかから、レポート機能が利用可能になります。After you publish, either from Power BI Desktop or Get Data, your reports should start working. ゲートウェイ内にデータ ソースを作成してから、接続が使用できるようになるまでには、数分ほどかかることがあります。It may take several minutes, after creating the data source within the gateway, for the connection to be usable.

スケジュールされた更新でデータ ソースを使用するUsing the data source with scheduled refresh

ゲートウェイ内に構成されているデータ ソースの [ユーザー] タブの一覧に自分のアカウントが表示されていて、さらにサーバーとデータベース名が一致している場合は、スケジュールされた更新で使用するオプションとして、ゲートウェイが表示されます。If you are listed in the Users tab of the data source configured within the gateway, and the server and database name match, you will see the gateway as an option to use with scheduled refresh.

トラブルシューティングTroubleshooting

名前付けの構文が正しくない、または適切に構成されていない場合、Oracle でエラーが発生する可能性があります。You may encounter serveral errors from Oracle when the naming syntax is either incorrect or not configured properly.

  • ORA-12154: TNS: could not resolve the connect identifier specified (指定された接続識別子を解決できませんでした)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-12514: TNS listener does not currently know of service requested in connect descriptor
  • ORA-12541: TNS: no listener (リスナーがありません)ORA-12541: TNS: no listener
  • ORA-12170: TNS:Connect timeout occurred (接続のタイムアウトが発生しました)ORA-12170: TNS:Connect timeout occurred
  • ORA-12504: TNS listener was not given the SERVICE_NAME in CONNECT_DATA (リスナーは CONNECT_DATA で SERVICE_NAME を指定されませんでした)ORA-12504: TNS listener was not given the SERVICE_NAME in CONNECT_DATA

Oracle クライアントがインストールされていない場合、または適切に構成されていない場合、これらのエラーが発生する可能性があります。These errors could occur if either the Oracle client is not installed, or if it is not configured properly. インストールされている場合は、tnsnames.ora ファイルが正しく構成されていること、および適切な net_service_name を使用していることを確認してください。If it is installed, you will want to verify the tnsnames.ora file is properly configured and you are using the proper net_service_name. また、Power BI Desktop を使用しているコンピューターとゲートウェイを実行しているコンピューターで、net_service_name が一致していることも確認する必要があります。You will also need to make sure that the net_service_name is the same between the machine using Power BI Desktop and the machine that is running the gateway. 詳細については、「Oracle クライアントのインストール」をご覧ください。For more information, see Installing the Oracle Client.

注意

Oracle サーバーのバージョンと Oracle クライアントのバージョンの互換性のために問題が発生する可能性もあります。You may also be hitting an issue due to compatability between the Oracle server version and the Oracle client version. 通常は、両者を一致させます。Typically you want these to match.

ゲートウェイに関する他のトラブルシューティングの情報については、「オンプレミス データ ゲートウェイのトラブルシューティング」をご覧ください。For additional troubleshooting information relating to the gateway, see Troubleshooting the on-premises data gateway.

次の手順Next steps

オンプレミス データ ゲートウェイOn-premises data gateway
オンプレミス データ ゲートウェイの詳細On-premises data gateway - in-depth
オンプレミス データ ゲートウェイのトラブルシューティングTroubleshooting the on-premises data gateway
Power BI PremiumPower BI Premium

他にわからないことがある場合は、More questions? Power BI コミュニティで質問してみてくださいTry asking the Power BI Community